Hosted ENSNode Instances
Get Started Quickly
Section titled “Get Started Quickly”NameHash Labs provides hosted instances of ENSNode for developers building on ENS and looking to get started quickly.
These instances are currently provided free of charge with no API key required, have no rate limiting, and are maintained and monitored by the NameHash Labs team.
1.13.1. The Omnigraph GraphQL schema is bundled inside the SDK and consumed by the gql.tada TypeScript plugin to type your queries, so pin an exact version (no ^ or ~) of enssdk@1.13.1 (and enskit@1.13.1 when using React) to keep your generated types matched to the deployed schema. Use these exact install commands:
npm install enssdk@1.13.1 # or, for React apps: npm install enskit@1.13.1 enssdk@1.13.1
ENS Namespaces
Section titled “ENS Namespaces”Each ENSNode instance is configured for a specific ENS namespace. An ENS namespace identifies which ENS protocol deployment ENSNode will provide data for (ex: mainnet or sepolia).
Each ENS namespace is associated with a particular ENS Root Registry deployment, which may or may not have completed the transition from ENSv1 (only) to ENSv1 + ENSv2 (both v1 and v2 concurrently activated together).
ENSNode supports all of the following ENS namespaces:
mainnet(currently ENSv1 only and not also ENSv2 yet)sepolia(currently ENSv1 only and not also ENSv2 yet)sepolia-v2(now ENSv1 + ENSv2 — An all new deployment of ENS to Sepolia that is already upgraded to ENSv1 + ENSv2 and is independent of the traditionalsepoliaENS namespace listed above which currently remains ENSv1 only)ens-test-env(now ENSv1 + ENSv2 — A deployment of ENSv1 + ENSv2 to a local Anvil chain for development and testing. For details see https://github.com/ensdomains/ens-test-env and https://github.com/ensdomains/contracts-v2). Teams working on the core ENS protocol and infrastructure such as ENS Labs and NameHash Labs are using this ENSNode configuration to support ENSv2 development.
More details about ENS namespaces can be found inside ENSNode’s datasources package.
ENSNode Plugins
Section titled “ENSNode Plugins”Each ENSNode instance is also configured for a specific set of activated ENSNode plugins.
The activated plugins determine the specific indexed data model and data records ENSIndexer will produce in ENSDb and therefore which APIs and data records ENSApi will make available to query.
ENSv1 + ENSv2 Instances
Section titled “ENSv1 + ENSv2 Instances”These instances are associated with an ENS namespace that has upgraded to ENSv1 + ENSv2 and demonstrate the latest support in ENSNode for ENSv1 and ENSv2 being concurrently activated together.
ENSNode ‘v2 Sepolia’
Section titled “ENSNode ‘v2 Sepolia’”The sepolia-v2 namespace is undergoing active development by the ENS Labs team who is continuing to release updated ENSv2 contracts. It should be considered experimental.
| Hosted at | https://api.v2-sepolia.ensnode.io Connect with ENSAdmin |
| ENSNode Version | v1.13.1 |
| ENS Namespace | sepolia-v2 |
| ENS Versions | ENSv1 + ENSv2 (concurrently activated together) |
| ENSNode Plugins | subgraph, unigraph, protocol-acceleration |
| ENS APIs |
|
ENSv1 Only Instances (not also ENSv2 yet)
Section titled “ENSv1 Only Instances (not also ENSv2 yet)”These instances are associated with an ENS namespace that has NOT upgraded to support ENSv1 and ENSv2 concurrently yet and are still operating exclusively under ENSv1. These demonstrate how the ENS Omnigraph API, enssdk, enskit, and the full stack of ENSNode services provide support to developers to become ENSv2 ready even before ENSv2 launches.
Alpha-style Deployments
Section titled “Alpha-style Deployments”These ENSNode instances do not constrain themselves to exclusively activating the subgraph plugin. They activate additional plugins such as the unigraph plugin to demonstrate the latest capabilities of ENSNode including the new ENS Omnigraph API.
ENSNode ‘Alpha’
Section titled “ENSNode ‘Alpha’”| Hosted at | https://api.alpha.ensnode.io Connect with ENSAdmin |
| ENSNode Version | v1.13.1 |
| ENS Namespace | mainnet |
| ENS Versions | ENSv1 only (not also ENSv2 yet) |
| ENSNode Plugins | unigraph, protocol-acceleration, subgraph, basenames, lineanames, threedns, registrars, tokenscope |
| ENS APIs |
|
ENSNode ‘Alpha-Sepolia’
Section titled “ENSNode ‘Alpha-Sepolia’”| Hosted at | https://api.alpha-sepolia.ensnode.io Connect with ENSAdmin |
| ENSNode Version | v1.13.1 |
| ENS Namespace | sepolia |
| ENS Versions | ENSv1 only (not also ENSv2 yet) |
| ENSNode Plugins | unigraph, protocol-acceleration, subgraph, basenames, lineanames, registrars |
| ENS APIs |
|
Subgraph-style Deployments
Section titled “Subgraph-style Deployments”These ENSNode instances focus on maximizing backwards compatibility with the ENS Subgraph. Therefore they exclusively activate the subgraph plugin and no others.
ENSNode ‘Mainnet’
Section titled “ENSNode ‘Mainnet’”| Hosted at | https://api.mainnet.ensnode.io Connect with ENSAdmin |
| ENSNode Version | v1.13.1 |
| ENS Namespace | mainnet |
| ENS Versions | ENSv1 only (not also ENSv2 yet) |
| ENSNode Plugins | subgraph |
| ENS APIs |
|
ENSNode ‘Sepolia’
Section titled “ENSNode ‘Sepolia’”| Hosted at | https://api.sepolia.ensnode.io Connect with ENSAdmin |
| ENSNode Version | v1.13.1 |
| ENS Namespace | sepolia |
| ENS Versions | ENSv1 only (not also ENSv2 yet) |
| ENSNode Plugins | subgraph |
| ENS APIs |
|
Start building
Section titled “Start building”Pick an instance above, then jump into the Quickstart for integration options to start making use of it.