@ensnode/ensdb-sdk 1.15.2 → 1.17.0

package/dist/index.js

@@ -16,6 +16,11 @@ __export(ensindexer_abstract_exports, {
   domainResolverRelation: () => domainResolverRelation,
   domainResolverRelation_relations: () => domainResolverRelation_relations,
   domainType: () => domainType,
+  efpAccountMetadata: () => efpAccountMetadata,
+  efpListMetadata: () => efpListMetadata,
+  efpListRecords: () => efpListRecords,
+  efpListStorageLocations: () => efpListStorageLocations,
+  efpLists: () => efpLists,
   event: () => event,
   internal_registrarActionMetadata: () => internal_registrarActionMetadata,
   internal_registrarActionMetadataType: () => internal_registrarActionMetadataType,
@@ -120,9 +125,141 @@ __export(ensindexer_abstract_exports, {
   truncateCanonicalNamePrefix: () => truncateCanonicalNamePrefix
 });
 
+// src/ensindexer-abstract/efp.schema.ts
+import { index, onchainTable } from "ponder";
+var efpLists = onchainTable(
+  "efp_lists",
+  (t) => ({
+    /** ERC-721 token id of the list NFT (a uint256), the list's primary key. */
+    id: t.bigint().primaryKey().$type(),
+    /** Current ERC-721 owner of the list NFT. */
+    owner: t.hex().notNull().$type(),
+    /** Chain id of the `ListRegistry` NFT (Base / 8453 on mainnet; the active namespace's EFP deployment chain otherwise). */
+    nftChainId: t.int8({ mode: "number" }).notNull().$type(),
+    /** `ListRegistry` contract address on `nftChainId`. */
+    nftContractAddress: t.hex().notNull().$type(),
+    /** Raw `UpdateListStorageLocation` payload. */
+    listStorageLocation: t.hex(),
+    /** Decoded list storage location: target chain id. */
+    listStorageLocationChainId: t.int8({ mode: "number" }).$type(),
+    /** Decoded list storage location: target contract address. */
+    listStorageLocationContractAddress: t.hex().$type(),
+    /** Decoded list storage location: target slot (bytes32). */
+    listStorageLocationSlot: t.hex(),
+    /** Address allowed to post records to this list (the EFP "user"). */
+    user: t.hex().$type(),
+    /** Address allowed to administer this list (the EFP "manager"). */
+    manager: t.hex().$type(),
+    createdAt: t.bigint().notNull().$type(),
+    updatedAt: t.bigint().notNull().$type()
+  }),
+  (t) => ({
+    idx_owner: index().on(t.owner),
+    idx_user: index().on(t.user),
+    idx_manager: index().on(t.manager),
+    idx_storageLocation: index().on(
+      t.listStorageLocationChainId,
+      t.listStorageLocationContractAddress,
+      t.listStorageLocationSlot
+    )
+    // `id` is a `bigint` (Postgres `numeric`) primary key, so its implicit unique index already
+    // orders numerically — `efp.lists` / `Account.efp.lists` pagination needs no extra index.
+  })
+);
+var efpListStorageLocations = onchainTable("efp_list_storage_locations", (t) => ({
+  /** Composite key "chainId-contractAddress-slot". */
+  id: t.text().primaryKey(),
+  chainId: t.int8({ mode: "number" }).notNull().$type(),
+  contractAddress: t.hex().notNull().$type(),
+  slot: t.hex().notNull(),
+  /**
+   * Token id of the list NFT that owns this storage location's reverse mapping. The slot is
+   * arbitrary, attacker-settable bytes, so multiple list NFTs can point at the same
+   * `(chainId, contract, slot)`; this records the FIRST list to claim it (first writer wins), and
+   * the `UpdateListStorageLocation` handler gates every write/delete of this row on that ownership.
+   * A consequence: when lists share a slot, only the owner's `EfpListRecord.list` back-ref and
+   * `user`/`manager` role routing track that slot.
+   */
+  tokenId: t.bigint().notNull().$type(),
+  updatedAt: t.bigint().notNull().$type()
+}));
+var efpListRecords = onchainTable(
+  "efp_list_records",
+  (t) => ({
+    /** Composite key "chainId-contractAddress-slot-record". */
+    id: t.text().primaryKey(),
+    chainId: t.int8({ mode: "number" }).notNull().$type(),
+    contractAddress: t.hex().notNull().$type(),
+    slot: t.hex().notNull(),
+    /** Canonical record prefix `version | type | address` (22 bytes). */
+    record: t.hex().notNull(),
+    /** Decoded record header — version byte. */
+    recordVersion: t.integer().notNull(),
+    /** Decoded record header — type byte. */
+    recordType: t.integer().notNull(),
+    /** Decoded record data. Only address records (type 1) are indexed, so exactly a 20-byte address. */
+    recordData: t.hex().notNull().$type(),
+    /** UTF-8 tags attached to this record (a set; NULL bytes stripped). */
+    tags: t.text().array().notNull().default([]),
+    createdAt: t.bigint().notNull().$type()
+  }),
+  (t) => ({
+    idx_slot: index().on(t.chainId, t.contractAddress, t.slot),
+    idx_recordData: index().on(t.recordData)
+  })
+);
+var efpAccountMetadata = onchainTable(
+  "efp_account_metadata",
+  (t) => ({
+    /** Composite key "chainId-address-key". */
+    id: t.text().primaryKey(),
+    chainId: t.int8({ mode: "number" }).notNull().$type(),
+    contractAddress: t.hex().notNull().$type(),
+    /** Account whose metadata this is. */
+    address: t.hex().notNull().$type(),
+    /** Metadata key (UTF-8 string). */
+    key: t.text().notNull(),
+    /** Metadata value (raw bytes). */
+    value: t.hex().notNull(),
+    /**
+     * For the `primary-list` key only: the decoded token id of the account's primary list (the
+     * `value` is `abi.encodePacked(uint256)`, which Postgres can't compare to the numeric
+     * `efp_lists.id`). Decoding it at index time makes the validated follower/following social graph
+     * a pure SQL join. `null` for any other key, or a malformed `primary-list` value.
+     */
+    primaryListTokenId: t.bigint().$type(),
+    createdAt: t.bigint().notNull().$type(),
+    updatedAt: t.bigint().notNull().$type()
+  }),
+  (t) => ({
+    idx_address: index().on(t.address),
+    // Account-metadata lookups (primary-list validation, `metadata(key:)`) filter by `(address, key)`;
+    // a composite index makes that a point lookup rather than an address-partition scan.
+    idx_address_key: index().on(t.address, t.key),
+    // The followers join filters lists by `(user, primaryListTokenId)`; index it for the social graph.
+    idx_primaryListTokenId: index().on(t.primaryListTokenId)
+  })
+);
+var efpListMetadata = onchainTable(
+  "efp_list_metadata",
+  (t) => ({
+    /** Composite key "chainId-contractAddress-slot-key". */
+    id: t.text().primaryKey(),
+    chainId: t.int8({ mode: "number" }).notNull().$type(),
+    contractAddress: t.hex().notNull().$type(),
+    slot: t.hex().notNull(),
+    key: t.text().notNull(),
+    value: t.hex().notNull(),
+    createdAt: t.bigint().notNull().$type()
+  }),
+  (t) => ({
+    idx_slot: index().on(t.chainId, t.contractAddress, t.slot)
+  })
+);
+
 // src/ensindexer-abstract/migrated-nodes.schema.ts
-import { onchainTable, primaryKey } from "ponder";
-var migratedNodeByParent = onchainTable(
+import { onchainTable as onchainTable2, primaryKey } from "ponder";
+var migratedNodeByParent = onchainTable2(
   "migrated_nodes_by_parent",
   (t) => ({
     // keyed by (parentNode, labelHash)
@@ -133,17 +270,19 @@ var migratedNodeByParent = onchainTable(
     pk: primaryKey({ columns: [t.parentNode, t.labelHash] })
   })
 );
-var migratedNodeByNode = onchainTable("migrated_nodes_by_node", (t) => ({
+var migratedNodeByNode = onchainTable2("migrated_nodes_by_node", (t) => ({
   node: t.hex().primaryKey().$type()
 }));
 
 // src/ensindexer-abstract/protocol-acceleration.schema.ts
-import { index, onchainTable as onchainTable2, primaryKey as primaryKey2, relations, uniqueIndex } from "ponder";
-var reverseNameRecord = onchainTable2(
+import { index as index2, onchainTable as onchainTable3, primaryKey as primaryKey2, relations, uniqueIndex } from "ponder";
+var reverseNameRecord = onchainTable3(
   "reverse_name_records",
   (t) => ({
     // keyed by (address, coinType)
     address: t.hex().notNull().$type(),
+    // @TODO(cointype-bigint): store as `t.int8({ mode: "number" }).$type<CoinType>()` (like chainId
+    // elsewhere) so reads/writes use CoinType directly without bigint round-trips. See #2293.
     coinType: t.bigint().notNull(),
     /**
      * Represents the ENSIP-19 Reverse Name Record for a given (address, coinType).
@@ -156,7 +295,7 @@ var reverseNameRecord = onchainTable2(
     pk: primaryKey2({ columns: [t.address, t.coinType] })
   })
 );
-var domainResolverRelation = onchainTable2(
+var domainResolverRelation = onchainTable3(
   "domain_resolver_relations",
   (t) => ({
     // keyed by (chainId, address, node)
@@ -169,7 +308,7 @@ var domainResolverRelation = onchainTable2(
   }),
   (t) => ({
     pk: primaryKey2({ columns: [t.chainId, t.address, t.domainId] }),
-    byDomain: index().on(t.domainId)
+    byDomain: index2().on(t.domainId)
   })
 );
 var domainResolverRelation_relations = relations(domainResolverRelation, ({ one }) => ({
@@ -178,7 +317,7 @@ var domainResolverRelation_relations = relations(domainResolverRelation, ({ one
     references: [resolver.chainId, resolver.address]
   })
 }));
-var resolver = onchainTable2(
+var resolver = onchainTable3(
   "resolvers",
   (t) => ({
     // keyed by (chainId, address)
@@ -199,7 +338,7 @@ var resolver = onchainTable2(
 var resolver_relations = relations(resolver, ({ many }) => ({
   records: many(resolverRecords)
 }));
-var resolverRecords = onchainTable2(
+var resolverRecords = onchainTable3(
   "resolver_records",
   (t) => ({
     // keyed by (chainId, resolver, node)
@@ -250,7 +389,7 @@ var resolverRecords_relations = relations(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)
@@ -259,6 +398,8 @@ var resolverAddressRecord = onchainTable2(
     node: t.hex().notNull().$type(),
     // NOTE: all well-known CoinTypes fit into javascript number but NOT postgres .integer, must be
     // stored as BigInt
+    // @TODO(cointype-bigint): use `t.int8({ mode: "number" }).$type<CoinType>()` like `chainId` above
+    // to drop bigint round-trips at every read/write boundary. See #2293.
     coinType: t.bigint().notNull(),
     /**
      * Represents the value of the Address Record specified by ((chainId, resolver, node), coinType).
@@ -269,7 +410,12 @@ var resolverAddressRecord = onchainTable2(
     value: t.hex().notNull()
   }),
   (t) => ({
-    pk: primaryKey2({ columns: [t.chainId, t.address, t.node, t.coinType] })
+    pk: primaryKey2({ columns: [t.chainId, t.address, t.node, t.coinType] }),
+    // supports the reverse lookup powering `Account.nameReferences`:
+    // `WHERE value = <address> [AND coin_type = <coinType>] ORDER BY (node, coinType, chainId, address)`.
+    // The `value` prefix seeks the filter; the remaining columns match the keyset ORDER BY tuple so
+    // rows are yielded already sorted, letting pagination range-scan to the cursor instead of sorting.
+    byValueKeyset: index2().on(t.value, t.node, t.coinType, t.chainId, t.address)
   })
 );
 var resolverAddressRecordRelations = relations(resolverAddressRecord, ({ one }) => ({
@@ -283,7 +429,7 @@ var resolverAddressRecordRelations = relations(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)
@@ -312,8 +458,8 @@ var resolverTextRecordRelations = relations(resolverTextRecord, ({ one }) => ({
 }));
 
 // src/ensindexer-abstract/registrars.schema.ts
-import { index as index2, onchainEnum, onchainTable as onchainTable3, relations as relations2, uniqueIndex as uniqueIndex2 } from "ponder";
-var subregistries = onchainTable3(
+import { index as index3, onchainEnum, onchainTable as onchainTable4, relations as relations2, uniqueIndex as uniqueIndex2 } from "ponder";
+var subregistries = onchainTable4(
   "subregistries",
   (t) => ({
     /**
@@ -343,7 +489,7 @@ var subregistries = onchainTable3(
     uniqueNode: uniqueIndex2().on(t.node)
   })
 );
-var registrationLifecycles = onchainTable3(
+var registrationLifecycles = onchainTable4(
   "registration_lifecycles",
   (t) => ({
     /**
@@ -376,14 +522,14 @@ var registrationLifecycles = onchainTable3(
     expiresAt: t.bigint().notNull()
   }),
   (t) => ({
-    bySubregistry: index2().on(t.subregistryId)
+    bySubregistry: index3().on(t.subregistryId)
   })
 );
 var registrarActionType = onchainEnum("registrar_action_type", [
   "registration",
   "renewal"
 ]);
-var registrarActions = onchainTable3(
+var registrarActions = onchainTable4(
   "registrar_actions",
   (t) => ({
     /**
@@ -632,15 +778,15 @@ var registrarActions = onchainTable3(
     eventIds: t.text().array().notNull()
   }),
   (t) => ({
-    byDecodedReferrer: index2().on(t.decodedReferrer),
-    byTimestamp: index2().on(t.timestamp)
+    byDecodedReferrer: index3().on(t.decodedReferrer),
+    byTimestamp: index3().on(t.timestamp)
   })
 );
 var internal_registrarActionMetadataType = onchainEnum(
   "_ensindexer_registrar_action_metadata_type",
   ["CURRENT_LOGICAL_REGISTRAR_ACTION"]
 );
-var internal_registrarActionMetadata = onchainTable3(
+var internal_registrarActionMetadata = onchainTable4(
   "_ensindexer_registrar_action_metadata",
   (t) => ({
     /**
@@ -689,7 +835,7 @@ var registrarActionRelations = relations2(registrarActions, ({ one }) => ({
 }));
 
 // src/ensindexer-abstract/subgraph.schema.ts
-import { index as index3, onchainTable as onchainTable4, relations as relations3, sql } from "ponder";
+import { index as index4, onchainTable as onchainTable5, relations as relations3, sql } from "ponder";
 
 // src/lib/collate.ts
 function monkeypatchCollate(col, collation) {
@@ -700,7 +846,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
@@ -770,17 +916,17 @@ var subgraph_domain = onchainTable4(
   }),
   (t) => ({
     // uses a hash index because some name values exceed the btree max row size (8191 bytes)
-    byExactName: index3().using("hash", t.name),
+    byExactName: index4().using("hash", t.name),
     // GIN trigram index for partial-match filters (_contains, _starts_with, _ends_with).
     // (inline `gin_trgm_ops` via `sql` because passing it through `.op()` gets dropped by Ponder,
     // producing `USING gin (name)` with no opclass)
-    byFuzzyName: index3().using("gin", sql`${t.name} gin_trgm_ops`),
-    byLabelhash: index3().on(t.labelhash),
-    byParentId: index3().on(t.parentId),
-    byOwnerId: index3().on(t.ownerId),
-    byRegistrantId: index3().on(t.registrantId),
-    byWrappedOwnerId: index3().on(t.wrappedOwnerId),
-    byResolvedAddressId: index3().on(t.resolvedAddressId)
+    byFuzzyName: index4().using("gin", sql`${t.name} gin_trgm_ops`),
+    byLabelhash: index4().on(t.labelhash),
+    byParentId: index4().on(t.parentId),
+    byOwnerId: index4().on(t.ownerId),
+    byRegistrantId: index4().on(t.registrantId),
+    byWrappedOwnerId: index4().on(t.wrappedOwnerId),
+    byResolvedAddressId: index4().on(t.resolvedAddressId)
   })
 );
 monkeypatchCollate(subgraph_domain.name, '"C"');
@@ -830,7 +976,7 @@ var subgraph_domainRelations = relations3(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 = relations3(subgraph_account, ({ many }) => ({
@@ -838,7 +984,7 @@ var subgraph_accountRelations = relations3(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
@@ -859,7 +1005,7 @@ var subgraph_resolver = onchainTable4(
     coinTypes: t.bigint().array()
   }),
   (t) => ({
-    byDomainId: index3().on(t.domainId)
+    byDomainId: index4().on(t.domainId)
   })
 );
 var subgraph_resolverRelations = relations3(subgraph_resolver, ({ one, many }) => ({
@@ -883,7 +1029,7 @@ var subgraph_resolverRelations = relations3(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
@@ -920,9 +1066,9 @@ var subgraph_registration = onchainTable4(
     labelName: t.text()
   }),
   (t) => ({
-    byDomainId: index3().on(t.domainId),
-    byRegistrationDate: index3().on(t.registrationDate),
-    byExpiryDate: index3().on(t.expiryDate)
+    byDomainId: index4().on(t.domainId),
+    byRegistrationDate: index4().on(t.registrationDate),
+    byExpiryDate: index4().on(t.expiryDate)
   })
 );
 var subgraph_registrationRelations = relations3(subgraph_registration, ({ one, many }) => ({
@@ -939,7 +1085,7 @@ var subgraph_registrationRelations = relations3(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
@@ -971,7 +1117,7 @@ var subgraph_wrappedDomain = onchainTable4(
     name: t.text()
   }),
   (t) => ({
-    byDomainId: index3().on(t.domainId)
+    byDomainId: index4().on(t.domainId)
   })
 );
 var subgraph_wrappedDomainRelations = relations3(subgraph_wrappedDomain, ({ one }) => ({
@@ -995,11 +1141,11 @@ var domainEvent = (t) => ({
 });
 var domainEventIndex = (t) => ({
   // primary reverse lookup
-  idx: index3().on(t.domainId),
+  idx: index4().on(t.domainId),
   // sorting index
-  idx_compound: index3().on(t.domainId, t.id)
+  idx_compound: index4().on(t.domainId, t.id)
 });
-var subgraph_transfer = onchainTable4(
+var subgraph_transfer = onchainTable5(
   "subgraph_transfers",
   (t) => ({
     ...domainEvent(t),
@@ -1007,7 +1153,7 @@ var subgraph_transfer = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_newOwner = onchainTable4(
+var subgraph_newOwner = onchainTable5(
   "subgraph_new_owners",
   (t) => ({
     ...domainEvent(t),
@@ -1016,7 +1162,7 @@ var subgraph_newOwner = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_newResolver = onchainTable4(
+var subgraph_newResolver = onchainTable5(
   "subgraph_new_resolvers",
   (t) => ({
     ...domainEvent(t),
@@ -1024,7 +1170,7 @@ var subgraph_newResolver = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_newTTL = onchainTable4(
+var subgraph_newTTL = onchainTable5(
   "subgraph_new_ttls",
   (t) => ({
     ...domainEvent(t),
@@ -1032,7 +1178,7 @@ var subgraph_newTTL = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_wrappedTransfer = onchainTable4(
+var subgraph_wrappedTransfer = onchainTable5(
   "subgraph_wrapped_transfers",
   (t) => ({
     ...domainEvent(t),
@@ -1040,7 +1186,7 @@ var subgraph_wrappedTransfer = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_nameWrapped = onchainTable4(
+var subgraph_nameWrapped = onchainTable5(
   "subgraph_name_wrapped",
   (t) => ({
     ...domainEvent(t),
@@ -1051,7 +1197,7 @@ var subgraph_nameWrapped = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_nameUnwrapped = onchainTable4(
+var subgraph_nameUnwrapped = onchainTable5(
   "subgraph_name_unwrapped",
   (t) => ({
     ...domainEvent(t),
@@ -1059,7 +1205,7 @@ var subgraph_nameUnwrapped = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_fusesSet = onchainTable4(
+var subgraph_fusesSet = onchainTable5(
   "subgraph_fuses_set",
   (t) => ({
     ...domainEvent(t),
@@ -1067,7 +1213,7 @@ var subgraph_fusesSet = onchainTable4(
   }),
   domainEventIndex
 );
-var subgraph_expiryExtended = onchainTable4(
+var subgraph_expiryExtended = onchainTable5(
   "subgraph_expiry_extended",
   (t) => ({
     ...domainEvent(t),
@@ -1081,11 +1227,11 @@ var registrationEvent = (t) => ({
 });
 var registrationEventIndex = (t) => ({
   // primary reverse lookup
-  idx: index3().on(t.registrationId),
+  idx: index4().on(t.registrationId),
   // sorting index
-  idx_compound: index3().on(t.registrationId, t.id)
+  idx_compound: index4().on(t.registrationId, t.id)
 });
-var subgraph_nameRegistered = onchainTable4(
+var subgraph_nameRegistered = onchainTable5(
   "subgraph_name_registered",
   (t) => ({
     ...registrationEvent(t),
@@ -1094,7 +1240,7 @@ var subgraph_nameRegistered = onchainTable4(
   }),
   registrationEventIndex
 );
-var subgraph_nameRenewed = onchainTable4(
+var subgraph_nameRenewed = onchainTable5(
   "subgraph_name_renewed",
   (t) => ({
     ...registrationEvent(t),
@@ -1102,7 +1248,7 @@ var subgraph_nameRenewed = onchainTable4(
   }),
   registrationEventIndex
 );
-var subgraph_nameTransferred = onchainTable4(
+var subgraph_nameTransferred = onchainTable5(
   "subgraph_name_transferred",
   (t) => ({
     ...registrationEvent(t),
@@ -1116,11 +1262,11 @@ var resolverEvent = (t) => ({
 });
 var resolverEventIndex = (t) => ({
   // primary reverse lookup
-  idx: index3().on(t.resolverId),
+  idx: index4().on(t.resolverId),
   // sorting index
-  idx_compound: index3().on(t.resolverId, t.id)
+  idx_compound: index4().on(t.resolverId, t.id)
 });
-var subgraph_addrChanged = onchainTable4(
+var subgraph_addrChanged = onchainTable5(
   "subgraph_addr_changed",
   (t) => ({
     ...resolverEvent(t),
@@ -1128,7 +1274,7 @@ var subgraph_addrChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_multicoinAddrChanged = onchainTable4(
+var subgraph_multicoinAddrChanged = onchainTable5(
   "subgraph_multicoin_addr_changed",
   (t) => ({
     ...resolverEvent(t),
@@ -1137,7 +1283,7 @@ var subgraph_multicoinAddrChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_nameChanged = onchainTable4(
+var subgraph_nameChanged = onchainTable5(
   "subgraph_name_changed",
   (t) => ({
     ...resolverEvent(t),
@@ -1145,7 +1291,7 @@ var subgraph_nameChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_abiChanged = onchainTable4(
+var subgraph_abiChanged = onchainTable5(
   "subgraph_abi_changed",
   (t) => ({
     ...resolverEvent(t),
@@ -1153,7 +1299,7 @@ var subgraph_abiChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_pubkeyChanged = onchainTable4(
+var subgraph_pubkeyChanged = onchainTable5(
   "subgraph_pubkey_changed",
   (t) => ({
     ...resolverEvent(t),
@@ -1162,7 +1308,7 @@ var subgraph_pubkeyChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_textChanged = onchainTable4(
+var subgraph_textChanged = onchainTable5(
   "subgraph_text_changed",
   (t) => ({
     ...resolverEvent(t),
@@ -1171,7 +1317,7 @@ var subgraph_textChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_contenthashChanged = onchainTable4(
+var subgraph_contenthashChanged = onchainTable5(
   "subgraph_contenthash_changed",
   (t) => ({
     ...resolverEvent(t),
@@ -1179,7 +1325,7 @@ var subgraph_contenthashChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_interfaceChanged = onchainTable4(
+var subgraph_interfaceChanged = onchainTable5(
   "subgraph_interface_changed",
   (t) => ({
     ...resolverEvent(t),
@@ -1188,7 +1334,7 @@ var subgraph_interfaceChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_authorisationChanged = onchainTable4(
+var subgraph_authorisationChanged = onchainTable5(
   "subgraph_authorisation_changed",
   (t) => ({
     ...resolverEvent(t),
@@ -1198,7 +1344,7 @@ var subgraph_authorisationChanged = onchainTable4(
   }),
   resolverEventIndex
 );
-var subgraph_versionChanged = onchainTable4(
+var subgraph_versionChanged = onchainTable5(
   "subgraph_version_changed",
   (t) => ({
     ...resolverEvent(t),
@@ -1392,8 +1538,8 @@ var subgraph_versionChangedRelations = relations3(subgraph_versionChanged, ({ on
 }));
 
 // src/ensindexer-abstract/tokenscope.schema.ts
-import { index as index4, onchainTable as onchainTable5 } from "ponder";
-var nameSales = onchainTable5(
+import { index as index5, onchainTable as onchainTable6 } from "ponder";
+var nameSales = onchainTable6(
   "name_sales",
   (t) => ({
     /**
@@ -1482,14 +1628,14 @@ var nameSales = onchainTable5(
     timestamp: t.bigint().notNull()
   }),
   (t) => ({
-    idx_domainId: index4().on(t.domainId),
-    idx_assetId: index4().on(t.assetId),
-    idx_buyer: index4().on(t.buyer),
-    idx_seller: index4().on(t.seller),
-    idx_timestamp: index4().on(t.timestamp)
+    idx_domainId: index5().on(t.domainId),
+    idx_assetId: index5().on(t.assetId),
+    idx_buyer: index5().on(t.buyer),
+    idx_seller: index5().on(t.seller),
+    idx_timestamp: index5().on(t.timestamp)
   })
 );
-var nameTokens = onchainTable5(
+var nameTokens = onchainTable6(
   "name_tokens",
   (t) => ({
     /**
@@ -1569,14 +1715,14 @@ var nameTokens = onchainTable5(
     mintStatus: t.text().notNull()
   }),
   (t) => ({
-    idx_domainId: index4().on(t.domainId),
-    idx_owner: index4().on(t.owner)
+    idx_domainId: index5().on(t.domainId),
+    idx_owner: index5().on(t.owner)
   })
 );
 
 // src/ensindexer-abstract/unigraph.schema.ts
-import { index as index5, onchainEnum as onchainEnum2, onchainTable as onchainTable6, primaryKey as primaryKey3, relations as relations4, sql as sql2, uniqueIndex as uniqueIndex3 } from "ponder";
-var event = onchainTable6(
+import { index as index6, onchainEnum as onchainEnum2, onchainTable as onchainTable7, primaryKey as primaryKey3, relations as relations4, sql as sql2, uniqueIndex as uniqueIndex3 } from "ponder";
+var event = onchainTable7(
   "events",
   (t) => ({
     // Ponder's event.id
@@ -1606,13 +1752,13 @@ var event = onchainTable6(
     data: t.hex().notNull()
   }),
   (t) => ({
-    bySelector: index5().on(t.selector),
-    byFrom: index5().on(t.from),
-    bySender: index5().on(t.sender),
-    byTimestamp: index5().on(t.timestamp)
+    bySelector: index6().on(t.selector),
+    byFrom: index6().on(t.from),
+    bySender: index6().on(t.sender),
+    byTimestamp: index6().on(t.timestamp)
   })
 );
-var domainEvent2 = onchainTable6(
+var domainEvent2 = onchainTable7(
   "domain_events",
   (t) => ({
     domainId: t.text().notNull().$type(),
@@ -1620,7 +1766,7 @@ var domainEvent2 = onchainTable6(
   }),
   (t) => ({ pk: primaryKey3({ columns: [t.domainId, t.eventId] }) })
 );
-var resolverEvent2 = onchainTable6(
+var resolverEvent2 = onchainTable7(
   "resolver_events",
   (t) => ({
     resolverId: t.text().notNull().$type(),
@@ -1628,7 +1774,7 @@ var resolverEvent2 = onchainTable6(
   }),
   (t) => ({ pk: primaryKey3({ columns: [t.resolverId, t.eventId] }) })
 );
-var permissionsEvent = onchainTable6(
+var permissionsEvent = onchainTable7(
   "permissions_events",
   (t) => ({
     permissionsId: t.text().notNull().$type(),
@@ -1636,7 +1782,7 @@ var permissionsEvent = onchainTable6(
   }),
   (t) => ({ pk: primaryKey3({ columns: [t.permissionsId, t.eventId] }) })
 );
-var permissionsUserEvent = onchainTable6(
+var permissionsUserEvent = onchainTable7(
   "permissions_user_events",
   (t) => ({
     permissionsUserId: t.text().notNull().$type(),
@@ -1644,7 +1790,7 @@ var permissionsUserEvent = onchainTable6(
   }),
   (t) => ({ pk: primaryKey3({ columns: [t.permissionsUserId, t.eventId] }) })
 );
-var account = onchainTable6("accounts", (t) => ({
+var account = onchainTable7("accounts", (t) => ({
   id: t.hex().primaryKey().$type()
 }));
 var account_relations = relations4(account, ({ many }) => ({
@@ -1657,7 +1803,7 @@ var registryType = onchainEnum2("RegistryType", [
   "ENSv1VirtualRegistry",
   "ENSv2Registry"
 ]);
-var registry = onchainTable6(
+var registry = onchainTable7(
   "registries",
   (t) => ({
     // see RegistryId for guarantees
@@ -1683,7 +1829,7 @@ var registry = onchainTable6(
   }),
   (t) => ({
     // NOTE: non-unique index because multiple rows can share (chainId, address) across virtual registries
-    byChainAddress: index5().on(t.chainId, t.address)
+    byChainAddress: index6().on(t.chainId, t.address)
   })
 );
 var relations_registry = relations4(registry, ({ one, many }) => ({
@@ -1710,7 +1856,7 @@ function truncateCanonicalNamePrefix(name) {
   }
   return prefix;
 }
-var domain = onchainTable6(
+var domain = onchainTable7(
   "domains",
   (t) => ({
     // see DomainId for guarantees (ENSv1DomainId: `${ENSv1RegistryId}/${node}`, ENSv2DomainId: CAIP-19)
@@ -1807,31 +1953,31 @@ var domain = onchainTable6(
     // NOTE: Domain-Resolver Relations tracked via Protocol Acceleration plugin
   }),
   (t) => ({
-    byType: index5().on(t.type),
-    bySubregistry: index5().on(t.subregistryId).where(sql2`${t.subregistryId} IS NOT NULL`),
-    byOwner: index5().on(t.ownerId),
-    byLabelHash: index5().on(t.labelHash),
+    byType: index6().on(t.type),
+    bySubregistry: index6().on(t.subregistryId).where(sql2`${t.subregistryId} IS NOT NULL`),
+    byOwner: index6().on(t.ownerId),
+    byLabelHash: index6().on(t.labelHash),
     // Composite for `(registry_id, label_hash)` lookups (namegraph walk in
     // get-domain-by-interpreted-name.ts). The leading `registry_id` column also serves
     // `WHERE registry_id = X` lookups via prefix scan.
-    byRegistryAndLabelHash: index5().on(t.registryId, t.labelHash),
+    byRegistryAndLabelHash: index6().on(t.registryId, t.labelHash),
     // composite for `WHERE registry_id = X ORDER BY __canonical_name_prefix LIMIT N` (Domain.subdomains
     // and other find-domains queries when ordering by NAME). The length-capped prefix keeps the
     // index tuple under btree's per-tuple max (~2712 bytes); 64 code points × max 4-byte UTF-8 =
     // 256 bytes, leaving ample room for the registry_id and id columns.
-    byRegistryAndCanonicalNamePrefix: index5().on(t.registryId, t.__canonicalNamePrefix, t.id),
+    byRegistryAndCanonicalNamePrefix: index6().on(t.registryId, t.__canonicalNamePrefix, t.id),
     // hash index avoids the btree 8191-byte row-size hazard for spam names
-    byCanonicalNameExact: index5().using("hash", t.canonicalName),
+    byCanonicalNameExact: index6().using("hash", t.canonicalName),
     // GIN trigram on the length-capped prefix for left-anchored (`LIKE 'vit%'`) and substring
     // search (inline `gin_trgm_ops` via `sql` because passing it through `.op()` gets dropped by
     // Ponder)
-    byCanonicalNamePrefixFuzzy: index5().using("gin", sql2`${t.__canonicalNamePrefix} gin_trgm_ops`),
+    byCanonicalNamePrefixFuzzy: index6().using("gin", sql2`${t.__canonicalNamePrefix} gin_trgm_ops`),
     // GIN containment for `cascadeLabelHeal`'s `canonical_label_hash_path @> ARRAY[lh]` lookup
-    byCanonicalLabelHashPath: index5().using("gin", t.canonicalLabelHashPath),
+    byCanonicalLabelHashPath: index6().using("gin", t.canonicalLabelHashPath),
     // hash index for resolver-record → canonical-domain joins
-    byCanonicalNode: index5().using("hash", t.canonicalNode),
+    byCanonicalNode: index6().using("hash", t.canonicalNode),
     // btree for ORDER BY canonical_depth (typeahead and DEPTH-ordered browse)
-    byCanonicalDepth: index5().on(t.canonicalDepth),
+    byCanonicalDepth: index6().on(t.canonicalDepth),
     // Composites for `WHERE registry_id = X ORDER BY <latest registration value> LIMIT N`
     // (REGISTRATION_TIMESTAMP / REGISTRATION_EXPIRY ordering in find-domains queries). The latest
     // registration's start/expiry is mirrored onto the Domain row (see `__latestRegistration*`) so
@@ -1839,12 +1985,12 @@ var domain = onchainTable6(
     // `registrations` followed by a sort. The columns are NOT NULL (absent → `REGISTRATION_SORT_SENTINEL`),
     // so a single plain composite per column serves both ASC and DESC (forward / backward scan) with
     // a plain keyset tuple — see find-domains-resolver-helpers.ts.
-    byRegistryAndLatestRegistrationStart: index5().on(
+    byRegistryAndLatestRegistrationStart: index6().on(
       t.registryId,
       t.__latestRegistrationStart,
       t.id
     ),
-    byRegistryAndLatestRegistrationExpiry: index5().on(
+    byRegistryAndLatestRegistrationExpiry: index6().on(
       t.registryId,
       t.__latestRegistrationExpiry,
       t.id
@@ -1887,7 +2033,7 @@ var registrationType = onchainEnum2("RegistrationType", [
   "ENSv2RegistryRegistration",
   "ENSv2RegistryReservation"
 ]);
-var registration = onchainTable6(
+var registration = onchainTable7(
   "registrations",
   (t) => ({
     // keyed by (domainId, registrationIndex)
@@ -1959,7 +2105,7 @@ var registration_relations = relations4(registration, ({ one, many }) => ({
     references: [event.id]
   })
 }));
-var latestRegistrationIndex = onchainTable6("latest_registration_indexes", (t) => ({
+var latestRegistrationIndex = onchainTable7("latest_registration_indexes", (t) => ({
   domainId: t.text().primaryKey().$type(),
   registrationIndex: t.integer().notNull()
 }));
@@ -1970,7 +2116,7 @@ var latestRegistrationIndex_relations = relations4(latestRegistrationIndex, ({ o
     references: [domain.id]
   })
 }));
-var renewal = onchainTable6(
+var renewal = onchainTable7(
   "renewals",
   (t) => ({
     // keyed by (registrationId, index)
@@ -2006,7 +2152,7 @@ var renewal_relations = relations4(renewal, ({ one }) => ({
     references: [event.id]
   })
 }));
-var latestRenewalIndex = onchainTable6(
+var latestRenewalIndex = onchainTable7(
   "latest_renewal_indexes",
   (t) => ({
     domainId: t.text().notNull().$type(),
@@ -2022,7 +2168,7 @@ var latestRenewalIndex_relations = relations4(latestRenewalIndex, ({ one }) => (
     references: [domain.id]
   })
 }));
-var permissions = onchainTable6(
+var permissions = onchainTable7(
   "permissions",
   (t) => ({
     id: t.text().primaryKey().$type(),
@@ -2037,7 +2183,7 @@ var relations_permissions = relations4(permissions, ({ many }) => ({
   resources: many(permissionsResource),
   users: many(permissionsUser)
 }));
-var permissionsResource = onchainTable6(
+var permissionsResource = onchainTable7(
   "permissions_resources",
   (t) => ({
     id: t.text().primaryKey().$type(),
@@ -2055,7 +2201,7 @@ var relations_permissionsResource = relations4(permissionsResource, ({ one }) =>
     references: [permissions.chainId, permissions.address]
   })
 }));
-var permissionsUser = onchainTable6(
+var permissionsUser = onchainTable7(
   "permissions_users",
   (t) => ({
     id: t.text().primaryKey().$type(),
@@ -2089,7 +2235,7 @@ var relations_permissionsUser = relations4(permissionsUser, ({ one }) => ({
     ]
   })
 }));
-var label = onchainTable6(
+var label = onchainTable7(
   "labels",
   (t) => ({
     labelHash: t.hex().primaryKey().$type(),
@@ -2098,10 +2244,10 @@ var label = onchainTable6(
   (t) => ({
     // hash index avoids the btree 8191-byte row-size hazard for spam labels (a single label can
     // exceed btree's leaf-size limit)
-    byInterpretedExact: index5().using("hash", t.interpreted),
+    byInterpretedExact: index6().using("hash", t.interpreted),
     // GIN trigram index for substring / similarity queries (inline `gin_trgm_ops` via `sql`
     // because passing it through `.op()` gets dropped by Ponder)
-    byInterpretedFuzzy: index5().using("gin", sql2`${t.interpreted} gin_trgm_ops`)
+    byInterpretedFuzzy: index6().using("gin", sql2`${t.interpreted} gin_trgm_ops`)
   })
 );
 var label_relations = relations4(label, ({ many }) => ({
@@ -2235,7 +2381,7 @@ var ENSDB_SCHEMA_CHECKSUM = getDrizzleSchemaChecksum({
 });
 
 // src/client/ensdb-reader.ts
-import { and, eq } from "drizzle-orm/sql";
+import { and, eq, sql as sql3 } from "drizzle-orm/sql";
 import {
   buildIndexingMetadataContextUninitialized,
   deserializeIndexingMetadataContext,
@@ -2375,6 +2521,15 @@ var EnsDbReader = class {
       versionInfo
     };
   }
+  /**
+   * Check whether a Postgres schema with the given name exists in the ENSDb instance.
+   */
+  async schemaExists(schemaName) {
+    const result = await this.ensDb.execute(
+      sql3`select 1 as exists from information_schema.schemata where schema_name = ${schemaName} limit 1`
+    );
+    return result.rows.length > 0;
+  }
   /**
    * Get Indexing Metadata Context
    *
@@ -2387,7 +2542,7 @@ var EnsDbReader = class {
     if (!record) {
       return buildIndexingMetadataContextUninitialized();
     }
-    return deserializeIndexingMetadataContext(record);
+    return deserializeIndexingMetadataContext(record.value);
   }
   /**
    * Destroy the ENSDbReader instance by closing the ENSDb connection pool.
@@ -2398,7 +2553,8 @@ var EnsDbReader = class {
   /**
    * Get ENSNode Metadata record
    *
-   * @returns selected record in ENSDb.
+   * @returns the full `{ key, value }` record for the given key under this instance's
+   *          ENSIndexer Schema, or undefined if no such record exists.
    * @throws when more than one matching metadata record is found
    *         (should be impossible given the composite PK constraint on
    *         'ensIndexerSchemaName' and 'key')
@@ -2414,7 +2570,7 @@ var EnsDbReader = class {
       return void 0;
     }
     if (result.length === 1 && result[0]) {
-      return result[0].value;
+      return { key: result[0].key, value: result[0].value };
     }
     throw new Error(
       `There must be exactly one ENSNodeMetadata record for ('${this.ensIndexerSchemaName}', '${metadata2.key}') composite key`
@@ -2450,8 +2606,8 @@ var EnsDbReader = class {
 };
 
 // src/client/ensdb-writer.ts
-import { sql as sql3 } from "drizzle-orm";
 import { migrate } from "drizzle-orm/node-postgres/migrator";
+import { sql as sql4 } from "drizzle-orm/sql";
 import {
   serializeIndexingMetadataContext
 } from "@ensnode/ensnode-sdk";
@@ -2487,30 +2643,50 @@ var EnsDbWriter = class _EnsDbWriter extends EnsDbReader {
    */
   async migrateEnsNodeSchema(migrationsDirPath) {
     await this.drizzleClient.transaction(async (tx) => {
-      await tx.execute(sql3`SELECT pg_advisory_xact_lock(${_EnsDbWriter.MIGRATION_LOCK_ID})`);
+      await tx.execute(sql4`SELECT pg_advisory_xact_lock(${_EnsDbWriter.MIGRATION_LOCK_ID})`);
       await migrate(tx, {
         migrationsFolder: migrationsDirPath,
         migrationsSchema: "ensnode"
       });
     });
   }
+  /**
+   * Drop a Postgres schema (and everything in it) from the ENSDb instance, if it exists.
+   */
+  async dropSchema(schemaName) {
+    await this.ensDb.execute(sql4`drop schema if exists ${sql4.identifier(schemaName)} cascade`);
+  }
+  /**
+   * Rename a Postgres schema within the ENSDb instance.
+   *
+   * The Postgres schema name does not affect Ponder's build_id, so renaming a restored ENSIndexer
+   * schema is safe for resume.
+   */
+  async renameSchema(fromSchemaName, toSchemaName) {
+    await this.ensDb.execute(
+      sql4`alter schema ${sql4.identifier(fromSchemaName)} rename to ${sql4.identifier(toSchemaName)}`
+    );
+  }
   /**
    * Upsert Indexing Metadata Context Initialized
    *
    * @throws when upsert operation failed.
    */
   async upsertIndexingMetadataContext(indexingMetadataContext) {
-    await this.upsertEnsNodeMetadata({
+    await this.writeEnsNodeMetadata({
       key: EnsNodeMetadataKeys.IndexingMetadataContext,
       value: serializeIndexingMetadataContext(indexingMetadataContext)
     });
   }
   /**
-   * Upsert ENSNode metadata
+   * Write (upsert) an ENSNode metadata record under this instance's ENSIndexer Schema.
    *
-   * @throws when upsert operation failed.
+   * Re-keys the record to this writer's {@link ensIndexerSchemaName}, so metadata read from one
+   * ENSIndexer Schema can be written under a different (e.g. renamed) one.
+   *
+   * @throws when the upsert operation failed.
    */
-  async upsertEnsNodeMetadata(metadata2) {
+  async writeEnsNodeMetadata(metadata2) {
     await this.ensDb.insert(this.ensNodeSchema.metadata).values({
       ensIndexerSchemaName: this.ensIndexerSchemaName,
       key: metadata2.key,