ENSv2 Quickstart
What is ENSv2?
Section titled “What is ENSv2?”ENSv2 is the next generation of the Ethereum Name Service — a protocol upgrade that moves ENS registries from Ethereum mainnet onto L2s. Names become cheaper to register, faster to update, and natively multichain.
ENSv2 is backwards compatible with ENSv1: existing .eth names continue to work, and ENSv2 introduces a new registry architecture that supports names across multiple chains simultaneously.
What is ENS Omnigraph?
Section titled “What is ENS Omnigraph?”ENS Omnigraph is ENSNode’s unified GraphQL API for querying ENS name data across every supported chain from a single endpoint.
Today, fully supporting ENSv1 requires two separate systems: on-chain resolution (via RPC calls + CCIP-read) and indexed data (via the ENS Subgraph). Neither alone gives a complete picture.
ENS Omnigraph solves this by combining both into one API:
- Indexes ENSv1 and ENSv2 names across mainnet, Base, Linea, 3DNS, and more
- Provides resolution data — owner, resolver, records, expiry — in a single query
- Backwards compatible with ENSv1, so you can integrate today and get ENSv2 support automatically when it launches
This means you can build your ENS integration once against the Omnigraph API and be ready for ENSv2 before it even launches. See ENSv2 Readiness for the full story.
Query ENS name data
Section titled “Query ENS name data”The fastest way to query ENS data is with enssdk — the official TypeScript SDK. It gives you a fully typed GraphQL client pointed at the ENS Omnigraph API.
The playground below is live — edit the query or the name and run it against a real ENSNode instance:
The client.omnigraph.query(...) call sends a typed GraphQL query to the ENS Omnigraph API. The asInterpretedName helper normalizes the name before querying.