@ensnode/ensnode-sdk 1.6.0 → 1.8.0

package/dist/index.js

@@ -850,7 +850,7 @@ import { z as z8 } from "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;
@@ -904,18 +904,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) {
@@ -1066,12 +1077,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
   });
 }
 
@@ -1599,16 +1629,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",
@@ -2916,6 +2937,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"
 };
 
@@ -3576,13 +3605,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");
@@ -4457,18 +4479,14 @@ var TtlCache = class {
 import {
   maybeGetDatasource as maybeGetDatasource5
 } from "@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 = maybeGetDatasource5(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 = maybeGetDatasource5(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(
@@ -4615,6 +4633,12 @@ var isENSv1Registry = (namespace, contract) => accountIdEqual(getENSv1Registry(n
 var getENSv2RootRegistry = (namespace) => getDatasourceContract(namespace, DatasourceNames5.ENSv2Root, "RootRegistry");
 var getENSv2RootRegistryId = (namespace) => makeRegistryId(getENSv2RootRegistry(namespace));
 var isENSv2RootRegistry = (namespace, contract) => accountIdEqual(getENSv2RootRegistry(namespace), contract);
+var maybeGetENSv2RootRegistry = (namespace) => maybeGetDatasourceContract(namespace, DatasourceNames5.ENSv2Root, "RootRegistry");
+var maybeGetENSv2RootRegistryId = (namespace) => {
+  const root = maybeGetENSv2RootRegistry(namespace);
+  if (!root) return void 0;
+  return makeRegistryId(root);
+};
 
 // src/shared/url.ts
 function isHttpProtocol(url) {
@@ -4690,7 +4714,6 @@ export {
   EnsApiIndexingStatusResponseCodes,
   EnsIndexerClient,
   EnsIndexerIndexingStatusResponseCodes,
-  EnsNodeMetadataKeys,
   ForwardResolutionProtocolStep,
   IndexingStatusResponseCodes,
   LINEANAMES_NODE,
@@ -4804,6 +4827,7 @@ export {
   getENSv2RootRegistryId,
   getEthnamesSubregistryId,
   getEthnamesSubregistryManagedName,
+  getHighestKnownBlockTimestamp,
   getLatestIndexedBlockRef,
   getLineanamesSubregistryId,
   getLineanamesSubregistryManagedName,
@@ -4875,6 +4899,8 @@ export {
   makeSerializedEnsApiPublicConfigSchema,
   makeSubdomainNode,
   maybeGetDatasourceContract,
+  maybeGetENSv2RootRegistry,
+  maybeGetENSv2RootRegistryId,
   mergeBlockNumberRanges,
   nameTokensPrerequisites,
   parseAccountId,