@ensnode/ensnode-sdk 1.2.0 → 1.3.0

package/dist/index.cjs

@@ -45,6 +45,7 @@ __export(index_exports, {
   DEFAULT_EVM_COIN_TYPE: () => DEFAULT_EVM_COIN_TYPE,
   ENSNamespaceIds: () => import_datasources.ENSNamespaceIds,
   ENSNodeClient: () => ENSNodeClient,
+  ENS_ROOT: () => ENS_ROOT,
   ETH_COIN_TYPE: () => ETH_COIN_TYPE,
   ETH_NODE: () => ETH_NODE,
   ForwardResolutionProtocolStep: () => ForwardResolutionProtocolStep,
@@ -53,6 +54,9 @@ __export(index_exports, {
   LruCache: () => LruCache,
   NFTMintStatuses: () => NFTMintStatuses,
   NFTTransferTypes: () => NFTTransferTypes,
+  NameTokenOwnershipTypes: () => NameTokenOwnershipTypes,
+  NameTokensResponseCodes: () => NameTokensResponseCodes,
+  NameTokensResponseErrorCodes: () => NameTokensResponseErrorCodes,
   OmnichainIndexingStatusIds: () => OmnichainIndexingStatusIds,
   PROTOCOL_ATTRIBUTE_PREFIX: () => PROTOCOL_ATTRIBUTE_PREFIX,
   PluginName: () => PluginName,
@@ -85,6 +89,7 @@ __export(index_exports, {
   buildEnsRainbowClientLabelSet: () => buildEnsRainbowClientLabelSet,
   buildLabelSetId: () => buildLabelSetId,
   buildLabelSetVersion: () => buildLabelSetVersion,
+  buildPageContext: () => buildPageContext,
   buildUnresolvedIdentity: () => buildUnresolvedIdentity,
   checkChainIndexingStatusSnapshotsForOmnichainStatusSnapshotBackfill: () => checkChainIndexingStatusSnapshotsForOmnichainStatusSnapshotBackfill,
   checkChainIndexingStatusSnapshotsForOmnichainStatusSnapshotCompleted: () => checkChainIndexingStatusSnapshotsForOmnichainStatusSnapshotCompleted,
@@ -97,7 +102,7 @@ __export(index_exports, {
   decodeDNSEncodedLiteralName: () => decodeDNSEncodedLiteralName,
   decodeDNSEncodedName: () => decodeDNSEncodedName,
   decodeEncodedReferrer: () => decodeEncodedReferrer,
-  deserializeAccountId: () => deserializeAccountId,
+  deserializeAssetId: () => deserializeAssetId,
   deserializeBlockNumber: () => deserializeBlockNumber,
   deserializeBlockRef: () => deserializeBlockRef,
   deserializeBlockrange: () => deserializeBlockrange,
@@ -118,18 +123,30 @@ __export(index_exports, {
   deserializeRegistrarActionsResponse: () => deserializeRegistrarActionsResponse,
   deserializeUnixTimestamp: () => deserializeUnixTimestamp,
   deserializeUrl: () => deserializeUrl,
+  deserializedNameTokensResponse: () => deserializedNameTokensResponse,
   durationBetween: () => durationBetween,
   encodeLabelHash: () => encodeLabelHash,
   evmChainIdToCoinType: () => evmChainIdToCoinType,
+  formatAccountId: () => formatAccountId,
+  formatAssetId: () => formatAssetId,
   formatNFTTransferEventMetadata: () => formatNFTTransferEventMetadata,
+  getBasenamesSubregistryId: () => getBasenamesSubregistryId,
+  getBasenamesSubregistryManagedName: () => getBasenamesSubregistryManagedName,
   getCurrencyInfo: () => getCurrencyInfo,
+  getDatasourceContract: () => getDatasourceContract,
   getENSRootChainId: () => import_datasources2.getENSRootChainId,
   getEthnamesSubregistryId: () => getEthnamesSubregistryId,
+  getEthnamesSubregistryManagedName: () => getEthnamesSubregistryManagedName,
   getLatestIndexedBlockRef: () => getLatestIndexedBlockRef,
+  getLineanamesSubregistryId: () => getLineanamesSubregistryId,
+  getLineanamesSubregistryManagedName: () => getLineanamesSubregistryManagedName,
   getNFTTransferType: () => getNFTTransferType,
   getNameHierarchy: () => getNameHierarchy,
+  getNameTokenOwnership: () => getNameTokenOwnership,
+  getNameWrapperAccounts: () => getNameWrapperAccounts,
   getOmnichainIndexingCursor: () => getOmnichainIndexingCursor,
   getOmnichainIndexingStatus: () => getOmnichainIndexingStatus,
+  getParentNameFQDN: () => getParentNameFQDN,
   getResolvePrimaryNameChainIdParam: () => getResolvePrimaryNameChainIdParam,
   getTimestampForHighestOmnichainKnownBlock: () => getTimestampForHighestOmnichainKnownBlock,
   getTimestampForLowestOmnichainStartBlock: () => getTimestampForLowestOmnichainStartBlock,
@@ -155,6 +172,10 @@ __export(index_exports, {
   literalLabelsToLiteralName: () => literalLabelsToLiteralName,
   makeENSApiPublicConfigSchema: () => makeENSApiPublicConfigSchema,
   makeSubdomainNode: () => makeSubdomainNode,
+  maybeGetDatasourceContract: () => maybeGetDatasourceContract,
+  nameTokensPrerequisites: () => nameTokensPrerequisites,
+  parseAccountId: () => parseAccountId,
+  parseAssetId: () => parseAssetId,
   parseNonNegativeInteger: () => parseNonNegativeInteger,
   parseReverseName: () => parseReverseName,
   priceDai: () => priceDai,
@@ -163,17 +184,19 @@ __export(index_exports, {
   registrarActionsFilter: () => registrarActionsFilter,
   registrarActionsPrerequisites: () => registrarActionsPrerequisites,
   reverseName: () => reverseName,
-  serializeAccountId: () => serializeAccountId,
   serializeAssetId: () => serializeAssetId,
   serializeChainId: () => serializeChainId,
   serializeChainIndexingSnapshots: () => serializeChainIndexingSnapshots,
   serializeConfigResponse: () => serializeConfigResponse,
   serializeCrossChainIndexingStatusSnapshotOmnichain: () => serializeCrossChainIndexingStatusSnapshotOmnichain,
   serializeDatetime: () => serializeDatetime,
+  serializeDomainAssetId: () => serializeDomainAssetId,
   serializeENSApiPublicConfig: () => serializeENSApiPublicConfig,
   serializeENSIndexerPublicConfig: () => serializeENSIndexerPublicConfig,
   serializeIndexedChainIds: () => serializeIndexedChainIds,
   serializeIndexingStatusResponse: () => serializeIndexingStatusResponse,
+  serializeNameToken: () => serializeNameToken,
+  serializeNameTokensResponse: () => serializeNameTokensResponse,
   serializeNamedRegistrarAction: () => serializeNamedRegistrarAction,
   serializeOmnichainIndexingStatusSnapshot: () => serializeOmnichainIndexingStatusSnapshot,
   serializePrice: () => serializePrice,
@@ -181,11 +204,10 @@ __export(index_exports, {
   serializeRealtimeIndexingStatusProjection: () => serializeRealtimeIndexingStatusProjection,
   serializeReferrerDetailResponse: () => serializeReferrerDetailResponse,
   serializeReferrerLeaderboardPageResponse: () => serializeReferrerLeaderboardPageResponse,
+  serializeRegisteredNameTokens: () => serializeRegisteredNameTokens,
   serializeRegistrarAction: () => serializeRegistrarAction,
   serializeRegistrarActionPricing: () => serializeRegistrarActionPricing,
   serializeRegistrarActionsResponse: () => serializeRegistrarActionsResponse,
-  serializeRegistrationLifecycle: () => serializeRegistrationLifecycle,
-  serializeSubregistry: () => serializeSubregistry,
   serializeUrl: () => serializeUrl,
   sortChainStatusesByStartBlockAsc: () => sortChainStatusesByStartBlockAsc,
   stripNullBytes: () => stripNullBytes,
@@ -205,25 +227,6 @@ var import_v44 = require("zod/v4");
 // src/ensindexer/config/zod-schemas.ts
 var import_v43 = __toESM(require("zod/v4"), 1);
 
-// src/ens/is-normalized.ts
-var import_ens = require("viem/ens");
-function isNormalizedName(name) {
-  try {
-    return name === (0, import_ens.normalize)(name);
-  } catch {
-    return false;
-  }
-}
-function isNormalizedLabel(label) {
-  if (label === "") return false;
-  if (label.includes(".")) return false;
-  try {
-    return label === (0, import_ens.normalize)(label);
-  } catch {
-    return false;
-  }
-}
-
 // src/shared/account-id.ts
 var import_viem = require("viem");
 var accountIdEqual = (a, b) => {
@@ -374,9 +377,39 @@ function isEncodedLabelHash(maybeEncodedLabelHash) {
   return expectedFormatting && includesLabelHash;
 }
 
+// src/ens/is-normalized.ts
+var import_ens = require("viem/ens");
+function isNormalizedName(name) {
+  try {
+    return name === (0, import_ens.normalize)(name);
+  } catch {
+    return false;
+  }
+}
+function isNormalizedLabel(label) {
+  if (label === "") return false;
+  if (label.includes(".")) return false;
+  try {
+    return label === (0, import_ens.normalize)(label);
+  } catch {
+    return false;
+  }
+}
+
 // src/ens/names.ts
 var import_ens_normalize = require("@adraffy/ens-normalize");
+var ENS_ROOT = "";
 var getNameHierarchy = (name) => name.split(".").map((_, i, labels) => labels.slice(i).join("."));
+var getParentNameFQDN = (name) => {
+  if (name === ENS_ROOT) {
+    throw new Error("There is no parent name for ENS Root.");
+  }
+  const labels = name.split(".");
+  if (labels.length === 1) {
+    return ENS_ROOT;
+  }
+  return labels.slice(1).join(".");
+};
 var beautifyName = (name) => {
   const beautifiedLabels = name.split(".").map((label) => {
     if (isNormalizedLabel(label)) {
@@ -619,7 +652,7 @@ var makeAccountIdSchema = (valueLabel = "AccountId") => import_v4.default.strict
   chainId: makeChainIdSchema(`${valueLabel} chain ID`),
   address: makeLowercaseAddressSchema(`${valueLabel} address`)
 });
-var makeSerializedAccountIdSchema = (valueLabel = "Account ID") => import_v4.default.coerce.string().transform((v) => {
+var makeAccountIdStringSchema = (valueLabel = "Account ID String") => import_v4.default.coerce.string().transform((v) => {
   const result = new import_caip.AccountId(v);
   return {
     chainId: Number(result.chainId.reference),
@@ -631,7 +664,7 @@ var makeHexStringSchema = (options, valueLabel = "String representation of bytes
     ctx.issues.push({
       code: "custom",
       input: ctx.value,
-      message: `${valueLabel} must start with '0x'.`
+      message: `${valueLabel} must be a hexadecimal value which starts with '0x'.`
     });
   }
 }).transform((v) => v).check(function invariant_encodesRequiredBytesCount(ctx) {
@@ -741,8 +774,8 @@ ${(0, import_v42.prettifyError)(parsed.error)}
   }
   return parsed.data;
 }
-function deserializeAccountId(maybeAccountId, valueLabel) {
-  const schema = makeSerializedAccountIdSchema(valueLabel);
+function parseAccountId(maybeAccountId, valueLabel) {
+  const schema = makeAccountIdStringSchema(valueLabel);
   const parsed = schema.safeParse(maybeAccountId);
   if (parsed.error) {
     throw new RangeError(`Cannot deserialize AccountId:
@@ -1005,6 +1038,28 @@ var TtlCache = class {
 // src/shared/collections.ts
 var uniq = (arr) => [...new Set(arr)];
 
+// src/shared/datasource-contract.ts
+var import_datasources3 = require("@ensnode/datasources");
+var maybeGetDatasourceContract = (namespaceId, datasourceName, contractName) => {
+  const datasource = (0, import_datasources3.maybeGetDatasource)(namespaceId, datasourceName);
+  if (!datasource) return void 0;
+  const address = datasource.contracts[contractName]?.address;
+  if (address === void 0 || Array.isArray(address)) return void 0;
+  return {
+    chainId: datasource.chain.id,
+    address
+  };
+};
+var getDatasourceContract = (namespaceId, datasourceName, contractName) => {
+  const contract = maybeGetDatasourceContract(namespaceId, datasourceName, contractName);
+  if (!contract) {
+    throw new Error(
+      `Expected contract not found for ${namespaceId} ${datasourceName} ${contractName}`
+    );
+  }
+  return contract;
+};
+
 // src/shared/labelhash.ts
 var import_viem9 = require("viem");
 var labelhashLiteralLabel = (label) => (0, import_viem9.keccak256)((0, import_viem9.stringToBytes)(label));
@@ -1063,7 +1118,7 @@ function serializePrice(price) {
 function serializePriceEth(price) {
   return serializePrice(price);
 }
-function serializeAccountId(accountId) {
+function formatAccountId(accountId) {
   return import_caip2.AccountId.format({
     chainId: { namespace: "eip155", reference: accountId.chainId.toString() },
     address: accountId.address
@@ -1079,7 +1134,7 @@ function isWebSocketProtocol(url) {
 }
 
 // src/ensindexer/config/is-subgraph-compatible.ts
-var import_datasources3 = require("@ensnode/datasources");
+var import_datasources4 = require("@ensnode/datasources");
 
 // src/ensindexer/config/types.ts
 var PluginName = /* @__PURE__ */ ((PluginName2) => {
@@ -1098,7 +1153,7 @@ function isSubgraphCompatible(config) {
   const onlySubgraphPluginActivated = config.plugins.length === 1 && config.plugins[0] === "subgraph" /* Subgraph */;
   const isSubgraphLabelSet = config.labelSet.labelSetId === "subgraph" && config.labelSet.labelSetVersion === 0;
   const isEnsTestEnvLabelSet = config.labelSet.labelSetId === "ens-test-env" && config.labelSet.labelSetVersion === 0;
-  const labelSetIsSubgraphCompatible = isSubgraphLabelSet || config.namespace === import_datasources3.ENSNamespaceIds.EnsTestEnv && isEnsTestEnvLabelSet;
+  const labelSetIsSubgraphCompatible = isSubgraphLabelSet || config.namespace === import_datasources4.ENSNamespaceIds.EnsTestEnv && isEnsTestEnvLabelSet;
   return onlySubgraphPluginActivated && labelSetIsSubgraphCompatible;
 }
 
@@ -2036,263 +2091,859 @@ function serializeConfigResponse(response) {
 }
 
 // src/api/indexing-status/deserialize.ts
-var import_v416 = require("zod/v4");
+var import_v410 = require("zod/v4");
 
 // src/api/indexing-status/zod-schemas.ts
-var import_v415 = __toESM(require("zod/v4"), 1);
-
-// src/api/registrar-actions/zod-schemas.ts
-var import_ens5 = require("viem/ens");
-var import_v410 = __toESM(require("zod/v4"), 1);
-
-// src/api/shared/errors/zod-schemas.ts
 var import_v49 = __toESM(require("zod/v4"), 1);
-var ErrorResponseSchema = import_v49.default.object({
-  message: import_v49.default.string(),
-  details: import_v49.default.optional(import_v49.default.unknown())
-});
 
-// src/api/registrar-actions/response.ts
-var RegistrarActionsResponseCodes = {
+// src/api/indexing-status/response.ts
+var IndexingStatusResponseCodes = {
   /**
-   * Represents that Registrar Actions are available.
+   * Represents that the indexing status is available.
    */
   Ok: "ok",
   /**
-   * Represents that Registrar Actions are unavailable.
+   * Represents that the indexing status is unavailable.
    */
   Error: "error"
 };
 
-// src/api/registrar-actions/zod-schemas.ts
-function invariant_registrationLifecycleNodeMatchesName(ctx) {
-  const { name, action } = ctx.value;
-  const expectedNode = action.registrationLifecycle.node;
-  const actualNode = (0, import_ens5.namehash)(name);
-  if (actualNode !== expectedNode) {
-    ctx.issues.push({
-      code: "custom",
-      input: ctx.value,
-      message: `The 'action.registrationLifecycle.node' must match namehash of 'name'`
-    });
-  }
-}
-var makeNamedRegistrarActionSchema = (valueLabel = "Named Registrar Action") => import_v410.default.object({
-  action: makeRegistrarActionSchema(valueLabel),
-  name: makeReinterpretedNameSchema(valueLabel)
-}).check(invariant_registrationLifecycleNodeMatchesName);
-var makeRegistrarActionsResponseOkSchema = (valueLabel = "Registrar Actions Response OK") => import_v410.default.strictObject({
-  responseCode: import_v410.default.literal(RegistrarActionsResponseCodes.Ok),
-  registrarActions: import_v410.default.array(makeNamedRegistrarActionSchema(valueLabel))
+// src/api/indexing-status/zod-schemas.ts
+var makeIndexingStatusResponseOkSchema = (valueLabel = "Indexing Status Response OK") => import_v49.default.strictObject({
+  responseCode: import_v49.default.literal(IndexingStatusResponseCodes.Ok),
+  realtimeProjection: makeRealtimeIndexingStatusProjectionSchema(valueLabel)
 });
-var makeRegistrarActionsResponseErrorSchema = (_valueLabel = "Registrar Actions Response Error") => import_v410.default.strictObject({
-  responseCode: import_v410.default.literal(RegistrarActionsResponseCodes.Error),
-  error: ErrorResponseSchema
+var makeIndexingStatusResponseErrorSchema = (_valueLabel = "Indexing Status Response Error") => import_v49.default.strictObject({
+  responseCode: import_v49.default.literal(IndexingStatusResponseCodes.Error)
 });
-var makeRegistrarActionsResponseSchema = (valueLabel = "Registrar Actions Response") => import_v410.default.discriminatedUnion("responseCode", [
-  makeRegistrarActionsResponseOkSchema(valueLabel),
-  makeRegistrarActionsResponseErrorSchema(valueLabel)
+var makeIndexingStatusResponseSchema = (valueLabel = "Indexing Status Response") => import_v49.default.discriminatedUnion("responseCode", [
+  makeIndexingStatusResponseOkSchema(valueLabel),
+  makeIndexingStatusResponseErrorSchema(valueLabel)
 ]);
 
-// src/api/shared/pagination/zod-schemas.ts
-var import_v411 = __toESM(require("zod/v4"), 1);
-
-// src/api/shared/pagination/request.ts
-var RECORDS_PER_PAGE_DEFAULT = 10;
-var RECORDS_PER_PAGE_MAX = 100;
-
-// ../ens-referrals/src/address.ts
-var import_viem11 = require("viem");
-
-// ../ens-referrals/src/encoding.ts
-var import_viem12 = require("viem");
-var ENCODED_REFERRER_BYTE_OFFSET = 12;
-var ENCODED_REFERRER_BYTE_LENGTH = 32;
-var EXPECTED_ENCODED_REFERRER_PADDING = (0, import_viem12.pad)("0x", {
-  size: ENCODED_REFERRER_BYTE_OFFSET,
-  dir: "left"
-});
-var ZERO_ENCODED_REFERRER = (0, import_viem12.pad)("0x", {
-  size: ENCODED_REFERRER_BYTE_LENGTH,
-  dir: "left"
-});
-function decodeEncodedReferrer(encodedReferrer) {
-  if ((0, import_viem12.size)(encodedReferrer) !== ENCODED_REFERRER_BYTE_LENGTH) {
-    throw new Error(
-      `Encoded referrer value must be represented by ${ENCODED_REFERRER_BYTE_LENGTH} bytes.`
-    );
-  }
-  const padding = (0, import_viem12.slice)(encodedReferrer, 0, ENCODED_REFERRER_BYTE_OFFSET);
-  if (padding !== EXPECTED_ENCODED_REFERRER_PADDING) {
-    return import_viem12.zeroAddress;
+// src/api/indexing-status/deserialize.ts
+function deserializeIndexingStatusResponse(maybeResponse) {
+  const parsed = makeIndexingStatusResponseSchema().safeParse(maybeResponse);
+  if (parsed.error) {
+    throw new Error(`Cannot deserialize IndexingStatusResponse:
+${(0, import_v410.prettifyError)(parsed.error)}
+`);
   }
-  const decodedReferrer = (0, import_viem12.slice)(encodedReferrer, ENCODED_REFERRER_BYTE_OFFSET);
-  try {
-    return (0, import_viem12.getAddress)(decodedReferrer);
-  } catch {
-    throw new Error(`Decoded referrer value must be a valid EVM address.`);
+  return parsed.data;
+}
+
+// src/api/indexing-status/serialize.ts
+function serializeIndexingStatusResponse(response) {
+  switch (response.responseCode) {
+    case IndexingStatusResponseCodes.Ok:
+      return {
+        responseCode: response.responseCode,
+        realtimeProjection: serializeRealtimeIndexingStatusProjection(response.realtimeProjection)
+      };
+    case IndexingStatusResponseCodes.Error:
+      return response;
   }
 }
 
-// ../ens-referrals/src/leaderboard-page.ts
-var REFERRERS_PER_LEADERBOARD_PAGE_MAX = 100;
+// src/api/name-tokens/deserialize.ts
+var import_v415 = require("zod/v4");
 
-// ../ens-referrals/src/link.ts
+// src/api/name-tokens/zod-schemas.ts
+var import_viem14 = require("viem");
+var import_v414 = __toESM(require("zod/v4"), 1);
+
+// src/tokenscope/assets.ts
+var import_caip4 = require("caip");
 var import_viem13 = require("viem");
+var import_v412 = require("zod/v4");
 
-// ../ens-referrals/src/referrer-detail.ts
-var ReferrerDetailTypeIds = {
+// src/tokenscope/zod-schemas.ts
+var import_caip3 = require("caip");
+var import_viem12 = require("viem");
+var import_v411 = __toESM(require("zod/v4"), 1);
+
+// src/tokenscope/name-token.ts
+var import_viem11 = require("viem");
+var import_datasources5 = require("@ensnode/datasources");
+var NameTokenOwnershipTypes = {
   /**
-   * Represents a referrer who is ranked on the leaderboard.
+   * Name Token is owned by NameWrapper account.
    */
-  Ranked: "ranked",
+  NameWrapper: "namewrapper",
   /**
-   * Represents a referrer who is not ranked on the leaderboard.
+   * Name Token is owned fully onchain.
+   *
+   * This ownership type can only apply to direct subnames of `.eth`
    */
-  Unranked: "unranked"
+  FullyOnchain: "fully-onchain",
+  /**
+   * Name Token ownership has been transferred to the null address.
+   */
+  Burned: "burned",
+  /**
+   * Name Token ownership is unknown.
+   */
+  Unknown: "unknown"
 };
-
-// src/registrars/zod-schemas.ts
-var import_v412 = __toESM(require("zod/v4"), 1);
-
-// src/registrars/subregistry.ts
-function serializeSubregistry(subregistry) {
-  return {
-    subregistryId: serializeAccountId(subregistry.subregistryId),
-    node: subregistry.node
-  };
-}
-
-// src/registrars/registration-lifecycle.ts
-function serializeRegistrationLifecycle(registrationLifecycle) {
+function serializeNameToken(nameToken) {
   return {
-    subregistry: serializeSubregistry(registrationLifecycle.subregistry),
-    node: registrationLifecycle.node,
-    expiresAt: registrationLifecycle.expiresAt
+    token: serializeAssetId(nameToken.token),
+    ownership: nameToken.ownership,
+    mintStatus: nameToken.mintStatus
   };
 }
-
-// src/registrars/registrar-action.ts
-var RegistrarActionTypes = {
-  Registration: "registration",
-  Renewal: "renewal"
-};
-function isRegistrarActionPricingAvailable(registrarActionPricing) {
-  const { baseCost, premium, total } = registrarActionPricing;
-  return baseCost !== null && premium !== null && total !== null;
-}
-function isRegistrarActionReferralAvailable(registrarActionReferral) {
-  const { encodedReferrer, decodedReferrer } = registrarActionReferral;
-  return encodedReferrer !== null && decodedReferrer !== null;
+function getNameWrapperAccounts(namespaceId) {
+  const ethnamesNameWrapperAccount = getDatasourceContract(
+    namespaceId,
+    import_datasources5.DatasourceNames.ENSRoot,
+    "NameWrapper"
+  );
+  const lineanamesNameWrapperAccount = maybeGetDatasourceContract(
+    namespaceId,
+    import_datasources5.DatasourceNames.Lineanames,
+    "NameWrapper"
+  );
+  const nameWrapperAccounts = [
+    // NameWrapper for direct subnames of .eth is defined for all ENS namespaces
+    ethnamesNameWrapperAccount
+  ];
+  if (lineanamesNameWrapperAccount) {
+    nameWrapperAccounts.push(lineanamesNameWrapperAccount);
+  }
+  return nameWrapperAccounts;
 }
-function serializeRegistrarActionPricing(pricing) {
-  if (isRegistrarActionPricingAvailable(pricing)) {
+function getNameTokenOwnership(namespaceId, name, owner) {
+  const nameWrapperAccounts = getNameWrapperAccounts(namespaceId);
+  const hasNameWrapperOwnership = nameWrapperAccounts.some(
+    (nameWrapperAccount) => accountIdEqual(owner, nameWrapperAccount)
+  );
+  if (hasNameWrapperOwnership) {
     return {
-      baseCost: serializePriceEth(pricing.baseCost),
-      premium: serializePriceEth(pricing.premium),
-      total: serializePriceEth(pricing.total)
+      ownershipType: NameTokenOwnershipTypes.NameWrapper,
+      owner
+    };
+  }
+  if ((0, import_viem11.isAddressEqual)(owner.address, import_viem11.zeroAddress)) {
+    return {
+      ownershipType: NameTokenOwnershipTypes.Burned,
+      owner
+    };
+  }
+  const parentName = getParentNameFQDN(name);
+  if (parentName === "eth") {
+    return {
+      ownershipType: NameTokenOwnershipTypes.FullyOnchain,
+      owner
     };
   }
-  return pricing;
-}
-function serializeRegistrarAction(registrarAction) {
   return {
-    id: registrarAction.id,
-    type: registrarAction.type,
-    incrementalDuration: registrarAction.incrementalDuration,
-    registrant: registrarAction.registrant,
-    registrationLifecycle: serializeRegistrationLifecycle(registrarAction.registrationLifecycle),
-    pricing: serializeRegistrarActionPricing(registrarAction.pricing),
-    referral: registrarAction.referral,
-    block: registrarAction.block,
-    transactionHash: registrarAction.transactionHash,
-    eventIds: registrarAction.eventIds
+    ownershipType: NameTokenOwnershipTypes.Unknown,
+    owner
   };
 }
 
-// src/registrars/zod-schemas.ts
-var makeSubregistrySchema = (valueLabel = "Subregistry") => import_v412.default.object({
-  subregistryId: makeSerializedAccountIdSchema(`${valueLabel} Subregistry ID`),
-  node: makeNodeSchema(`${valueLabel} Node`)
-});
-var makeRegistrationLifecycleSchema = (valueLabel = "Registration Lifecycle") => import_v412.default.object({
-  subregistry: makeSubregistrySchema(`${valueLabel} Subregistry`),
-  node: makeNodeSchema(`${valueLabel} Node`),
-  expiresAt: makeUnixTimestampSchema(`${valueLabel} Expires at`)
+// src/tokenscope/zod-schemas.ts
+var makeAssetIdSchema = (valueLabel = "Asset ID Schema") => import_v411.default.object({
+  assetNamespace: import_v411.default.enum(AssetNamespaces),
+  contract: makeAccountIdSchema(valueLabel),
+  tokenId: import_v411.default.preprocess((v) => typeof v === "string" ? BigInt(v) : v, import_v411.default.bigint().positive())
 });
-function invariant_registrarActionPricingTotalIsSumOfBaseCostAndPremium(ctx) {
-  const { baseCost, premium, total } = ctx.value;
-  const actualTotal = addPrices(baseCost, premium);
-  if (!isPriceEqual(actualTotal, total)) {
+var makeAssetIdStringSchema = (valueLabel = "Asset ID String Schema") => import_v411.default.preprocess((v) => {
+  if (typeof v === "string") {
+    const result = new import_caip3.AssetId(v);
+    return {
+      assetNamespace: result.assetName.namespace,
+      contract: {
+        chainId: Number(result.chainId.reference),
+        address: result.assetName.reference
+      },
+      tokenId: result.tokenId
+    };
+  }
+  return v;
+}, makeAssetIdSchema(valueLabel));
+function invariant_nameTokenOwnershipHasNonZeroAddressOwner(ctx) {
+  const ownership = ctx.value;
+  if (ctx.value.owner.address === import_viem12.zeroAddress) {
     ctx.issues.push({
       code: "custom",
       input: ctx.value,
-      message: `'total' must be equal to the sum of 'baseCost' and 'premium'`
+      message: `Name Token Ownership with '${ownership.ownershipType}' must have 'address' other than the zero address.`
     });
   }
 }
-var makeRegistrarActionPricingSchema = (valueLabel = "Registrar Action Pricing") => import_v412.default.union([
-  // pricing available
-  import_v412.default.object({
-    baseCost: makePriceEthSchema(`${valueLabel} Base Cost`),
-    premium: makePriceEthSchema(`${valueLabel} Premium`),
-    total: makePriceEthSchema(`${valueLabel} Total`)
-  }).check(invariant_registrarActionPricingTotalIsSumOfBaseCostAndPremium).transform((v) => v),
-  // pricing unknown
-  import_v412.default.object({
-    baseCost: import_v412.default.null(),
-    premium: import_v412.default.null(),
-    total: import_v412.default.null()
-  }).transform((v) => v)
-]);
-function invariant_registrarActionDecodedReferrerBasedOnRawReferrer(ctx) {
-  const { encodedReferrer, decodedReferrer } = ctx.value;
-  try {
-    const expectedDecodedReferrer = decodeEncodedReferrer(encodedReferrer).toLowerCase();
-    if (decodedReferrer !== expectedDecodedReferrer) {
-      ctx.issues.push({
-        code: "custom",
-        input: ctx.value,
-        message: `'decodedReferrer' must be based on 'encodedReferrer'`
-      });
-    }
-  } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : "Unknown error";
+var makeNameTokenOwnershipNameWrapperSchema = (valueLabel = "Name Token Ownership NameWrapper") => import_v411.default.object({
+  ownershipType: import_v411.default.literal(NameTokenOwnershipTypes.NameWrapper),
+  owner: makeAccountIdSchema(`${valueLabel}.owner`)
+}).check(invariant_nameTokenOwnershipHasNonZeroAddressOwner);
+var makeNameTokenOwnershipFullyOnchainSchema = (valueLabel = "Name Token Ownership Fully Onchain") => import_v411.default.object({
+  ownershipType: import_v411.default.literal(NameTokenOwnershipTypes.FullyOnchain),
+  owner: makeAccountIdSchema(`${valueLabel}.owner`)
+}).check(invariant_nameTokenOwnershipHasNonZeroAddressOwner);
+var makeNameTokenOwnershipBurnedSchema = (valueLabel = "Name Token Ownership Burned") => import_v411.default.object({
+  ownershipType: import_v411.default.literal(NameTokenOwnershipTypes.Burned),
+  owner: makeAccountIdSchema(`${valueLabel}.owner`)
+}).check(invariant_nameTokenOwnershipHasZeroAddressOwner);
+var makeNameTokenOwnershipUnknownSchema = (valueLabel = "Name Token Ownership Unknown") => import_v411.default.object({
+  ownershipType: import_v411.default.literal(NameTokenOwnershipTypes.Unknown),
+  owner: makeAccountIdSchema(`${valueLabel}.owner`)
+}).check(invariant_nameTokenOwnershipHasNonZeroAddressOwner);
+function invariant_nameTokenOwnershipHasZeroAddressOwner(ctx) {
+  const ownership = ctx.value;
+  if (ctx.value.owner.address !== import_viem12.zeroAddress) {
     ctx.issues.push({
       code: "custom",
       input: ctx.value,
-      message: errorMessage
+      message: `Name Token Ownership with '${ownership.ownershipType}' must have 'address' set to the zero address.`
     });
   }
 }
-var makeRegistrarActionReferralSchema = (valueLabel = "Registrar Action Referral") => import_v412.default.union([
-  // referral available
-  import_v412.default.object({
-    encodedReferrer: makeHexStringSchema(
-      { bytesCount: ENCODED_REFERRER_BYTE_LENGTH },
-      `${valueLabel} Encoded Referrer`
-    ),
-    decodedReferrer: makeLowercaseAddressSchema(`${valueLabel} Decoded Referrer`)
-  }).check(invariant_registrarActionDecodedReferrerBasedOnRawReferrer),
-  // referral not applicable
-  import_v412.default.object({
-    encodedReferrer: import_v412.default.null(),
-    decodedReferrer: import_v412.default.null()
-  })
+var makeNameTokenOwnershipSchema = (valueLabel = "Name Token Ownership") => import_v411.default.discriminatedUnion("ownershipType", [
+  makeNameTokenOwnershipNameWrapperSchema(valueLabel),
+  makeNameTokenOwnershipFullyOnchainSchema(valueLabel),
+  makeNameTokenOwnershipBurnedSchema(valueLabel),
+  makeNameTokenOwnershipUnknownSchema(valueLabel)
 ]);
-function invariant_eventIdsInitialElementIsTheActionId(ctx) {
-  const { id, eventIds } = ctx.value;
-  if (eventIds[0] !== id) {
-    ctx.issues.push({
+var makeNameTokenSchema = (valueLabel = "Name Token Schema") => import_v411.default.object({
+  token: makeAssetIdSchema(`${valueLabel}.token`),
+  ownership: makeNameTokenOwnershipSchema(`${valueLabel}.ownership`),
+  mintStatus: import_v411.default.enum(NFTMintStatuses)
+});
+
+// src/tokenscope/assets.ts
+var AssetNamespaces = {
+  ERC721: "erc721",
+  ERC1155: "erc1155"
+};
+function serializeAssetId(assetId) {
+  return {
+    assetNamespace: assetId.assetNamespace,
+    contract: assetId.contract,
+    tokenId: uint256ToHex32(assetId.tokenId)
+  };
+}
+function deserializeAssetId(maybeAssetId, valueLabel) {
+  const schema = makeAssetIdSchema(valueLabel);
+  const parsed = schema.safeParse(maybeAssetId);
+  if (parsed.error) {
+    throw new RangeError(`Cannot deserialize AssetId:
+${(0, import_v412.prettifyError)(parsed.error)}
+`);
+  }
+  return parsed.data;
+}
+function formatAssetId(assetId) {
+  const { assetNamespace, contract, tokenId } = serializeAssetId(assetId);
+  return import_caip4.AssetId.format({
+    chainId: { namespace: "eip155", reference: contract.chainId.toString() },
+    assetName: { namespace: assetNamespace, reference: contract.address },
+    tokenId
+  }).toLowerCase();
+}
+function parseAssetId(maybeAssetId, valueLabel) {
+  const schema = makeAssetIdStringSchema(valueLabel);
+  const parsed = schema.safeParse(maybeAssetId);
+  if (parsed.error) {
+    throw new RangeError(`Cannot parse AssetId:
+${(0, import_v412.prettifyError)(parsed.error)}
+`);
+  }
+  return parsed.data;
+}
+var buildAssetId = (contract, tokenId, assetNamespace) => {
+  return {
+    assetNamespace,
+    contract,
+    tokenId
+  };
+};
+function serializeDomainAssetId(domainAsset) {
+  return {
+    ...serializeAssetId(domainAsset),
+    domainId: domainAsset.domainId
+  };
+}
+var NFTMintStatuses = {
+  Minted: "minted",
+  Burned: "burned"
+};
+var formatNFTTransferEventMetadata = (metadata) => {
+  const serializedAssetId = serializeAssetId(metadata.nft);
+  return [
+    `Event: ${metadata.eventHandlerName}`,
+    `Chain ID: ${metadata.chainId}`,
+    `Block Number: ${metadata.blockNumber}`,
+    `Transaction Hash: ${metadata.transactionHash}`,
+    `NFT: ${serializedAssetId}`
+  ].map((line) => ` - ${line}`).join("\n");
+};
+var NFTTransferTypes = {
+  /**
+   * Initial transfer from zeroAddress to a non-zeroAddress
+   * Can happen at most once to a NFT AssetId
+   *
+   * Invariants:
+   * - NFT is not indexed and therefore has no previous mint status or owner
+   * - new NFT mint status is `minted`
+   * - new NFT owner is a non-zeroAddress
+   */
+  Mint: "mint",
+  /**
+   * Subsequent transfer from zeroAddress to a non-zeroAddress
+   * Can happen any number of times to a NFT AssetId as it passes in a cycle from
+   * mint -> burn -> remint -> burn -> remint -> ...
+   *
+   * Invariants:
+   * - NFT is indexed
+   * - previous NFT mint status was `burned`
+   * - previous NFT owner is the zeroAddress
+   * - new NFT mint status is `minted`
+   * - new NFT owner is a non-zeroAddress
+   */
+  Remint: "remint",
+  /**
+   * Special transfer type for improperly implemented NFT contracts that allow a NFT
+   * that is currently minted to be reminted before an intermediate burn.
+   *
+   * Transfer from zeroAddress to non-zeroAddress for an indexed NFT where the
+   * previously indexed nft had status `minted` with a non-zeroAddress owner.
+   *
+   * Invariants:
+   * - NFT is indexed
+   * - previous NFT mint status was `minted`
+   * - previous NFT owner was a non-zeroAddress
+   * - new NFT mint status is `minted`
+   * - new NFT owner is a non-zeroAddress
+   */
+  MintedRemint: "minted-remint",
+  /**
+   * Transfer from a non-zeroAddress to zeroAddress
+   *
+   * Invariants:
+   * - NFT is indexed
+   * - previous NFT mint status was `minted`
+   * - previous NFT owner is a non-zeroAddress
+   * - new NFT mint status is `burned`
+   * - new NFT owner is the zeroAddress
+   */
+  Burn: "burn",
+  /**
+   * Transfer from a non-zeroAddress to a distinct non-zeroAddress
+   *
+   * Invariants:
+   * - NFT is indexed
+   * - previous and new NFT mint status is `minted`
+   * - previous and new NFT owner are distinct non-zeroAddress
+   */
+  Transfer: "transfer",
+  /**
+   * Transfer from a non-zeroAddress to the same non-zeroAddress
+   *
+   * Invariants:
+   * - NFT is indexed
+   * - previous and new NFT mint status is `minted`
+   * - previous and new NFT owner are equivalent non-zeroAddress
+   */
+  SelfTransfer: "self-transfer",
+  /**
+   * Transfer from zeroAddress to zeroAddress for an indexed NFT
+   *
+   * Invariants:
+   * - NFT is indexed
+   * - previous and new NFT mint status is `burned`
+   * - previous and new NFT owner are zeroAddress
+   */
+  RemintBurn: "remint-burn",
+  /**
+   * Special transfer type for improperly implemented NFT contracts that allow a NFT
+   * that is currently minted to be reminted again before an intermediate burn.
+   *
+   * Transfer from zeroAddress to zeroAddress for an indexed NFT where the
+   * previously indexed nft had status `minted` with a non-zeroAddress owner.
+   *
+   * Invariants:
+   * - NFT is indexed
+   * - previous NFT mint status was `minted`
+   * - previous NFT owner was a non-zeroAddress
+   * - new NFT mint status is `burned`
+   * - new NFT owner is the zeroAddress
+   */
+  MintedRemintBurn: "minted-remint-burn",
+  /**
+   * Transfer from zeroAddress to zeroAddress for an unindexed NFT
+   *
+   * Invariants:
+   * - NFT is not indexed and therefore has no previous mint status or owner
+   * - NFT should remain unindexed and without any mint status or owner
+   */
+  MintBurn: "mint-burn"
+};
+var getNFTTransferType = (from, to, allowMintedRemint, metadata, currentlyIndexedOwner) => {
+  const isIndexed = currentlyIndexedOwner !== void 0;
+  const isIndexedAsMinted = isIndexed && !(0, import_viem13.isAddressEqual)(currentlyIndexedOwner, import_viem13.zeroAddress);
+  const isMint = (0, import_viem13.isAddressEqual)(from, import_viem13.zeroAddress);
+  const isBurn = (0, import_viem13.isAddressEqual)(to, import_viem13.zeroAddress);
+  const isSelfTransfer = (0, import_viem13.isAddressEqual)(from, to);
+  if (isIndexed && !(0, import_viem13.isAddressEqual)(currentlyIndexedOwner, from)) {
+    if (isMint && allowMintedRemint) {
+    } else {
+      throw new Error(
+        `Error: Sending from ${from} conflicts with currently indexed owner ${currentlyIndexedOwner}.
+${formatNFTTransferEventMetadata(metadata)}`
+      );
+    }
+  }
+  if (isSelfTransfer) {
+    if (isMint) {
+      if (!isIndexed) {
+        return NFTTransferTypes.MintBurn;
+      } else if (!isIndexedAsMinted) {
+        return NFTTransferTypes.RemintBurn;
+      } else if (allowMintedRemint) {
+        return NFTTransferTypes.MintedRemintBurn;
+      } else {
+        throw new Error(
+          `Error: Invalid state transition from minted -> remint-burn
+${formatNFTTransferEventMetadata(metadata)}`
+        );
+      }
+    } else {
+      if (!isIndexed) {
+        throw new Error(
+          `Error: Invalid state transition from unindexed -> self-transfer
+${formatNFTTransferEventMetadata(metadata)}`
+        );
+      } else if (!isIndexedAsMinted) {
+        throw new Error(
+          `Error: invalid state transition from burned -> self-transfer
+${formatNFTTransferEventMetadata(metadata)}`
+        );
+      } else {
+        return NFTTransferTypes.SelfTransfer;
+      }
+    }
+  } else if (isMint) {
+    if (!isIndexed) {
+      return NFTTransferTypes.Mint;
+    } else if (!isIndexedAsMinted) {
+      return NFTTransferTypes.Remint;
+    } else if (allowMintedRemint) {
+      return NFTTransferTypes.MintedRemint;
+    } else {
+      throw new Error(
+        `Error: Invalid state transition from minted -> mint
+${formatNFTTransferEventMetadata(metadata)}`
+      );
+    }
+  } else if (isBurn) {
+    if (!isIndexed) {
+      throw new Error(
+        `Error: Invalid state transition from unindexed -> burn
+${formatNFTTransferEventMetadata(metadata)}`
+      );
+    } else if (!isIndexedAsMinted) {
+      throw new Error(
+        `Error: Invalid state transition from burned -> burn
+${formatNFTTransferEventMetadata(metadata)}`
+      );
+    } else {
+      return NFTTransferTypes.Burn;
+    }
+  } else {
+    if (!isIndexed) {
+      throw new Error(
+        `Error: Invalid state transition from unindexed -> transfer
+${formatNFTTransferEventMetadata(metadata)}`
+      );
+    } else if (!isIndexedAsMinted) {
+      throw new Error(
+        `Error: Invalid state transition from burned -> transfer
+${formatNFTTransferEventMetadata(metadata)}`
+      );
+    } else {
+      return NFTTransferTypes.Transfer;
+    }
+  }
+};
+
+// src/api/shared/errors/zod-schemas.ts
+var import_v413 = __toESM(require("zod/v4"), 1);
+var ErrorResponseSchema = import_v413.default.object({
+  message: import_v413.default.string(),
+  details: import_v413.default.optional(import_v413.default.unknown())
+});
+
+// src/api/name-tokens/response.ts
+var NameTokensResponseCodes = {
+  /**
+   * Represents a response when Name Tokens API can respond with requested data.
+   */
+  Ok: "ok",
+  /**
+   * Represents a response when Name Tokens API could not respond with requested data.
+   */
+  Error: "error"
+};
+var NameTokensResponseErrorCodes = {
+  /**
+   * Name tokens not indexed
+   *
+   * Represents an error when tokens for the requested name are not indexed by
+   * the ENSNode instance's configuration.
+   */
+  NameTokensNotIndexed: "name-tokens-not-indexed",
+  /**
+   * Unsupported ENSIndexer Config
+   *
+   * Represents a prerequisites error when connected ENSIndexer config lacks
+   * params required to enable Name Tokens API.
+   */
+  EnsIndexerConfigUnsupported: "unsupported-ensindexer-config",
+  /**
+   * Unsupported Indexing Status
+   *
+   * Represents a prerequisites error when Indexing Status has not yet reached
+   * status required to enable Name Tokens API.
+   */
+  IndexingStatusUnsupported: "unsupported-indexing-status"
+};
+
+// src/api/name-tokens/zod-schemas.ts
+function invariant_nameIsAssociatedWithDomainId(ctx) {
+  const { name, domainId } = ctx.value;
+  if ((0, import_viem14.namehash)(name) !== domainId) {
+    ctx.issues.push({
+      code: "custom",
+      input: ctx.value,
+      message: `'name' must be associated with 'domainId': ${domainId}`
+    });
+  }
+}
+function invariant_nameTokensOwnershipTypeNameWrapperRequiresOwnershipTypeFullyOnchainOrUnknown(ctx) {
+  const { tokens } = ctx.value;
+  const containsOwnershipNameWrapper = tokens.some(
+    (t) => t.ownership.ownershipType === NameTokenOwnershipTypes.NameWrapper
+  );
+  const containsOwnershipFullyOnchainOrUnknown = tokens.some(
+    (t) => t.ownership.ownershipType === NameTokenOwnershipTypes.FullyOnchain || t.ownership.ownershipType === NameTokenOwnershipTypes.Unknown
+  );
+  if (containsOwnershipNameWrapper && !containsOwnershipFullyOnchainOrUnknown) {
+    ctx.issues.push({
+      code: "custom",
+      input: ctx.value,
+      message: `'tokens' must contain name token with ownership type 'fully-onchain' or 'unknown' when name token with ownership type 'namewrapper' in listed`
+    });
+  }
+}
+function invariant_nameTokensContainAtMostOneWithOwnershipTypeEffective(ctx) {
+  const { tokens } = ctx.value;
+  const tokensCountWithOwnershipFullyOnchain = tokens.filter(
+    (t) => t.ownership.ownershipType === NameTokenOwnershipTypes.FullyOnchain
+  ).length;
+  if (tokensCountWithOwnershipFullyOnchain > 1) {
+    ctx.issues.push({
+      code: "custom",
+      input: ctx.value,
+      message: `'tokens' must contain at most one name token with ownership type 'fully-onchain', current count: ${tokensCountWithOwnershipFullyOnchain}`
+    });
+  }
+}
+var makeRegisteredNameTokenSchema = (valueLabel = "Registered Name Token") => import_v414.default.object({
+  domainId: makeNodeSchema(`${valueLabel}.domainId`),
+  name: makeReinterpretedNameSchema(valueLabel),
+  tokens: import_v414.default.array(makeNameTokenSchema(`${valueLabel}.tokens`)).nonempty(),
+  expiresAt: makeUnixTimestampSchema(`${valueLabel}.expiresAt`),
+  accurateAsOf: makeUnixTimestampSchema(`${valueLabel}.accurateAsOf`)
+}).check(invariant_nameIsAssociatedWithDomainId).check(invariant_nameTokensContainAtMostOneWithOwnershipTypeEffective).check(invariant_nameTokensOwnershipTypeNameWrapperRequiresOwnershipTypeFullyOnchainOrUnknown);
+var makeNameTokensResponseOkSchema = (valueLabel = "Name Tokens Response OK") => import_v414.default.strictObject({
+  responseCode: import_v414.default.literal(NameTokensResponseCodes.Ok),
+  registeredNameTokens: makeRegisteredNameTokenSchema(`${valueLabel}.nameTokens`)
+});
+var makeNameTokensResponseErrorNameTokensNotIndexedSchema = (_valueLabel = "Name Tokens Response Error Name Not Indexed") => import_v414.default.strictObject({
+  responseCode: import_v414.default.literal(NameTokensResponseCodes.Error),
+  errorCode: import_v414.default.literal(NameTokensResponseErrorCodes.NameTokensNotIndexed),
+  error: ErrorResponseSchema
+});
+var makeNameTokensResponseErrorEnsIndexerConfigUnsupported = (_valueLabel = "Name Tokens Response Error ENSIndexer Config Unsupported") => import_v414.default.strictObject({
+  responseCode: import_v414.default.literal(NameTokensResponseCodes.Error),
+  errorCode: import_v414.default.literal(NameTokensResponseErrorCodes.EnsIndexerConfigUnsupported),
+  error: ErrorResponseSchema
+});
+var makeNameTokensResponseErrorNameIndexingStatusUnsupported = (_valueLabel = "Name Tokens Response Error Indexing Status Unsupported") => import_v414.default.strictObject({
+  responseCode: import_v414.default.literal(NameTokensResponseCodes.Error),
+  errorCode: import_v414.default.literal(NameTokensResponseErrorCodes.IndexingStatusUnsupported),
+  error: ErrorResponseSchema
+});
+var makeNameTokensResponseErrorSchema = (valueLabel = "Name Tokens Response Error") => import_v414.default.discriminatedUnion("errorCode", [
+  makeNameTokensResponseErrorNameTokensNotIndexedSchema(valueLabel),
+  makeNameTokensResponseErrorEnsIndexerConfigUnsupported(valueLabel),
+  makeNameTokensResponseErrorNameIndexingStatusUnsupported(valueLabel)
+]);
+var makeNameTokensResponseSchema = (valueLabel = "Name Tokens Response") => import_v414.default.discriminatedUnion("responseCode", [
+  makeNameTokensResponseOkSchema(valueLabel),
+  makeNameTokensResponseErrorSchema(valueLabel)
+]);
+
+// src/api/name-tokens/deserialize.ts
+function deserializedNameTokensResponse(maybeResponse) {
+  const parsed = makeNameTokensResponseSchema().safeParse(maybeResponse);
+  if (parsed.error) {
+    throw new Error(`Cannot deserialize NameTokensResponse:
+${(0, import_v415.prettifyError)(parsed.error)}
+`);
+  }
+  return parsed.data;
+}
+
+// src/api/name-tokens/prerequisites.ts
+var nameTokensPrerequisites = Object.freeze({
+  /**
+   * Required plugins to enable Name Tokens API routes.
+   *
+   * 1. `registrars` plugin is required so that data in the `registrationLifecycles`
+   *    table is populated.
+   * 2. `tokenscope` plugin is required so that data in the `nameTokens`
+   *    table is populated.
+   */
+  requiredPlugins: ["registrars" /* Registrars */, "tokenscope" /* TokenScope */],
+  /**
+   * Check if provided ENSApiPublicConfig supports the Name Tokens API.
+   */
+  hasEnsIndexerConfigSupport(config) {
+    return nameTokensPrerequisites.requiredPlugins.every(
+      (plugin) => config.plugins.includes(plugin)
+    );
+  },
+  /**
+   * Required Indexing Status IDs
+   *
+   * Database indexes are created by the time the omnichain indexing status
+   * is either `completed` or `following`.
+   */
+  supportedIndexingStatusIds: [
+    OmnichainIndexingStatusIds.Completed,
+    OmnichainIndexingStatusIds.Following
+  ],
+  /**
+   * Check if provided indexing status supports the Name Tokens API.
+   */
+  hasIndexingStatusSupport(omnichainIndexingStatusId) {
+    return nameTokensPrerequisites.supportedIndexingStatusIds.some(
+      (supportedIndexingStatusId) => supportedIndexingStatusId === omnichainIndexingStatusId
+    );
+  }
+});
+
+// src/api/name-tokens/serialize.ts
+function serializeRegisteredNameTokens({
+  domainId,
+  name,
+  tokens,
+  expiresAt,
+  accurateAsOf
+}) {
+  return {
+    domainId,
+    name,
+    tokens: tokens.map(serializeNameToken),
+    expiresAt,
+    accurateAsOf
+  };
+}
+function serializeNameTokensResponse(response) {
+  switch (response.responseCode) {
+    case NameTokensResponseCodes.Ok:
+      return {
+        responseCode: response.responseCode,
+        registeredNameTokens: serializeRegisteredNameTokens(response.registeredNameTokens)
+      };
+    case NameTokensResponseCodes.Error:
+      return response;
+  }
+}
+
+// src/api/registrar-actions/deserialize.ts
+var import_v419 = require("zod/v4");
+
+// src/api/registrar-actions/zod-schemas.ts
+var import_ens7 = require("viem/ens");
+var import_v418 = __toESM(require("zod/v4"), 1);
+
+// ../ens-referrals/src/address.ts
+var import_viem15 = require("viem");
+
+// ../ens-referrals/src/encoding.ts
+var import_viem16 = require("viem");
+var ENCODED_REFERRER_BYTE_OFFSET = 12;
+var ENCODED_REFERRER_BYTE_LENGTH = 32;
+var EXPECTED_ENCODED_REFERRER_PADDING = (0, import_viem16.pad)("0x", {
+  size: ENCODED_REFERRER_BYTE_OFFSET,
+  dir: "left"
+});
+var ZERO_ENCODED_REFERRER = (0, import_viem16.pad)("0x", {
+  size: ENCODED_REFERRER_BYTE_LENGTH,
+  dir: "left"
+});
+function decodeEncodedReferrer(encodedReferrer) {
+  if ((0, import_viem16.size)(encodedReferrer) !== ENCODED_REFERRER_BYTE_LENGTH) {
+    throw new Error(
+      `Encoded referrer value must be represented by ${ENCODED_REFERRER_BYTE_LENGTH} bytes.`
+    );
+  }
+  const padding = (0, import_viem16.slice)(encodedReferrer, 0, ENCODED_REFERRER_BYTE_OFFSET);
+  if (padding !== EXPECTED_ENCODED_REFERRER_PADDING) {
+    return import_viem16.zeroAddress;
+  }
+  const decodedReferrer = (0, import_viem16.slice)(encodedReferrer, ENCODED_REFERRER_BYTE_OFFSET);
+  try {
+    return (0, import_viem16.getAddress)(decodedReferrer);
+  } catch {
+    throw new Error(`Decoded referrer value must be a valid EVM address.`);
+  }
+}
+
+// ../ens-referrals/src/leaderboard-page.ts
+var REFERRERS_PER_LEADERBOARD_PAGE_MAX = 100;
+
+// ../ens-referrals/src/link.ts
+var import_viem17 = require("viem");
+
+// ../ens-referrals/src/referrer-detail.ts
+var ReferrerDetailTypeIds = {
+  /**
+   * Represents a referrer who is ranked on the leaderboard.
+   */
+  Ranked: "ranked",
+  /**
+   * Represents a referrer who is not ranked on the leaderboard.
+   */
+  Unranked: "unranked"
+};
+
+// src/registrars/zod-schemas.ts
+var import_v416 = __toESM(require("zod/v4"), 1);
+
+// src/registrars/registrar-action.ts
+var RegistrarActionTypes = {
+  Registration: "registration",
+  Renewal: "renewal"
+};
+function isRegistrarActionPricingAvailable(registrarActionPricing) {
+  const { baseCost, premium, total } = registrarActionPricing;
+  return baseCost !== null && premium !== null && total !== null;
+}
+function isRegistrarActionReferralAvailable(registrarActionReferral) {
+  const { encodedReferrer, decodedReferrer } = registrarActionReferral;
+  return encodedReferrer !== null && decodedReferrer !== null;
+}
+function serializeRegistrarActionPricing(pricing) {
+  if (isRegistrarActionPricingAvailable(pricing)) {
+    return {
+      baseCost: serializePriceEth(pricing.baseCost),
+      premium: serializePriceEth(pricing.premium),
+      total: serializePriceEth(pricing.total)
+    };
+  }
+  return pricing;
+}
+function serializeRegistrarAction(registrarAction) {
+  return {
+    id: registrarAction.id,
+    type: registrarAction.type,
+    incrementalDuration: registrarAction.incrementalDuration,
+    registrant: registrarAction.registrant,
+    registrationLifecycle: registrarAction.registrationLifecycle,
+    pricing: serializeRegistrarActionPricing(registrarAction.pricing),
+    referral: registrarAction.referral,
+    block: registrarAction.block,
+    transactionHash: registrarAction.transactionHash,
+    eventIds: registrarAction.eventIds
+  };
+}
+
+// src/registrars/zod-schemas.ts
+var makeSubregistrySchema = (valueLabel = "Subregistry") => import_v416.default.object({
+  subregistryId: makeAccountIdSchema(`${valueLabel} Subregistry ID`),
+  node: makeNodeSchema(`${valueLabel} Node`)
+});
+var makeRegistrationLifecycleSchema = (valueLabel = "Registration Lifecycle") => import_v416.default.object({
+  subregistry: makeSubregistrySchema(`${valueLabel} Subregistry`),
+  node: makeNodeSchema(`${valueLabel} Node`),
+  expiresAt: makeUnixTimestampSchema(`${valueLabel} Expires at`)
+});
+function invariant_registrarActionPricingTotalIsSumOfBaseCostAndPremium(ctx) {
+  const { baseCost, premium, total } = ctx.value;
+  const actualTotal = addPrices(baseCost, premium);
+  if (!isPriceEqual(actualTotal, total)) {
+    ctx.issues.push({
+      code: "custom",
+      input: ctx.value,
+      message: `'total' must be equal to the sum of 'baseCost' and 'premium'`
+    });
+  }
+}
+var makeRegistrarActionPricingSchema = (valueLabel = "Registrar Action Pricing") => import_v416.default.union([
+  // pricing available
+  import_v416.default.object({
+    baseCost: makePriceEthSchema(`${valueLabel} Base Cost`),
+    premium: makePriceEthSchema(`${valueLabel} Premium`),
+    total: makePriceEthSchema(`${valueLabel} Total`)
+  }).check(invariant_registrarActionPricingTotalIsSumOfBaseCostAndPremium).transform((v) => v),
+  // pricing unknown
+  import_v416.default.object({
+    baseCost: import_v416.default.null(),
+    premium: import_v416.default.null(),
+    total: import_v416.default.null()
+  }).transform((v) => v)
+]);
+function invariant_registrarActionDecodedReferrerBasedOnRawReferrer(ctx) {
+  const { encodedReferrer, decodedReferrer } = ctx.value;
+  try {
+    const expectedDecodedReferrer = decodeEncodedReferrer(encodedReferrer).toLowerCase();
+    if (decodedReferrer !== expectedDecodedReferrer) {
+      ctx.issues.push({
+        code: "custom",
+        input: ctx.value,
+        message: `'decodedReferrer' must be based on 'encodedReferrer'`
+      });
+    }
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : "Unknown error";
+    ctx.issues.push({
+      code: "custom",
+      input: ctx.value,
+      message: errorMessage
+    });
+  }
+}
+var makeRegistrarActionReferralSchema = (valueLabel = "Registrar Action Referral") => import_v416.default.union([
+  // referral available
+  import_v416.default.object({
+    encodedReferrer: makeHexStringSchema(
+      { bytesCount: ENCODED_REFERRER_BYTE_LENGTH },
+      `${valueLabel} Encoded Referrer`
+    ),
+    decodedReferrer: makeLowercaseAddressSchema(`${valueLabel} Decoded Referrer`)
+  }).check(invariant_registrarActionDecodedReferrerBasedOnRawReferrer),
+  // referral not applicable
+  import_v416.default.object({
+    encodedReferrer: import_v416.default.null(),
+    decodedReferrer: import_v416.default.null()
+  })
+]);
+function invariant_eventIdsInitialElementIsTheActionId(ctx) {
+  const { id, eventIds } = ctx.value;
+  if (eventIds[0] !== id) {
+    ctx.issues.push({
       code: "custom",
       input: ctx.value,
       message: "The initial element of `eventIds` must be the `id` value"
     });
   }
 }
-var EventIdSchema = import_v412.default.string().nonempty();
-var EventIdsSchema = import_v412.default.array(EventIdSchema).min(1).transform((v) => v);
-var makeBaseRegistrarActionSchema = (valueLabel = "Base Registrar Action") => import_v412.default.object({
+var EventIdSchema = import_v416.default.string().nonempty();
+var EventIdsSchema = import_v416.default.array(EventIdSchema).min(1).transform((v) => v);
+var makeBaseRegistrarActionSchema = (valueLabel = "Base Registrar Action") => import_v416.default.object({
   id: EventIdSchema,
   incrementalDuration: makeDurationSchema(`${valueLabel} Incremental Duration`),
   registrant: makeLowercaseAddressSchema(`${valueLabel} Registrant`),
@@ -2306,151 +2957,135 @@ var makeBaseRegistrarActionSchema = (valueLabel = "Base Registrar Action") => im
   eventIds: EventIdsSchema
 }).check(invariant_eventIdsInitialElementIsTheActionId);
 var makeRegistrarActionRegistrationSchema = (valueLabel = "Registration ") => makeBaseRegistrarActionSchema(valueLabel).extend({
-  type: import_v412.default.literal(RegistrarActionTypes.Registration)
+  type: import_v416.default.literal(RegistrarActionTypes.Registration)
 });
 var makeRegistrarActionRenewalSchema = (valueLabel = "Renewal") => makeBaseRegistrarActionSchema(valueLabel).extend({
-  type: import_v412.default.literal(RegistrarActionTypes.Renewal)
+  type: import_v416.default.literal(RegistrarActionTypes.Renewal)
 });
-var makeRegistrarActionSchema = (valueLabel = "Registrar Action") => import_v412.default.discriminatedUnion("type", [
+var makeRegistrarActionSchema = (valueLabel = "Registrar Action") => import_v416.default.discriminatedUnion("type", [
   makeRegistrarActionRegistrationSchema(`${valueLabel} Registration`),
   makeRegistrarActionRenewalSchema(`${valueLabel} Renewal`)
 ]);
 
-// src/shared/config/build-rpc-urls.ts
-var import_chains = require("viem/chains");
+// src/api/shared/pagination/zod-schemas.ts
+var import_v417 = __toESM(require("zod/v4"), 1);
 
-// src/shared/config/rpc-configs-from-env.ts
-var import_datasources4 = require("@ensnode/datasources");
+// src/api/shared/pagination/request.ts
+var RECORDS_PER_PAGE_DEFAULT = 10;
+var RECORDS_PER_PAGE_MAX = 100;
 
-// src/shared/config/validatons.ts
-var import_datasources5 = require("@ensnode/datasources");
-function invariant_rpcEndpointConfigIncludesAtLeastOneHTTPProtocolURL(ctx) {
-  const endpoints = ctx.value;
-  const httpEndpoints = endpoints.filter(isHttpProtocol);
-  if (httpEndpoints.length < 1) {
+// src/api/shared/pagination/zod-schemas.ts
+var makeRequestPageParamsSchema = (valueLabel = "RequestPageParams") => import_v417.default.object({
+  page: makePositiveIntegerSchema(`${valueLabel}.page`),
+  recordsPerPage: makePositiveIntegerSchema(`${valueLabel}.recordsPerPage`).max(
+    RECORDS_PER_PAGE_MAX,
+    `${valueLabel}.recordsPerPage must not exceed ${RECORDS_PER_PAGE_MAX}`
+  )
+});
+var makeResponsePageContextSchemaWithNoRecords = (valueLabel = "ResponsePageContextWithNoRecords") => import_v417.default.object({
+  totalRecords: import_v417.default.literal(0),
+  totalPages: import_v417.default.literal(1),
+  hasNext: import_v417.default.literal(false),
+  hasPrev: import_v417.default.literal(false),
+  startIndex: import_v417.default.undefined(),
+  endIndex: import_v417.default.undefined()
+}).extend(makeRequestPageParamsSchema(valueLabel).shape);
+function invariant_responsePageWithRecordsIsCorrect(ctx) {
+  const { hasNext, hasPrev, recordsPerPage, page, totalRecords, startIndex, endIndex } = ctx.value;
+  const expectedHasNext = page * recordsPerPage < totalRecords;
+  if (hasNext !== expectedHasNext) {
     ctx.issues.push({
       code: "custom",
-      input: endpoints,
-      message: `RPC endpoint configuration for a chain must include at least one http/https protocol URL.`
+      input: ctx.value,
+      message: `hasNext must be equal to '${expectedHasNext ? "true" : "false"}'`
     });
   }
-}
-function invariant_rpcEndpointConfigIncludesAtMostOneWebSocketsProtocolURL(ctx) {
-  const endpoints = ctx.value;
-  const wsEndpoints = endpoints.filter(isWebSocketProtocol);
-  if (wsEndpoints.length > 1) {
+  const expectedHasPrev = page > 1;
+  if (hasPrev !== expectedHasPrev) {
     ctx.issues.push({
       code: "custom",
-      input: endpoints,
-      message: `RPC endpoint configuration for a chain must include at most one websocket (ws/wss) protocol URL.`
+      input: ctx.value,
+      message: `hasPrev must be equal to '${expectedHasPrev ? "true" : "false"}'`
     });
   }
-}
-
-// src/shared/config/zod-schemas.ts
-var import_v413 = require("zod/v4");
-var import_datasources6 = require("@ensnode/datasources");
-var DatabaseSchemaNameSchema = import_v413.z.string({
-  error: "DATABASE_SCHEMA is required."
-}).trim().min(1, {
-  error: "DATABASE_SCHEMA is required and cannot be an empty string."
-});
-var RpcConfigSchema = import_v413.z.string().transform((val) => val.split(",")).pipe(import_v413.z.array(makeUrlSchema("RPC URL"))).check(invariant_rpcEndpointConfigIncludesAtLeastOneHTTPProtocolURL).check(invariant_rpcEndpointConfigIncludesAtMostOneWebSocketsProtocolURL);
-var RpcConfigsSchema = import_v413.z.record(makeChainIdStringSchema("RPC URL"), RpcConfigSchema, {
-  error: "Chains configuration must be an object mapping valid chain IDs to their configs."
-}).transform((records) => {
-  const rpcConfigs = /* @__PURE__ */ new Map();
-  for (const [chainIdString, rpcConfig] of Object.entries(records)) {
-    const httpRPCs = rpcConfig.filter(isHttpProtocol);
-    const websocketRPC = rpcConfig.find(isWebSocketProtocol);
-    rpcConfigs.set(deserializeChainId(chainIdString), {
-      httpRPCs,
-      websocketRPC
+  if (endIndex < startIndex) {
+    ctx.issues.push({
+      code: "custom",
+      input: ctx.value,
+      message: `endIndex must be greater than or equal to startIndex`
     });
   }
-  return rpcConfigs;
-});
-var EnsIndexerUrlSchema = makeUrlSchema("ENSINDEXER_URL");
-var ENSNamespaceSchema = import_v413.z.enum(import_datasources6.ENSNamespaceIds, {
-  error: ({ input }) => `Invalid NAMESPACE. Got '${input}', but supported ENS namespaces are: ${Object.keys(import_datasources6.ENSNamespaceIds).join(", ")}`
-});
-var PortSchema = import_v413.z.coerce.number({ error: "PORT must be a number." }).min(1, { error: "PORT must be greater than 1." }).max(65535, { error: "PORT must be less than 65535" }).optional();
-var TheGraphApiKeySchema = import_v413.z.string().optional();
-
-// src/shared/datasources-with-resolvers.ts
-var import_datasources7 = require("@ensnode/datasources");
-var DATASOURCE_NAMES_WITH_RESOLVERS = [
-  import_datasources7.DatasourceNames.ENSRoot,
-  import_datasources7.DatasourceNames.Basenames,
-  import_datasources7.DatasourceNames.Lineanames,
-  import_datasources7.DatasourceNames.ThreeDNSOptimism,
-  import_datasources7.DatasourceNames.ThreeDNSBase
-];
-
-// src/shared/log-level.ts
-var import_v414 = require("zod/v4");
-var LogLevelSchema = import_v414.z.enum(["fatal", "error", "warn", "info", "debug", "trace", "silent"]);
-
-// src/shared/protocol-acceleration/interpret-record-values.ts
-var import_viem14 = require("viem");
+  if (endIndex >= totalRecords) {
+    ctx.issues.push({
+      code: "custom",
+      input: ctx.value,
+      message: `endIndex must be lower than totalRecords`
+    });
+  }
+}
+var makeResponsePageContextSchemaWithRecords = (valueLabel = "ResponsePageContextWithRecords") => import_v417.default.object({
+  totalRecords: makePositiveIntegerSchema(`${valueLabel}.totalRecords`),
+  totalPages: makePositiveIntegerSchema(`${valueLabel}.totalPages`),
+  hasNext: import_v417.default.boolean(),
+  hasPrev: import_v417.default.boolean(),
+  startIndex: makeNonNegativeIntegerSchema(`${valueLabel}.startIndex`),
+  endIndex: makeNonNegativeIntegerSchema(`${valueLabel}.endIndex`)
+}).extend(makeRequestPageParamsSchema(valueLabel).shape).check(invariant_responsePageWithRecordsIsCorrect);
+var makeResponsePageContextSchema = (valueLabel = "ResponsePageContext") => import_v417.default.union([
+  makeResponsePageContextSchemaWithNoRecords(valueLabel),
+  makeResponsePageContextSchemaWithRecords(valueLabel)
+]);
 
-// src/api/indexing-status/response.ts
-var IndexingStatusResponseCodes = {
+// src/api/registrar-actions/response.ts
+var RegistrarActionsResponseCodes = {
   /**
-   * Represents that the indexing status is available.
+   * Represents that Registrar Actions are available.
    */
   Ok: "ok",
   /**
-   * Represents that the indexing status is unavailable.
+   * Represents that Registrar Actions are unavailable.
    */
   Error: "error"
 };
 
-// src/api/indexing-status/zod-schemas.ts
-var makeIndexingStatusResponseOkSchema = (valueLabel = "Indexing Status Response OK") => import_v415.default.strictObject({
-  responseCode: import_v415.default.literal(IndexingStatusResponseCodes.Ok),
-  realtimeProjection: makeRealtimeIndexingStatusProjectionSchema(valueLabel)
+// src/api/registrar-actions/zod-schemas.ts
+function invariant_registrationLifecycleNodeMatchesName(ctx) {
+  const { name, action } = ctx.value;
+  const expectedNode = action.registrationLifecycle.node;
+  const actualNode = (0, import_ens7.namehash)(name);
+  if (actualNode !== expectedNode) {
+    ctx.issues.push({
+      code: "custom",
+      input: ctx.value,
+      message: `The 'action.registrationLifecycle.node' must match namehash of 'name'`
+    });
+  }
+}
+var makeNamedRegistrarActionSchema = (valueLabel = "Named Registrar Action") => import_v418.default.object({
+  action: makeRegistrarActionSchema(valueLabel),
+  name: makeReinterpretedNameSchema(valueLabel)
+}).check(invariant_registrationLifecycleNodeMatchesName);
+var makeRegistrarActionsResponseOkSchema = (valueLabel = "Registrar Actions Response OK") => import_v418.default.strictObject({
+  responseCode: import_v418.default.literal(RegistrarActionsResponseCodes.Ok),
+  registrarActions: import_v418.default.array(makeNamedRegistrarActionSchema(valueLabel)),
+  pageContext: makeResponsePageContextSchema(`${valueLabel}.pageContext`)
 });
-var makeIndexingStatusResponseErrorSchema = (_valueLabel = "Indexing Status Response Error") => import_v415.default.strictObject({
-  responseCode: import_v415.default.literal(IndexingStatusResponseCodes.Error)
+var makeRegistrarActionsResponseErrorSchema = (_valueLabel = "Registrar Actions Response Error") => import_v418.default.strictObject({
+  responseCode: import_v418.default.literal(RegistrarActionsResponseCodes.Error),
+  error: ErrorResponseSchema
 });
-var makeIndexingStatusResponseSchema = (valueLabel = "Indexing Status Response") => import_v415.default.discriminatedUnion("responseCode", [
-  makeIndexingStatusResponseOkSchema(valueLabel),
-  makeIndexingStatusResponseErrorSchema(valueLabel)
+var makeRegistrarActionsResponseSchema = (valueLabel = "Registrar Actions Response") => import_v418.default.discriminatedUnion("responseCode", [
+  makeRegistrarActionsResponseOkSchema(valueLabel),
+  makeRegistrarActionsResponseErrorSchema(valueLabel)
 ]);
 
-// src/api/indexing-status/deserialize.ts
-function deserializeIndexingStatusResponse(maybeResponse) {
-  const parsed = makeIndexingStatusResponseSchema().safeParse(maybeResponse);
-  if (parsed.error) {
-    throw new Error(`Cannot deserialize IndexingStatusResponse:
-${(0, import_v416.prettifyError)(parsed.error)}
-`);
-  }
-  return parsed.data;
-}
-
-// src/api/indexing-status/serialize.ts
-function serializeIndexingStatusResponse(response) {
-  switch (response.responseCode) {
-    case IndexingStatusResponseCodes.Ok:
-      return {
-        responseCode: response.responseCode,
-        realtimeProjection: serializeRealtimeIndexingStatusProjection(response.realtimeProjection)
-      };
-    case IndexingStatusResponseCodes.Error:
-      return response;
-  }
-}
-
 // src/api/registrar-actions/deserialize.ts
-var import_v417 = require("zod/v4");
 function deserializeRegistrarActionsResponse(maybeResponse) {
   const parsed = makeRegistrarActionsResponseSchema().safeParse(maybeResponse);
   if (parsed.error) {
     throw new Error(
       `Cannot deserialize RegistrarActionsResponse:
-${(0, import_v417.prettifyError)(parsed.error)}
+${(0, import_v419.prettifyError)(parsed.error)}
 `
     );
   }
@@ -2460,7 +3095,8 @@ ${(0, import_v417.prettifyError)(parsed.error)}
 // src/api/registrar-actions/request.ts
 var RegistrarActionsFilterTypes = {
   BySubregistryNode: "bySubregistryNode",
-  WithEncodedReferral: "withEncodedReferral"
+  WithEncodedReferral: "withEncodedReferral",
+  ByDecodedReferrer: "byDecodedReferrer"
 };
 var RegistrarActionsOrders = {
   LatestRegistrarActions: "orderBy[timestamp]=desc"
@@ -2484,9 +3120,19 @@ function withReferral(withReferral2) {
     filterType: RegistrarActionsFilterTypes.WithEncodedReferral
   };
 }
+function byDecodedReferrer(decodedReferrer) {
+  if (typeof decodedReferrer === "undefined") {
+    return void 0;
+  }
+  return {
+    filterType: RegistrarActionsFilterTypes.ByDecodedReferrer,
+    value: decodedReferrer
+  };
+}
 var registrarActionsFilter = {
   byParentNode,
-  withReferral
+  withReferral,
+  byDecodedReferrer
 };
 
 // src/api/registrar-actions/prerequisites.ts
@@ -2539,12 +3185,68 @@ var registrarActionsPrerequisites = Object.freeze({
   }
 });
 
+// src/registrars/basenames-subregistry.ts
+var import_datasources6 = require("@ensnode/datasources");
+function getBasenamesSubregistryId(namespace) {
+  const datasource = (0, import_datasources6.maybeGetDatasource)(namespace, import_datasources6.DatasourceNames.Basenames);
+  if (!datasource) {
+    throw new Error(`Datasource not found for ${namespace} ${import_datasources6.DatasourceNames.Basenames}`);
+  }
+  const address = datasource.contracts.BaseRegistrar?.address;
+  if (address === void 0 || Array.isArray(address)) {
+    throw new Error(`BaseRegistrar contract not found or has multiple addresses for ${namespace}`);
+  }
+  return {
+    chainId: datasource.chain.id,
+    address
+  };
+}
+function getBasenamesSubregistryManagedName(namespaceId) {
+  switch (namespaceId) {
+    case import_datasources6.ENSNamespaceIds.Mainnet:
+      return "base.eth";
+    case import_datasources6.ENSNamespaceIds.Sepolia:
+      return "basetest.eth";
+    case import_datasources6.ENSNamespaceIds.Holesky:
+    case import_datasources6.ENSNamespaceIds.EnsTestEnv:
+      throw new Error(
+        `No registrar managed name is known for the 'basenames' subregistry within the "${namespaceId}" namespace.`
+      );
+  }
+}
+
 // src/registrars/ethnames-subregistry.ts
-var import_datasources8 = require("@ensnode/datasources");
+var import_datasources7 = require("@ensnode/datasources");
 function getEthnamesSubregistryId(namespace) {
-  const datasource = (0, import_datasources8.maybeGetDatasource)(namespace, import_datasources8.DatasourceNames.ENSRoot);
+  const datasource = (0, import_datasources7.maybeGetDatasource)(namespace, import_datasources7.DatasourceNames.ENSRoot);
+  if (!datasource) {
+    throw new Error(`Datasource not found for ${namespace} ${import_datasources7.DatasourceNames.ENSRoot}`);
+  }
+  const address = datasource.contracts.BaseRegistrar?.address;
+  if (address === void 0 || Array.isArray(address)) {
+    throw new Error(`BaseRegistrar contract not found or has multiple addresses for ${namespace}`);
+  }
+  return {
+    chainId: datasource.chain.id,
+    address
+  };
+}
+function getEthnamesSubregistryManagedName(namespaceId) {
+  switch (namespaceId) {
+    case import_datasources7.ENSNamespaceIds.Mainnet:
+    case import_datasources7.ENSNamespaceIds.Sepolia:
+    case import_datasources7.ENSNamespaceIds.Holesky:
+    case import_datasources7.ENSNamespaceIds.EnsTestEnv:
+      return "eth";
+  }
+}
+
+// src/registrars/lineanames-subregistry.ts
+var import_datasources8 = require("@ensnode/datasources");
+function getLineanamesSubregistryId(namespace) {
+  const datasource = (0, import_datasources8.maybeGetDatasource)(namespace, import_datasources8.DatasourceNames.Lineanames);
   if (!datasource) {
-    throw new Error(`Datasource not found for ${namespace} ${import_datasources8.DatasourceNames.ENSRoot}`);
+    throw new Error(`Datasource not found for ${namespace} ${import_datasources8.DatasourceNames.Lineanames}`);
   }
   const address = datasource.contracts.BaseRegistrar?.address;
   if (address === void 0 || Array.isArray(address)) {
@@ -2555,6 +3257,19 @@ function getEthnamesSubregistryId(namespace) {
     address
   };
 }
+function getLineanamesSubregistryManagedName(namespaceId) {
+  switch (namespaceId) {
+    case import_datasources8.ENSNamespaceIds.Mainnet:
+      return "linea.eth";
+    case import_datasources8.ENSNamespaceIds.Sepolia:
+      return "linea-sepolia.eth";
+    case import_datasources8.ENSNamespaceIds.Holesky:
+    case import_datasources8.ENSNamespaceIds.EnsTestEnv:
+      throw new Error(
+        `No registrar managed name is known for the 'Lineanames' subregistry within the "${namespaceId}" namespace.`
+      );
+  }
+}
 
 // src/api/registrar-actions/serialize.ts
 function serializeNamedRegistrarAction({
@@ -2571,7 +3286,8 @@ function serializeRegistrarActionsResponse(response) {
     case RegistrarActionsResponseCodes.Ok:
       return {
         responseCode: response.responseCode,
-        registrarActions: response.registrarActions.map(serializeNamedRegistrarAction)
+        registrarActions: response.registrarActions.map(serializeNamedRegistrarAction),
+        pageContext: response.pageContext
       };
     case RegistrarActionsResponseCodes.Error:
       return response;
@@ -2579,17 +3295,52 @@ function serializeRegistrarActionsResponse(response) {
 }
 
 // src/api/shared/errors/deserialize.ts
-var import_v418 = require("zod/v4");
+var import_v420 = require("zod/v4");
 function deserializeErrorResponse(maybeErrorResponse) {
   const parsed = ErrorResponseSchema.safeParse(maybeErrorResponse);
   if (parsed.error) {
     throw new Error(`Cannot deserialize ErrorResponse:
-${(0, import_v418.prettifyError)(parsed.error)}
+${(0, import_v420.prettifyError)(parsed.error)}
 `);
   }
   return parsed.data;
 }
 
+// src/api/shared/pagination/build-page-context.ts
+function buildPageContext(page, recordsPerPage, totalRecords) {
+  const totalPages = Math.max(1, Math.ceil(totalRecords / recordsPerPage));
+  if (page > totalPages) {
+    throw new Error(`Invalid page: page ${page} exceeds total pages ${totalPages}.`);
+  }
+  if (totalRecords === 0) {
+    return {
+      page,
+      recordsPerPage,
+      totalRecords: 0,
+      totalPages: 1,
+      hasNext: false,
+      hasPrev: false,
+      startIndex: void 0,
+      endIndex: void 0
+    };
+  }
+  const startIndex = (page - 1) * recordsPerPage;
+  const maxTheoreticalIndexOnPage = startIndex + (recordsPerPage - 1);
+  const endIndex = Math.min(maxTheoreticalIndexOnPage, totalRecords - 1);
+  const hasNext = maxTheoreticalIndexOnPage < totalRecords - 1;
+  const hasPrev = page > 1;
+  return {
+    page,
+    recordsPerPage,
+    totalRecords,
+    totalPages,
+    hasNext,
+    hasPrev,
+    startIndex,
+    endIndex
+  };
+}
+
 // src/client-error.ts
 var ClientError = class _ClientError extends Error {
   details;
@@ -2604,10 +3355,10 @@ var ClientError = class _ClientError extends Error {
 };
 
 // src/ensanalytics/deserialize.ts
-var import_v420 = require("zod/v4");
+var import_v422 = require("zod/v4");
 
 // src/ensanalytics/zod-schemas.ts
-var import_v419 = __toESM(require("zod/v4"), 1);
+var import_v421 = __toESM(require("zod/v4"), 1);
 
 // src/ensanalytics/types.ts
 var ReferrerLeaderboardPageResponseCodes = {
@@ -2632,20 +3383,20 @@ var ReferrerDetailResponseCodes = {
 };
 
 // src/ensanalytics/zod-schemas.ts
-var makeReferralProgramRulesSchema = (valueLabel = "ReferralProgramRules") => import_v419.default.object({
+var makeReferralProgramRulesSchema = (valueLabel = "ReferralProgramRules") => import_v421.default.object({
   totalAwardPoolValue: makeFiniteNonNegativeNumberSchema(`${valueLabel}.totalAwardPoolValue`),
   maxQualifiedReferrers: makeNonNegativeIntegerSchema(`${valueLabel}.maxQualifiedReferrers`),
   startTime: makeUnixTimestampSchema(`${valueLabel}.startTime`),
   endTime: makeUnixTimestampSchema(`${valueLabel}.endTime`),
   subregistryId: makeAccountIdSchema(`${valueLabel}.subregistryId`)
 });
-var makeAwardedReferrerMetricsSchema = (valueLabel = "AwardedReferrerMetrics") => import_v419.default.object({
+var makeAwardedReferrerMetricsSchema = (valueLabel = "AwardedReferrerMetrics") => import_v421.default.object({
   referrer: makeLowercaseAddressSchema(`${valueLabel}.referrer`),
   totalReferrals: makeNonNegativeIntegerSchema(`${valueLabel}.totalReferrals`),
   totalIncrementalDuration: makeDurationSchema(`${valueLabel}.totalIncrementalDuration`),
   score: makeFiniteNonNegativeNumberSchema(`${valueLabel}.score`),
   rank: makePositiveIntegerSchema(`${valueLabel}.rank`),
-  isQualified: import_v419.default.boolean(),
+  isQualified: import_v421.default.boolean(),
   finalScoreBoost: makeFiniteNonNegativeNumberSchema(`${valueLabel}.finalScoreBoost`).max(
     1,
     `${valueLabel}.finalScoreBoost must be <= 1`
@@ -2657,13 +3408,13 @@ var makeAwardedReferrerMetricsSchema = (valueLabel = "AwardedReferrerMetrics") =
   ),
   awardPoolApproxValue: makeFiniteNonNegativeNumberSchema(`${valueLabel}.awardPoolApproxValue`)
 });
-var makeUnrankedReferrerMetricsSchema = (valueLabel = "UnrankedReferrerMetrics") => import_v419.default.object({
+var makeUnrankedReferrerMetricsSchema = (valueLabel = "UnrankedReferrerMetrics") => import_v421.default.object({
   referrer: makeLowercaseAddressSchema(`${valueLabel}.referrer`),
   totalReferrals: makeNonNegativeIntegerSchema(`${valueLabel}.totalReferrals`),
   totalIncrementalDuration: makeDurationSchema(`${valueLabel}.totalIncrementalDuration`),
   score: makeFiniteNonNegativeNumberSchema(`${valueLabel}.score`),
-  rank: import_v419.default.null(),
-  isQualified: import_v419.default.literal(false),
+  rank: import_v421.default.null(),
+  isQualified: import_v421.default.literal(false),
   finalScoreBoost: makeFiniteNonNegativeNumberSchema(`${valueLabel}.finalScoreBoost`).max(
     1,
     `${valueLabel}.finalScoreBoost must be <= 1`
@@ -2675,7 +3426,7 @@ var makeUnrankedReferrerMetricsSchema = (valueLabel = "UnrankedReferrerMetrics")
   ),
   awardPoolApproxValue: makeFiniteNonNegativeNumberSchema(`${valueLabel}.awardPoolApproxValue`)
 });
-var makeAggregatedReferrerMetricsSchema = (valueLabel = "AggregatedReferrerMetrics") => import_v419.default.object({
+var makeAggregatedReferrerMetricsSchema = (valueLabel = "AggregatedReferrerMetrics") => import_v421.default.object({
   grandTotalReferrals: makeNonNegativeIntegerSchema(`${valueLabel}.grandTotalReferrals`),
   grandTotalIncrementalDuration: makeDurationSchema(
     `${valueLabel}.grandTotalIncrementalDuration`
@@ -2687,66 +3438,66 @@ var makeAggregatedReferrerMetricsSchema = (valueLabel = "AggregatedReferrerMetri
     `${valueLabel}.minFinalScoreToQualify`
   )
 });
-var makeReferrerLeaderboardPageContextSchema = (valueLabel = "ReferrerLeaderboardPageContext") => import_v419.default.object({
+var makeReferrerLeaderboardPageContextSchema = (valueLabel = "ReferrerLeaderboardPageContext") => import_v421.default.object({
   page: makePositiveIntegerSchema(`${valueLabel}.page`),
-  itemsPerPage: makePositiveIntegerSchema(`${valueLabel}.itemsPerPage`).max(
+  recordsPerPage: makePositiveIntegerSchema(`${valueLabel}.recordsPerPage`).max(
     REFERRERS_PER_LEADERBOARD_PAGE_MAX,
-    `${valueLabel}.itemsPerPage must not exceed ${REFERRERS_PER_LEADERBOARD_PAGE_MAX}`
+    `${valueLabel}.recordsPerPage must not exceed ${REFERRERS_PER_LEADERBOARD_PAGE_MAX}`
   ),
   totalRecords: makeNonNegativeIntegerSchema(`${valueLabel}.totalRecords`),
   totalPages: makePositiveIntegerSchema(`${valueLabel}.totalPages`),
-  hasNext: import_v419.default.boolean(),
-  hasPrev: import_v419.default.boolean(),
-  startIndex: import_v419.default.optional(makeNonNegativeIntegerSchema(`${valueLabel}.startIndex`)),
-  endIndex: import_v419.default.optional(makeNonNegativeIntegerSchema(`${valueLabel}.endIndex`))
+  hasNext: import_v421.default.boolean(),
+  hasPrev: import_v421.default.boolean(),
+  startIndex: import_v421.default.optional(makeNonNegativeIntegerSchema(`${valueLabel}.startIndex`)),
+  endIndex: import_v421.default.optional(makeNonNegativeIntegerSchema(`${valueLabel}.endIndex`))
 });
-var makeReferrerLeaderboardPageSchema = (valueLabel = "ReferrerLeaderboardPage") => import_v419.default.object({
+var makeReferrerLeaderboardPageSchema = (valueLabel = "ReferrerLeaderboardPage") => import_v421.default.object({
   rules: makeReferralProgramRulesSchema(`${valueLabel}.rules`),
-  referrers: import_v419.default.array(makeAwardedReferrerMetricsSchema(`${valueLabel}.referrers[item]`)),
+  referrers: import_v421.default.array(makeAwardedReferrerMetricsSchema(`${valueLabel}.referrers[record]`)),
   aggregatedMetrics: makeAggregatedReferrerMetricsSchema(`${valueLabel}.aggregatedMetrics`),
-  paginationContext: makeReferrerLeaderboardPageContextSchema(`${valueLabel}.paginationContext`),
+  pageContext: makeReferrerLeaderboardPageContextSchema(`${valueLabel}.pageContext`),
   accurateAsOf: makeUnixTimestampSchema(`${valueLabel}.accurateAsOf`)
 });
-var makeReferrerLeaderboardPageResponseOkSchema = (valueLabel = "ReferrerLeaderboardPageResponseOk") => import_v419.default.object({
-  responseCode: import_v419.default.literal(ReferrerLeaderboardPageResponseCodes.Ok),
+var makeReferrerLeaderboardPageResponseOkSchema = (valueLabel = "ReferrerLeaderboardPageResponseOk") => import_v421.default.object({
+  responseCode: import_v421.default.literal(ReferrerLeaderboardPageResponseCodes.Ok),
   data: makeReferrerLeaderboardPageSchema(`${valueLabel}.data`)
 });
-var makeReferrerLeaderboardPageResponseErrorSchema = (_valueLabel = "ReferrerLeaderboardPageResponseError") => import_v419.default.object({
-  responseCode: import_v419.default.literal(ReferrerLeaderboardPageResponseCodes.Error),
-  error: import_v419.default.string(),
-  errorMessage: import_v419.default.string()
+var makeReferrerLeaderboardPageResponseErrorSchema = (_valueLabel = "ReferrerLeaderboardPageResponseError") => import_v421.default.object({
+  responseCode: import_v421.default.literal(ReferrerLeaderboardPageResponseCodes.Error),
+  error: import_v421.default.string(),
+  errorMessage: import_v421.default.string()
 });
-var makeReferrerLeaderboardPageResponseSchema = (valueLabel = "ReferrerLeaderboardPageResponse") => import_v419.default.union([
+var makeReferrerLeaderboardPageResponseSchema = (valueLabel = "ReferrerLeaderboardPageResponse") => import_v421.default.union([
   makeReferrerLeaderboardPageResponseOkSchema(valueLabel),
   makeReferrerLeaderboardPageResponseErrorSchema(valueLabel)
 ]);
-var makeReferrerDetailRankedSchema = (valueLabel = "ReferrerDetailRanked") => import_v419.default.object({
-  type: import_v419.default.literal(ReferrerDetailTypeIds.Ranked),
+var makeReferrerDetailRankedSchema = (valueLabel = "ReferrerDetailRanked") => import_v421.default.object({
+  type: import_v421.default.literal(ReferrerDetailTypeIds.Ranked),
   rules: makeReferralProgramRulesSchema(`${valueLabel}.rules`),
   referrer: makeAwardedReferrerMetricsSchema(`${valueLabel}.referrer`),
   aggregatedMetrics: makeAggregatedReferrerMetricsSchema(`${valueLabel}.aggregatedMetrics`),
   accurateAsOf: makeUnixTimestampSchema(`${valueLabel}.accurateAsOf`)
 });
-var makeReferrerDetailUnrankedSchema = (valueLabel = "ReferrerDetailUnranked") => import_v419.default.object({
-  type: import_v419.default.literal(ReferrerDetailTypeIds.Unranked),
+var makeReferrerDetailUnrankedSchema = (valueLabel = "ReferrerDetailUnranked") => import_v421.default.object({
+  type: import_v421.default.literal(ReferrerDetailTypeIds.Unranked),
   rules: makeReferralProgramRulesSchema(`${valueLabel}.rules`),
   referrer: makeUnrankedReferrerMetricsSchema(`${valueLabel}.referrer`),
   aggregatedMetrics: makeAggregatedReferrerMetricsSchema(`${valueLabel}.aggregatedMetrics`),
   accurateAsOf: makeUnixTimestampSchema(`${valueLabel}.accurateAsOf`)
 });
-var makeReferrerDetailResponseOkSchema = (valueLabel = "ReferrerDetailResponse") => import_v419.default.object({
-  responseCode: import_v419.default.literal(ReferrerDetailResponseCodes.Ok),
-  data: import_v419.default.union([
+var makeReferrerDetailResponseOkSchema = (valueLabel = "ReferrerDetailResponse") => import_v421.default.object({
+  responseCode: import_v421.default.literal(ReferrerDetailResponseCodes.Ok),
+  data: import_v421.default.union([
     makeReferrerDetailRankedSchema(`${valueLabel}.data`),
     makeReferrerDetailUnrankedSchema(`${valueLabel}.data`)
   ])
 });
-var makeReferrerDetailResponseErrorSchema = (_valueLabel = "ReferrerDetailResponse") => import_v419.default.object({
-  responseCode: import_v419.default.literal(ReferrerDetailResponseCodes.Error),
-  error: import_v419.default.string(),
-  errorMessage: import_v419.default.string()
+var makeReferrerDetailResponseErrorSchema = (_valueLabel = "ReferrerDetailResponse") => import_v421.default.object({
+  responseCode: import_v421.default.literal(ReferrerDetailResponseCodes.Error),
+  error: import_v421.default.string(),
+  errorMessage: import_v421.default.string()
 });
-var makeReferrerDetailResponseSchema = (valueLabel = "ReferrerDetailResponse") => import_v419.default.union([
+var makeReferrerDetailResponseSchema = (valueLabel = "ReferrerDetailResponse") => import_v421.default.union([
   makeReferrerDetailResponseOkSchema(valueLabel),
   makeReferrerDetailResponseErrorSchema(valueLabel)
 ]);
@@ -2758,7 +3509,7 @@ function deserializeReferrerLeaderboardPageResponse(maybeResponse, valueLabel) {
   if (parsed.error) {
     throw new Error(
       `Cannot deserialize SerializedReferrerLeaderboardPageResponse:
-${(0, import_v420.prettifyError)(parsed.error)}
+${(0, import_v422.prettifyError)(parsed.error)}
 `
     );
   }
@@ -2769,7 +3520,7 @@ function deserializeReferrerDetailResponse(maybeResponse, valueLabel) {
   const parsed = schema.safeParse(maybeResponse);
   if (parsed.error) {
     throw new Error(`Cannot deserialize ReferrerDetailResponse:
-${(0, import_v420.prettifyError)(parsed.error)}
+${(0, import_v422.prettifyError)(parsed.error)}
 `);
   }
   return parsed.data;
@@ -3037,7 +3788,7 @@ var ENSNodeClient = class _ENSNodeClient {
    *
    * @param request - Pagination parameters
    * @param request.page - The page number to retrieve (1-indexed, default: 1)
-   * @param request.itemsPerPage - Number of items per page (default: 25, max: 100)
+   * @param request.recordsPerPage - Number of records per page (default: 25, max: 100)
    * @returns {ReferrerLeaderboardPageResponse}
    *
    * @throws if the ENSNode request fails
@@ -3046,28 +3797,28 @@ var ENSNodeClient = class _ENSNodeClient {
    *
    * @example
    * ```typescript
-   * // Get first page with default page size (25 items)
+   * // Get first page with default page size (25 records)
    * const response = await client.getReferrerLeaderboardPage();
    * if (response.responseCode === ReferrerLeaderboardPageResponseCodes.Ok) {
    *   const {
    *     aggregatedMetrics,
    *     referrers,
    *     rules,
-   *     paginationContext,
+   *     pageContext,
    *     updatedAt
    *   } = response.data;
    *   console.log(aggregatedMetrics);
    *   console.log(referrers);
    *   console.log(rules);
    *   console.log(updatedAt);
-   *   console.log(`Page ${paginationContext.page} of ${paginationContext.totalPages}`);
+   *   console.log(`Page ${pageContext.page} of ${pageContext.totalPages}`);
    * }
    * ```
    *
    * @example
    * ```typescript
-   * // Get second page with 50 items per page
-   * const response = await client.getReferrerLeaderboardPage({ page: 2, itemsPerPage: 50 });
+   * // Get second page with 50 records per page
+   * const response = await client.getReferrerLeaderboardPage({ page: 2, recordsPerPage: 50 });
    * ```
    *
    * @example
@@ -3084,8 +3835,8 @@ var ENSNodeClient = class _ENSNodeClient {
   async getReferrerLeaderboardPage(request) {
     const url = new URL(`/ensanalytics/referrers`, this.options.url);
     if (request?.page) url.searchParams.set("page", request.page.toString());
-    if (request?.itemsPerPage)
-      url.searchParams.set("itemsPerPage", request.itemsPerPage.toString());
+    if (request?.recordsPerPage)
+      url.searchParams.set("recordsPerPage", request.recordsPerPage.toString());
     const response = await fetch(url);
     let responseData;
     try {
@@ -3190,11 +3941,13 @@ var ENSNodeClient = class _ENSNodeClient {
   /**
    * Fetch ENSNode Registrar Actions
    *
-   * @param {RegistrarActionsRequestFilter} request.filter is
-   *        an optional request filter configuration.
-   * @param {number} request.limit sets the maximum count of results in the response.
-   * @param {RegistrarActionsRequestOrder} request.order sets the order of
-   *        results in the response by field and direction.
+   * Retrieves a paginated list of registrar actions with optional filters.
+   *
+   * @param request is a request configuration.
+   * @param request.page sets the page number to retrieve (1-indexed, default: 1)
+   * @param request.recordsPerPage sets the number of records per page (default: 10, max: 100)
+   * @param request.filters is an optional request filter configuration.
+   * @param request.order sets the order of results in the response by field and direction.
    * @returns {RegistrarActionsResponse}
    *
    * @throws if the ENSNode request fails
@@ -3204,23 +3957,25 @@ var ENSNodeClient = class _ENSNodeClient {
    * @example
    * ```ts
    * import {
-   *   registrarActionsFilter,,
+   *   registrarActionsFilter,
    *   ENSNodeClient,
    * } from "@ensnode/ensnode-sdk";
    * import { namehash } from "viem/ens";
    *
    * const client: ENSNodeClient;
    *
-   * // get latest registrar action records across all indexed subregistries
-   * // NOTE: when no `limit` value is passed,
-   * //       the default RESPONSE_ITEMS_PER_PAGE_DEFAULT applies.
-   * const registrarActions = await client.registrarActions();
+   * // Get first page with default page size (10 records)
+   * const response = await client.registrarActions();
+   * if (response.responseCode === RegistrarActionsResponseCodes.Ok) {
+   *   const { registrarActions, pageContext } = response;
+   *   console.log(registrarActions);
+   *   console.log(`Page ${pageContext.page} of ${pageContext.totalPages}`);
+   * }
    *
-   * // get latest 5 registrar action records across all indexed subregistries
-   * // NOTE: when a `limit` value is passed, it must be lower than or equal to
-   * //       the RESPONSE_ITEMS_PER_PAGE_MAX value.
-   * const registrarActions = await client.registrarActions({
-   *   limit: 5,
+   * // Get second page with 25 records per page
+   * const response = await client.registrarActions({
+   *   page: 2,
+   *   recordsPerPage: 25,
    * });
    *
    * // get latest registrar action records associated with
@@ -3234,49 +3989,123 @@ var ENSNodeClient = class _ENSNodeClient {
    *   filters: [registrarActionsFilter.withReferral(true)],
    * });
    *
+   * // get latest registrar action records for a specific decoded referrer
+   * await client.registrarActions({
+   *   filters: [registrarActionsFilter.byDecodedReferrer("0x1234567890123456789012345678901234567890")],
+   * });
+   *
    * // get latest 10 registrar action records associated with
    * // subregistry managing `base.eth` name
    * await client.registrarActions({
    *   filters: [registrarActionsFilter.byParentNode(namehash('base.eth'))],
-   *   limit: 10
+   *   recordsPerPage: 10
+   * });
+   * ```
+   */
+  async registrarActions(request = {}) {
+    const buildUrlPath = (filters) => {
+      const bySubregistryNodeFilter = filters?.find(
+        (f) => f.filterType === RegistrarActionsFilterTypes.BySubregistryNode
+      );
+      return bySubregistryNodeFilter ? new URL(`/api/registrar-actions/${bySubregistryNodeFilter.value}`, this.options.url) : new URL(`/api/registrar-actions`, this.options.url);
+    };
+    const buildWithReferralArg = (filters) => {
+      const withReferralFilter = filters?.find(
+        (f) => f.filterType === RegistrarActionsFilterTypes.WithEncodedReferral
+      );
+      return withReferralFilter ? { key: "withReferral", value: "true" } : null;
+    };
+    const buildDecodedReferrerArg = (filters) => {
+      const decodedReferrerFilter = filters?.find(
+        (f) => f.filterType === RegistrarActionsFilterTypes.ByDecodedReferrer
+      );
+      return decodedReferrerFilter ? { key: "decodedReferrer", value: decodedReferrerFilter.value } : null;
+    };
+    const buildOrderArg = (order) => {
+      switch (order) {
+        case RegistrarActionsOrders.LatestRegistrarActions: {
+          const [field, direction] = order.split("=");
+          return {
+            key: `sort[${field}]`,
+            value: `${direction}`
+          };
+        }
+      }
+    };
+    const url = buildUrlPath(request.filters);
+    if (request.order) {
+      const orderArgs = buildOrderArg(request.order);
+      url.searchParams.set(orderArgs.key, orderArgs.value);
+    }
+    if (request.page) {
+      url.searchParams.set("page", request.page.toString());
+    }
+    if (request.recordsPerPage) {
+      url.searchParams.set("recordsPerPage", request.recordsPerPage.toString());
+    }
+    const referralArg = buildWithReferralArg(request.filters);
+    if (referralArg) {
+      url.searchParams.set(referralArg.key, referralArg.value);
+    }
+    const decodedReferrerArg = buildDecodedReferrerArg(request.filters);
+    if (decodedReferrerArg) {
+      url.searchParams.set(decodedReferrerArg.key, decodedReferrerArg.value);
+    }
+    const response = await fetch(url);
+    let responseData;
+    try {
+      responseData = await response.json();
+    } catch {
+      throw new Error("Malformed response data: invalid JSON");
+    }
+    if (!response.ok) {
+      let errorResponse;
+      try {
+        errorResponse = deserializeErrorResponse(responseData);
+      } catch {
+        console.log("Registrar Actions API: handling a known server error.");
+      }
+      if (typeof errorResponse !== "undefined") {
+        throw new Error(`Fetching ENSNode Registrar Actions Failed: ${errorResponse.message}`);
+      }
+    }
+    return deserializeRegistrarActionsResponse(responseData);
+  }
+  /**
+   * Fetch Name Tokens for requested name.
+   *
+   * @param request.name - Name for which Name Tokens will be fetched.
+   * @returns {NameTokensResponse}
+   *
+   * @throws if the ENSNode request fails
+   * @throws if the ENSNode API returns an error response
+   * @throws if the ENSNode response breaks required invariants
+   *
+   * @example
+   * ```ts
+   * import {
+   *   ENSNodeClient,
+   * } from "@ensnode/ensnode-sdk";
+   * import { namehash } from "viem/ens";
+   *
+   * const client: ENSNodeClient;
+   *
+   * // get latest name token records from the indexed subregistry based on the requested name
+   * const response = await client.nameTokens({
+   *   name: "vitalik.eth"
    * });
+   *
+   * const response = await client.nameTokens({
+   *   domainId: "0xee6c4522aab0003e8d14cd40a6af439055fd2577951148c14b6cea9a53475835" // namehash('vitalik.eth')
+   * })
    * ```
    */
-  async registrarActions(request = {}) {
-    const buildUrlPath = (filters) => {
-      const bySubregistryNodeFilter = filters?.find(
-        (f) => f.filterType === RegistrarActionsFilterTypes.BySubregistryNode
-      );
-      return bySubregistryNodeFilter ? new URL(`/api/registrar-actions/${bySubregistryNodeFilter.value}`, this.options.url) : new URL(`/api/registrar-actions`, this.options.url);
-    };
-    const buildWithReferralArg = (filters) => {
-      const withReferralFilter = filters?.find(
-        (f) => f.filterType === RegistrarActionsFilterTypes.WithEncodedReferral
-      );
-      return withReferralFilter ? { key: "withReferral", value: "true" } : null;
-    };
-    const buildOrderArg = (order) => {
-      switch (order) {
-        case RegistrarActionsOrders.LatestRegistrarActions: {
-          const [field, direction] = order.split("=");
-          return {
-            key: `sort[${field}]`,
-            value: `${direction}`
-          };
-        }
-      }
-    };
-    const url = buildUrlPath(request.filters);
-    if (request.order) {
-      const orderArgs = buildOrderArg(request.order);
-      url.searchParams.set(orderArgs.key, orderArgs.value);
-    }
-    if (request.itemsPerPage) {
-      url.searchParams.set("itemsPerPage", request.itemsPerPage.toString());
-    }
-    const referralArg = buildWithReferralArg(request.filters);
-    if (referralArg) {
-      url.searchParams.set(referralArg.key, referralArg.value);
+  async nameTokens(request) {
+    const url = new URL(`/api/name-tokens`, this.options.url);
+    if (request.name !== void 0) {
+      url.searchParams.set("name", request.name);
+    } else {
+      url.searchParams.set("domainId", request.domainId);
     }
     const response = await fetch(url);
     let responseData;
@@ -3290,13 +4119,13 @@ var ENSNodeClient = class _ENSNodeClient {
       try {
         errorResponse = deserializeErrorResponse(responseData);
       } catch {
-        console.log("Registrar Actions API: handling a known server error.");
+        console.log("Name Tokens API: handling a known server error.");
       }
       if (typeof errorResponse !== "undefined") {
-        throw new Error(`Fetching ENSNode Registrar Actions Failed: ${errorResponse.message}`);
+        throw new Error(`Fetching ENSNode Name Tokens Failed: ${errorResponse.message}`);
       }
     }
-    return deserializeRegistrarActionsResponse(responseData);
+    return deserializedNameTokensResponse(responseData);
   }
 };
 
@@ -3337,11 +4166,11 @@ function isResolvedIdentity(identity) {
 }
 
 // src/resolution/ensip19-chainid.ts
-var import_chains2 = require("viem/chains");
+var import_chains = require("viem/chains");
 var import_datasources10 = require("@ensnode/datasources");
 var getResolvePrimaryNameChainIdParam = (chainId, namespaceId) => {
   const ensRootChainId = (0, import_datasources10.getENSRootChainId)(namespaceId);
-  return chainId === ensRootChainId ? import_chains2.mainnet.id : chainId;
+  return chainId === ensRootChainId ? import_chains.mainnet.id : chainId;
 };
 var translateDefaultableChainIdToChainId = (chainId, namespaceId) => {
   return chainId === DEFAULT_EVM_CHAIN_ID ? (0, import_datasources10.getENSRootChainId)(namespaceId) : chainId;
@@ -3350,231 +4179,6 @@ var translateDefaultableChainIdToChainId = (chainId, namespaceId) => {
 // src/resolution/resolver-records-selection.ts
 var isSelectionEmpty = (selection) => !selection.name && !selection.addresses?.length && !selection.texts?.length;
 
-// src/tokenscope/assets.ts
-var import_caip3 = require("caip");
-var import_viem15 = require("viem");
-var AssetNamespaces = {
-  ERC721: "erc721",
-  ERC1155: "erc1155"
-};
-function serializeAssetId(assetId) {
-  const { assetNamespace, contract, tokenId } = assetId;
-  return import_caip3.AssetId.format({
-    chainId: { namespace: "eip155", reference: contract.chainId.toString() },
-    assetName: { namespace: assetNamespace, reference: contract.address },
-    tokenId: uint256ToHex32(tokenId)
-  }).toLowerCase();
-}
-var buildAssetId = (contract, tokenId, assetNamespace) => {
-  return {
-    assetNamespace,
-    contract,
-    tokenId
-  };
-};
-var NFTMintStatuses = {
-  Minted: "minted",
-  Burned: "burned"
-};
-var formatNFTTransferEventMetadata = (metadata) => {
-  const serializedAssetId = serializeAssetId(metadata.nft);
-  return [
-    `Event: ${metadata.eventHandlerName}`,
-    `Chain ID: ${metadata.chainId}`,
-    `Block Number: ${metadata.blockNumber}`,
-    `Transaction Hash: ${metadata.transactionHash}`,
-    `NFT: ${serializedAssetId}`
-  ].map((line) => ` - ${line}`).join("\n");
-};
-var NFTTransferTypes = {
-  /**
-   * Initial transfer from zeroAddress to a non-zeroAddress
-   * Can happen at most once to a NFT AssetId
-   *
-   * Invariants:
-   * - NFT is not indexed and therefore has no previous mint status or owner
-   * - new NFT mint status is `minted`
-   * - new NFT owner is a non-zeroAddress
-   */
-  Mint: "mint",
-  /**
-   * Subsequent transfer from zeroAddress to a non-zeroAddress
-   * Can happen any number of times to a NFT AssetId as it passes in a cycle from
-   * mint -> burn -> remint -> burn -> remint -> ...
-   *
-   * Invariants:
-   * - NFT is indexed
-   * - previous NFT mint status was `burned`
-   * - previous NFT owner is the zeroAddress
-   * - new NFT mint status is `minted`
-   * - new NFT owner is a non-zeroAddress
-   */
-  Remint: "remint",
-  /**
-   * Special transfer type for improperly implemented NFT contracts that allow a NFT
-   * that is currently minted to be reminted before an intermediate burn.
-   *
-   * Transfer from zeroAddress to non-zeroAddress for an indexed NFT where the
-   * previously indexed nft had status `minted` with a non-zeroAddress owner.
-   *
-   * Invariants:
-   * - NFT is indexed
-   * - previous NFT mint status was `minted`
-   * - previous NFT owner was a non-zeroAddress
-   * - new NFT mint status is `minted`
-   * - new NFT owner is a non-zeroAddress
-   */
-  MintedRemint: "minted-remint",
-  /**
-   * Transfer from a non-zeroAddress to zeroAddress
-   *
-   * Invariants:
-   * - NFT is indexed
-   * - previous NFT mint status was `minted`
-   * - previous NFT owner is a non-zeroAddress
-   * - new NFT mint status is `burned`
-   * - new NFT owner is the zeroAddress
-   */
-  Burn: "burn",
-  /**
-   * Transfer from a non-zeroAddress to a distinct non-zeroAddress
-   *
-   * Invariants:
-   * - NFT is indexed
-   * - previous and new NFT mint status is `minted`
-   * - previous and new NFT owner are distinct non-zeroAddress
-   */
-  Transfer: "transfer",
-  /**
-   * Transfer from a non-zeroAddress to the same non-zeroAddress
-   *
-   * Invariants:
-   * - NFT is indexed
-   * - previous and new NFT mint status is `minted`
-   * - previous and new NFT owner are equivalent non-zeroAddress
-   */
-  SelfTransfer: "self-transfer",
-  /**
-   * Transfer from zeroAddress to zeroAddress for an indexed NFT
-   *
-   * Invariants:
-   * - NFT is indexed
-   * - previous and new NFT mint status is `burned`
-   * - previous and new NFT owner are zeroAddress
-   */
-  RemintBurn: "remint-burn",
-  /**
-   * Special transfer type for improperly implemented NFT contracts that allow a NFT
-   * that is currently minted to be reminted again before an intermediate burn.
-   *
-   * Transfer from zeroAddress to zeroAddress for an indexed NFT where the
-   * previously indexed nft had status `minted` with a non-zeroAddress owner.
-   *
-   * Invariants:
-   * - NFT is indexed
-   * - previous NFT mint status was `minted`
-   * - previous NFT owner was a non-zeroAddress
-   * - new NFT mint status is `burned`
-   * - new NFT owner is the zeroAddress
-   */
-  MintedRemintBurn: "minted-remint-burn",
-  /**
-   * Transfer from zeroAddress to zeroAddress for an unindexed NFT
-   *
-   * Invariants:
-   * - NFT is not indexed and therefore has no previous mint status or owner
-   * - NFT should remain unindexed and without any mint status or owner
-   */
-  MintBurn: "mint-burn"
-};
-var getNFTTransferType = (from, to, allowMintedRemint, metadata, currentlyIndexedOwner) => {
-  const isIndexed = currentlyIndexedOwner !== void 0;
-  const isIndexedAsMinted = isIndexed && !(0, import_viem15.isAddressEqual)(currentlyIndexedOwner, import_viem15.zeroAddress);
-  const isMint = (0, import_viem15.isAddressEqual)(from, import_viem15.zeroAddress);
-  const isBurn = (0, import_viem15.isAddressEqual)(to, import_viem15.zeroAddress);
-  const isSelfTransfer = (0, import_viem15.isAddressEqual)(from, to);
-  if (isIndexed && !(0, import_viem15.isAddressEqual)(currentlyIndexedOwner, from)) {
-    if (isMint && allowMintedRemint) {
-    } else {
-      throw new Error(
-        `Error: Sending from ${from} conflicts with currently indexed owner ${currentlyIndexedOwner}.
-${formatNFTTransferEventMetadata(metadata)}`
-      );
-    }
-  }
-  if (isSelfTransfer) {
-    if (isMint) {
-      if (!isIndexed) {
-        return NFTTransferTypes.MintBurn;
-      } else if (!isIndexedAsMinted) {
-        return NFTTransferTypes.RemintBurn;
-      } else if (allowMintedRemint) {
-        return NFTTransferTypes.MintedRemintBurn;
-      } else {
-        throw new Error(
-          `Error: Invalid state transition from minted -> remint-burn
-${formatNFTTransferEventMetadata(metadata)}`
-        );
-      }
-    } else {
-      if (!isIndexed) {
-        throw new Error(
-          `Error: Invalid state transition from unindexed -> self-transfer
-${formatNFTTransferEventMetadata(metadata)}`
-        );
-      } else if (!isIndexedAsMinted) {
-        throw new Error(
-          `Error: invalid state transition from burned -> self-transfer
-${formatNFTTransferEventMetadata(metadata)}`
-        );
-      } else {
-        return NFTTransferTypes.SelfTransfer;
-      }
-    }
-  } else if (isMint) {
-    if (!isIndexed) {
-      return NFTTransferTypes.Mint;
-    } else if (!isIndexedAsMinted) {
-      return NFTTransferTypes.Remint;
-    } else if (allowMintedRemint) {
-      return NFTTransferTypes.MintedRemint;
-    } else {
-      throw new Error(
-        `Error: Invalid state transition from minted -> mint
-${formatNFTTransferEventMetadata(metadata)}`
-      );
-    }
-  } else if (isBurn) {
-    if (!isIndexed) {
-      throw new Error(
-        `Error: Invalid state transition from unindexed -> burn
-${formatNFTTransferEventMetadata(metadata)}`
-      );
-    } else if (!isIndexedAsMinted) {
-      throw new Error(
-        `Error: Invalid state transition from burned -> burn
-${formatNFTTransferEventMetadata(metadata)}`
-      );
-    } else {
-      return NFTTransferTypes.Burn;
-    }
-  } else {
-    if (!isIndexed) {
-      throw new Error(
-        `Error: Invalid state transition from unindexed -> transfer
-${formatNFTTransferEventMetadata(metadata)}`
-      );
-    } else if (!isIndexedAsMinted) {
-      throw new Error(
-        `Error: Invalid state transition from burned -> transfer
-${formatNFTTransferEventMetadata(metadata)}`
-      );
-    } else {
-      return NFTTransferTypes.Transfer;
-    }
-  }
-};
-
 // src/tracing/index.ts
 var TraceableENSProtocol = /* @__PURE__ */ ((TraceableENSProtocol2) => {
   TraceableENSProtocol2["ForwardResolution"] = "forward-resolution";