@ensnode/ensnode-sdk 1.6.0 → 1.8.0

package/dist/index.cjs

@@ -56,7 +56,6 @@ __export(index_exports, {
   EnsApiIndexingStatusResponseCodes: () => EnsApiIndexingStatusResponseCodes,
   EnsIndexerClient: () => EnsIndexerClient,
   EnsIndexerIndexingStatusResponseCodes: () => EnsIndexerIndexingStatusResponseCodes,
-  EnsNodeMetadataKeys: () => EnsNodeMetadataKeys,
   ForwardResolutionProtocolStep: () => ForwardResolutionProtocolStep,
   IndexingStatusResponseCodes: () => IndexingStatusResponseCodes,
   LINEANAMES_NODE: () => LINEANAMES_NODE,
@@ -170,6 +169,7 @@ __export(index_exports, {
   getENSv2RootRegistryId: () => getENSv2RootRegistryId,
   getEthnamesSubregistryId: () => getEthnamesSubregistryId,
   getEthnamesSubregistryManagedName: () => getEthnamesSubregistryManagedName,
+  getHighestKnownBlockTimestamp: () => getHighestKnownBlockTimestamp,
   getLatestIndexedBlockRef: () => getLatestIndexedBlockRef,
   getLineanamesSubregistryId: () => getLineanamesSubregistryId,
   getLineanamesSubregistryManagedName: () => getLineanamesSubregistryManagedName,
@@ -241,6 +241,8 @@ __export(index_exports, {
   makeSerializedEnsApiPublicConfigSchema: () => makeSerializedEnsApiPublicConfigSchema,
   makeSubdomainNode: () => makeSubdomainNode,
   maybeGetDatasourceContract: () => maybeGetDatasourceContract,
+  maybeGetENSv2RootRegistry: () => maybeGetENSv2RootRegistry,
+  maybeGetENSv2RootRegistryId: () => maybeGetENSv2RootRegistryId,
   mergeBlockNumberRanges: () => mergeBlockNumberRanges,
   nameTokensPrerequisites: () => nameTokensPrerequisites,
   parseAccountId: () => parseAccountId,
@@ -1159,7 +1161,7 @@ var import_v412 = require("zod/v4");
 
 // src/shared/block-ref.ts
 function isBefore(blockA, blockB) {
-  return blockA.number < blockB.number && blockA.timestamp < blockB.timestamp;
+  return blockA.number < blockB.number;
 }
 function isEqualTo(blockA, blockB) {
   return blockA.number === blockB.number && blockA.timestamp === blockB.timestamp;
@@ -1213,18 +1215,29 @@ function mergeBlockNumberRanges(...ranges) {
   }
   let minStartBlock;
   let maxEndBlock;
+  let hasUnboundedStart = false;
+  let hasUnboundedEnd = false;
   for (const range of ranges) {
-    if (range.startBlock !== void 0) {
-      if (minStartBlock === void 0 || range.startBlock < minStartBlock) {
-        minStartBlock = range.startBlock;
-      }
+    if (range.startBlock === void 0) {
+      hasUnboundedStart = true;
+    } else if (minStartBlock === void 0 || range.startBlock < minStartBlock) {
+      minStartBlock = range.startBlock;
     }
-    if (range.endBlock !== void 0) {
-      if (maxEndBlock === void 0 || range.endBlock > maxEndBlock) {
-        maxEndBlock = range.endBlock;
-      }
+    if (range.endBlock === void 0) {
+      hasUnboundedEnd = true;
+    } else if (maxEndBlock === void 0 || range.endBlock > maxEndBlock) {
+      maxEndBlock = range.endBlock;
+    }
+    if (hasUnboundedStart && hasUnboundedEnd) {
+      return buildBlockNumberRange(void 0, void 0);
     }
   }
+  if (hasUnboundedStart) {
+    minStartBlock = void 0;
+  }
+  if (hasUnboundedEnd) {
+    maxEndBlock = void 0;
+  }
   return buildBlockNumberRange(minStartBlock, maxEndBlock);
 }
 function buildBlockRefRange(startBlock, endBlock) {
@@ -1375,12 +1388,31 @@ function getLatestIndexedBlockRef(indexingStatus, chainId) {
   }
   return chainIndexingStatus.latestIndexedBlock;
 }
+function getHighestKnownBlockTimestamp(chains) {
+  if (chains.length === 0) {
+    throw new Error(
+      "Invariant violation: at least one chain is required to determine the highest known block timestamp"
+    );
+  }
+  const startBlockTimestamps = chains.map((chain) => chain.config.startBlock.timestamp);
+  const endBlockTimestamps = chains.map((chain) => chain.config).filter((chainConfig) => chainConfig.rangeType === RangeTypeIds.Bounded).map((chainConfig) => chainConfig.endBlock.timestamp);
+  const backfillEndBlockTimestamps = chains.filter((chain) => chain.chainStatus === ChainIndexingStatusIds.Backfill).map((chain) => chain.backfillEndBlock.timestamp);
+  const latestKnownBlockTimestamps = chains.filter((chain) => chain.chainStatus === ChainIndexingStatusIds.Following).map((chain) => chain.latestKnownBlock.timestamp);
+  return Math.max(
+    ...startBlockTimestamps,
+    ...endBlockTimestamps,
+    ...backfillEndBlockTimestamps,
+    ...latestKnownBlockTimestamps
+  );
+}
 function buildCrossChainIndexingStatusSnapshotOmnichain(omnichainSnapshot, snapshotTime) {
+  const chains = Array.from(omnichainSnapshot.chains.values());
+  const adjustedSnapshotTime = Math.max(snapshotTime, getHighestKnownBlockTimestamp(chains));
   return validateCrossChainIndexingStatusSnapshot({
     strategy: CrossChainIndexingStrategyIds.Omnichain,
     slowestChainIndexingCursor: omnichainSnapshot.omnichainIndexingCursor,
     omnichainSnapshot,
-    snapshotTime
+    snapshotTime: adjustedSnapshotTime
   });
 }
 
@@ -1908,16 +1940,7 @@ function invariant_slowestChainEqualsToOmnichainSnapshotTime(ctx) {
 function invariant_snapshotTimeIsTheHighestKnownBlockTimestamp(ctx) {
   const { snapshotTime, omnichainSnapshot } = ctx.value;
   const chains = Array.from(omnichainSnapshot.chains.values());
-  const startBlockTimestamps = chains.map((chain) => chain.config.startBlock.timestamp);
-  const endBlockTimestamps = chains.map((chain) => chain.config).filter((chainConfig) => chainConfig.rangeType === RangeTypeIds.Bounded).map((chainConfig) => chainConfig.endBlock.timestamp);
-  const backfillEndBlockTimestamps = chains.filter((chain) => chain.chainStatus === ChainIndexingStatusIds.Backfill).map((chain) => chain.backfillEndBlock.timestamp);
-  const latestKnownBlockTimestamps = chains.filter((chain) => chain.chainStatus === ChainIndexingStatusIds.Following).map((chain) => chain.latestKnownBlock.timestamp);
-  const highestKnownBlockTimestamp = Math.max(
-    ...startBlockTimestamps,
-    ...endBlockTimestamps,
-    ...backfillEndBlockTimestamps,
-    ...latestKnownBlockTimestamps
-  );
+  const highestKnownBlockTimestamp = getHighestKnownBlockTimestamp(chains);
   if (snapshotTime < highestKnownBlockTimestamp) {
     ctx.issues.push({
       code: "custom",
@@ -3223,6 +3246,14 @@ var RegistrarActionsFilterTypes = {
   EndTimestamp: "endTimestamp"
 };
 var RegistrarActionsOrders = {
+  /**
+   * Returns registrar actions newest-first.
+   *
+   * Sorts by block timestamp descending. Because each action's identifier encodes
+   * all ordering-relevant onchain properties, this also correctly orders actions
+   * that share the same block timestamp by the chronological order in which they
+   * were executed within the block.
+   */
   LatestRegistrarActions: "orderBy[timestamp]=desc"
 };
 
@@ -3883,13 +3914,6 @@ var EnsApiClient = class _EnsApiClient {
 var ENSNodeClient = class extends EnsApiClient {
 };
 
-// src/ensdb/ensnode-metadata.ts
-var EnsNodeMetadataKeys = {
-  EnsDbVersion: "ensdb_version",
-  EnsIndexerPublicConfig: "ensindexer_public_config",
-  EnsIndexerIndexingStatus: "ensindexer_indexing_status"
-};
-
 // src/ensindexer/api/config/deserialize.ts
 function deserializeEnsIndexerConfigResponse(maybeResponse) {
   return deserializeEnsIndexerPublicConfig(maybeResponse, "EnsIndexerConfigResponse");
@@ -4750,18 +4774,14 @@ var TtlCache = class {
 
 // src/shared/config/indexed-blockranges.ts
 var import_datasources12 = require("@ensnode/datasources");
-function buildIndexedBlockranges(namespace, pluginsRequiredDatasourceNames) {
+function buildIndexedBlockranges(namespace, pluginsDatasourceNames) {
   const indexedBlockranges = /* @__PURE__ */ new Map();
-  for (const [pluginName, requiredDatasourceNames] of pluginsRequiredDatasourceNames) {
-    for (const requiredDatasourceName of requiredDatasourceNames) {
-      const requiredDatasource = (0, import_datasources12.maybeGetDatasource)(namespace, requiredDatasourceName);
-      if (!requiredDatasource) {
-        throw new Error(
-          `Datasource ${requiredDatasourceName} required by plugin ${pluginName} is not defined in namespace ${namespace}.`
-        );
-      }
-      const datasourceChainId = requiredDatasource.chain.id;
-      const datasourceContracts = Object.values(requiredDatasource.contracts);
+  for (const [, datasourceNames] of pluginsDatasourceNames) {
+    for (const datasourceName of datasourceNames) {
+      const datasource = (0, import_datasources12.maybeGetDatasource)(namespace, datasourceName);
+      if (!datasource) continue;
+      const datasourceChainId = datasource.chain.id;
+      const datasourceContracts = Object.values(datasource.contracts);
       for (const datasourceContract of datasourceContracts) {
         const currentChainIndexedBlockrange = indexedBlockranges.get(datasourceChainId);
         const contractIndexedBlockrange = buildBlockNumberRange(
@@ -4908,6 +4928,12 @@ var isENSv1Registry = (namespace, contract) => accountIdEqual(getENSv1Registry(n
 var getENSv2RootRegistry = (namespace) => getDatasourceContract(namespace, import_datasources13.DatasourceNames.ENSv2Root, "RootRegistry");
 var getENSv2RootRegistryId = (namespace) => makeRegistryId(getENSv2RootRegistry(namespace));
 var isENSv2RootRegistry = (namespace, contract) => accountIdEqual(getENSv2RootRegistry(namespace), contract);
+var maybeGetENSv2RootRegistry = (namespace) => maybeGetDatasourceContract(namespace, import_datasources13.DatasourceNames.ENSv2Root, "RootRegistry");
+var maybeGetENSv2RootRegistryId = (namespace) => {
+  const root = maybeGetENSv2RootRegistry(namespace);
+  if (!root) return void 0;
+  return makeRegistryId(root);
+};
 
 // src/shared/url.ts
 function isHttpProtocol(url) {