Release New Version by github-actions[bot] · Pull Request #1990 · namehash/ensnode

github-actions · 2026-04-23T16:56:18Z

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@ensnode/datasources@1.11.0

Minor Changes

#2036 43d8a9b Thanks @shrugs! - Update sepolia-v2 namespace to point to the most recent Sepolia V2 deployment on the virtual Sepolia chain.

Patch Changes

#2049 5729ac1 Thanks @shrugs! - Removed LegacyEthRegistrarController, WrappedEthRegistrarController, and UniversalRegistrarRenewalWithReferrer placeholder entries from the sepolia-v2 namespace, and UniversalRegistrarRenewalWithReferrer from ens-test-env. AnyRegistrarControllerABI now also includes the UniversalRegistrarRenewalWithReferrer ABI.

@namehash/ens-referrals@1.11.0

Minor Changes

#1986 aa26180 Thanks @Goader! - Add BaseReferralProgramEditionConfig as the shared parent of ReferralProgramEditionConfig and BaseReferralProgramEditionSummary.
#1986 aa26180 Thanks @Goader! - Expose the per-award-model (pie-split, rev-share-cap) Zod schemas via @namehash/ens-referrals/internal.
#1986 aa26180 Thanks @Goader! - Reject overlapping referral program editions: for a given subregistryId, no two editions may share any point in time.

Patch Changes

Updated dependencies [43d8a9b, 824d819, 6173160, 92ca54f, 7e77c5c, 0d8a4b4, 0e7c601, 0e7c601, 0e7c601, 6173160]:
- @ensnode/ensnode-sdk@1.11.0
- enssdk@1.11.0

@ensnode/ensdb-sdk@1.11.0

Minor Changes

#2016 7e77c5c Thanks @shrugs! - migrated_nodes renamed to migrated_nodes_by_parent and re-keyed by composite (parentNode, labelHash) to match the payload of ENSv1Registry(Old)#NewOwner events. New sibling migrated_nodes_by_node keyed solely by node for the three ENSv1RegistryOld handlers (Transfer / NewTTL / NewResolver) that emit only node. Both rows are written together by the migration helper so each read site addresses whichever key matches its event payload. Schema definitions live in a new migrated-nodes.schema.ts.
#2056 0e7c601 Thanks @shrugs! - Introduced IndexingMetadataContext as a single record type in the ENSNode Metadata table, replacing three separate record types (ensdb_version, ensindexer_public_config, ensindexer_indexing_status).
- EnsDbReader: added getIndexingMetadataContext(), isHealthy(), isReady().
- EnsDbWriter: added upsertIndexingMetadataContext().
- Old per-record read/write methods removed.
- EnsNodeMetadataKeys reduced to a single IndexingMetadataContext key.
#1983 6173160 Thanks @shrugs! - Unify v1Domain + v2Domain into a single polymorphic domain table discriminated by a type enum ("ENSv1Domain" | "ENSv2Domain"), and make Registry polymorphic across concrete ENSv1 (mainnet Registry, Basenames Registry, Lineanames Registry), ENSv1 Virtual (per-parent-domain virtual Registry managed by each ENSv1 domain that has children), and ENSv2 Registries.

Breaking schema + id format changes
- ENSv1DomainId is now a dash-delimited tuple: ${ENSv1RegistryId}-${node} (was Node). Every ENSv1 Domain is addressable through a concrete Registry, so bare node values no longer identify a Domain by themselves.
- RegistryId is a union of ENSv1RegistryId, ENSv1VirtualRegistryId, and ENSv2RegistryId. New id constructors: makeENSv1RegistryId, makeENSv2RegistryId, makeENSv1VirtualRegistryId, and makeConcreteRegistryId (returns ENSv1RegistryId | ENSv2RegistryId for callsites that only need to address a concrete Registry contract). makeENSv1DomainId now takes (AccountId, Node).
- domains table: replaces v1_domains + v2_domains. Adds type, nullable tokenId (non-null iff ENSv2), nullable node (non-null iff ENSv1), nullable rootRegistryOwnerId (v1 only). parentId removed; parent relationships flow through registryCanonicalDomain for both v1 and v2.
- registries table: adds type enum column and nullable node (non-null iff ENSv1VirtualRegistry). Unique (chainId, address) index becomes a plain index so virtual Registries can share their concrete parent's (chainId, address).
- registryCanonicalDomain.domainId is typed as the unified DomainId.
GraphQL
- Registry becomes a GraphQL interface with ENSv1Registry, ENSv1VirtualRegistry, and ENSv2Registry implementations. ENSv1VirtualRegistry exposes node: Node!.
- Domain interface gains parent: Domain (resolved via the canonical-path dataloader); ENSv1Domain exposes node: Node! and rootRegistryOwner; ENSv2Domain exposes tokenId, registry, subregistry, permissions.
- Query.registry(by: { contract }) now DB-looks up the concrete Registry by (chainId, address, type IN (ENSv1Registry, ENSv2Registry)). Virtual Registries are not addressable via AccountId alone.

Patch Changes

#1996 c186ad8 Thanks @tk-o! - Made EnsDbWriter.migrateEnsNodeSchema race-condition safe.
Updated dependencies [43d8a9b, 824d819, 6173160, 92ca54f, 7e77c5c, 0d8a4b4, 0e7c601, 0e7c601, 0e7c601, 6173160]:
- @ensnode/ensnode-sdk@1.11.0
- enssdk@1.11.0

@ensnode/ensnode-sdk@1.11.0

Minor Changes

#2036 43d8a9b Thanks @shrugs! - Replaces the flat DEVNET_DEPLOYER / DEVNET_OWNER / DEVNET_USER / DEVNET_USER2 constants exported from @ensnode/ensnode-sdk/internal with a single DevnetAccounts object that groups each account's address and resolver. Consumers must migrate to DevnetAccounts.{deployer,owner,user,user2}.{address,resolver}.
#2017 824d819 Thanks @Goader! - Add $ENS Tokens as a supported currency in @ensnode/ensnode-sdk: CurrencyIds.ENSTokens, PriceEnsTokens/SerializedPriceEnsTokens types, and the priceEnsTokens, parseEnsTokens, serializePriceEnsTokens, deserializePriceEnsTokens helpers.
#1983 6173160 Thanks @shrugs! - Centralized Managed Name and Root Registry helpers.
- Removed: getEthnamesSubregistryId, getEthnamesSubregistryManagedName, getBasenamesSubregistryId, getBasenamesSubregistryManagedName, getLineanamesSubregistryId, getLineanamesSubregistryManagedName.
- Added: getManagedName(namespace, contract) — given any contract in the ENSv1 ecosystem, returns its Managed Name, namehash, and concrete ENSv1 Registry. Replaces the per-plugin helpers above. Also exposes isNameWrapper(namespace, contract).
- Added: getRootRegistryId(namespace) returns the namespace's primary Root Registry (prefers ENSv2 when defined). getRootRegistryIds(namespace) returns every top-level Root Registry — concrete ENSv1 Root, Basenames/Lineanames base.eth/linea.eth ENSv1VirtualRegistries, and the ENSv2 Root when defined — for consumers that walk the full canonical-set tree.
- Added: getENSv1RootRegistryId(namespace).
#1988 0d8a4b4 Thanks @tk-o! - Introduced a set of "stack info" data models: EnsIndexerStackInfo, EnsNodeStackInfo.
#2056 0e7c601 Thanks @shrugs! - Added EnsIndexerStackInfo as a base type; refactored EnsNodeStackInfo to extend it.
#2056 0e7c601 Thanks @shrugs! - Breaking: EnsIndexerPublicConfig: renamed labelSet → clientLabelSet.
#2056 0e7c601 Thanks @shrugs! - Added replaceBigInts (sourced from @ponder/utils) and toJson helpers to @ensnode/ensnode-sdk. toJson takes an options object ({ pretty?: boolean }) with pretty defaulting to false — pass { pretty: true } for indented output.
#1983 6173160 Thanks @shrugs! - Unify v1Domain + v2Domain into a single polymorphic domain table discriminated by a type enum ("ENSv1Domain" | "ENSv2Domain"), and make Registry polymorphic across concrete ENSv1 (mainnet Registry, Basenames Registry, Lineanames Registry), ENSv1 Virtual (per-parent-domain virtual Registry managed by each ENSv1 domain that has children), and ENSv2 Registries.

Breaking schema + id format changes
- ENSv1DomainId is now a dash-delimited tuple: ${ENSv1RegistryId}-${node} (was Node). Every ENSv1 Domain is addressable through a concrete Registry, so bare node values no longer identify a Domain by themselves.
- RegistryId is a union of ENSv1RegistryId, ENSv1VirtualRegistryId, and ENSv2RegistryId. New id constructors: makeENSv1RegistryId, makeENSv2RegistryId, makeENSv1VirtualRegistryId, and makeConcreteRegistryId (returns ENSv1RegistryId | ENSv2RegistryId for callsites that only need to address a concrete Registry contract). makeENSv1DomainId now takes (AccountId, Node).
- domains table: replaces v1_domains + v2_domains. Adds type, nullable tokenId (non-null iff ENSv2), nullable node (non-null iff ENSv1), nullable rootRegistryOwnerId (v1 only). parentId removed; parent relationships flow through registryCanonicalDomain for both v1 and v2.
- registries table: adds type enum column and nullable node (non-null iff ENSv1VirtualRegistry). Unique (chainId, address) index becomes a plain index so virtual Registries can share their concrete parent's (chainId, address).
- registryCanonicalDomain.domainId is typed as the unified DomainId.
GraphQL
- Registry becomes a GraphQL interface with ENSv1Registry, ENSv1VirtualRegistry, and ENSv2Registry implementations. ENSv1VirtualRegistry exposes node: Node!.
- Domain interface gains parent: Domain (resolved via the canonical-path dataloader); ENSv1Domain exposes node: Node! and rootRegistryOwner; ENSv2Domain exposes tokenId, registry, subregistry, permissions.
- Query.registry(by: { contract }) now DB-looks up the concrete Registry by (chainId, address, type IN (ENSv1Registry, ENSv2Registry)). Virtual Registries are not addressable via AccountId alone.

Patch Changes

Updated dependencies [5729ac1, 92ca54f, 7e77c5c, 43d8a9b, 6173160]:
- @ensnode/datasources@1.11.0
- enssdk@1.11.0

@ensnode/ensrainbow-sdk@1.11.0

Minor Changes

#2056 0e7c601 Thanks @shrugs! - Breaking: Updated core data models.
- EnsRainbowApiClientOptions: renamed labelSet → clientLabelSet.
- EnsRainbowPublicConfig:
  - Replaced version: string with versionInfo: EnsRainbowVersionInfo.
  - Renamed labelSet → serverLabelSet.
  - Removed recordsCount.
#2056 0e7c601 Thanks @shrugs! - Added EnsRainbowApiClient.ready(), plus EnsRainbow.ReadyResponse / EnsRainbow.ServiceUnavailableError types and ErrorCode.ServiceUnavailable. The client now throws a typed EnsRainbowHttpError (with structured status / statusText properties) from ready(), health(), and config() whenever the service responds with a non-2xx HTTP status, so callers can branch their retry/abort logic on the status without parsing message strings.

Patch Changes

Updated dependencies [92ca54f, 7e77c5c, 6173160]:
- enssdk@1.11.0

enssdk@1.11.0

Minor Changes

#2050 92ca54f Thanks @shrugs! - Add beautifyInterpretedName(name: InterpretedName): BeautifiedName for converting an InterpretedName into a UI-presentable Name, plus a new BeautifiedName nominally-typed alias. Each label is either preserved verbatim (Encoded LabelHashes) or passed through ens_beautify (normalized labels), so e.g. "♾♾♾♾.eth" renders as "♾️♾️♾️♾️.eth". The branded BeautifiedName return type prevents the result from being passed to APIs that expect an InterpretedName — continue to use the source InterpretedName for navigation targets and lookups.
#2016 7e77c5c Thanks @shrugs! - Switch composite ids to dash-delimited tuples so Ponder's profile-pattern matcher can decompose them and prefetch hot tables.

Every id constructor (makeENSv1RegistryId, makeENSv2RegistryId, makeENSv1VirtualRegistryId, makeConcreteRegistryId, makeResolverId, makeENSv1DomainId, makeENSv2DomainId, makePermissionsId, makePermissionsResourceId, makePermissionsUserId, makeResolverRecordsId, makeRegistrationId, makeRenewalId) now joins its components with - instead of CAIP-style mixed : / / delimiters. makeENSv2DomainId no longer wraps the registry contract in CAIP-19 ERC1155 form since the registry already namespaces it. Ponder's matcher only does single-level string-delimiter splits, so the unified - tuple is the shape it can decompose to derive prefetch lookup keys from event args.
#1983 6173160 Thanks @shrugs! - Unify v1Domain + v2Domain into a single polymorphic domain table discriminated by a type enum ("ENSv1Domain" | "ENSv2Domain"), and make Registry polymorphic across concrete ENSv1 (mainnet Registry, Basenames Registry, Lineanames Registry), ENSv1 Virtual (per-parent-domain virtual Registry managed by each ENSv1 domain that has children), and ENSv2 Registries.

Breaking schema + id format changes
- ENSv1DomainId is now a dash-delimited tuple: ${ENSv1RegistryId}-${node} (was Node). Every ENSv1 Domain is addressable through a concrete Registry, so bare node values no longer identify a Domain by themselves.
- RegistryId is a union of ENSv1RegistryId, ENSv1VirtualRegistryId, and ENSv2RegistryId. New id constructors: makeENSv1RegistryId, makeENSv2RegistryId, makeENSv1VirtualRegistryId, and makeConcreteRegistryId (returns ENSv1RegistryId | ENSv2RegistryId for callsites that only need to address a concrete Registry contract). makeENSv1DomainId now takes (AccountId, Node).
- domains table: replaces v1_domains + v2_domains. Adds type, nullable tokenId (non-null iff ENSv2), nullable node (non-null iff ENSv1), nullable rootRegistryOwnerId (v1 only). parentId removed; parent relationships flow through registryCanonicalDomain for both v1 and v2.
- registries table: adds type enum column and nullable node (non-null iff ENSv1VirtualRegistry). Unique (chainId, address) index becomes a plain index so virtual Registries can share their concrete parent's (chainId, address).
- registryCanonicalDomain.domainId is typed as the unified DomainId.
GraphQL
- Registry becomes a GraphQL interface with ENSv1Registry, ENSv1VirtualRegistry, and ENSv2Registry implementations. ENSv1VirtualRegistry exposes node: Node!.
- Domain interface gains parent: Domain (resolved via the canonical-path dataloader); ENSv1Domain exposes node: Node! and rootRegistryOwner; ENSv2Domain exposes tokenId, registry, subregistry, permissions.
- Query.registry(by: { contract }) now DB-looks up the concrete Registry by (chainId, address, type IN (ENSv1Registry, ENSv2Registry)). Virtual Registries are not addressable via AccountId alone.

enskit@1.11.0

Patch Changes

Updated dependencies [92ca54f, 7e77c5c, 6173160]:
- enssdk@1.11.0

@ensnode/ensnode-react@1.11.0

Patch Changes

Updated dependencies [43d8a9b, 824d819, 6173160, 92ca54f, 7e77c5c, 0d8a4b4, 0e7c601, 0e7c601, 0e7c601, 6173160]:
- @ensnode/ensnode-sdk@1.11.0
- enssdk@1.11.0

@namehash/namehash-ui@1.11.0

Patch Changes

Updated dependencies [43d8a9b, 824d819, 5729ac1, 6173160, 92ca54f, 7e77c5c, 0d8a4b4, 0e7c601, 0e7c601, 0e7c601, 43d8a9b, 6173160]:
- @ensnode/ensnode-sdk@1.11.0
- @ensnode/datasources@1.11.0
- enssdk@1.11.0
- @ensnode/ensnode-react@1.11.0

ensskills@1.11.0

@ensnode/ponder-sdk@1.11.0

@ensnode/ponder-subgraph@1.11.0

ensadmin@1.11.0

Minor Changes

#1988 0d8a4b4 Thanks @tk-o! - Removed Records Count info from the ENSRainbow card UI on the Connection page.
#1988 0d8a4b4 Thanks @tk-o! - Renamed ENSNodeConfig* components to follow the EnsNodeStackInfo* pattern.

Patch Changes

#2001 7c1c048 Thanks @notrab! - Fix ENSAdmin GraphiQL docs sidebar failing to stay open on the omnigraph page. The editor now memoizes its fetcher, storage, and plugins so 1Hz parent re-renders (driven by the realtime indexing-status projection) no longer trigger schema re-introspection.
#1951 c56e32c Thanks @notrab! - Introduced interactive REST API Reference playground (/api/rest) powered by Scalar, enabling discovery and testing of all REST APIs published by a connected ENSApi instance. Added @ensnode/scalar-react wrapper package.
Updated dependencies [43d8a9b, 824d819, 5729ac1, 6173160, 92ca54f, 7e77c5c, 0d8a4b4, 0e7c601, 0e7c601, 0e7c601, 43d8a9b, 6173160]:
- @ensnode/ensnode-sdk@1.11.0
- @ensnode/datasources@1.11.0
- enssdk@1.11.0
- @ensnode/ensnode-react@1.11.0
- @namehash/namehash-ui@1.11.0
- @ensnode/scalar-react@0.0.0

ensapi@1.11.0

Minor Changes

#2014 6bd4154 Thanks @shrugs! - Adds HCA-aware Event.sender to the Omnigraph API alongside the existing Event.from. For ENSv2 events that emit an explicit sender/owner/account/ERC1155 operator argument, Event.sender is set from that argument (the HCA Smart Account address, if used) and falls back to tx.from otherwise. Adds a sender filter to EventsWhereInput. Account.events now filters by sender (HCA-aware) instead of tx.from. Documents HCA-aware semantics on Domain.owner, Registration.registrant/unregistrant, and *.PermissionsUser.user.
#2056 0e7c601 Thanks @shrugs! - indexing-status.cache and stack-info.cache updated to consume the new IndexingMetadataContext record. Config schema updated to fetch EnsIndexerPublicConfig from EnsNodeStackInfo.
#2007 e40ce8f Thanks @shrugs! - Adds PermissionsUser.events to the Omnigraph API, exposing the per-role-assignment event history (grants, revokes, role-bitmap mutations) for a specific (contract, resource, user) tuple.
#1983 6173160 Thanks @shrugs! - Query.root is now non-null and returns the namespace's Root Registry — preferring the ENSv2 Root Registry when defined, falling back to the ENSv1 Root Registry.
#2021 6824f35 Thanks @tk-o! - Integrated ENSDb health check and readiness check into ENSApi /health and /ready endpoints.
#1983 6173160 Thanks @shrugs! - Unify v1Domain + v2Domain into a single polymorphic domain table discriminated by a type enum ("ENSv1Domain" | "ENSv2Domain"), and make Registry polymorphic across concrete ENSv1 (mainnet Registry, Basenames Registry, Lineanames Registry), ENSv1 Virtual (per-parent-domain virtual Registry managed by each ENSv1 domain that has children), and ENSv2 Registries.

Breaking schema + id format changes
- ENSv1DomainId is now a dash-delimited tuple: ${ENSv1RegistryId}-${node} (was Node). Every ENSv1 Domain is addressable through a concrete Registry, so bare node values no longer identify a Domain by themselves.
- RegistryId is a union of ENSv1RegistryId, ENSv1VirtualRegistryId, and ENSv2RegistryId. New id constructors: makeENSv1RegistryId, makeENSv2RegistryId, makeENSv1VirtualRegistryId, and makeConcreteRegistryId (returns ENSv1RegistryId | ENSv2RegistryId for callsites that only need to address a concrete Registry contract). makeENSv1DomainId now takes (AccountId, Node).
- domains table: replaces v1_domains + v2_domains. Adds type, nullable tokenId (non-null iff ENSv2), nullable node (non-null iff ENSv1), nullable rootRegistryOwnerId (v1 only). parentId removed; parent relationships flow through registryCanonicalDomain for both v1 and v2.
- registries table: adds type enum column and nullable node (non-null iff ENSv1VirtualRegistry). Unique (chainId, address) index becomes a plain index so virtual Registries can share their concrete parent's (chainId, address).
- registryCanonicalDomain.domainId is typed as the unified DomainId.
GraphQL
- Registry becomes a GraphQL interface with ENSv1Registry, ENSv1VirtualRegistry, and ENSv2Registry implementations. ENSv1VirtualRegistry exposes node: Node!.
- Domain interface gains parent: Domain (resolved via the canonical-path dataloader); ENSv1Domain exposes node: Node! and rootRegistryOwner; ENSv2Domain exposes tokenId, registry, subregistry, permissions.
- Query.registry(by: { contract }) now DB-looks up the concrete Registry by (chainId, address, type IN (ENSv1Registry, ENSv2Registry)). Virtual Registries are not addressable via AccountId alone.

Patch Changes

#2056 0e7c601 Thanks @shrugs! - Migrated to @ensnode/ensnode-sdk's replaceBigInts / toJson helpers. Dropped the direct @ponder/utils dependency from ensapi.
Updated dependencies [aa26180, 43d8a9b, 824d819, 5729ac1, 7e77c5c, 6173160, 92ca54f, 7e77c5c, 0d8a4b4, 0e7c601, 0e7c601, 0e7c601, aa26180, 0e7c601, aa26180, 43d8a9b, c186ad8, 6173160]:
- @namehash/ens-referrals@1.11.0
- @ensnode/ensnode-sdk@1.11.0
- @ensnode/datasources@1.11.0
- @ensnode/ensdb-sdk@1.11.0
- enssdk@1.11.0
- @ensnode/ponder-subgraph@1.11.0

ensindexer@1.11.0

Minor Changes

#2036 43d8a9b Thanks @shrugs! - Updates ens-test-env devnet commit to 580c60a.
#2056 0e7c601 Thanks @shrugs! - Consolidated startup init into initIndexingOnchainEvents() for reliable execution on every ENSIndexer startup. Added IndexingMetadataContextBuilder and StackInfoBuilder. EnsDbWriterWorker simplified to a single recurring task. The HTTP /config and /indexing-status endpoints now read from in-memory builders instead of ENSDb. initializeIndexingSetup / initializeIndexingActivation replaced by initIndexingOnchainEvents.
#1983 6173160 Thanks @shrugs! - Unify v1Domain + v2Domain into a single polymorphic domain table discriminated by a type enum ("ENSv1Domain" | "ENSv2Domain"), and make Registry polymorphic across concrete ENSv1 (mainnet Registry, Basenames Registry, Lineanames Registry), ENSv1 Virtual (per-parent-domain virtual Registry managed by each ENSv1 domain that has children), and ENSv2 Registries.

Breaking schema + id format changes
- ENSv1DomainId is now a dash-delimited tuple: ${ENSv1RegistryId}-${node} (was Node). Every ENSv1 Domain is addressable through a concrete Registry, so bare node values no longer identify a Domain by themselves.
- RegistryId is a union of ENSv1RegistryId, ENSv1VirtualRegistryId, and ENSv2RegistryId. New id constructors: makeENSv1RegistryId, makeENSv2RegistryId, makeENSv1VirtualRegistryId, and makeConcreteRegistryId (returns ENSv1RegistryId | ENSv2RegistryId for callsites that only need to address a concrete Registry contract). makeENSv1DomainId now takes (AccountId, Node).
- domains table: replaces v1_domains + v2_domains. Adds type, nullable tokenId (non-null iff ENSv2), nullable node (non-null iff ENSv1), nullable rootRegistryOwnerId (v1 only). parentId removed; parent relationships flow through registryCanonicalDomain for both v1 and v2.
- registries table: adds type enum column and nullable node (non-null iff ENSv1VirtualRegistry). Unique (chainId, address) index becomes a plain index so virtual Registries can share their concrete parent's (chainId, address).
- registryCanonicalDomain.domainId is typed as the unified DomainId.
GraphQL
- Registry becomes a GraphQL interface with ENSv1Registry, ENSv1VirtualRegistry, and ENSv2Registry implementations. ENSv1VirtualRegistry exposes node: Node!.
- Domain interface gains parent: Domain (resolved via the canonical-path dataloader); ENSv1Domain exposes node: Node! and rootRegistryOwner; ENSv2Domain exposes tokenId, registry, subregistry, permissions.
- Query.registry(by: { contract }) now DB-looks up the concrete Registry by (chainId, address, type IN (ENSv1Registry, ENSv2Registry)). Virtual Registries are not addressable via AccountId alone.

Patch Changes

#2049 5729ac1 Thanks @shrugs! - Fixed a bug in ensv2 plugin where only UnwrappedEthRegistrarController was indexed; LegacyEthRegistrarController and WrappedEthRegistrarController were silently dropped. Fixes ENSv2 plugin silently overrides RegistrarController address per chain #2048.
#2056 0e7c601 Thanks @shrugs! - waitForEnsRainbowToBeReady now polls /ready (via ensRainbowClient.ready()) instead of /health, so it correctly waits for the database to finish bootstrapping. It also aborts retries immediately on non-503 HTTP responses (e.g. 404 from a misconfigured ENSRAINBOW_URL, 500 from a broken instance) instead of blocking startup for ~1h, while still retrying on 503 Service Unavailable and on transient network errors.
#2056 0e7c601 Thanks @shrugs! - Migrated to @ensnode/ensnode-sdk's replaceBigInts / toJson helpers. Dropped the direct @ponder/utils dependency from ensapi.
#1989 16ecad1 Thanks @shrugs! - ENSIndexer's ensv2 plugin now avoids attempting to heal addr.reverse subnames if they've already been healed.
Updated dependencies [43d8a9b, 824d819, 5729ac1, 7e77c5c, 6173160, 92ca54f, 7e77c5c, 0d8a4b4, 0e7c601, 0e7c601, 0e7c601, 0e7c601, 0e7c601, 0e7c601, 43d8a9b, c186ad8, 6173160]:
- @ensnode/ensnode-sdk@1.11.0
- @ensnode/datasources@1.11.0
- @ensnode/ensdb-sdk@1.11.0
- enssdk@1.11.0
- @ensnode/ensrainbow-sdk@1.11.0
- @ensnode/ponder-sdk@1.11.0

ensrainbow@1.11.0

Minor Changes

#2037 1db1637 Thanks @djstrong! - ENSRainbow's GET /v1/config is now available immediately at startup, removing the cold-start gap that previously forced downstream services (e.g. ENSIndexer) to wait for the entire database download/validation before they could read public config (issue Allow ENSRainbow clients to fetch EnsRainbowPublicConfig as soon as possible. #2020).
- The entrypoint command now builds the EnsRainbowPublicConfig in-memory from its CLI/env arguments (LABEL_SET_ID, LABEL_SET_VERSION) before the HTTP server starts accepting requests, so /v1/config returns 200 from the first request.
- After the background bootstrap finishes, ENSRainbow verifies that the on-disk database's stored label set (labelSetId and highestLabelSetVersion) matches the configured one. On mismatch it logs a helpful error naming both the expected and actual label sets, refuses to serve, and terminates with exit code 1.
- /ready continues to gate on full database readiness (200 only after the database has been attached and the env-vs-DB validation has passed).
- /v1/heal/{labelhash} and /v1/labels/count continue to return 503 Service Unavailable while the database is still bootstrapping.
- /health is unchanged and still returns 200 as soon as the HTTP server is listening.
#2056 0e7c601 Thanks @shrugs! - ENSRainbow now starts its HTTP server immediately and downloads/validates its database in the background, instead of blocking container startup behind a netcat placeholder.
- New GET /ready endpoint: returns 200 { status: "ok" } once the database is attached, or 503 Service Unavailable while ENSRainbow is still bootstrapping. /health is now a pure liveness probe that succeeds as soon as the HTTP server is listening.
- 503 responses for API routes during bootstrap: /v1/heal, /v1/labels/count, and /v1/config return a structured ServiceUnavailableError (errorCode: 503) until the database is ready.
- New Docker entrypoint: the container now runs pnpm run entrypoint from the apps/ensrainbow working directory (implemented in Node via tsx src/cli.ts entrypoint), which replaces scripts/entrypoint.sh and the netcat workaround.
- Graceful shutdown during bootstrap: SIGTERM/SIGINT now abort an in-flight bootstrap. Spawned download/tar child processes are terminated (SIGTERM → SIGKILL after a 5s grace period) and any partially-opened LevelDB handle is closed before the HTTP server and DB-backed server shut down, so the container exits promptly without leaking child processes or LevelDB locks.
Migration: if you previously polled GET /health to gate traffic on database readiness, switch to GET /ready. /health is still available and still returns 200, but it now indicates liveness only.

Patch Changes

Updated dependencies [43d8a9b, 824d819, 6173160, 92ca54f, 7e77c5c, 0d8a4b4, 0e7c601, 0e7c601, 0e7c601, 0e7c601, 0e7c601, 6173160]:
- @ensnode/ensnode-sdk@1.11.0
- enssdk@1.11.0
- @ensnode/ensrainbow-sdk@1.11.0

@docs/ensnode@1.11.0

Minor Changes

#1942 2df3b45 Thanks @tk-o! - Created docs for ENSDb.
#2012 c4a39bb Thanks @tk-o! - Added "Startup sequence" page to ENSIndexer docs.

Patch Changes

#2056 0e7c601 Thanks @shrugs! - Updated docs and CI test paths to reflect the new docker/ location of docker-compose.yml.
Updated dependencies []:
- @namehash/namehash-ui@1.11.0

@ensnode/ensindexer-perf-testing@1.11.0

Minor Changes

#1989 16ecad1 Thanks @shrugs! - Introduces the ENSIndexer Performance Testing package for running a local Prometheus x Grafana stack against an ENSIndexer instance.

@ensnode/integration-test-env@1.11.0

Minor Changes

#2056 0e7c601 Thanks @shrugs! - pollIndexingStatus updated to use getIndexingMetadataContext().

Patch Changes

#2056 0e7c601 Thanks @shrugs! - Moved docker-compose.yml into a separate docker/ directory.
Updated dependencies [43d8a9b, 824d819, 5729ac1, 7e77c5c, 6173160, 0d8a4b4, 0e7c601, 0e7c601, 0e7c601, 0e7c601, 43d8a9b, c186ad8, 6173160]:
- @ensnode/ensnode-sdk@1.11.0
- @ensnode/datasources@1.11.0
- @ensnode/ensdb-sdk@1.11.0
- @ensnode/shared-configs@1.11.0

fallback-ensapi@1.11.0

Patch Changes

Updated dependencies [43d8a9b, 824d819, 5729ac1, 6173160, 0d8a4b4, 0e7c601, 0e7c601, 0e7c601, 43d8a9b, 6173160]:
- @ensnode/ensnode-sdk@1.11.0
- @ensnode/datasources@1.11.0

@docs/ensrainbow@1.11.0

Patch Changes

Updated dependencies []:
- @namehash/namehash-ui@1.11.0

@ensnode/enskit-react-example@0.0.3

Patch Changes

Updated dependencies [92ca54f, 7e77c5c, 6173160]:
- enssdk@1.11.0
- enskit@1.11.0

enscli@1.11.0

@ensnode/shared-configs@1.11.0

vercel · 2026-04-23T16:56:24Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
admin.ensnode.io	Ready	Preview, Comment	May 5, 2026 8:09pm
ensnode-enskit-react-example	Ready	Preview, Comment	May 5, 2026 8:09pm
ensnode.io	Ready	Preview, Comment	May 5, 2026 8:09pm
ensrainbow.io	Ready	Preview, Comment	May 5, 2026 8:09pm

greptile-apps · 2026-04-23T16:57:25Z

Greptile Summary

This is an automated Changesets release PR that bumps all packages to 1.11.0 (plus @ensnode/enskit-react-example to 0.0.3), deletes the consumed changeset files, appends entries to every CHANGELOG, and updates default image tags in the Docker Compose service files and the OpenAPI spec version.

All package versions incremented from 1.10.1 → 1.11.0; Docker service YAML defaults and docs/ensnode.io/ensapi-openapi.json updated to match.
43 changeset files deleted after their content was folded into the respective CHANGELOG files.

Confidence Score: 5/5

Safe to merge — all changes are mechanical version bumps and changelog entries generated by the Changesets action; no business logic is modified.

Every changed file is either a deleted changeset stub, an appended CHANGELOG entry, a package version number increment, or a Docker/OpenAPI default tag update. No source code is touched.

No files require special attention; all changes are auto-generated release artifacts.

Important Files Changed

Filename	Overview
apps/ensadmin/package.json	Version bumped from 1.10.1 to 1.11.0; no code changes.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    CS[43 Changeset files] -->|consumed by changesets action| REL[Release 1.11.0]
    REL --> CL[CHANGELOG.md updates]
    REL --> PKG[package.json version bumps\n1.10.1 → 1.11.0]
    REL --> DOCK[Docker service YAMLs\ndefault tag → 1.11.0]
    REL --> OAS[ensapi-openapi.json\nversion → 1.11.0]
    PKG --> NPM[npm publish\nvia CI on merge]

_{Reviews (37): Last reviewed commit: "chore(release): version apps" | Re-trigger Greptile}

vercel

Additional Suggestion:

Redundant and semantically confusing version check comparing ENSDb with ENSApi instead of ENSIndexer with ENSApi

greptile-apps · 2026-04-24T19:09:05Z

  "name": "@ensnode/ensnode-sdk",
-  "version": "1.10.1",
+  "version": "1.11.0",
  "type": "module",


Breaking changes shipped as a minor bump

The CHANGELOG for @ensnode/ensnode-sdk@1.11.0 explicitly marks changes as Breaking — labelSet → clientLabelSet rename and recordsCount removal — yet the bump is minor (1.10.1 → 1.11.0). Both packages are at 1.x.x and publicly published, so semver requires a major bump (2.0.0) for breaking API changes. Consumers relying on the removed or renamed fields will silently break without any version-range signal to warn them.

greptile-apps · 2026-04-24T19:09:06Z

  "name": "@ensnode/ensrainbow-sdk",
-  "version": "1.10.1",
+  "version": "1.11.0",
  "type": "module",


Breaking changes shipped as a minor bump

Same issue as @ensnode/ensnode-sdk: @ensnode/ensrainbow-sdk@1.11.0 also contains the breaking EnsRainbowPublicConfig changes (versionInfo replacing version: string, serverLabelSet rename, recordsCount removal) yet bumps minor instead of major. This violates semver for a public 1.x.x package and will silently break consumers.

greptile-apps · 2026-04-29T17:18:27Z

+
+  ### Breaking schema + id format changes
+  - `ENSv1DomainId` is now CAIP-shaped: `${ENSv1RegistryId}/${node}` (was `Node`). Every ENSv1 Domain is addressable through a concrete Registry, so bare `node` values no longer identify a Domain by themselves.
+  - `RegistryId` is a union of `ENSv1RegistryId`, `ENSv1VirtualRegistryId`, and `ENSv2RegistryId`. New id constructors: `makeENSv1RegistryId`, `makeENSv2RegistryId`, `makeENSv1VirtualRegistryId`, and `makeConcreteRegistryId` (returns `ENSv1RegistryId | ENSv2RegistryId` for callsites that only need to address a concrete Registry contract). `makeENSv1DomainId` now takes `(AccountId, Node)`.
+  - `domains` table: replaces `v1_domains` + `v2_domains`. Adds `type`, nullable `tokenId` (non-null iff ENSv2), nullable `node` (non-null iff ENSv1), nullable `rootRegistryOwnerId` (v1 only). `parentId` removed; parent relationships flow through `registryCanonicalDomain` for both v1 and v2.
+  - `registries` table: adds `type` enum column and nullable `node` (non-null iff `ENSv1VirtualRegistry`). Unique `(chainId, address)` index becomes a plain index so virtual Registries can share their concrete parent's `(chainId, address)`.
+  - `registryCanonicalDomain.domainId` is typed as the unified `DomainId`.
+
+  ### GraphQL
+  - `Registry` becomes a GraphQL interface with `ENSv1Registry`, `ENSv1VirtualRegistry`, and `ENSv2Registry` implementations. `ENSv1VirtualRegistry` exposes `node: Node!`.
+  - `Domain` interface gains `parent: Domain` (resolved via the canonical-path dataloader); `ENSv1Domain` exposes `node: Node!` and `rootRegistryOwner`; `ENSv2Domain` exposes `tokenId`, `registry`, `subregistry`, `permissions`.
+  - `Query.registry(by: { contract })` now DB-looks up the concrete Registry by `(chainId, address, type IN (ENSv1Registry, ENSv2Registry))`. Virtual Registries are not addressable via `AccountId` alone.
+
+### Patch Changes
+


Breaking changes in enssdk and @ensnode/ensdb-sdk also shipped as minor bumps

The unified-domain-model.md changeset explicitly labels its changes as Breaking for both enssdk and @ensnode/ensdb-sdk — ENSv1DomainId shape change (Node → ${ENSv1RegistryId}/${node}), makeENSv1DomainId signature change, v1_domains/v2_domains tables replaced by a unified domains table, and parentId removed — yet both packages are bumped minor (1.10.1 → 1.11.0). Neither package has "private": true, so semver requires a major bump for breaking API changes affecting external consumers. The same pattern affects packages/enssdk/CHANGELOG.md.

Releases: @namehash/ens-referrals@1.11.0 ensadmin@1.11.0 ensindexer@1.11.0 @ensnode/ensnode-sdk@1.11.0 @docs/ensnode@1.11.0 @ensnode/integration-test-env@1.11.0 @ensnode/datasources@1.11.0 @ensnode/ensdb-sdk@1.11.0 ensrainbow@1.11.0 enssdk@1.11.0 ensapi@1.11.0 @ensnode/ensrainbow-sdk@1.11.0 @ensnode/ensindexer-perf-testing@1.11.0 fallback-ensapi@1.11.0 @ensnode/ensnode-react@1.11.0 @namehash/namehash-ui@1.11.0 @ensnode/enskit-react-example@0.0.3 enskit@1.11.0 @docs/ensrainbow@1.11.0 enscli@1.11.0 ensskills@1.11.0 @ensnode/ponder-sdk@1.11.0 @ensnode/ponder-subgraph@1.11.0 @ensnode/shared-configs@1.11.0 [skip ci]

shrugs

big release, lgtm

github-actions Bot requested a review from a team as a code owner April 23, 2026 16:56

vercel Bot deployed to Preview – ensrainbow.io April 23, 2026 16:56 View deployment

vercel Bot deployed to Preview – ensnode.io April 23, 2026 16:57 View deployment

vercel Bot deployed to Preview – admin.ensnode.io April 23, 2026 16:58 View deployment

github-actions Bot force-pushed the changeset-release/main branch from 8c08124 to 951bd5d Compare April 24, 2026 12:48

vercel Bot deployed to Preview – ensrainbow.io April 24, 2026 12:48 View deployment

vercel Bot deployed to Preview – admin.ensnode.io April 24, 2026 12:49 View deployment

vercel Bot deployed to Preview – ensnode.io April 24, 2026 12:49 View deployment

vercel Bot reviewed Apr 24, 2026

View reviewed changes

github-actions Bot force-pushed the changeset-release/main branch from 951bd5d to 84e86f5 Compare April 24, 2026 19:07

vercel Bot deployed to Preview – ensrainbow.io April 24, 2026 19:07 View deployment

vercel Bot deployed to Preview – admin.ensnode.io April 24, 2026 19:08 View deployment

vercel Bot deployed to Preview – ensnode.io April 24, 2026 19:08 View deployment

greptile-apps Bot reviewed Apr 24, 2026

View reviewed changes

github-actions Bot force-pushed the changeset-release/main branch from 84e86f5 to 462a433 Compare April 25, 2026 00:59

vercel Bot deployed to Preview – ensrainbow.io April 25, 2026 00:59 View deployment

vercel Bot deployed to Preview – admin.ensnode.io April 25, 2026 01:00 View deployment

vercel Bot deployed to Preview – ensnode.io April 25, 2026 01:00 View deployment

github-actions Bot force-pushed the changeset-release/main branch from 462a433 to 408a21e Compare April 27, 2026 07:47

vercel Bot deployed to Preview – ensrainbow.io April 27, 2026 07:48 View deployment

vercel Bot deployed to Preview – admin.ensnode.io April 27, 2026 07:48 View deployment

vercel Bot deployed to Preview – ensnode.io April 27, 2026 07:49 View deployment

github-actions Bot force-pushed the changeset-release/main branch from 408a21e to ac1d0ba Compare April 27, 2026 11:17

vercel Bot deployed to Preview – ensrainbow.io April 27, 2026 11:17 View deployment

vercel Bot deployed to Preview – admin.ensnode.io April 27, 2026 11:18 View deployment

vercel Bot deployed to Preview – ensnode.io April 27, 2026 11:18 View deployment

github-actions Bot force-pushed the changeset-release/main branch from ac1d0ba to 4b27d58 Compare April 27, 2026 16:03

vercel Bot deployed to Preview – ensrainbow.io April 27, 2026 16:03 View deployment

greptile-apps Bot reviewed Apr 29, 2026

View reviewed changes

github-actions Bot force-pushed the changeset-release/main branch from d290025 to f35133c Compare April 29, 2026 17:48

vercel Bot deployed to Preview – ensrainbow.io April 29, 2026 17:48 View deployment

vercel Bot deployed to Preview – ensnode.io April 29, 2026 17:49 View deployment

vercel Bot deployed to Preview – admin.ensnode.io April 29, 2026 17:49 View deployment

github-actions Bot force-pushed the changeset-release/main branch from f35133c to 1b009b4 Compare April 29, 2026 18:08

vercel Bot deployed to Preview – ensrainbow.io April 29, 2026 18:08 View deployment

vercel Bot deployed to Preview – admin.ensnode.io April 29, 2026 18:09 View deployment

vercel Bot deployed to Preview – ensnode.io April 29, 2026 18:09 View deployment

github-actions Bot force-pushed the changeset-release/main branch from 1b009b4 to 0d6bcab Compare April 29, 2026 19:18

vercel Bot deployed to Preview – ensrainbow.io April 29, 2026 19:18 View deployment

vercel Bot deployed to Preview – admin.ensnode.io April 29, 2026 19:19 View deployment

vercel Bot deployed to Preview – ensnode.io April 29, 2026 19:19 View deployment

github-actions Bot force-pushed the changeset-release/main branch from 0d6bcab to a6ed9f7 Compare April 29, 2026 19:41

vercel Bot deployed to Preview – ensrainbow.io April 29, 2026 19:41 View deployment

vercel Bot deployed to Preview – admin.ensnode.io April 29, 2026 19:42 View deployment

vercel Bot deployed to Preview – ensnode.io April 29, 2026 19:42 View deployment

github-actions Bot force-pushed the changeset-release/main branch from a6ed9f7 to 0b12ff6 Compare April 29, 2026 23:09

vercel Bot deployed to Preview – ensrainbow.io April 29, 2026 23:09 View deployment

vercel Bot deployed to Preview – admin.ensnode.io April 29, 2026 23:10 View deployment

vercel Bot deployed to Preview – ensnode.io April 29, 2026 23:10 View deployment

github-actions Bot force-pushed the changeset-release/main branch from 0b12ff6 to f85dff7 Compare April 30, 2026 09:16

vercel Bot deployed to Preview – ensrainbow.io April 30, 2026 09:17 View deployment

vercel Bot deployed to Preview – admin.ensnode.io April 30, 2026 09:17 View deployment

vercel Bot deployed to Preview – ensnode.io April 30, 2026 09:17 View deployment

github-actions Bot force-pushed the changeset-release/main branch from f85dff7 to ae3f0fd Compare April 30, 2026 14:00

vercel Bot deployed to Preview – ensrainbow.io April 30, 2026 14:00 View deployment

github-actions Bot added 2 commits May 5, 2026 20:08

chore(release): version apps

52e33bb

shrugs approved these changes May 5, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Release New Version#1990

Release New Version#1990
shrugs merged 2 commits intomainfrom
changeset-release/main

github-actions Bot commented Apr 23, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Apr 23, 2026 •

edited

Loading

Uh oh!

greptile-apps Bot commented Apr 23, 2026 •

edited

Loading

Uh oh!

vercel Bot left a comment

Uh oh!

greptile-apps Bot Apr 24, 2026

Uh oh!

greptile-apps Bot Apr 24, 2026

Uh oh!

greptile-apps Bot Apr 29, 2026

Uh oh!

shrugs left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

github-actions Bot commented Apr 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Releases

@ensnode/datasources@1.11.0

Minor Changes

Patch Changes

@namehash/ens-referrals@1.11.0

Minor Changes

Patch Changes

@ensnode/ensdb-sdk@1.11.0

Minor Changes

Breaking schema + id format changes

GraphQL

Patch Changes

@ensnode/ensnode-sdk@1.11.0

Minor Changes

Breaking schema + id format changes

GraphQL

Patch Changes

@ensnode/ensrainbow-sdk@1.11.0

Minor Changes

Patch Changes

enssdk@1.11.0

Minor Changes

Breaking schema + id format changes

GraphQL

enskit@1.11.0

Patch Changes

@ensnode/ensnode-react@1.11.0

Patch Changes

@namehash/namehash-ui@1.11.0

Patch Changes

ensskills@1.11.0

@ensnode/ponder-sdk@1.11.0

@ensnode/ponder-subgraph@1.11.0

ensadmin@1.11.0

Minor Changes

Patch Changes

ensapi@1.11.0

Minor Changes

Breaking schema + id format changes

GraphQL

Patch Changes

ensindexer@1.11.0

Minor Changes

Breaking schema + id format changes

GraphQL

Patch Changes

ensrainbow@1.11.0

Minor Changes

Patch Changes

@docs/ensnode@1.11.0

Minor Changes

Patch Changes

@ensnode/ensindexer-perf-testing@1.11.0

Minor Changes

@ensnode/integration-test-env@1.11.0

Minor Changes

Patch Changes

fallback-ensapi@1.11.0

Patch Changes

@docs/ensrainbow@1.11.0

Patch Changes

@ensnode/enskit-react-example@0.0.3

Patch Changes

enscli@1.11.0

@ensnode/shared-configs@1.11.0

Uh oh!

vercel Bot commented Apr 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

greptile-apps Bot commented Apr 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Greptile Summary

Confidence Score: 5/5

Important Files Changed

Flowchart

Uh oh!

vercel Bot left a comment

github-actions Bot commented Apr 23, 2026 •

edited

Loading

vercel Bot commented Apr 23, 2026 •

edited

Loading

greptile-apps Bot commented Apr 23, 2026 •

edited

Loading