Documentation for agents: an index at /llms.txt, every docs page in one file at /llms-full.txt, and Markdown for any docs page by adding .md to its URL.

Skip to Content
ensforgeContracts

Deployments

Look up ENS contract addresses per chain, the capability flags of each deployment and the Deployments helpers in @ensforge/contracts.

Deployments holds the address of every ENS contract per chain, for ENSv1 and ENSv2. ensforge picks the deployment from the client's chain. See Addresses and chains.

mainnet (chain 1)

ENSv2 (mainnet-v2, active)

From https://github.com/ensdomains/contracts-v2 v1.0.1.

GroupContractAddress
contractsuniversalResolver0xeEeEEEeE14D718C2B47D9923Deab1335E144EeEe
contractsuniversalHelper0x46AE127D14683Ac74eF151e46ae2117A1A25C676
contractsrootRegistry0x2553c09bE6447BeFfdB86FA622ad41fB8f77A91e
contractsethRegistry0xf60aba43E1f7F3DAB1186Ff03B561401C9Df85E2
contractsethRegistrar0xD6D8369e55c94Ae8AFA714E6cF7AB5bE54D5CC81
contractsrentPriceOracle0x76F29609A363a8A1a2a6abe2e859C0F8916Af469
contractsensV2Resolver0x3071AD643cE4Ed8b3D67b289845b45dB82b068A4
contractspublicResolver0x66f9F566fF2f26309C1Bd9134388478A801dA3e1
contractsverifiableFactory0x77510ba162dfeA3d8989E3f0928a691B345730D2
contractslabelStore0x31e5E081fe38d15B3E8214ba5Cb08dC4708B70Ba
contractscontractNamer0x5cDaF63d4C2a01218149DDe707E5bc239c68730c
contractsreverseRegistrarAdapter0x349151735790269a9C14668B58D7C83b5ecb9607
contractsdefaultReverseRegistrarAdapter0xd86E32499eCAFe9c181dd7410f93A1a9bB61ef0d
implementationsuniversalResolver0x06Fdd07F007ADaC667177b46aB2EB9A75132Cfd5
implementationsuniversalResolverV10x804bf0D289C8353a0BaFdAAF9069Ab14C92B2099
implementationspermissionedResolver0x565b0F456a04Ac9b48758190e90030623Cff57C5
implementationsuserRegistry0x3269b830b61b3186Dc6d2f57Cab118E2FBC3E2df
implementationswrapperRegistry0xe86A4ef4d7A210aAA1d6A9594fC7Add7cD2Cf888
implementationscontractNamer0x87d7CDffAfBe9826D978FBdBE3Ad45E7A4BF3D1C
migrationensV1Resolver0x394D8EB4a4fDF599384DeAb25F31d111d755c398
migrationethRenewerV10x56c447F308F463A01121C41E72b0E7e7557fCb68
migrationunlockedMigrationController0xaB821Ca676CF2e0790Fa273526a165CFa86aEB64
migrationlockedMigrationController0x3ceA18620883a69ED349B23328A3B6302598e51A
migrationmigrationHelper0x6c8452AFc6043b5aF32eb345A8135108906F07ee
migrationgraveyard0xDa021A2C1C2F99574D861Ef8c6fA745851BEB7F6
migrationpublicResolverSet0xfFCedA021CBDF20f1a66ebbef32E49d208cAbf62
migrationregistryUpgradeSet0x573A73c0B3C0C90bB8BD728519434aF19Fb88935
infrastructureensUriRenderer0x82CaC0d801b9A392a4fF217D5E68145801E90a41
infrastructureboxedEnsUriRenderer0x6f412Ff4144d525f791777d3384e9A1B170492Fb
infrastructuremanagedUniversalResolverProxy0xcFFd2Ae680CD110D28739a70922636B5937b022B
infrastructurebatchRegistrar0xf0CcfBF6DbA1E01CCB833CED6d551A8F000E9721
infrastructurerootBatchRegistrar0xe467Ae049DDd65A21fb85B5f1dE5F7997a8Eb164
dnstldResolver0x6695327EE70F41151d2cBADC3ABBb6e4a58e739c
dnslegacyTldResolver0xaB48304A2520CE420E636AaCD48A8bb3e7e485Ee
dnsaliasResolver0x13285e928c65beFd90904F77A68FE4e7D9a43882
dnstxtResolver0xbB76e2ae1a61Ef91D095eC044ABf563e4C464E3E
dnsgatewayProvider0xA646BCEE466D77669A087f3379640CB03aCA7c3D
dnstemporaryRegistrar0x9d6D535f08be25A9A2FdA1a1C21217D27d81cC61
hcaownerAndSessionValidator0xa818428ed2F3F949bdc71b8A15bDD7B5D27ce938
hcaupgradeSet0x85E115F5b43c72e2BA4419a9A95e325dB18431c2
hcastandaloneFactory0x742bf21897a78e2C98cC5f5C5473A370a081e561
hcastandaloneImplementation0x116F462FA078ec0009e9b25DCd60309E70aaC4F4
hcaentryPoint0x0000000071727De22E5E9d8BAf0edAc6f37da032
hcaintentExecutor0x00000000005aD9ce1f5035FD62CA96CEf16AdAAF
hcagasRefundPaymaster0x1d7df6Ddc7328Ac827EB4D7f171C60AFB7f9A599
paymentTokensdai0x6B175474E89094C44Da98b954EedeAC495271d0F
paymentTokensusdc0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

ENSv1 (mainnet-v1, legacy)

From https://github.com/ensdomains/ens-contracts v1.7.0.

GroupContractAddress
contractsregistry0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e
contractsbaseRegistrar0x57f1887a8BF19b14fC0dF6Fd9B2acc9Af147eA85
contractsethRegistrarController0x59E16fcCd424Cc24e280Be16E11Bcd56fb0CE547
contractswrappedEthRegistrarController0x253553366Da8546fC250F225fe3d25d0C782303b
contractsbulkRenewal0xc649947a460B135e6B9a70Ee2FB429aDBB529290
contractspriceOracle0x7542565191d074cE84fBfA92cAE13AcB84788CA9
contractsnameWrapper0xD4416b13d2b3a9aBae7AcD5D6C2BbDBE25686401
contractspublicResolver0xF29100983E058B709F3D539b0c765937B804AC15
contractsuniversalResolver0xeEeEEEeE14D718C2B47D9923Deab1335E144EeEe
contractsreverseRegistrar0xa58E81fe9b61B5c3fE2AFD33CF304c454AbFc7Cb
contractsdefaultReverseRegistrar0x283F227c4Bd38ecE252C4Ae7ECE650B0e913f1f9
contractsdnsRegistrar0xB32cB5677a7C971689228EC835800432B339bA2B
contractsdnssecOracle0x0fc3152971714E5ed7723FAFa650F86A4BaF30C5
contractsoffchainDnsResolver0xF142B308cF687d4358410a4cB885513b30A42025

sepolia (chain 11155111)

ENSv2 (sepolia-v2, active)

From https://github.com/ensdomains/contracts-v2 v1.0.1.

GroupContractAddress
contractsuniversalResolver0xeEeEEEeE14D718C2B47D9923Deab1335E144EeEe
contractsuniversalHelper0xd453e5Bdb62CC3beA84341B1e306319C8Ffd7DFe
contractsrootRegistry0xB458D6a3a77919449d03e7A6903C26827c1eC43f
contractsethRegistry0xD4eBcbBdF463C9c45784603Db0dDD499BC44A8B4
contractsethRegistrar0xf633e7FC17e2bbE0D0965D18ec1821dcB754a3d3
contractsrentPriceOracle0x8196665D4ca7488B6474a9EC8E7d2719FB42263A
contractsensV2Resolver0x1cF3989ED3E5EC3cB1d731fC3777323813b61aCf
contractspublicResolver0xdC4a563d00F5c3012b699794eB9e13A561Be386F
contractsverifiableFactory0xDa70306C98E97eCe36F997a21368e53298572991
contractslabelStore0xed8246FF02203a4d4cb262bD78bEAA7408A57cAE
contractscontractNamer0x606f2453484f4Fa85b6E5FDB0E0bf777064bf9F3
contractsreverseRegistrarAdapter0x56Bce5E727FAa9D237341Bb5B9E8a03D5919779d
contractsdefaultReverseRegistrarAdapter0x36f97328e843e37520cbF530e9402791c2754066
implementationsuniversalResolver0x24E1D8e068620B647CA097f961A61055f4f42D72
implementationspermissionedResolver0x115eb53F0c60696633855F90b138178Fb40b2b2C
implementationsuserRegistry0x0822d199699f0a9D378617817a1439663234a126
implementationswrapperRegistry0xBe768b63E5fBBFBB0Ae97E9064E0002dF8001880
implementationscontractNamer0x4b8263BE7c522d8Fb3FBcA1F74B9C6e083B8D3e4
migrationensV1Resolver0x322B7581cA210a69c6D0e0D7c88a7688D2789Cb0
migrationethRenewerV10xf2ece44980778966b8a0FccB3A9E339440f6e045
migrationunlockedMigrationController0x2a35B94DF22cc7354570be2284655E2CDC0e64A2
migrationlockedMigrationController0x6029a063d69b09D23c52a754a90E4FE43aDac3A8
migrationmigrationHelper0xA8F86EE5cdD28703bd876F3a8c10B1DE70f36899
migrationgraveyard0xB58A90a39D13CcE1D0E192B5da5c47640855B04D
migrationpublicResolverSet0x5B2bd5208dac31905106d8e5a4973Ae1Cd7414F2
migrationregistryUpgradeSet0xF0a6f68c28603bDF2881Ca17476Ee477C72cD2fE
infrastructureensUriRenderer0x4D7f0349DfFB8e7BeD9fFBA1B9e45f7ECBD4f0f8
infrastructureboxedEnsUriRenderer0x0f5B101b6Fc626b9b210bB5E70f60F3dd9cA0d96
infrastructuremanagedUniversalResolverProxy0x6d80F2172CFdEc5730fE683860C33d26fC42e6F1
infrastructurebatchRegistrar0x4A4c8B7CDAB6B19dc2CdB417cdB53a2ccBaf5322
infrastructurerootBatchRegistrar0x4CDEDc6B514A6bc9B64854DfE2D6849D5B1369a6
dnstldResolver0x0c9F5E9AE61165140b49919F0dF13C0a6642e80d
dnsaliasResolver0xe30c9374929De41b71b6fb999B945553F2194c5F
dnstxtResolver0x00263173B7De91594Eb4140Ad8dD3a723B8e4EB3
dnsgatewayProvider0xd542a53982FDd0c456F02c5a54734c06073fA915
hcaownerAndSessionValidator0x4bF641590ab18E31B9F8789A3417A2620f860466
hcaupgradeSet0xCde956D6E2949Bc25a4273F93E0db6f68A1a6f34
hcastandaloneFactory0x6Bad0176236e97b346B5Dd13BCc8325B931EE8ab
hcastandaloneImplementation0xC940e5C5bF263C0e097054AECf73826769A72CEE
hcaentryPoint0x0000000071727De22E5E9d8BAf0edAc6f37da032
hcaintentExecutor0x00000000005aD9ce1f5035FD62CA96CEf16AdAAF
hcagasRefundPaymaster0x1d7df6Ddc7328Ac827EB4D7f171C60AFB7f9A599
paymentTokensdai0xF6faC8A58a0BE13b9197f27C41B73162Fe32572b
paymentTokensusdc0x240b0316Df57887DBBE58b586508b19e633a14aa

ENSv1 (sepolia-v1, legacy)

From https://github.com/ensdomains/ens-contracts v1.7.0.

GroupContractAddress
contractsregistry0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e
contractsbaseRegistrar0x57f1887a8BF19b14fC0dF6Fd9B2acc9Af147eA85
contractsethRegistrarController0xfb3cE5D01e0f33f41DbB39035dB9745962F1f968
contractsbulkRenewal0x6394b694a8C0DC716e447802E568F0Fb2c4E0965
contractspriceOracle0x6810DbCE73C67506f785A225F818b30D8f209AAb
contractsnameWrapper0x0635513f179D50A207757E05759CbD106d7dFcE8
contractspublicResolver0xE99638b40E4Fff0129D56f03b55b6bbC4BBE49b5
contractsuniversalResolver0xeEeEEEeE14D718C2B47D9923Deab1335E144EeEe
contractsreverseRegistrar0xA0a1AbcDAe1a2a4A2EF8e9113Ff0e02DD81DC0C6
contractsdefaultReverseRegistrar0x4F382928805ba0e23B30cFB75fC9E848e82DFD47
contractsdnsRegistrar0x5a07C75Ae469Bf3ee2657B588e8E6ABAC6741b4f
contractsdnssecOracle0xe62E4b6cE018Ad6e916fcC24545e20a33b9d8653
contractsoffchainDnsResolver0x179Be112b24Ad4cFC392eF8924DfA08C20Ad8583

Capabilities

Deployments differ in some behaviours; ensforge reads these flags instead of the chain ID.

CapabilitymainnetsepoliaDescription
resolutionErrorWrappingtruefalseResolution contracts wrap registry reverts in ResolutionError(address,bytes) and reject foreign OffchainLookup senders with InvalidOffchainLookup().
wrapperRegistryInitializerfuse-derivedexplicitHow WrapperRegistry initialize receives its label and roles: passed explicitly (initialize(bytes32,address,string,uint256)) or fuse-derived from NameWrapper fuses (initialize(bytes32,address)).
wrapperRegistryEmancipationrole-derivedstaticHow WrapperRegistry isEmancipated is computed: static (always true) or role-derived (from the unemancipated role bitmap).
lockedMigrationRenewalmax-expiryrenew-roleHow locked migration treats names with CAN_EXTEND_EXPIRY: grant the renew-role, or set the expiry to max-expiry (type(uint64).max).
userRegistryUpgradeGatetruetrueUser registries only upgrade to implementations approved by UPGRADE_SET().
userRegistryRootRenewaltruefalseRegistries running implementations.userRegistry check the renew role at their root only (contracts-v2 #505, mainnet since 2026-11-17). Every other registry, including those created on an earlier UserRegistry implementation, also accepts it on the name.
hcaSameChainSourceRejectedtruefalseThe HCA validator rejects permits whose source chain is the current chain.
hcaSessionDomainsmart-sessionsmart-sessionEIP-712 domain HCA session approvals are signed under: Rhinestone's smart-session domain (contracts-v2 v1.0.1), or a dedicated hca domain (contracts-v2 #498, not deployed).
hcaContractOwnersfalsefalseHCA owners can be contracts that sign with ERC-1271 (contracts-v2 #499, not deployed).

L2 reverse registrars

Chain IDAddress
100x0000000000D8e504002cC26E3Ec46D81971C1664
84530x0000000000D8e504002cC26E3Ec46D81971C1664
421610x0000000000D8e504002cC26E3Ec46D81971C1664
591410x00000BeEF055f7934784D6d81b6BC86665630dbA
591440x0000000000D8e504002cC26E3Ec46D81971C1664
845320x00000BeEF055f7934784D6d81b6BC86665630dbA
4216140x00000BeEF055f7934784D6d81b6BC86665630dbA
5343510x00000BeEF055f7934784D6d81b6BC86665630dbA
5343520x0000000000D8e504002cC26E3Ec46D81971C1664
111554200x00000BeEF055f7934784D6d81b6BC86665630dbA

API

Deployments.InvalidProfileError

Thrown by define with every problem found in a profile.

class InvalidProfileError
FieldTypeDescription
nameunknown
_tagunknown
issuesreadonly string[]

Deployments.Profile

Every ENS deployment on one chain.

interface Profile
FieldTypeDescription
namestringNetwork name, e.g. mainnet.
chainIdnumber
v1 (optional)V1
v2 (optional)V2

Deployments.Provenance

Where the addresses of a deployment come from.

interface Provenance
FieldTypeDescription
repositorystringSource repository of the deployed contracts.
releasestringRelease tag the addresses were taken from, e.g. v1.0.1.
commitstringCommit of the release tag.
builds (optional){ readonly default: string; readonly overrides: Readonly<Record<string, string>>; }Compiler builds of the live contracts. ENSv2 networks mix builds because contracts were redeployed individually; overrides maps contracts-v2 deployment names to their build.
documentation (optional)stringHuman-readable deployment documentation.

Deployments.Status

Lifecycle of a deployment: active is the current protocol on that chain, legacy is kept for compatibility and migration, beta is not yet recommended for production names.

type Status = "active" | "beta" | "legacy";

Deployments.V1

An ENSv1 deployment.

interface V1
FieldTypeDescription
idstringStable identifier, e.g. mainnet-v1.
chainIdnumber
protocol"v1"
statusStatus
contractsV1Contracts
legacyPublicResolvers (optional)readonly Address[]Earlier ENS PublicResolver generations, still used by many names. They authorize writes the same way, through the current registry. Newest first; contracts.publicResolver is not listed.
frozenPublicResolvers (optional)readonly Address[]ENS PublicResolvers bound to the registry that ENS replaced in 2020. Their records can be read but no longer changed; the oldest store raw content instead of contenthash.
provenance (optional)Provenance

Deployments.V1Contracts

ENSv1 contract addresses.

interface V1Contracts
FieldTypeDescription
registryAddressENS registry.
baseRegistrarAddress.eth ERC-721 registrar.
ethRegistrarControllerAddressCurrent .eth registrar controller.
wrappedEthRegistrarController (optional)AddressPrevious .eth controller that registers names directly into the NameWrapper.
bulkRenewalAddressBatch renewal helper.
priceOracleAddress.eth rent price oracle.
nameWrapperAddressNameWrapper (ERC-1155 wrapped names and fuses).
publicResolverAddressCurrent public resolver.
universalResolverAddressUniversal Resolver proxy.
reverseRegistrarAddressReverse registrar for addr.reverse.
defaultReverseRegistrarAddressReverse registrar for default.reverse.
dnsRegistrarAddressDNSSEC registrar for DNS names.
dnssecOracleAddressDNSSEC oracle.
offchainDnsResolverAddressOff-chain DNS resolver (gasless DNSSEC).

Deployments.V2

An ENSv2 deployment.

interface V2
FieldTypeDescription
idstringStable identifier, e.g. mainnet-v2.
chainIdnumber
protocol"v2"
statusStatus
contractsV2Contracts
implementationsV2Implementations
migrationV2Migration
infrastructureV2Infrastructure
dns (optional)V2Dns
hca (optional)V2Hca
paymentTokens (optional)V2PaymentTokens
capabilitiesCapabilities
provenance (optional)Provenance

Deployments.V2Contracts

ENSv2 entry points that applications call directly.

interface V2Contracts
FieldTypeDescription
universalResolverAddressPublic Universal Resolver proxy (0xeeee…eeee on mainnet and Sepolia).
universalHelperAddressBatched read helper for registries, resolvers and names.
rootRegistryAddressRoot registry holding top-level names.
ethRegistryAddressRegistry holding second-level .eth names.
ethRegistrarAddressCommit-reveal .eth registrar.
rentPriceOracleAddress.eth rent price oracle.
ensV2ResolverAddressResolver that resolves through the ENSv2 registry tree.
publicResolverAddressShared public resolver.
verifiableFactoryAddressFactory for per-name user registries and per-user resolvers.
labelStoreAddressLabel hash to label store.
contractNamerAddressReverse-name setter for ENSv2 contracts (proxy).
reverseRegistrarAdapterAddressEthereum primary name adapter.
defaultReverseRegistrarAdapterAddressDefault (chain-independent) primary name adapter.

Deployments.V2Dns

ENSv2 DNS integration contracts.

interface V2Dns
FieldTypeDescription
tldResolverAddressResolver for DNS top-level domains.
legacyTldResolver (optional)AddressAn earlier DNSTLDResolver the root registry still points DNS TLDs at, when ENS has not switched over to tldResolver yet (mainnet, contracts-v2 v1.0.1).
aliasResolverAddressResolver mapping DNS names onto ENS names through TXT aliases.
txtResolverAddressResolver answering from ENS1 TXT records.
gatewayProviderAddressGateway provider for DNSSEC proofs.
temporaryRegistrar (optional)AddressRegistrar that claims DNS names into ENSv2 (mainnet only).

Deployments.V2Hca

Experimental

Hosted contract account (HCA) contracts.

interface V2Hca
FieldTypeDescription
ownerAndSessionValidatorAddressOwner signature and session key validator.
upgradeSetAddressSet of approved HCA implementation upgrades.
standaloneFactoryAddressStandalone HCA factory.
standaloneImplementationAddressSingle-owner standalone HCA implementation.
entryPointAddressERC-4337 EntryPoint (v0.7) the HCA accepts UserOperations from.
intentExecutorAddressRhinestone IntentExecutor, the only caller whose session signatures the validator accepts.
gasRefundPaymasterAddressPaymaster that reimburses intent execution from the session's refund token.

Deployments.V2Implementations

ENSv2 implementation contracts that proxies and factory deployments point to.

interface V2Implementations
FieldTypeDescription
universalResolverAddressUniversal Resolver implementation behind the managed proxy.
universalResolverV1 (optional)AddressENSv1-only Universal Resolver implementation kept as a fallback target.
permissionedResolverAddressPermissionedResolver implementation for factory-deployed resolvers.
userRegistryAddressUserRegistry implementation for factory-deployed subname registries.
wrapperRegistryAddressWrapperRegistry implementation for migrated NameWrapper names.
contractNamerAddressContractNamer implementation.

Deployments.V2Infrastructure

ENSv2 supporting infrastructure.

interface V2Infrastructure
FieldTypeDescription
ensUriRenderer (optional)AddressStatic token URI renderer.
boxedEnsUriRenderer (optional)AddressToken URI renderer for boxed registries.
managedUniversalResolverProxy (optional)AddressENS-managed Universal Resolver proxy behind the public proxy.
batchRegistrarAddressBatch registration helper for .eth.
rootBatchRegistrarAddressBatch registration helper for the root registry.

Deployments.V2Migration

ENSv1 to ENSv2 migration contracts.

interface V2Migration
FieldTypeDescription
ensV1ResolverAddressResolver that forwards unmigrated names to ENSv1.
ethRenewerV1AddressRenewal controller for unmigrated ENSv1 .eth names.
unlockedMigrationControllerAddressMigration controller for unlocked names.
lockedMigrationControllerAddressMigration controller for locked NameWrapper names (a proxy on mainnet).
migrationHelperAddressBatched migration helper.
graveyardAddressHolder of retired ENSv1 tokens.
publicResolverSetAddressSet of resolvers treated as public resolvers during migration.
registryUpgradeSetAddressSet of registry implementations user registries may upgrade to.

Deployments.V2PaymentTokens

ERC-20 tokens the .eth registrar accepts: real stablecoins on mainnet, mocks on testnets. The rent price oracle (isPaymentToken) stays the source of truth.

interface V2PaymentTokens
FieldTypeDescription
daiAddress
usdcAddress

Deployments.define

Validates a custom profile (a devnet, a fork or a chain ensforge does not ship) and returns it unchanged.

function define<const profile extends Profile>(profile: profile): profile

Checks that the chain IDs agree, that every required contract group and address is present and well-formed, and that every capability flag has a known value. It does not read the chain.

Defining a devnet profile
import { Deployments } from "@ensforge/contracts"

const devnet = Deployments.define({
  name: "devnet",
  chainId: 31337,
  v2: { ...devnetAddresses, capabilities: Deployments.mainnet.v2.capabilities },
})

Errors:

  • `` Deployments.InvalidProfileError listing every problem found.

Deployments.get

Returns the built-in profile for a chain, or undefined when ensforge ships none.

function get(options: { readonly chainId: number }): Profile | undefined
Looking up the connected chain
import { Deployments } from "@ensforge/contracts"

const profile = Deployments.get({ chainId: await client.getChainId() })
const registry = profile?.v1?.contracts.registry

Deployments.l2ReverseRegistrars

The ENSv1 L2ReverseRegistrar (ens-contracts v1.7.0) of each chain it is deployed on, by chain ID: where an address sets its primary name for that chain (<coinType>.reverse). Its ABI is Abis.v1.l2ReverseRegistrar. Every mainnet L2 shares one address, and every testnet another, so one signed name claim covers all of them.

Deployments.list

Lists the built-in profiles.

function list(): readonly Profile[]
Listing supported chains
import { Deployments } from "@ensforge/contracts"

const chainIds = Deployments.list().map((profile) => profile.chainId)

Deployments.mainnet

ENSv1 and ENSv2 on Ethereum mainnet.

Deployments.sepolia

ENSv1 (legacy) and ENSv2 on Sepolia.

Was this page helpful?