@ensnode/ensdb-sdk 1.10.1 → 1.11.0

package/dist/index.js

@@ -9,23 +9,29 @@ var ensindexer_abstract_exports = {};
 __export(ensindexer_abstract_exports, {
   account: () => account,
   account_relations: () => account_relations,
+  domain: () => domain,
   domainEvent: () => domainEvent,
   domainResolverRelation: () => domainResolverRelation,
   domainResolverRelation_relations: () => domainResolverRelation_relations,
+  domainType: () => domainType,
   event: () => event,
   internal_registrarActionMetadata: () => internal_registrarActionMetadata,
   internal_registrarActionMetadataType: () => internal_registrarActionMetadataType,
   label: () => label,
   label_relations: () => label_relations,
   latestRegistrationIndex: () => latestRegistrationIndex,
+  latestRegistrationIndex_relations: () => latestRegistrationIndex_relations,
   latestRenewalIndex: () => latestRenewalIndex,
-  migratedNode: () => migratedNode,
+  latestRenewalIndex_relations: () => latestRenewalIndex_relations,
+  migratedNodeByNode: () => migratedNodeByNode,
+  migratedNodeByParent: () => migratedNodeByParent,
   nameSales: () => nameSales,
   nameTokens: () => nameTokens,
   permissions: () => permissions,
   permissionsEvent: () => permissionsEvent,
   permissionsResource: () => permissionsResource,
   permissionsUser: () => permissionsUser,
+  permissionsUserEvent: () => permissionsUserEvent,
   registrarActionRelations: () => registrarActionRelations,
   registrarActionType: () => registrarActionType,
   registrarActions: () => registrarActions,
@@ -36,12 +42,12 @@ __export(ensindexer_abstract_exports, {
   registration_relations: () => registration_relations,
   registry: () => registry,
   registryCanonicalDomain: () => registryCanonicalDomain,
+  registryType: () => registryType,
+  relations_domain: () => relations_domain,
   relations_permissions: () => relations_permissions,
   relations_permissionsResource: () => relations_permissionsResource,
   relations_permissionsUser: () => relations_permissionsUser,
   relations_registry: () => relations_registry,
-  relations_v1Domain: () => relations_v1Domain,
-  relations_v2Domain: () => relations_v2Domain,
   renewal: () => renewal,
   renewal_relations: () => renewal_relations,
   resolver: () => resolver,
@@ -109,9 +115,7 @@ __export(ensindexer_abstract_exports, {
   subgraph_wrappedTransfer: () => subgraph_wrappedTransfer,
   subgraph_wrappedTransferRelations: () => subgraph_wrappedTransferRelations,
   subregistries: () => subregistries,
-  subregistryRelations: () => subregistryRelations,
-  v1Domain: () => v1Domain,
-  v2Domain: () => v2Domain
+  subregistryRelations: () => subregistryRelations
 });
 
 // src/ensindexer-abstract/ensv2.schema.ts
@@ -121,9 +125,11 @@ var event = onchainTable(
   (t) => ({
     // Ponder's event.id
     id: t.text().primaryKey(),
+    // The HCA account address if used, otherwise Transaction.from.
+    sender: t.hex().notNull().$type(),
     // Event Log Metadata
     // chain
-    chainId: t.integer().notNull().$type(),
+    chainId: t.int8({ mode: "number" }).notNull().$type(),
     // block
     blockNumber: t.bigint().notNull().$type(),
     blockHash: t.hex().notNull().$type(),
@@ -131,6 +137,8 @@ var event = onchainTable(
     // transaction
     transactionHash: t.hex().notNull().$type(),
     transactionIndex: t.integer().notNull(),
+    // `tx.from` — never HCA-aware. Always the EOA/relayer that submitted the transaction.
+    // Use `event.sender` for the HCA-aware actor.
     from: t.hex().notNull().$type(),
     to: t.hex().$type(),
     // NOTE: a null `to` means this was a tx that deployed a contract
@@ -144,6 +152,7 @@ var event = onchainTable(
   (t) => ({
     bySelector: index().on(t.selector),
     byFrom: index().on(t.from),
+    bySender: index().on(t.sender),
     byTimestamp: index().on(t.timestamp)
   })
 );
@@ -171,130 +180,114 @@ var permissionsEvent = onchainTable(
   }),
   (t) => ({ pk: primaryKey({ columns: [t.permissionsId, t.eventId] }) })
 );
+var permissionsUserEvent = onchainTable(
+  "permissions_user_events",
+  (t) => ({
+    permissionsUserId: t.text().notNull().$type(),
+    eventId: t.text().notNull()
+  }),
+  (t) => ({ pk: primaryKey({ columns: [t.permissionsUserId, t.eventId] }) })
+);
 var account = onchainTable("accounts", (t) => ({
   id: t.hex().primaryKey().$type()
 }));
 var account_relations = relations(account, ({ many }) => ({
   registrations: many(registration, { relationName: "registrant" }),
-  domains: many(v2Domain),
+  domains: many(domain),
   permissions: many(permissionsUser)
 }));
+var registryType = onchainEnum("RegistryType", [
+  "ENSv1Registry",
+  "ENSv1VirtualRegistry",
+  "ENSv2Registry"
+]);
 var registry = onchainTable(
   "registries",
   (t) => ({
     // see RegistryId for guarantees
     id: t.text().primaryKey().$type(),
-    chainId: t.integer().notNull().$type(),
-    address: t.hex().notNull().$type()
+    // has a type
+    type: registryType().notNull(),
+    chainId: t.int8({ mode: "number" }).notNull().$type(),
+    address: t.hex().notNull().$type(),
+    // If this is an ENSv1VirtualRegistry, `node` is the namehash of the parent ENSv1 domain that
+    // owns it, otherwise null.
+    node: t.hex().$type()
   }),
   (t) => ({
-    byId: uniqueIndex().on(t.chainId, t.address)
+    // NOTE: non-unique index because multiple rows can share (chainId, address) across virtual registries
+    byChainAddress: index().on(t.chainId, t.address)
   })
 );
 var relations_registry = relations(registry, ({ one, many }) => ({
-  domain: one(v2Domain, {
-    relationName: "subregistry",
-    fields: [registry.id],
-    references: [v2Domain.registryId]
-  }),
-  domains: many(v2Domain, { relationName: "registry" }),
+  // domains that declare this registry as their parent registry
+  domains: many(domain, { relationName: "registry" }),
+  // domains that declare this registry as their subregistry
+  domainsAsSubregistry: many(domain, { relationName: "subregistry" }),
   permissions: one(permissions, {
     relationName: "permissions",
     fields: [registry.chainId, registry.address],
     references: [permissions.chainId, permissions.address]
   })
 }));
-var v1Domain = onchainTable(
-  "v1_domains",
-  (t) => ({
-    // keyed by node, see ENSv1DomainId for guarantees.
-    id: t.text().primaryKey().$type(),
-    // must have a parent v1Domain (note: root node does not exist in index)
-    parentId: t.text().notNull().$type(),
-    // may have an owner
-    ownerId: t.hex().$type(),
-    // represents a labelHash
-    labelHash: t.hex().notNull().$type(),
-    // may have a `rootRegistryOwner` (ENSv1Registry's owner()), zeroAddress interpreted as null
-    rootRegistryOwnerId: t.hex().$type()
-    // NOTE: Domain-Resolver Relations tracked via Protocol Acceleration plugin
-  }),
-  (t) => ({
-    byParent: index().on(t.parentId),
-    byOwner: index().on(t.ownerId),
-    byLabelHash: index().on(t.labelHash)
-  })
-);
-var relations_v1Domain = relations(v1Domain, ({ one, many }) => ({
-  // v1Domain
-  parent: one(v1Domain, {
-    fields: [v1Domain.parentId],
-    references: [v1Domain.id]
-  }),
-  children: many(v1Domain, { relationName: "parent" }),
-  rootRegistryOwner: one(account, {
-    relationName: "rootRegistryOwner",
-    fields: [v1Domain.rootRegistryOwnerId],
-    references: [account.id]
-  }),
-  // shared
-  owner: one(account, {
-    relationName: "owner",
-    fields: [v1Domain.ownerId],
-    references: [account.id]
-  }),
-  label: one(label, {
-    relationName: "label",
-    fields: [v1Domain.labelHash],
-    references: [label.labelHash]
-  }),
-  registrations: many(registration)
-}));
-var v2Domain = onchainTable(
-  "v2_domains",
+var domainType = onchainEnum("DomainType", ["ENSv1Domain", "ENSv2Domain"]);
+var domain = onchainTable(
+  "domains",
   (t) => ({
-    // see ENSv2DomainId for guarantees
+    // see DomainId for guarantees (ENSv1DomainId: `${ENSv1RegistryId}/${node}`, ENSv2DomainId: CAIP-19)
     id: t.text().primaryKey().$type(),
-    // has a tokenId
-    tokenId: t.bigint().notNull(),
-    // belongs to registry
+    // has a type
+    type: domainType().notNull(),
+    // belongs to a registry
     registryId: t.text().notNull().$type(),
-    // may have one subregistry
+    // may have a subregistry
     subregistryId: t.text().$type(),
-    // may have an owner
-    ownerId: t.hex().$type(),
+    // If this is an ENSv2Domain, the TokenId within the ENSv2Registry, otherwise null.
+    tokenId: t.bigint().$type(),
+    // If this is an ENSv1Domain, The Domain's namehash, otherwise null.
+    node: t.hex().$type(),
     // represents a labelHash
-    labelHash: t.hex().notNull().$type()
+    labelHash: t.hex().notNull().$type(),
+    // If this is an ENSv1Domain, this is the effective owner of the Domain.
+    // If this is an ENSv2Domain, this is the on-chain owner address (the HCA account address if used).
+    ownerId: t.hex().$type(),
+    // If this is an ENSv1Domain, may have a `rootRegistryOwner`, otherwise null.
+    rootRegistryOwnerId: t.hex().$type()
     // NOTE: Domain-Resolver Relations tracked via Protocol Acceleration plugin
+    // NOTE: parent is derived via registryCanonicalDomain, not stored on the domain row
   }),
   (t) => ({
+    byType: index().on(t.type),
     byRegistry: index().on(t.registryId),
     bySubregistry: index().on(t.subregistryId).where(sql`${t.subregistryId} IS NOT NULL`),
     byOwner: index().on(t.ownerId),
     byLabelHash: index().on(t.labelHash)
   })
 );
-var relations_v2Domain = relations(v2Domain, ({ one, many }) => ({
-  // v2Domain
+var relations_domain = relations(domain, ({ one, many }) => ({
   registry: one(registry, {
     relationName: "registry",
-    fields: [v2Domain.registryId],
+    fields: [domain.registryId],
     references: [registry.id]
   }),
   subregistry: one(registry, {
     relationName: "subregistry",
-    fields: [v2Domain.subregistryId],
+    fields: [domain.subregistryId],
     references: [registry.id]
   }),
-  // shared
   owner: one(account, {
     relationName: "owner",
-    fields: [v2Domain.ownerId],
+    fields: [domain.ownerId],
+    references: [account.id]
+  }),
+  rootRegistryOwner: one(account, {
+    relationName: "rootRegistryOwner",
+    fields: [domain.rootRegistryOwnerId],
     references: [account.id]
   }),
   label: one(label, {
     relationName: "label",
-    fields: [v2Domain.labelHash],
+    fields: [domain.labelHash],
     references: [label.labelHash]
   }),
   registrations: many(registration)
@@ -323,11 +316,13 @@ var registration = onchainTable(
     // maybe have a grace period (BaseRegistrar)
     gracePeriod: t.bigint(),
     // registrar AccountId
-    registrarChainId: t.integer().notNull().$type(),
+    registrarChainId: t.int8({ mode: "number" }).notNull().$type(),
     registrarAddress: t.hex().notNull().$type(),
-    // may reference a registrant
+    // may reference a registrant. If this is an ENSv2 Registration, the protocol-emitted
+    // registrant address (the HCA account address if used).
     registrantId: t.hex().$type(),
-    // may reference an unregistrant
+    // may reference an unregistrant. If this is an ENSv2 Registration, the protocol-emitted
+    // unregistrant address (the HCA account address if used).
     unregistrantId: t.hex().$type(),
     // may have referrer data
     referrer: t.hex().$type(),
@@ -347,19 +342,11 @@ var registration = onchainTable(
     byId: uniqueIndex().on(t.domainId, t.registrationIndex)
   })
 );
-var latestRegistrationIndex = onchainTable("latest_registration_indexes", (t) => ({
-  domainId: t.text().primaryKey().$type(),
-  registrationIndex: t.integer().notNull()
-}));
 var registration_relations = relations(registration, ({ one, many }) => ({
-  // belongs to either v1Domain or v2Domain
-  v1Domain: one(v1Domain, {
-    fields: [registration.domainId],
-    references: [v1Domain.id]
-  }),
-  v2Domain: one(v2Domain, {
+  // belongs to a domain
+  domain: one(domain, {
     fields: [registration.domainId],
-    references: [v2Domain.id]
+    references: [domain.id]
   }),
   // has one registrant
   registrant: one(account, {
@@ -367,6 +354,10 @@ var registration_relations = relations(registration, ({ one, many }) => ({
     references: [account.id],
     relationName: "registrant"
   }),
+  // has a latest registration index
+  latestRegistrationIndex: one(latestRegistrationIndex),
+  // has a latest renewal index
+  latestRenewalIndex: one(latestRenewalIndex),
   // has one unregistrant
   unregistrant: one(account, {
     fields: [registration.unregistrantId],
@@ -381,6 +372,17 @@ var registration_relations = relations(registration, ({ one, many }) => ({
     references: [event.id]
   })
 }));
+var latestRegistrationIndex = onchainTable("latest_registration_indexes", (t) => ({
+  domainId: t.text().primaryKey().$type(),
+  registrationIndex: t.integer().notNull()
+}));
+var latestRegistrationIndex_relations = relations(latestRegistrationIndex, ({ one }) => ({
+  // references domain
+  domain: one(domain, {
+    fields: [latestRegistrationIndex.domainId],
+    references: [domain.id]
+  })
+}));
 var renewal = onchainTable(
   "renewals",
   (t) => ({
@@ -426,11 +428,18 @@ var latestRenewalIndex = onchainTable(
   }),
   (t) => ({ pk: primaryKey({ columns: [t.domainId, t.registrationIndex] }) })
 );
+var latestRenewalIndex_relations = relations(latestRenewalIndex, ({ one }) => ({
+  // references domain
+  domain: one(domain, {
+    fields: [latestRenewalIndex.domainId],
+    references: [domain.id]
+  })
+}));
 var permissions = onchainTable(
   "permissions",
   (t) => ({
     id: t.text().primaryKey().$type(),
-    chainId: t.integer().notNull().$type(),
+    chainId: t.int8({ mode: "number" }).notNull().$type(),
     address: t.hex().notNull().$type()
   }),
   (t) => ({
@@ -445,7 +454,7 @@ var permissionsResource = onchainTable(
   "permissions_resources",
   (t) => ({
     id: t.text().primaryKey().$type(),
-    chainId: t.integer().notNull().$type(),
+    chainId: t.int8({ mode: "number" }).notNull().$type(),
     address: t.hex().notNull().$type(),
     resource: t.bigint().notNull()
   }),
@@ -463,9 +472,10 @@ var permissionsUser = onchainTable(
   "permissions_users",
   (t) => ({
     id: t.text().primaryKey().$type(),
-    chainId: t.integer().notNull().$type(),
+    chainId: t.int8({ mode: "number" }).notNull().$type(),
     address: t.hex().notNull().$type(),
     resource: t.bigint().notNull(),
+    // The user/grantee address this Permission is granted to (the HCA account address if used).
     user: t.hex().notNull().$type(),
     // has one roles bitmap
     roles: t.bigint().notNull()
@@ -503,16 +513,33 @@ var label = onchainTable(
   })
 );
 var label_relations = relations(label, ({ many }) => ({
-  domains: many(v2Domain)
+  domains: many(domain)
 }));
 var registryCanonicalDomain = onchainTable("registry_canonical_domains", (t) => ({
   registryId: t.text().primaryKey().$type(),
   domainId: t.text().notNull().$type()
 }));
 
+// src/ensindexer-abstract/migrated-nodes.schema.ts
+import { onchainTable as onchainTable2, primaryKey as primaryKey2 } from "ponder";
+var migratedNodeByParent = onchainTable2(
+  "migrated_nodes_by_parent",
+  (t) => ({
+    // keyed by (parentNode, labelHash)
+    parentNode: t.hex().notNull().$type(),
+    labelHash: t.hex().notNull().$type()
+  }),
+  (t) => ({
+    pk: primaryKey2({ columns: [t.parentNode, t.labelHash] })
+  })
+);
+var migratedNodeByNode = onchainTable2("migrated_nodes_by_node", (t) => ({
+  node: t.hex().primaryKey().$type()
+}));
+
 // src/ensindexer-abstract/protocol-acceleration.schema.ts
-import { onchainTable as onchainTable2, primaryKey as primaryKey2, relations as relations2, uniqueIndex as uniqueIndex2 } from "ponder";
-var reverseNameRecord = onchainTable2(
+import { onchainTable as onchainTable3, primaryKey as primaryKey3, relations as relations2, uniqueIndex as uniqueIndex2 } from "ponder";
+var reverseNameRecord = onchainTable3(
   "reverse_name_records",
   (t) => ({
     // keyed by (address, coinType)
@@ -526,22 +553,22 @@ var reverseNameRecord = onchainTable2(
     value: t.text().notNull().$type()
   }),
   (t) => ({
-    pk: primaryKey2({ columns: [t.address, t.coinType] })
+    pk: primaryKey3({ columns: [t.address, t.coinType] })
   })
 );
-var domainResolverRelation = onchainTable2(
+var domainResolverRelation = onchainTable3(
   "domain_resolver_relations",
   (t) => ({
-    // keyed by (chainId, registry, node)
-    chainId: t.integer().notNull().$type(),
+    // keyed by (chainId, address, node)
+    chainId: t.int8({ mode: "number" }).notNull().$type(),
     // The Registry (ENSv1Registry or ENSv2Registry)'s AccountId.
     address: t.hex().notNull().$type(),
-    domainId: t.hex().notNull().$type(),
+    domainId: t.text().notNull().$type(),
     // The Domain's assigned Resolver's address (NOTE: always scoped to chainId)
     resolver: t.hex().notNull().$type()
   }),
   (t) => ({
-    pk: primaryKey2({ columns: [t.chainId, t.address, t.domainId] })
+    pk: primaryKey3({ columns: [t.chainId, t.address, t.domainId] })
   })
 );
 var domainResolverRelation_relations = relations2(domainResolverRelation, ({ one }) => ({
@@ -550,12 +577,12 @@ var domainResolverRelation_relations = relations2(domainResolverRelation, ({ one
     references: [resolver.chainId, resolver.address]
   })
 }));
-var resolver = onchainTable2(
+var resolver = onchainTable3(
   "resolvers",
   (t) => ({
     // keyed by (chainId, address)
     id: t.text().primaryKey().$type(),
-    chainId: t.integer().notNull().$type(),
+    chainId: t.int8({ mode: "number" }).notNull().$type(),
     address: t.hex().notNull().$type()
   }),
   (t) => ({
@@ -565,12 +592,12 @@ var resolver = onchainTable2(
 var resolver_relations = relations2(resolver, ({ many }) => ({
   records: many(resolverRecords)
 }));
-var resolverRecords = onchainTable2(
+var resolverRecords = onchainTable3(
   "resolver_records",
   (t) => ({
     // keyed by (chainId, resolver, node)
     id: t.text().primaryKey().$type(),
-    chainId: t.integer().notNull().$type(),
+    chainId: t.int8({ mode: "number" }).notNull().$type(),
     address: t.hex().notNull().$type(),
     node: t.hex().notNull().$type(),
     /**
@@ -616,11 +643,11 @@ var resolverRecords_relations = relations2(resolverRecords, ({ one, many }) => (
   // resolverRecord has many text records
   textRecords: many(resolverTextRecord)
 }));
-var resolverAddressRecord = onchainTable2(
+var resolverAddressRecord = onchainTable3(
   "resolver_address_records",
   (t) => ({
     // keyed by ((chainId, resolver, node), coinType)
-    chainId: t.integer().notNull().$type(),
+    chainId: t.int8({ mode: "number" }).notNull().$type(),
     address: t.hex().notNull().$type(),
     node: t.hex().notNull().$type(),
     // NOTE: all well-known CoinTypes fit into javascript number but NOT postgres .integer, must be
@@ -635,7 +662,7 @@ var resolverAddressRecord = onchainTable2(
     value: t.text().notNull()
   }),
   (t) => ({
-    pk: primaryKey2({ columns: [t.chainId, t.address, t.node, t.coinType] })
+    pk: primaryKey3({ columns: [t.chainId, t.address, t.node, t.coinType] })
   })
 );
 var resolverAddressRecordRelations = relations2(resolverAddressRecord, ({ one }) => ({
@@ -649,11 +676,11 @@ var resolverAddressRecordRelations = relations2(resolverAddressRecord, ({ one })
     references: [resolverRecords.chainId, resolverRecords.address, resolverRecords.node]
   })
 }));
-var resolverTextRecord = onchainTable2(
+var resolverTextRecord = onchainTable3(
   "resolver_text_records",
   (t) => ({
     // keyed by ((chainId, resolver, node), key)
-    chainId: t.integer().notNull().$type(),
+    chainId: t.int8({ mode: "number" }).notNull().$type(),
     address: t.hex().notNull().$type(),
     node: t.hex().notNull().$type(),
     key: t.text().notNull(),
@@ -666,7 +693,7 @@ var resolverTextRecord = onchainTable2(
     value: t.text().notNull()
   }),
   (t) => ({
-    pk: primaryKey2({ columns: [t.chainId, t.address, t.node, t.key] })
+    pk: primaryKey3({ columns: [t.chainId, t.address, t.node, t.key] })
   })
 );
 var resolverTextRecordRelations = relations2(resolverTextRecord, ({ one }) => ({
@@ -676,13 +703,10 @@ var resolverTextRecordRelations = relations2(resolverTextRecord, ({ one }) => ({
     references: [resolverRecords.chainId, resolverRecords.address, resolverRecords.node]
   })
 }));
-var migratedNode = onchainTable2("migrated_nodes", (t) => ({
-  node: t.hex().primaryKey().$type()
-}));
 
 // src/ensindexer-abstract/registrars.schema.ts
-import { index as index2, onchainEnum as onchainEnum2, onchainTable as onchainTable3, relations as relations3, uniqueIndex as uniqueIndex3 } from "ponder";
-var subregistries = onchainTable3(
+import { index as index2, onchainEnum as onchainEnum2, onchainTable as onchainTable4, relations as relations3, uniqueIndex as uniqueIndex3 } from "ponder";
+var subregistries = onchainTable4(
   "subregistries",
   (t) => ({
     /**
@@ -712,7 +736,7 @@ var subregistries = onchainTable3(
     uniqueNode: uniqueIndex3().on(t.node)
   })
 );
-var registrationLifecycles = onchainTable3(
+var registrationLifecycles = onchainTable4(
   "registration_lifecycles",
   (t) => ({
     /**
@@ -752,7 +776,7 @@ var registrarActionType = onchainEnum2("registrar_action_type", [
   "registration",
   "renewal"
 ]);
-var registrarActions = onchainTable3(
+var registrarActions = onchainTable4(
   "registrar_actions",
   (t) => ({
     /**
@@ -1009,7 +1033,7 @@ var internal_registrarActionMetadataType = onchainEnum2(
   "_ensindexer_registrar_action_metadata_type",
   ["CURRENT_LOGICAL_REGISTRAR_ACTION"]
 );
-var internal_registrarActionMetadata = onchainTable3(
+var internal_registrarActionMetadata = onchainTable4(
   "_ensindexer_registrar_action_metadata",
   (t) => ({
     /**
@@ -1058,7 +1082,7 @@ var registrarActionRelations = relations3(registrarActions, ({ one }) => ({
 }));
 
 // src/ensindexer-abstract/subgraph.schema.ts
-import { index as index3, onchainTable as onchainTable4, relations as relations4, sql as sql2 } from "ponder";
+import { index as index3, onchainTable as onchainTable5, relations as relations4, sql as sql2 } from "ponder";
 
 // src/lib/collate.ts
 function monkeypatchCollate(col, collation) {
@@ -1069,7 +1093,7 @@ function monkeypatchCollate(col, collation) {
 }
 
 // src/ensindexer-abstract/subgraph.schema.ts
-var subgraph_domain = onchainTable4(
+var subgraph_domain = onchainTable5(
   "subgraph_domains",
   (t) => ({
     // The namehash of the name
@@ -1199,7 +1223,7 @@ var subgraph_domainRelations = relations4(subgraph_domain, ({ one, many }) => ({
   fusesSets: many(subgraph_fusesSet),
   expiryExtendeds: many(subgraph_expiryExtended)
 }));
-var subgraph_account = onchainTable4("subgraph_accounts", (t) => ({
+var subgraph_account = onchainTable5("subgraph_accounts", (t) => ({
   id: t.hex().primaryKey()
 }));
 var subgraph_accountRelations = relations4(subgraph_account, ({ many }) => ({
@@ -1207,7 +1231,7 @@ var subgraph_accountRelations = relations4(subgraph_account, ({ many }) => ({
   wrappedDomains: many(subgraph_wrappedDomain),
   registrations: many(subgraph_registration)
 }));
-var subgraph_resolver = onchainTable4(
+var subgraph_resolver = onchainTable5(
   "subgraph_resolvers",
   (t) => ({
     // The unique identifier for this resolver, which is a concatenation of the domain namehash and the resolver address
@@ -1252,7 +1276,7 @@ var subgraph_resolverRelations = relations4(subgraph_resolver, ({ one, many }) =
   authorisationChangeds: many(subgraph_authorisationChanged),
   versionChangeds: many(subgraph_versionChanged)
 }));
-var subgraph_registration = onchainTable4(
+var subgraph_registration = onchainTable5(
   "subgraph_registrations",
   (t) => ({
     // The unique identifier of the registration
@@ -1308,7 +1332,7 @@ var subgraph_registrationRelations = relations4(subgraph_registration, ({ one, m
   nameReneweds: many(subgraph_nameRenewed),
   nameTransferreds: many(subgraph_nameTransferred)
 }));
-var subgraph_wrappedDomain = onchainTable4(
+var subgraph_wrappedDomain = onchainTable5(
   "subgraph_wrapped_domains",
   (t) => ({
     // The unique identifier for each instance of the WrappedDomain entity
@@ -1368,7 +1392,7 @@ var domainEventIndex = (t) => ({
   // sorting index
   idx_compound: index3().on(t.domainId, t.id)
 });
-var subgraph_transfer = onchainTable4(
+var subgraph_transfer = onchainTable5(
   "subgraph_transfers",
   (t) => ({
     ...domainEvent2(t),
@@ -1376,7 +1400,7 @@ var subgraph_transfer = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_newOwner = onchainTable4(
+var subgraph_newOwner = onchainTable5(
   "subgraph_new_owners",
   (t) => ({
     ...domainEvent2(t),
@@ -1385,7 +1409,7 @@ var subgraph_newOwner = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_newResolver = onchainTable4(
+var subgraph_newResolver = onchainTable5(
   "subgraph_new_resolvers",
   (t) => ({
     ...domainEvent2(t),
@@ -1393,7 +1417,7 @@ var subgraph_newResolver = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_newTTL = onchainTable4(
+var subgraph_newTTL = onchainTable5(
   "subgraph_new_ttls",
   (t) => ({
     ...domainEvent2(t),
@@ -1401,7 +1425,7 @@ var subgraph_newTTL = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_wrappedTransfer = onchainTable4(
+var subgraph_wrappedTransfer = onchainTable5(
   "subgraph_wrapped_transfers",
   (t) => ({
     ...domainEvent2(t),
@@ -1409,7 +1433,7 @@ var subgraph_wrappedTransfer = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_nameWrapped = onchainTable4(
+var subgraph_nameWrapped = onchainTable5(
   "subgraph_name_wrapped",
   (t) => ({
     ...domainEvent2(t),
@@ -1420,7 +1444,7 @@ var subgraph_nameWrapped = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_nameUnwrapped = onchainTable4(
+var subgraph_nameUnwrapped = onchainTable5(
   "subgraph_name_unwrapped",
   (t) => ({
     ...domainEvent2(t),
@@ -1428,7 +1452,7 @@ var subgraph_nameUnwrapped = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_fusesSet = onchainTable4(
+var subgraph_fusesSet = onchainTable5(
   "subgraph_fuses_set",
   (t) => ({
     ...domainEvent2(t),
@@ -1436,7 +1460,7 @@ var subgraph_fusesSet = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_expiryExtended = onchainTable4(
+var subgraph_expiryExtended = onchainTable5(
   "subgraph_expiry_extended",
   (t) => ({
     ...domainEvent2(t),
@@ -1454,7 +1478,7 @@ var registrationEventIndex = (t) => ({
   // sorting index
   idx_compound: index3().on(t.registrationId, t.id)
 });
-var subgraph_nameRegistered = onchainTable4(
+var subgraph_nameRegistered = onchainTable5(
   "subgraph_name_registered",
   (t) => ({
     ...registrationEvent(t),
@@ -1463,7 +1487,7 @@ var subgraph_nameRegistered = onchainTable4(
   }),
   registrationEventIndex
 );
-var subgraph_nameRenewed = onchainTable4(
+var subgraph_nameRenewed = onchainTable5(
   "subgraph_name_renewed",
   (t) => ({
     ...registrationEvent(t),
@@ -1471,7 +1495,7 @@ var subgraph_nameRenewed = onchainTable4(
   }),
   registrationEventIndex
 );
-var subgraph_nameTransferred = onchainTable4(
+var subgraph_nameTransferred = onchainTable5(
   "subgraph_name_transferred",
   (t) => ({
     ...registrationEvent(t),
@@ -1489,7 +1513,7 @@ var resolverEventIndex = (t) => ({
   // sorting index
   idx_compound: index3().on(t.resolverId, t.id)
 });
-var subgraph_addrChanged = onchainTable4(
+var subgraph_addrChanged = onchainTable5(
   "subgraph_addr_changed",
   (t) => ({
     ...resolverEvent2(t),
@@ -1497,7 +1521,7 @@ var subgraph_addrChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_multicoinAddrChanged = onchainTable4(
+var subgraph_multicoinAddrChanged = onchainTable5(
   "subgraph_multicoin_addr_changed",
   (t) => ({
     ...resolverEvent2(t),
@@ -1506,7 +1530,7 @@ var subgraph_multicoinAddrChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_nameChanged = onchainTable4(
+var subgraph_nameChanged = onchainTable5(
   "subgraph_name_changed",
   (t) => ({
     ...resolverEvent2(t),
@@ -1514,7 +1538,7 @@ var subgraph_nameChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_abiChanged = onchainTable4(
+var subgraph_abiChanged = onchainTable5(
   "subgraph_abi_changed",
   (t) => ({
     ...resolverEvent2(t),
@@ -1522,7 +1546,7 @@ var subgraph_abiChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_pubkeyChanged = onchainTable4(
+var subgraph_pubkeyChanged = onchainTable5(
   "subgraph_pubkey_changed",
   (t) => ({
     ...resolverEvent2(t),
@@ -1531,7 +1555,7 @@ var subgraph_pubkeyChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_textChanged = onchainTable4(
+var subgraph_textChanged = onchainTable5(
   "subgraph_text_changed",
   (t) => ({
     ...resolverEvent2(t),
@@ -1540,7 +1564,7 @@ var subgraph_textChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_contenthashChanged = onchainTable4(
+var subgraph_contenthashChanged = onchainTable5(
   "subgraph_contenthash_changed",
   (t) => ({
     ...resolverEvent2(t),
@@ -1548,7 +1572,7 @@ var subgraph_contenthashChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_interfaceChanged = onchainTable4(
+var subgraph_interfaceChanged = onchainTable5(
   "subgraph_interface_changed",
   (t) => ({
     ...resolverEvent2(t),
@@ -1557,7 +1581,7 @@ var subgraph_interfaceChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_authorisationChanged = onchainTable4(
+var subgraph_authorisationChanged = onchainTable5(
   "subgraph_authorisation_changed",
   (t) => ({
     ...resolverEvent2(t),
@@ -1567,7 +1591,7 @@ var subgraph_authorisationChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_versionChanged = onchainTable4(
+var subgraph_versionChanged = onchainTable5(
   "subgraph_version_changed",
   (t) => ({
     ...resolverEvent2(t),
@@ -1761,8 +1785,8 @@ var subgraph_versionChangedRelations = relations4(subgraph_versionChanged, ({ on
 }));
 
 // src/ensindexer-abstract/tokenscope.schema.ts
-import { index as index4, onchainTable as onchainTable5 } from "ponder";
-var nameSales = onchainTable5(
+import { index as index4, onchainTable as onchainTable6 } from "ponder";
+var nameSales = onchainTable6(
   "name_sales",
   (t) => ({
     /**
@@ -1774,7 +1798,7 @@ var nameSales = onchainTable5(
     /**
      * The chain where the sale occurred.
      */
-    chainId: t.integer().notNull(),
+    chainId: t.int8({ mode: "number" }).notNull(),
     /**
      * The block number on chainId where the sale occurred.
      */
@@ -1858,7 +1882,7 @@ var nameSales = onchainTable5(
     idx_timestamp: index4().on(t.timestamp)
   })
 );
-var nameTokens = onchainTable5(
+var nameTokens = onchainTable6(
   "name_tokens",
   (t) => ({
     /**
@@ -1888,7 +1912,7 @@ var nameTokens = onchainTable5(
     /**
      * The chain that manages the token.
      */
-    chainId: t.integer().notNull(),
+    chainId: t.int8({ mode: "number" }).notNull(),
     /**
      * The address of the contract on chainId that manages the token.
      */
@@ -1948,7 +1972,7 @@ var ensnode_exports = {};
 __export(ensnode_exports, {
   metadata: () => metadata
 });
-import { pgSchema, primaryKey as primaryKey3 } from "drizzle-orm/pg-core";
+import { pgSchema, primaryKey as primaryKey4 } from "drizzle-orm/pg-core";
 var ENSNODE_SCHEMA_NAME = "ensnode";
 var ENSNODE_SCHEMA = pgSchema(ENSNODE_SCHEMA_NAME);
 var metadata = ENSNODE_SCHEMA.table(
@@ -1988,7 +2012,7 @@ var metadata = ENSNODE_SCHEMA.table(
      * Primary key constraint on 'ensIndexerSchemaName' and 'key' columns,
      * to ensure that there is only one record for each key per ENSIndexer instance.
      */
-    primaryKey3({
+    primaryKey4({
       name: "metadata_pkey",
       columns: [table.ensIndexerSchemaName, table.key]
     })
@@ -2072,8 +2096,12 @@ var ENSDB_SCHEMA_CHECKSUM = getDrizzleSchemaChecksum({
 // src/client/ensdb-reader.ts
 import { and, eq } from "drizzle-orm/sql";
 import {
-  deserializeCrossChainIndexingStatusSnapshot,
-  deserializeEnsIndexerPublicConfig
+  buildIndexingMetadataContextUninitialized,
+  deserializeIndexingMetadataContext,
+  IndexingMetadataContextStatusCodes
+} from "@ensnode/ensnode-sdk";
+import {
+  IndexingMetadataContextStatusCodes as IndexingMetadataContextStatusCodes2
 } from "@ensnode/ensnode-sdk";
 
 // src/lib/parse-pg-version-info.ts
@@ -2094,9 +2122,7 @@ function parsePgVersionInfo(versionString) {
 
 // src/client/ensnode-metadata.ts
 var EnsNodeMetadataKeys = {
-  EnsDbVersion: "ensdb_version",
-  EnsIndexerPublicConfig: "ensindexer_public_config",
-  EnsIndexerIndexingStatus: "ensindexer_indexing_status"
+  IndexingMetadataContext: "indexing_metadata_context"
 };
 
 // src/client/ensdb-reader.ts
@@ -2175,29 +2201,29 @@ var EnsDbReader = class {
     return this._ensNodeSchema;
   }
   /**
-   * Get ENSDb Version
-   *
-   * @returns the existing record, or `undefined`.
+   * Check if the ENSDb instance is healthy by running a simple query
+   * against it.
    */
-  async getEnsDbVersion() {
-    const record = await this.getEnsNodeMetadata({
-      key: EnsNodeMetadataKeys.EnsDbVersion
-    });
-    return record;
+  async isHealthy() {
+    try {
+      await this.ensDb.execute("SELECT 1;");
+      return true;
+    } catch {
+      return false;
+    }
   }
   /**
-   * Get ENSIndexer Public Config
-   *
-   * @returns the existing record, or `undefined`.
+   * Check if the ENSDb instance is ready by verifying that
+   * the {@link IndexingMetadataContext} has been initialized for
+   * the ENSIndexer Schema used by this ENSDbReader instance.
    */
-  async getEnsIndexerPublicConfig() {
-    const record = await this.getEnsNodeMetadata({
-      key: EnsNodeMetadataKeys.EnsIndexerPublicConfig
-    });
-    if (!record) {
-      return void 0;
+  async isReady() {
+    try {
+      const indexingMetadataContext = await this.getIndexingMetadataContext();
+      return indexingMetadataContext.statusCode === IndexingMetadataContextStatusCodes.Initialized;
+    } catch {
+      return false;
     }
-    return deserializeEnsIndexerPublicConfig(record);
   }
   /**
    * Build ENSDb Public Config
@@ -2209,20 +2235,18 @@ var EnsDbReader = class {
     };
   }
   /**
-   * Get Indexing Status Snapshot
+   * Get Indexing Metadata Context
    *
-   * @returns the existing record, or `undefined`.
+   * @returns the initialized record, or a default uninitialized one if no record exists in ENSDb.
    */
-  async getIndexingStatusSnapshot() {
-    const record = await this.getEnsNodeMetadata(
-      {
-        key: EnsNodeMetadataKeys.EnsIndexerIndexingStatus
-      }
-    );
+  async getIndexingMetadataContext() {
+    const record = await this.getEnsNodeMetadata({
+      key: EnsNodeMetadataKeys.IndexingMetadataContext
+    });
     if (!record) {
-      return void 0;
+      return buildIndexingMetadataContextUninitialized();
     }
-    return deserializeCrossChainIndexingStatusSnapshot(record);
+    return deserializeIndexingMetadataContext(record);
   }
   /**
    * Get ENSNode Metadata record
@@ -2279,56 +2303,59 @@ var EnsDbReader = class {
 };
 
 // src/client/ensdb-writer.ts
+import { sql as sql3 } from "drizzle-orm";
 import { migrate } from "drizzle-orm/node-postgres/migrator";
 import {
-  serializeCrossChainIndexingStatusSnapshot,
-  serializeEnsIndexerPublicConfig
+  serializeIndexingMetadataContext
 } from "@ensnode/ensnode-sdk";
-var EnsDbWriter = class extends EnsDbReader {
+
+// src/lib/advisory-lock-id.ts
+import { createHash as createHash2 } from "crypto";
+function advisoryLockId(name) {
+  const hash = createHash2("sha256").update(name).digest();
+  return hash.readBigInt64BE(0);
+}
+
+// src/client/ensdb-writer.ts
+var EnsDbWriter = class _EnsDbWriter extends EnsDbReader {
+  /**
+   * Stable arbitrary lock ID for ENSNode Schema migrations to
+   * prevent concurrent migration execution across multiple ENSIndexer instances.
+   */
+  static MIGRATION_LOCK_ID = advisoryLockId(
+    "ensnode-schema-migration-lock"
+  );
   /**
    * Execute pending database migrations for ENSNode Schema in ENSDb.
    *
+   * This function is:
+   * - idempotent and can be safely executed multiple times,
+   * - safe to execute concurrently across multiple ENSIndexer instances,
+   *   as it uses a stable arbitrary advisory lock to prevent concurrent
+   *   execution of migrations.
+   *
    * @param migrationsDirPath - The file path to the directory containing
    *                            database migration files for ENSNode Schema.
    * @throws error when migration execution fails.
    */
   async migrateEnsNodeSchema(migrationsDirPath) {
-    return migrate(this.drizzleClient, {
-      migrationsFolder: migrationsDirPath,
-      migrationsSchema: "ensnode"
-    });
-  }
-  /**
-   * Upsert ENSDb Version
-   *
-   * @throws when upsert operation failed.
-   */
-  async upsertEnsDbVersion(ensDbVersion) {
-    await this.upsertEnsNodeMetadata({
-      key: EnsNodeMetadataKeys.EnsDbVersion,
-      value: ensDbVersion
-    });
-  }
-  /**
-   * Upsert ENSIndexer Public Config
-   *
-   * @throws when upsert operation failed.
-   */
-  async upsertEnsIndexerPublicConfig(ensIndexerPublicConfig) {
-    await this.upsertEnsNodeMetadata({
-      key: EnsNodeMetadataKeys.EnsIndexerPublicConfig,
-      value: serializeEnsIndexerPublicConfig(ensIndexerPublicConfig)
+    await this.drizzleClient.transaction(async (tx) => {
+      await tx.execute(sql3`SELECT pg_advisory_xact_lock(${_EnsDbWriter.MIGRATION_LOCK_ID})`);
+      await migrate(tx, {
+        migrationsFolder: migrationsDirPath,
+        migrationsSchema: "ensnode"
+      });
     });
   }
   /**
-   * Upsert Indexing Status Snapshot
+   * Upsert Indexing Metadata Context Initialized
    *
    * @throws when upsert operation failed.
    */
-  async upsertIndexingStatusSnapshot(indexingStatus) {
+  async upsertIndexingMetadataContext(indexingMetadataContext) {
     await this.upsertEnsNodeMetadata({
-      key: EnsNodeMetadataKeys.EnsIndexerIndexingStatus,
-      value: serializeCrossChainIndexingStatusSnapshot(indexingStatus)
+      key: EnsNodeMetadataKeys.IndexingMetadataContext,
+      value: serializeIndexingMetadataContext(indexingMetadataContext)
     });
   }
   /**
@@ -2396,6 +2423,7 @@ export {
   EnsDbReader,
   EnsDbWriter,
   EnsNodeMetadataKeys,
+  IndexingMetadataContextStatusCodes2 as IndexingMetadataContextStatusCodes,
   validateEnsDbConfig
 };
 //# sourceMappingURL=index.js.map