omnigraph

Query ENS domains, addresses, records, and ownership via a unified GraphQL API.

41|19|Updated Dec 23, 2024
One-click install
npx skills add https://github.com/namehash/ensnode --skill omnigraph
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omnigraph
Source: https://github.com/namehash/ensnode/tree/main/packages/ensskills/skills/omnigraph
Command: npx skills add https://github.com/namehash/ensnode --skill omnigraph

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unified access to ENS state across v1 and v2 via a single GraphQL API, reducing the need to stitch multiple sources or RPC calls.

Core Features & Use Cases

  • Unified GraphQL API over ENS state (domains, ownership, registrations, records, primary names, resolvers) across all chains.
  • Quick exploration with ENSNode CLI (enscli) or programmatic clients to fetch canonical domains, owners, and forward/reverse resolution data.
  • Use cases include verifying domain ownership, inspecting registrations, retrieving resolver records, and cross-chain name resolution for dashboards.

Quick Start

Run a sample Omnigraph query against ensnode to fetch the owner and canonical name for a domain.

Frequently Asked Questions about omnigraph

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query ENS domain ownership and records across multiple chains?

To query ENS domain ownership and records across chains, use a unified GraphQL API that consolidates ENSv1 and ENSv2 state. This single endpoint exposes core types like Domain, Account, and Registration, eliminating the need to stitch multiple RPC calls.

What is the best way to resolve ENS names and verify registration status programmatically?

The best way to resolve ENS names and verify registration status programmatically is by using GraphQL API clients or the enscli runner. These tools support both forward and reverse resolution, retrieving canonical names and resolver records directly from an ENSNode instance.

Do I need an ENSNode instance to perform cross-chain ENS data lookups?

Yes, you need an active ENSNode instance along with the enscli or enssdk runners to perform cross-chain ENS data lookups. This backend infrastructure serves the unified GraphQL schema required to fetch domains, addresses, and ownership data.

Can I use a single GraphQL API to retrieve both ENSv1 and ENSv2 resolver records?

Yes, you can use a single GraphQL API to retrieve both ENSv1 and ENSv2 resolver records. The unified schema exposes core types like Resolver and Registration, allowing you to inspect records and verify domain ownership across mainnet and alternative namespaces.

How does unified GraphQL ENS data access improve domain resolution workflows?

Unified GraphQL ENS data access improves domain resolution workflows by providing a single queryable schema for all chains. This reduces the complexity of stitching multiple data sources or RPC calls, streamlining dashboards and ownership verification processes.

What types of ENS data can I fetch when inspecting domain registrations via GraphQL?

When inspecting domain registrations via GraphQL, you can fetch core data types including Domain, Account, Resolver, and Registration. This allows you to retrieve canonical names, verify owners, check registration status, and access resolver records.