@ensnode/ensnode-sdk 0.35.0 → 1.0.0

package/dist/index.d.ts

@@ -1,10 +1,11 @@
-import { Hex, Address, ByteArray } from 'viem';
-import * as _ensdomains_address_encoder from '@ensdomains/address-encoder';
+import { Hex, Address, ByteArray, Hash } from 'viem';
 import { CoinType, EvmCoinType } from '@ensdomains/address-encoder';
 export { CoinType, EvmCoinType } from '@ensdomains/address-encoder';
+import { EncodedReferrer } from '@namehash/ens-referrals';
+export { EncodedReferrer, decodeEncodedReferrer, zeroEncodedReferrer } from '@namehash/ens-referrals';
+import z$1, { z } from 'zod/v4';
 import { ENSNamespaceId } from '@ensnode/datasources';
-export { ENSNamespaceId, ENSNamespaceIds } from '@ensnode/datasources';
-import z from 'zod/v4';
+export { ENSNamespaceId, ENSNamespaceIds, getENSRootChainId } from '@ensnode/datasources';
 
 /**
  * A hash value that uniquely identifies a single ENS name.
@@ -14,147 +15,450 @@ import z from 'zod/v4';
  * ```
  * namehash("vitalik.eth") === "0xee6c4522aab0003e8d14cd40a6af439055fd2577951148c14b6cea9a53475835"
  * ```
- * @link https://docs.ens.domains/ensip/1#namehash-algorithm
+ * @see https://docs.ens.domains/ensip/1#namehash-algorithm
+ * @see https://ensnode.io/docs/reference/terminology#name-node-namehash
  */
 type Node = Hex;
 /**
- * A Name represents a human-readable ENS name.
+ * An ENS Name that may or may not be normalized.
  *
- * ex: vitalik.eth
+ * @example vitalik.eth
+ * @see https://ensnode.io/docs/reference/terminology#name-node-namehash
+ * @see https://docs.ens.domains/ensip/15
  */
 type Name = string;
+/**
+ * A Normalized Name is an ENS Name that is guaranteed to be normalized.
+ *
+ * @example vitalik.eth
+ * @see https://ensnode.io/docs/reference/terminology#name-node-namehash
+ * @see https://docs.ens.domains/ensip/15
+ * @dev nominally typed to enforce usage & enhance codebase clarity
+ */
+type NormalizedName = Name & {
+    __brand: "NormalizedName";
+};
 /**
  * A LabelHash is the result of the labelhash function (which is just keccak256) on a Label.
  *
- * @link https://docs.ens.domains/terminology#labelhash
+ * @example
+ * ```
+ * labelhash('vitalik') === '0xaf2caa1c2ca1d027f1ac823b529d0a67cd144264b2789fa2ea4d63a67c7103cc'
+ * ```
+ *
+ * @see https://docs.ens.domains/terminology#labelhash
+ * @see https://ensnode.io/docs/reference/terminology#labels-labelhashes-labelhash-function
  */
 type LabelHash = Hex;
 /**
  * A Label is a single part of an ENS Name.
  *
- * @link https://docs.ens.domains/terminology#label
+ * @example vitalik
+ *
+ * @see https://docs.ens.domains/terminology#label
+ * @see https://ensnode.io/docs/reference/terminology#labels-labelhashes-labelhash-function
  */
 type Label = string;
 /**
- * An EncodedLabelHash is a specially formatted unnormalized Label that should be interpreted as a
- * LabelHash literal, particularly for use within an ENS Name.
+ * An EncodedLabelHash is a specially formatted (unnormalized) Label formatted
+ * as a non-0x prefixed 32-byte hex string enclosed in square brackets.
+ *
+ * Care should be taken to distinguish Label values formatted as an
+ * EncodedLabelHash as either a LiteralLabel or an InterpretedLabel:
+ * - If a LiteralLabel is formatted as an EncodedLabelHash it does NOT
+ *   symbolically represent the encoding of a LabelHash literal.
+ * - If an InterpretedLabel is formatted as an EncodedLabelHash it should be
+ *   interpreted as encoding a LabelHash literal.
+ *
+ * An InterpretedLabel may be formatted as an EncodedLabelHash if the related
+ * LiteralLabel is:
+ * - not a normalized label
+ * - is an unknown value that could not be healed.
+ * - is too long for DNS-Encoding in contexts where DNS-Encoding was required.
+ *
+ * @example [af2caa1c2ca1d027f1ac823b529d0a67cd144264b2789fa2ea4d63a67c7103cc]
  *
- * @example [abcd]
- * @example [abcd].example.eth
+ * @see https://ensnode.io/docs/reference/terminology#encoded-labelhash
  */
 type EncodedLabelHash = `[${string}]`;
+/**
+ * A Literal Label is a Label as it literally appears onchain, without any interpretation
+ * or normalization processing. It may be an unnormalized label for reasons including:
+ * - being an empty label,
+ * - containing '.' characters,
+ * - being formatted as an EncodedLabelHash (which are not normalizable). Note that
+ *   when LiteralLabel are formatted as an EncodedLabelHash they do NOT symbolically
+ *   represent the encoding of a LabelHash literal, or
+ * - containing other unnormalized characters such as null bytes or other characters
+ *   not suitable for display.
+ *
+ *
+ * @see https://ensnode.io/docs/reference/terminology#literal-label
+ * @dev nominally typed to enforce usage & enhance codebase clarity
+ */
+type LiteralLabel = Label & {
+    __brand: "LiteralLabel";
+};
+/**
+ * An Interpreted Label is a Label that is either:
+ * a) a Normalized Label, or
+ * b) an Unnormalizable Label exclusively for the reason that it is formatted
+ *    as an Encoded LabelHash that should be interpreted as encoding a
+ *    LabelHash literal, where the encoded LabelHash literal is the `labelhash`
+ *    of the related LiteralLabel.
+ *
+ * @see https://ensnode.io/docs/reference/terminology#interpreted-label
+ * @dev nominally typed to enforce usage & enhance codebase clarity
+ */
+type InterpretedLabel = Label & {
+    __brand: "InterpretedLabel";
+};
+/**
+ * A Literal Name is a Name as it literally appears onchain, composed of 0 or more Literal Labels
+ * joined by dots. It may be an unnormalized name for reasons including:
+ * - containing empty labels,
+ * - containing LiteralLabel values formatted as an EncodedLabelHash (which are
+ *   not normalizable)). Note that when LiteralLabel values are formatted as an
+ *   EncodedLabelHash they do NOT symbolically represent the encoding of a
+ *   LabelHash literal, or
+ * - containing other unnormalized characters such as null bytes or other characters
+ *   not suitable for display.
+ *
+ * @see https://ensnode.io/docs/reference/terminology#literal-name
+ * @dev nominally typed to enforce usage & enhance codebase clarity
+ */
+type LiteralName = Name & {
+    __brand: "LiteralName";
+};
+/**
+ * An Interpreted Name is a Name that is entirely composed of 0 or more Interpreted Labels.
+ *
+ * That is, it is either:
+ * a) a Normalized Name, or
+ * b) an Unnormalizable Name exclusively for the reason that it contains 1 or
+ *    more labels formatted as Encoded LabelHashes that should be interpreted
+ *    as encoding a LabelHash literal, where the encoded LabelHash literal is
+ *    the `labelhash` of the related LiteralLabel.
+ *
+ * @see https://ensnode.io/docs/reference/terminology#interpreted-name
+ * @dev nominally typed to enforce usage & enhance codebase clarity
+ */
+type InterpretedName = Name & {
+    __brand: "InterpretedName";
+};
+/**
+ * A Subgraph Interpreted Label is a Literal Label that is either:
+ * a) (if subgraph-indexable): a Literal Label, of unknown normalization status, guaranteed to not
+ *   contain any of the subgraph-unindexable UTF-8 characters (and therefore guaranteed not to be
+ *   an Encoded LabelHash), or
+ * b) (if subgraph-unindexable): an Encoded LabelHash.
+ *
+ * @see https://ensnode.io/docs/reference/terminology#subgraph-interpreted-label
+ * @dev nominally typed to enforce usage & enhance codebase clarity
+ */
+type SubgraphInterpretedLabel = Label & {
+    __brand: "SubgraphInterpretedLabel";
+};
+/**
+ * A Subgraph Interpreted Name is a name exclusively composed of 0 or more Subgraph Interpreted Labels.
+ *
+ * @see https://ensnode.io/docs/reference/terminology#subgraph-interpreted-name
+ * @dev nominally typed to enforce usage & enhance codebase clarity
+ */
+type SubgraphInterpretedName = Name & {
+    __brand: "SubgraphInterpretedName";
+};
+/**
+ * A DNS-Encoded Name as a hex string, representing the binary DNS wire format encoding
+ * of a domain name. Used in ENS contracts for efficient name storage and transmission.
+ * Each label is prefixed with a length byte, and the entire sequence is null-terminated.
+ *
+ * @example "0x076578616d706c650365746800" represents "example.eth"
+ *
+ * @see https://docs.ens.domains/resolution/names/#dns-encoding
+ * @see https://github.com/ensdomains/ens-contracts/blob/staging/contracts/utils/NameCoder.sol
+ *
+ * DNS Packet Format for Domain Names:
+ * - Domain names are encoded as a sequence of 0 or more labels
+ * - Each label begins with a length byte (1 byte) indicating how many bytes follow for that label
+ *   Note how this constrains each label in DNS encoded names to a max byte length of 255 bytes.
+ * - The bytes after the length byte represent the label, as a UTF-8 byte array
+ * - Labels are concatenated with no separators
+ * - The sequence ends with a null byte (0x00)
+ *
+ * Example: "example.eth" is encoded as:
+ * [0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e', 0x03, 'e', 't', 'h', 0x00]
+ * Where 0x07 is the length of "example", 0x03 is the length of "eth", and 0x00 marks the end
+ *
+ * Example: "" (empty string, i.e. root node) is encoded as:
+ * [0x00]
+ *
+ * Example: "👩🏼‍❤‍💋‍👨🏼.eth" (multi-byte unicode character) is encoded as:
+ * [0x20, 240, 159, 145, 169, 240, 159, 143, 188, 226, 128, 141, 226, 157, 164, 226,
+ * 128, 141, 240, 159, 146, 139, 226, 128, 141, 240, 159, 145, 168, 240, 159, 143,
+ * 188, 3, 'e', 't', 'h', 0x00]
+ *
+ * A DNS-Encoded Name Packet may be malformed if it does not exactly follow that specification.
+ * Possible reasons a DNS-Encoded Name may be malfomed include:
+ * - 'empty' packet
+ *   - e.g. []
+ *           ^-- that's empty!
+ * - 'length' byte overflowing packet byte length
+ *   - e.g. [0x06, 'e', 't', 'h', 0x00]
+ *            ^-- length overflows available bytes!
+ * - 'junk' at the end of the dns-encoded
+ *   - e.g. [0x03, 'e', 't', 'h', 0x00, 0x01]
+ *                                       ^-- junk!
+ *
+ * @dev This type is _structurally_ typed to aid Event Argument Typing — consumers should further
+ * cast the type of the event argument to a _nominally_ typed DNSEncodedName like {@link DNSEncodedLiteralName}
+ * or {@link DNSEncodedPartiallyInterpretedName} depending on the context.
+ */
+type DNSEncodedName = Hex;
+/**
+ * A DNSEncodedName that encodes a name containing 0 or more {@link LiteralLabel}s.
+ *
+ * In a DNSEncodedLiteralName, all labels are Literal Labels, including any Encoded-LabelHash-looking
+ * labels. Any Encoded-LabelHash-looking Literal Label values, when interpreted, will be formatted as
+ * the `labelhash` of the Literal Label value.
+ *
+ * The NameWrapper contract emits DNSEncodedLiteralNames:
+ * @see https://github.com/ensdomains/ens-contracts/blob/staging/contracts/utils/BytesUtils_LEGACY.sol
+ *
+ * The ThreeDNSToken contract emits DNSEncodedLiteralNames:
+ * @see https://github.com/3dns-xyz/contracts/blob/44937318ae26cc036982e8c6a496cd82ebdc2b12/src/regcontrol/libraries/BytesUtils.sol
+ *
+ * @dev nominally typed to enforce usage & enhance codebase clarity
+ */
+type DNSEncodedLiteralName = DNSEncodedName & {
+    __brand: "DNSEncodedLiteralName";
+};
+/**
+ * A DNSEncodedName that encodes a name consisting of 0 or more labels that are either:
+ * a) Literal Labels, or
+ * b) Encoded LabelHashes, which are already an Interpreted Label.
+ *
+ * In a DNSEncodedPartiallyInterpretedName, any Encoded-LabelHash-looking decoded Labels (i.e. ones
+ * that match the regex /^\[[\da-f]{64}\]$/) represent an Encoded LabelHash. When decoding a
+ * DNSEncodedPartiallyInterpretedName, these labels are already considered Interpreted.
+ *
+ * NOTE: This type is unused in ENSv1, but its usage is anticipated in ENSv2 due to Encoded
+ * LabelHash support in the ENSv2 implementation of the NameCoder contract.
+ *
+ * @see https://github.com/ensdomains/ens-contracts/blob/staging/contracts/utils/NameCoder.sol
+ *
+ * @dev nominally typed to enforce usage & enhance codebase clarity
+ */
+type DNSEncodedPartiallyInterpretedName = DNSEncodedName & {
+    __brand: "DNSEncodedPartiallyInterpretedName";
+};
 
-declare const ROOT_NODE: Node;
-declare const ETH_NODE: `0x${string}`;
-declare const BASENAMES_NODE: `0x${string}`;
-declare const LINEANAMES_NODE: `0x${string}`;
 /**
- * A set of nodes whose children are used for reverse resolution.
+ * Determines whether the Name is normalized.
+ *
+ * @param name - The Name to check for normalization
+ * @returns True if the name is normalized according to ENS normalization rules, false otherwise
+ */
+declare function isNormalizedName(name: Name): name is NormalizedName;
+/**
+ * Determines whether the Label is normalized.
  *
- * Useful for identifying if a domain is used for reverse resolution.
- * See apps/ensindexer/src/handlers/Registry.ts for context.
+ * @param label - The Label to check for normalization
+ * @returns True if the label is normalized according to ENS normalization rules, false otherwise
  */
-declare const REVERSE_ROOT_NODES: Set<Node>;
+declare function isNormalizedLabel(label: Label): boolean;
 
 /**
- * Implements one step of the namehash algorithm, combining `labelHash` with `node` to produce
- * the `node` of a given subdomain. Note that the order of the arguments is 'reversed' (as compared to
- * the actual concatenation) in order to improve readability (i.e. read as [labelHash].[node]).
+ * The ETH coinType.
+ *
+ * @see https://docs.ens.domains/ensip/9
  */
-declare const makeSubdomainNode: (labelHash: LabelHash, node: Node) => Node;
+declare const ETH_COIN_TYPE: CoinType;
 /**
- * Attempt to heal the labelHash of an addr.reverse subname using an address that might be related to the subname.
+ * The 'default' chainId corresponding to the below {@link DEFAULT_EVM_COIN_TYPE} in the context of
+ * ENSIP-19.
  *
- * @throws if maybeReverseAddress is not a valid Address
- * @throws if labelHash is not a valid Labelhash
+ * @see https://docs.ens.domains/ensip/19
+ */
+declare const DEFAULT_EVM_CHAIN_ID = 0;
+/**
+ * ENSIP-19 EVM CoinType representing the 'default' coinType for EVM chains in ENS.
  *
- * @returns the original label if healed, otherwise null
+ * @see https://docs.ens.domains/ensip/19/#reverse-resolution
  */
-declare const maybeHealLabelByReverseAddress: ({ maybeReverseAddress, labelHash, }: {
-    /** The address that is possibly associated with the addr.reverse subname */
-    maybeReverseAddress: Address;
-    /** The labelhash of the addr.reverse subname */
-    labelHash: LabelHash;
-}) => string | null;
+declare const DEFAULT_EVM_COIN_TYPE: EvmCoinType;
 /**
- * Encodes a uint256 bigint as hex string sized to 32 bytes.
- * Uses include, in the context of ENS, decoding the uint256-encoded tokenId of NFT-issuing contracts
- * into Node or LabelHash, which is a common behavior in the ENS ecosystem.
- * (see NameWrapper, ETHRegistrarController)
+ * Converts a CoinType to an EVM Chain Id.
+ *
+ * NOTE: for whatever reason @ensdomains/address-encoder#coinTypeToEvmChainId doesn't handle the
+ * mainnet case so we implement that here
+ *
+ * @see https://docs.ens.domains/ensip/11/
  */
-declare const uint256ToHex32: (num: bigint) => Hex;
+declare const coinTypeToEvmChainId: (coinType: CoinType) => ChainId;
 /**
- * Check if any characters in `label` are "unindexable".
+ * Converts an EVM Chain Id to a CoinType.
  *
- * Related logic in ENS Subgraph:
- * https://github.com/ensdomains/ens-subgraph/blob/c844791/src/utils.ts#L68
+ * NOTE: for whatever reason @ensdomains/address-encoder#evmChainIdToCoinType doesn't handle the
+ * mainnet case so we implement that here
+ */
+declare const evmChainIdToCoinType: (chainId: ChainId) => CoinType;
+/**
+ * Converts a bigint value representing a CoinType into a valid CoinType.
  *
- * @param label - The label to check. Note:
- * A `null` value for `label` represents an unhealable labelhash.
+ * This is useful when onchain events emit coinTypes as bigint but we want to constrain them to
+ * the CoinType type.
  *
- * @returns `true` if the label is indexable, `false` otherwise.
+ * @throws if `value` is too large to fit in Number.MAX_SAFE_INTEGER
  */
-declare const isLabelIndexable: (label: Label | null) => label is Label;
+declare const bigintToCoinType: (value: bigint) => CoinType;
+
+declare const ROOT_NODE: Node;
+declare const ETH_NODE: Node;
+declare const BASENAMES_NODE: Node;
+declare const LINEANAMES_NODE: Node;
+declare const ADDR_REVERSE_NODE: Node;
 
 /**
- * Cache that maps from string -> ValueType.
+ * Decodes a DNS-Encoded name consisting of Literal Labels into an ordered list of Literal Labels.
+ *
+ * For discussion on DNS-Encoding, see the {@link DNSEncodedName} and {@link DNSEncodedLiteralName} types.
+ *
+ * Due to the constraints of DNS-Encoding, there is an additional guarantee that each Literal Label
+ * in the resulting list is guaranteed to have a maximum byte length of 255.
+ *
+ * @param packet a hex string that encodes a DNSEncodedLiteralName
+ * @returns A list of the LiteralLabels contained in packet
+ * @throws If the packet is malformed
+ * @dev This is just `decodeDNSEncodedName` with semantic input/output
  */
-interface Cache<KeyType extends string, ValueType> {
-    /**
-     * Store a value in the cache with the given key.
-     *
-     * @param key Cache key
-     * @param value Value to store
-     */
-    set(key: KeyType, value: ValueType): void;
-    /**
-     * Retrieve a value from the cache with the given key.
-     *
-     * @param key Cache key
-     * @returns The cached value if it exists, otherwise undefined
-     */
-    get(key: KeyType): ValueType | undefined;
-    /**
-     * Clear the cache.
-     */
-    clear(): void;
-    /**
-     * The current number of items in the cache. Always a non-negative integer.
-     */
-    get size(): number;
-    /**
-     * The maximum number of items in the cache. Always a non-negative integer that is >= size().
-     */
-    get capacity(): number;
-}
+declare function decodeDNSEncodedLiteralName(packet: DNSEncodedLiteralName): LiteralLabel[];
 /**
- * Cache that maps from string -> ValueType with a LRU (least recently used) eviction policy.
+ * Decodes a DNS-Encoded Name into an ordered list of string segments.
  *
- * `get` and `set` are O(1) operations.
+ * For discussion on DNS-Encoding, see the {@link DNSEncodedName} type.
  *
- * @link https://en.wikipedia.org/wiki/Cache_replacement_policies#LRU
+ * Due to the constraints of DNS-Encoding, there is an additional guarantee that each segment
+ * in the resulting list is guaranteed to have a maximum byte length of 255.
+ *
+ * @param packet a hex string that encodes a DNSEncodedName
+ * @returns A UTF-8 string array of the segments contained in packet
+ * @throws If the packet is malformed
+ * @dev This is the generic implementation of DNS-Encoded Name Decoding
  */
-declare class LruCache<KeyType extends string, ValueType> implements Cache<KeyType, ValueType> {
-    private readonly _cache;
-    private readonly _capacity;
-    /**
-     * Create a new LRU cache with the given capacity.
-     *
-     * @param capacity The maximum number of items in the cache. If set to 0, the cache is effectively disabled.
-     * @throws Error if capacity is not a non-negative integer.
-     */
-    constructor(capacity: number);
-    set(key: string, value: ValueType): void;
-    get(key: string): ValueType | undefined;
-    clear(): void;
-    get size(): number;
-    get capacity(): number;
-}
+declare function decodeDNSEncodedName(packet: DNSEncodedName): string[];
 
 /**
- * Filter out duplicates.
+ * Formats a LabelHash as an Encoded LabelHash.
+ *
+ * @see https://ensnode.io/docs/reference/terminology#encoded-labelhash
+ *
+ * @param labelHash - A 32-byte lowercase hash string starting with '0x'
+ * @returns The encoded label hash in format `[hash_without_0x_prefix]`
  */
-declare const uniq: <T>(arr: T[]) => T[];
+declare const encodeLabelHash: (labelHash: LabelHash) => EncodedLabelHash;
+/**
+ * Checks if the input value is an {@link EncodedLabelHash}.
+ */
+declare function isEncodedLabelHash(maybeEncodedLabelHash: string): maybeEncodedLabelHash is EncodedLabelHash;
+
+/**
+ * Checks if the input is a {@link LabelHash}.
+ *
+ * @see https://ensnode.io/docs/reference/terminology#label-processing-and-classification
+ */
+declare function isLabelHash(maybeLabelHash: string): maybeLabelHash is LabelHash;
+
+/**
+ * Constructs a name hierarchy from a given NormalizedName.
+ *
+ * @example
+ * ```
+ * getNameHierarchy("sub.example.eth") -> ["sub.example.eth", "example.eth", "eth"]
+ * ```
+ *
+ * @dev by restricting the input type to NormalizedName we guarantee that we can split and join
+ * on '.' and receive NormalizedNames as a result
+ */
+declare const getNameHierarchy: (name: NormalizedName) => NormalizedName[];
+/**
+ * Beautifies a name by converting each normalized label in the provided name to
+ * its "beautified" form. Labels that are not normalized retain their original value.
+ *
+ * Invariants:
+ * - The number of labels in the returned name is the same as the number of labels in the input name.
+ * - The order of the labels in the returned name is the same as the order of the labels in the input name.
+ * - If a label in the input is normalized, it is returned in its "beautified" form.
+ * - If a label in the input name is not normalized, it is returned without modification.
+ * - Therefore, the result of ens_normalize(beautifyName(name)) is the same as the result of ens_normalize(name).
+ *
+ * The "beautified form" of a normalized label converts special sequences of
+ * emojis and other special characters to their "beautified" equivalents. All
+ * such conversions transform X -> Y where Y is normalizable and normalizes back to X.
+ * Ex: '1⃣2⃣' (normalized) to '1️⃣2️⃣' (normalizable but not normalized).
+ * Ex: 'ξethereum' (normalized) to 'Ξethereum' (normalizable, but not normalized).
+ * Ex: 'abc' (normalized) to 'abc' (also normalized, no conversion).
+ * Ex: 'ABC' (normalizable but not normalized) to 'ABC' (no conversion).
+ * Ex: 'invalid|label' (not normalizable) to 'invalid|label' (no conversion).
+ * Ex: '' (unnormalized as a label) to '' (no conversion).
+ *
+ * @param name - The name to beautify.
+ * @returns The beautified name.
+ */
+declare const beautifyName: (name: Name) => Name;
+
+/**
+ * Parse the address and coinType out of an ENSIP-19 reverse name.
+ */
+declare function parseReverseName(name: Name): {
+    address: Address;
+    coinType: CoinType;
+} | null;
+
+/**
+ * Gets the Label used for the reverse names of subnames as per ENSIP-11 & ENSIP-19.
+ *
+ * @see https://docs.ens.domains/ensip/19/#reverse-resolution
+ */
+declare const addrReverseLabel: (address: Address) => LiteralLabel;
+/**
+ * Converts `coinType` to prefix-free hex string.
+ *
+ * @see https://docs.ens.domains/ensip/19
+ */
+declare const coinTypeReverseLabel: (coinType: CoinType) => Label;
+/**
+ * Gets the reverse name for an address according to ENSIP-11 & ENSIP-19.
+ *
+ * @see https://docs.ens.domains/ensip/11#specification
+ * @see https://docs.ens.domains/ensip/19#specification
+ *
+ * @param address - The address to get the reverse name for
+ * @param coinType - The coin type to use for the reverse name
+ * @returns The reverse name for the address
+ *
+ * @example
+ * ```ts
+ * reverseName("0x1234", BigInt(ETH_COIN_TYPE)) // "1234.addr.reverse"
+ * reverseName("0x1234", BigInt(0x80000000)) // "1234.default.reverse"
+ * reverseName("0x1234", BigInt(0x5678)) // "1234.5678.reverse"
+ * ```
+ */
+declare function reverseName(address: Address, coinType: CoinType): Name;
+
+/**
+ * Implements one step of the namehash algorithm, combining `labelHash` with `node` to produce
+ * the `node` of a given subdomain. Note that the order of the arguments is 'reversed' (as compared to
+ * the actual concatenation) in order to improve readability (i.e. read as [labelHash].[node]).
+ */
+declare const makeSubdomainNode: (labelHash: LabelHash, node: Node) => Node;
+/**
+ * Encodes a uint256 bigint as hex string sized to 32 bytes.
+ * Uses include, in the context of ENS, decoding the uint256-encoded tokenId of NFT-issuing contracts
+ * into Node or LabelHash, which is a common behavior in the ENS ecosystem.
+ * (see NameWrapper, ETHRegistrarController)
+ */
+declare const uint256ToHex32: (num: bigint) => Hex;
 
 /**
  * Chain ID
@@ -163,6 +467,17 @@ declare const uniq: <T>(arr: T[]) => T[];
  * Guaranteed to be a positive integer.
  **/
 type ChainId = number;
+/**
+ * Defaultable Chain ID
+ *
+ * Represents a unique identifier for a chain, or
+ * the default chain as defined by ENSIP-19.
+ *
+ * @see https://docs.ens.domains/ensip/19/#annex-supported-chains
+ *
+ * Guaranteed to be a non-negative integer.
+ **/
+type DefaultableChainId = typeof DEFAULT_EVM_CHAIN_ID | ChainId;
 /**
  * Represents an account (contract or EOA) at `address` on chain `chainId`.
  *
@@ -185,7 +500,11 @@ type Datetime = Date;
 /**
  * Unix timestamp value
  *
- * Guaranteed to be an integer.
+ * Represents the number of seconds that have elapsed
+ * since January 1, 1970 (midnight UTC/GMT).
+ *
+ * Guaranteed to be an integer. May be zero or negative to represent a time at or
+ * before Jan 1, 1970.
  */
 type UnixTimestamp = number;
 /**
@@ -260,189 +579,396 @@ type DeepPartial<T> = {
 };
 
 /**
- * A string representation of {@link ChainId}.
- **/
-type ChainIdString = string;
+ * Determines where the provided AccountId values represent the same address on the same chain.
+ */
+declare const accountIdEqual: (a: AccountId, b: AccountId) => boolean;
+
 /**
- * Datetime value following the ISO 8601 standard.
+ * Converts an EVM address to its lowercase representation.
  *
- * @see https://www.iso.org/iso-8601-date-and-time-format.html
+ * @param address - EVM address to convert.
+ * @returns The lowercase representation of the EVM address.
  */
-type DatetimeISO8601 = string;
+declare function asLowerCaseAddress(address: Address): Address;
+
 /**
- * A string representation of a {@link URL}.
+ * Cache that maps from string -> ValueType.
  */
-type UrlString = string;
-
+interface Cache<KeyType extends string, ValueType> {
+    /**
+     * Store a value in the cache with the given key.
+     *
+     * @param key Cache key
+     * @param value Value to store
+     */
+    set(key: KeyType, value: ValueType): void;
+    /**
+     * Retrieve a value from the cache with the given key.
+     *
+     * @param key Cache key
+     * @returns The cached value if it exists, otherwise undefined
+     */
+    get(key: KeyType): ValueType | undefined;
+    /**
+     * Clear the cache.
+     */
+    clear(): void;
+    /**
+     * The current number of items in the cache. Always a non-negative integer.
+     */
+    get size(): number;
+    /**
+     * The maximum number of items in the cache. Always a non-negative integer that is >= size().
+     */
+    get capacity(): number;
+}
 /**
- * Serializes a {@link ChainId} value into its string representation.
+ * Cache that maps from string -> ValueType with a LRU (least recently used) eviction policy.
+ *
+ * `get` and `set` are O(1) operations.
+ *
+ * @link https://en.wikipedia.org/wiki/Cache_replacement_policies#LRU
  */
-declare function serializeChainId(chainId: ChainId): ChainIdString;
+declare class LruCache<KeyType extends string, ValueType> implements Cache<KeyType, ValueType> {
+    private readonly _cache;
+    private readonly _capacity;
+    /**
+     * Create a new LRU cache with the given capacity.
+     *
+     * @param capacity The maximum number of items in the cache. If set to 0, the cache is effectively disabled.
+     * @throws Error if capacity is not a non-negative integer.
+     */
+    constructor(capacity: number);
+    set(key: string, value: ValueType): void;
+    get(key: string): ValueType | undefined;
+    clear(): void;
+    get size(): number;
+    get capacity(): number;
+}
 /**
- * Serializes a {@link Datetime} value into its string representation.
+ * Cache that maps from string -> ValueType with TTL (time-to-live) expiration.
+ *
+ * Items are automatically removed when they expire.
  */
-declare function serializeDatetime(datetime: Datetime): DatetimeISO8601;
+declare class TtlCache<KeyType extends string, ValueType> implements Cache<KeyType, ValueType> {
+    private readonly _cache;
+    private readonly _ttl;
+    /**
+     * Create a new TTL cache with the given TTL.
+     *
+     * @param ttl Time-to-live duration in seconds. Items expire after this duration.
+     */
+    constructor(ttl: Duration);
+    private _cleanup;
+    set(key: string, value: ValueType): void;
+    get(key: string): ValueType | undefined;
+    clear(): void;
+    get size(): number;
+    get capacity(): number;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+}
+interface StaleWhileRevalidateOptions<ValueType> {
+    /**
+     * The async function to wrap with SWR caching.
+     * On success this function returns a value of type `ValueType` to store in the `SWRCache`.
+     * On error, this function throws an error and no changes will be made to the `SWRCache`.
+     */
+    fn: () => Promise<ValueType>;
+    /**
+     * Time-to-live duration in seconds. After this duration, data in the `SWRCache` is
+     * considered stale but is still retained in the cache until replaced with a new value.
+     */
+    ttl: Duration;
+}
 /**
- * Serializes a {@link URL} value into its string representation.
+ * Stale-While-Revalidate (SWR) cache wrapper for async functions.
+ *
+ * This caching strategy serves cached data immediately (even if stale) while
+ * asynchronously revalidating the cache in the background. This provides:
+ * - Sub-millisecond response times (after first fetch)
+ * - Always available data (serves stale data during revalidation)
+ * - Automatic background updates (currently only triggered lazily when new requests
+ *   are made for the cached data after it becomes stale)
+ *
+ * Error Handling:
+ * - If a new invocation of the provided `fn` throws an error and a cached value exists
+ *   from a previous successfully invocation of the provided `fn`, the stale cached value is returned.
+ * - If a new invocation of the provided `fn` throws an error and NO cached value exists,
+ *   from any prior invocations of the provided `fn`, such that the provided `fn` has never
+ *   successfully returned a value for the lifetime of the `SWRCache`, then `null` is returned.
+ * - Therefore, errors occuring within the provided `fn` are handled internally within
+ *   `staleWhileRevalidate` and do not propagate to the caller.
+ *
+ * @example
+ * ```typescript
+ * const fetchExpensiveData = async () => {
+ *   const response = await fetch('/api/data');
+ *   return response.json();
+ * };
+ *
+ * const cachedFetch = staleWhileRevalidate(fetchExpensiveData, 60); // 60 second TTL
+ *
+ * // First call: fetches data (slow)
+ * const data1 = await cachedFetch();
+ *
+ * // Within TTL: returns cached data (fast)
+ * const data2 = await cachedFetch();
+ *
+ * // After TTL: returns stale data immediately, revalidates asynchronously in the background
+ * const data3 = await cachedFetch(); // Still fast!
+ * ```
+ *
+ * @param fn The async function to wrap with SWR caching
+ * @param ttl Time-to-live duration in seconds. After this duration, data is considered stale
+ * @returns a value of `ValueType` that was most recently successfully returned by `fn`
+ *          or `null` if `fn` has never successfully returned and has always thrown an error.
+ *
+ * @link https://web.dev/stale-while-revalidate/
+ * @link https://datatracker.ietf.org/doc/html/rfc5861
  */
-declare function serializeUrl(url: URL): UrlString;
+declare function staleWhileRevalidate<ValueType>(options: StaleWhileRevalidateOptions<ValueType>): () => Promise<ValueType | null>;
 
-declare function deserializeChainId(maybeChainId: ChainIdString, valueLabel?: string): ChainId;
-declare function deserializeDatetime(maybeDatetime: string, valueLabel?: string): Datetime;
-declare function deserializeUrl(maybeUrl: UrlString, valueLabel?: string): URL;
-declare function deserializeBlockNumber(maybeBlockNumber: number, valueLabel?: string): BlockNumber;
-declare function deserializeBlockrange(maybeBlockrange: Partial<Blockrange>, valueLabel?: string): {
-    startBlock?: number | undefined;
-    endBlock?: number | undefined;
-};
-declare function deserializeBlockRef(maybeBlockRef: Partial<BlockRef>, valueLabel?: string): BlockRef;
-declare function deserializeDuration(maybeDuration: string, valueLabel?: string): Duration;
+/**
+ * Filter out duplicates.
+ */
+declare const uniq: <T>(arr: T[]) => T[];
 
 /**
- * Determines whether the Name is normalized.
+ * Identifiers for supported currencies.
  *
- * @param name - The Name to check for normalization
- * @returns True if the name is normalized according to ENS normalization rules, false otherwise
+ * TODO: Add support for WETH
  */
-declare function isNormalizedName(name: Name): boolean;
+declare const CurrencyIds: {
+    readonly ETH: "ETH";
+    readonly USDC: "USDC";
+    readonly DAI: "DAI";
+};
+type CurrencyId = (typeof CurrencyIds)[keyof typeof CurrencyIds];
 /**
- * Determines whether the Label is normalized.
+ * The amount of the currency in the smallest unit of the currency
+ * (see {@link CurrencyInfo.decimals} for the currency).
  *
- * @param label - The Label to check for normalization
- * @returns True if the label is normalized according to ENS normalization rules, false otherwise
+ * Guaranteed to be non-negative.
  */
-declare function isNormalizedLabel(label: Label): boolean;
+type CurrencyAmount = bigint;
+/**
+ * Serialized representation of {@link CurrencyAmount}.
+ */
+type SerializedCurrencyAmount = string;
+interface PriceEth {
+    currency: typeof CurrencyIds.ETH;
+    amount: CurrencyAmount;
+}
+interface PriceDai {
+    currency: typeof CurrencyIds.DAI;
+    amount: CurrencyAmount;
+}
+interface PriceUsdc {
+    currency: typeof CurrencyIds.USDC;
+    amount: CurrencyAmount;
+}
+type Price = PriceEth | PriceDai | PriceUsdc;
+/**
+ * Serialized representation of {@link PriceEth}.
+ */
+interface SerializedPriceEth extends Omit<PriceEth, "amount"> {
+    amount: SerializedCurrencyAmount;
+}
+/**
+ * Serialized representation of {@link PriceDai}.
+ */
+interface SerializedPriceDai extends Omit<PriceDai, "amount"> {
+    amount: SerializedCurrencyAmount;
+}
+/**
+ * Serialized representation of {@link PriceUsdc}.
+ */
+interface SerializedPriceUsdc extends Omit<PriceUsdc, "amount"> {
+    amount: SerializedCurrencyAmount;
+}
+/**
+ * Serialized representation of {@link Price}.
+ */
+type SerializedPrice = SerializedPriceEth | SerializedPriceDai | SerializedPriceUsdc;
+interface CurrencyInfo {
+    id: CurrencyId;
+    name: string;
+    decimals: number;
+}
+/**
+ * Get currency info for a provided currency.
+ */
+declare function getCurrencyInfo(currencyId: CurrencyId): CurrencyInfo;
+/**
+ * Create price in ETH for given amount.
+ */
+declare function priceEth(amount: Price["amount"]): PriceEth;
+/**
+ * Create price in USDC for given amount.
+ */
+declare function priceUsdc(amount: Price["amount"]): PriceUsdc;
+/**
+ * Create price in DAI for given amount.
+ */
+declare function priceDai(amount: Price["amount"]): PriceDai;
+/**
+ * Check if two prices have the same currency.
+ */
+declare function isPriceCurrencyEqual(priceA: Price, priceB: Price): boolean;
+/**
+ * Check if two {@link Price} values have the same currency and amount.
+ */
+declare function isPriceEqual(priceA: Price, priceB: Price): boolean;
+/**
+ * Add prices
+ *
+ * @param prices at least two {@link Price} values to be added together.
+ * @returns total of all prices.
+ * @throws if not all prices have the same currency.
+ */
+declare function addPrices<const PriceType extends Price = Price>(...prices: [PriceType, PriceType, ...PriceType[]]): PriceType;
 
 /**
- * Determines where the provided AccountId values represent the same address on the same chain.
+ * Duration between two moments in time.
  */
-declare const accountIdEqual: (a: AccountId, b: AccountId) => boolean;
+declare function durationBetween(start: UnixTimestamp, end: UnixTimestamp): Duration;
+/**
+ * Add a duration to a timestamp.
+ */
+declare function addDuration(timestamp: UnixTimestamp, duration: Duration): UnixTimestamp;
 
 /**
- * Transforms a Literal Label into an Interpreted Label.
- *
- * @see https://ensnode.io/docs/reference/terminology#literal-label
- * @see https://ensnode.io/docs/reference/terminology#interpreted-label
+ * Serialized representation of {@link ChainId}.
+ **/
+type ChainIdString = string;
+/**
+ * Datetime value following the ISO 8601 standard.
  *
- * @param label - The Literal Label string to interpret
- * @returns The provided label if it is normalized, else the EncodedLabelHash of the label
+ * @see https://www.iso.org/iso-8601-date-and-time-format.html
  */
-declare function interpretLiteralLabel(label: Label): Label | EncodedLabelHash;
+type DatetimeISO8601 = string;
 /**
- * Transforms a Literal Name into an Interpreted Name.
- *
- * @see https://ensnode.io/docs/reference/terminology#literal-name
- * @see https://ensnode.io/docs/reference/terminology#interpreted-name
+ * Serialized representation of a {@link URL}.
+ */
+type UrlString = string;
+/**
+ * Serialized representation of {@link AccountId}.
  *
- * If the name provided to this function contains empty-string labels (i.e 'this..name'),
- * then the empty string labels will be Interpreted. Empty-string is not a normalizable name, so the
- * label will be replaced with its Encoded LabelHash representation (i.e. )
+ * Formatted as a fully lowercase CAIP-10 AccountId.
  *
- * @param name - The Literal Name string to interpret
- * @returns The provided name if it is normalized, else converts each label in name that is not a
- * normalized label into an Interpreted Label
+ * @see https://chainagnostic.org/CAIPs/caip-10
  */
-declare function interpretLiteralName(name: Name): Name;
+type SerializedAccountId = string;
+
+declare function deserializeChainId(maybeChainId: ChainIdString, valueLabel?: string): ChainId;
+declare function deserializeDatetime(maybeDatetime: string, valueLabel?: string): Datetime;
+declare function deserializeUnixTimestamp(maybeTimestamp: number, valueLabel?: string): number;
+declare function deserializeUrl(maybeUrl: UrlString, valueLabel?: string): URL;
+declare function deserializeBlockNumber(maybeBlockNumber: number, valueLabel?: string): BlockNumber;
+declare function deserializeBlockrange(maybeBlockrange: Partial<Blockrange>, valueLabel?: string): {
+    startBlock?: number | undefined;
+    endBlock?: number | undefined;
+};
+declare function deserializeBlockRef(maybeBlockRef: Partial<BlockRef>, valueLabel?: string): BlockRef;
+declare function deserializeDuration(maybeDuration: unknown, valueLabel?: string): Duration;
+declare function deserializeAccountId(maybeAccountId: unknown, valueLabel?: string): AccountId;
 
 /**
- * The ETH coinType.
+ * Interprets a Literal Label, producing an Interpreted Label.
  *
- * @see https://docs.ens.domains/ensip/9
+ * @see https://ensnode.io/docs/reference/terminology#literal-label
+ * @see https://ensnode.io/docs/reference/terminology#interpreted-label
+ *
+ * @param label - The Literal Label string to interpret
+ * @returns The provided label if it is a normalized label, else the EncodedLabelHash of the label
  */
-declare const ETH_COIN_TYPE: CoinType;
+declare function literalLabelToInterpretedLabel(label: LiteralLabel): InterpretedLabel;
 /**
- * The 'default' chainId corresponding to the below {@link DEFAULT_EVM_COIN_TYPE} in the context of
- * ENSIP-19.
+ * Interprets an ordered list of Literal Labels, producing an Interpreted Name.
  *
- * @see https://docs.ens.domains/ensip/19
+ * Note that it's important that the Literal Labels are provided as an array, otherwise it's
+ * impossible to differentiate between 'a.label.eth' being ['a.label', 'eth'] or ['a', 'label', 'eth'].
+ *
+ * Note that the input is an ordered list of _Literal_ Labels: in this context, any literal label
+ * that is formatted as an Encoded LabelHash will NOT be interpreted as such. Instead it will be
+ * interpreted into an Encoded LabelHash that encodes the literal labelhash of the Literal Label.
+ *
+ * @param labels An ordered list of 0 or more Literal Labels
+ * @returns An InterpretedName
  */
-declare const DEFAULT_EVM_CHAIN_ID: ChainId;
+declare function literalLabelsToInterpretedName(labels: LiteralLabel[]): InterpretedName;
 /**
- * ENSIP-19 EVM CoinType representing the 'default' coinType for EVM chains in ENS.
+ * Joins the list of Interpreted Labels with '.' to form an Interpreted Name.
  *
- * @see https://docs.ens.domains/ensip/19/#reverse-resolution
+ * @param labels An ordered list of 0 or more Interpreted Labels
+ * @returns An InterpretedName
  */
-declare const DEFAULT_EVM_COIN_TYPE: EvmCoinType;
+declare function interpretedLabelsToInterpretedName(labels: InterpretedLabel[]): InterpretedName;
 /**
- * Converts a CoinType to an EVM Chain Id.
+ * Joins the list of Literal Labels with '.' to form a Literal Name.
  *
- * NOTE: for whatever reason @ensdomains/address-encoder#coinTypeToEvmChainId doesn't handle the
- * mainnet case so we implement that here
+ * Note: LiteralLabel values may contain '.' characters, which will be preserved
+ * in the resulting LiteralName. Therefore, the number of labels in the returned
+ * LiteralName may be greater than the number of LiteralLabels in the input array.
  *
- * @see https://docs.ens.domains/ensip/11/
+ * @param labels An ordered list of 0 or more Literal Labels
+ * @returns An LiteralName
  */
-declare const coinTypeToEvmChainId: (coinType: CoinType) => ChainId;
+declare function literalLabelsToLiteralName(labels: LiteralLabel[]): LiteralName;
+
 /**
- * Converts an EVM Chain Id to a CoinType.
+ * Implements the ENS `labelhash` function for Literal Labels.
+ * @see https://docs.ens.domains/ensip/1
  *
- * NOTE: for whatever reason @ensdomains/address-encoder#evmChainIdToCoinType doesn't handle the
- * mainnet case so we implement that here
+ * @param label the Literal Label to hash
+ * @returns the hash of the provided label
+ * @dev This function is viem/ens#labelhash but without the special-case handling of Encoded LabelHashes.
  */
-declare const evmChainIdToCoinType: (chainId: ChainId) => CoinType;
+declare const labelhashLiteralLabel: (label: LiteralLabel) => LabelHash;
+
+declare const hasNullByte: (value: string) => boolean;
+declare const stripNullBytes: (value: string) => string;
+
 /**
- * Converts a bigint value representing a CoinType into a valid CoinType.
+ * Converts a bigint value into a number value.
  *
- * This is useful when onchain events emit coinTypes as bigint but we want to constrain them to
- * the CoinType type.
- *
- * @throws if `value` is too large to fit in Number.MAX_SAFE_INTEGER
+ * @throws when value is outside the range of `Number.MIN_SAFE_INTEGER` and
+ * `Number.MAX_SAFE_INTEGER`.
  */
-declare const bigintToCoinType: (value: bigint) => CoinType;
+declare function bigIntToNumber(n: bigint): number;
 
 /**
- * Constructs a name hierarchy from a given Name.
- * i.e. sub.example.eth -> [sub.example.eth, example.eth, eth]
+ * Serializes a {@link ChainId} value into its string representation.
  */
-declare const getNameHierarchy: (name: Name) => Name[];
-
+declare function serializeChainId(chainId: ChainId): ChainIdString;
 /**
- * Gets the Label used for the reverse names of subnames as per ENSIP-11 & ENSIP-19.
- *
- * @see https://docs.ens.domains/ensip/19/#reverse-resolution
+ * Serializes a {@link Datetime} value into its string representation.
  */
-declare const addrReverseLabel: (address: Address) => Label;
+declare function serializeDatetime(datetime: Datetime): DatetimeISO8601;
 /**
- * Converts `coinType` to prefix-free hex string.
- *
- * @see https://docs.ens.domains/ensip/19
+ * Serializes a {@link URL} value into its string representation.
  */
-declare const coinTypeReverseLabel: (coinType: CoinType) => Label;
+declare function serializeUrl(url: URL): UrlString;
 /**
- * Gets the reverse name for an address according to ENSIP-11 & ENSIP-19.
- *
- * @see https://docs.ens.domains/ensip/11#specification
- * @see https://docs.ens.domains/ensip/19#specification
- *
- * @param address - The address to get the reverse name for
- * @param coinType - The coin type to use for the reverse name
- * @returns The reverse name for the address
- *
- * @example
- * ```ts
- * reverseName("0x1234", BigInt(ETH_COIN_TYPE)) // "1234.addr.reverse"
- * reverseName("0x1234", BigInt(0x80000000)) // "1234.default.reverse"
- * reverseName("0x1234", BigInt(0x5678)) // "1234.5678.reverse"
- * ```
+ * Serializes a {@link Price} object.
  */
-declare function reverseName(address: Address, coinType: CoinType): Name;
-
+declare function serializePrice(price: Price): SerializedPrice;
 /**
- * Parse the address and coinType out of an ENSIP-19 reverse name.
+ * Serializes a {@link PriceEth} object.
  */
-declare function parseReverseName(name: Name): {
-    address: Address;
-    coinType: CoinType;
-} | null;
-
+declare function serializePriceEth(price: PriceEth): SerializedPriceEth;
 /**
- * Formats a LabelHash as an Encoded LabelHash.
+ * Serializes {@link AccountId} object.
  *
- * @see https://ensnode.io/docs/reference/terminology#encoded-labelhash
+ * Formatted as a fully lowercase CAIP-10 AccountId.
  *
- * @param labelHash - A 32-byte hash string starting with '0x'
- * @returns The encoded label hash in format `[hash_without_0x_prefix]`
+ * @see https://chainagnostic.org/CAIPs/caip-10
  */
-declare const encodeLabelHash: (labelHash: LabelHash) => EncodedLabelHash;
+declare function serializeAccountId(accountId: AccountId): SerializedAccountId;
+
+declare function isHttpProtocol(url: URL): boolean;
+declare function isWebSocketProtocol(url: URL): boolean;
 
 /**
  * A label set ID identifies a set of labels that can be used for deterministic healing.
@@ -504,22 +1030,56 @@ declare enum PluginName {
     Basenames = "basenames",
     Lineanames = "lineanames",
     ThreeDNS = "threedns",
-    ReverseResolvers = "reverse-resolvers",
-    Referrals = "referrals",
+    ProtocolAcceleration = "protocol-acceleration",
+    Registrars = "registrars",
     TokenScope = "tokenscope"
 }
 /**
- * Information about ENSIndexer's dependencies.
+ * Version info about ENSIndexer and its dependencies.
  */
-interface DependencyInfo {
-    /** Node.js runtime version */
+interface ENSIndexerVersionInfo {
+    /**
+     * Node.js runtime version
+     *
+     * @see https://nodejs.org/en/about/previous-releases
+     **/
     nodejs: string;
-    /** Ponder framework version */
+    /**
+     * Ponder framework version
+     *
+     * @see https://www.npmjs.com/package/ponder
+     **/
     ponder: string;
-    /** ENSRainbow service version */
+    /**
+     * ENSDb service version
+     *
+     * Guaranteed to be the same as {@link ENSIndexerVersionInfo.ensIndexer}.
+     * */
+    ensDb: string;
+    /**
+     * ENSIndexer service version
+     *
+     * @see https://ghcr.io/namehash/ensnode/ensindexer
+     **/
+    ensIndexer: string;
+    /**
+     * ENSRainbow service version
+     *
+     * @see https://ghcr.io/namehash/ensnode/ensindexer
+     **/
     ensRainbow: string;
-    /** ENSRainbow schema version */
+    /**
+     * ENSRainbow schema version
+     **/
     ensRainbowSchema: number;
+    /**
+     * ENS Normalize package version
+     *
+     * Available on NPM as: `@adraffy/ens-normalize`
+     *
+     * @see https://www.npmjs.com/package/@adraffy/ens-normalize
+     **/
+    ensNormalize: string;
 }
 /**
  * Complete public configuration object for ENSIndexer.
@@ -534,24 +1094,6 @@ interface ENSIndexerPublicConfig {
      * See {@link ENSNamespaceIds} for available namespace identifiers.
      */
     namespace: ENSNamespaceId;
-    /**
-     * An ENSAdmin URL
-     *
-     * The ENSNode root api route `/` redirects to {@link ensAdminUrl},
-     * configuring ENSAdmin with an entry for this instance of ENSNode,
-     * identified by {@link ensNodePublicUrl}.
-     *
-     * @see https://ensnode.io/ensadmin/overview/what-is-ensadmin
-     */
-    ensAdminUrl: URL;
-    /**
-     * The publicly accessible endpoint of the ENSNode API
-     * (ex: http://localhost:42069).
-     *
-     * ENSAdmin will use this url to connect to the ENSNode api for querying
-     * state about the ENSNode instance.
-     */
-    ensNodePublicUrl: URL;
     /**
      * The "fully pinned" label set reference that ENSIndexer will request ENSRainbow use for deterministic label healing across time. This label set reference is "fully pinned" as it requires both the labelSetId and labelSetVersion fields to be defined.
      */
@@ -566,234 +1108,100 @@ interface ENSIndexerPublicConfig {
      */
     databaseSchemaName: string;
     /**
-     * A set of {@link PluginName}s indicating which plugins to activate.
+     * A set of strings referring to the names of plugins that are active.
+     *
+     * For future-proofing, this is a list of strings that may or may
+     * not be currently valid {@link PluginName} values.
      *
      * Invariants:
-     * - A set of valid {@link PluginName}s with at least one value
+     * - A set of strings with at least one value.
      */
-    plugins: PluginName[];
+    plugins: string[];
     /**
-     * Enable or disable healing of addr.reverse subnames.
-     * If this is set to true, ENSIndexer will attempt to heal subnames of
-     * addr.reverse.
+     * Indexed Chain IDs
+     *
+     * Includes the {@link ChainId} for each chain being indexed.
      */
-    healReverseAddresses: boolean;
+    indexedChainIds: Set<ChainId>;
     /**
-     * Enable or disable the indexing of Resolver record values.
-     * If this is set to false, ENSIndexer will apply subgraph-backwards
-     * compatible logic that only tracks the keys of Resolver records.
-     * If this is set to true, ENSIndexer will track both the keys and the values
-     * of Resolver records.
+     * A feature flag to enable/disable ENSIndexer's Subgraph Compatible Indexing Behavior.
      *
-     * WARNING: Special care must be taken when interacting with indexed resolver
-     * record values. It is unsafe to naively assume that indexed resolver record
-     * values are equivalent to the resolver record values that would be returned
-     * through dynamic lookups via the ENS protocol. For example, if a resolver
-     * implements CCIP-Read, the resolver records may not be discoverable through
-     * onchain indexing. This feature is under R&D. At this time we do not
-     * recommend anyone directly use indexed resolver record values in their
-     * applications. Features are planned in the ENSNode roadmap that will
-     * provide safe use of indexed resolver record values (in appropriate
-     * contexts).
+     * If {@link isSubgraphCompatible} is true, indexing behavior will match that of the legacy ENS
+     * Subgraph.
      *
-     * Note that enabling {@link indexAdditionalResolverRecords} results in indexed data becoming a
-     * _superset_ of the Subgraph. For exact data-level backwards compatibility with the ENS Subgraph,
-     * {@link indexAdditionalResolverRecords} should be `false`.
-     */
-    indexAdditionalResolverRecords: boolean;
-    /**
-     * Controls ENSIndexer's handling of Literal Labels and Literal Names
-     * This configuration only applies to the Subgraph datamodel and Subgraph Compatible GraphQL API responses.
+     * ENSIndexer will store and return Literal Labels and Literal Names without further interpretation.
+     * @see https://ensnode.io/docs/reference/terminology#literal-label
+     * @see https://ensnode.io/docs/reference/terminology#literal-name
      *
-     * When set to true, all Literal Labels and Literal Names encountered by ENSIndexer will be Interpreted.
-     * - https://ensnode.io/docs/reference/terminology#interpreted-label
-     * - https://ensnode.io/docs/reference/terminology#interpreted-name
+     * If {@link isSubgraphCompatible} is true, the following invariants are true for the ENSIndexerConfig:
+     * 1. only the 'subgraph' plugin is enabled, and
+     * 2. the labelSet must be { labelSetId: 'subgraph', labelSetVersion: 0 }
      *
-     * That is,
-     * 1) all Labels stored and returned by ENSIndexer will either be normalized or represented as an Encoded
-     *    LabelHash, and
-     * 2) all Names stored and returned by ENSIndexer will either be normalized or consist of Labels that
-     *    may be represented as an Encoded LabelHash of the Literal Label value found onchain.
+     * If {@link isSubgraphCompatible} is false, ENSIndexer will additionally:
      *
-     * When set to false, ENSIndexer will store and return Literal Labels and Literal Names without further
-     * interpretation.
-     * - https://ensnode.io/docs/reference/terminology#literal-label
-     * - https://ensnode.io/docs/reference/terminology#literal-name
+     * 1. ENSIndexer will heal all subnames of addr.reverse on the ENS Root Chain.
      *
-     * NOTE: {@link replaceUnnormalized} must be `false` for subgraph compatible indexing behavior.
-     */
-    replaceUnnormalized: boolean;
-    /**
-     * Indexed Chain IDs
+     * 2. ENSIndexer will track both the keys and the values of Resolver records.
      *
-     * Includes the {@link ChainId} for each chain being indexed.
-     */
-    indexedChainIds: Set<ChainId>;
-    /**
-     * A flag derived from the built config indicating whether ENSIndexer is operating in a
-     * subgraph-compatible way. This flag is true if:
-     * a) only the subgraph plugin is activated,
-     * b) healReverseAddresess is false, and
-     * c) indexRecordValues is false
+     * WARNING: Special care must be taken when interacting with indexed resolver record values. It
+     * is unsafe to naively assume that indexed resolver record values are equivalent to the
+     * resolver record values that would be returned through dynamic lookups via the ENS protocol.
+     * For example, if a resolver implements CCIP-Read, the resolver records may not be
+     * discoverable through onchain indexing.
      *
-     * If {@link isSubgraphCompatible} is true, ENSIndexer will:
-     * 1) use subgraph-compatible IDs for entities and events
-     * 2) limit indexing behavior to subgraph indexing semantics
+     * 3. Literal Labels and Literal Names encountered by ENSIndexer will be Interpreted.
+     * @see https://ensnode.io/docs/reference/terminology#interpreted-label
+     * @see https://ensnode.io/docs/reference/terminology#interpreted-name
+     *
+     * That is,
+     * a) all Labels stored and returned by ENSIndexer will be Interpreted Labels, which are either:
+     *    i. normalized, or
+     *    ii. represented as an Encoded LabelHash of the Literal Label value found onchain, and
+     * b) all Names stored and returned by ENSIndexer will be Interpreted Names, which are exclusively
+     *   composed of Interpreted Labels.
      */
     isSubgraphCompatible: boolean;
     /**
-     * Information about the ENSIndexer instance dependencies.
+     * Version info about ENSIndexer.
      */
-    dependencyInfo: DependencyInfo;
+    versionInfo: ENSIndexerVersionInfo;
 }
 
 type SerializedIndexedChainIds = Array<ChainId>;
 /**
  * Serialized representation of {@link ENSIndexerPublicConfig}
  */
-interface SerializedENSIndexerPublicConfig extends Omit<ENSIndexerPublicConfig, "ensAdminUrl" | "ensNodePublicUrl" | "indexedChainIds"> {
-    /**
-     * String representation of {@link ENSIndexerPublicConfig.ensAdminUrl}.
-     */
-    ensAdminUrl: UrlString;
-    /**
-     * String representation of {@link ENSIndexerPublicConfig.ensNodePublicUrl}.
-     */
-    ensNodePublicUrl: UrlString;
+interface SerializedENSIndexerPublicConfig extends Omit<ENSIndexerPublicConfig, "indexedChainIds"> {
     /**
      * Array representation of {@link ENSIndexerPublicConfig.indexedChainIds}.
      */
     indexedChainIds: ChainId[];
 }
-
-/**
- * Serialize a {@link ENSIndexerPublicConfig} object.
- */
-declare function deserializeENSIndexerPublicConfig(maybeConfig: SerializedENSIndexerPublicConfig, valueLabel?: string): ENSIndexerPublicConfig;
-
 /**
- * Determines if the provided `config` produces an index equivalent to the ENS Subgraph.
- *
- * @see https://ensnode.io/docs/reference/subgraph-compatibility/
+ * Serialized representation of {@link ENSIndexerVersionInfo}
  */
-declare function isSubgraphCompatible(config: Pick<ENSIndexerPublicConfig, "plugins" | "healReverseAddresses" | "indexAdditionalResolverRecords" | "replaceUnnormalized" | "labelSet">): boolean;
+type SerializedENSIndexerVersionInfo = ENSIndexerVersionInfo;
 
-/**
- * Serializes a {@link ChainConfig} object.
- */
-declare function serializeIndexedChainIds(indexedChainIds: Set<ChainId>): SerializedIndexedChainIds;
 /**
  * Serialize a {@link ENSIndexerPublicConfig} object.
  */
-declare function serializeENSIndexerPublicConfig(config: ENSIndexerPublicConfig): SerializedENSIndexerPublicConfig;
-
-/**
- * All zod schemas we define must remain internal implementation details.
- * We want the freedom to move away from zod in the future without impacting
- * any users of the ensnode-sdk package.
- *
- * The only way to share Zod schemas is to re-export them from
- * `./src/internal.ts` file.
- */
-
-/**
- * Zod `.check()` function input.
- */
-type ZodCheckFnInput<T> = z.core.ParsePayload<T>;
-
-/**
- * All zod schemas we define must remain internal implementation details.
- * We want the freedom to move away from zod in the future without impacting
- * any users of the ensnode-sdk package.
- *
- * The only way to share Zod schemas is to re-export them from
- * `./src/internal.ts` file.
- */
+declare function deserializeENSIndexerPublicConfig(maybeConfig: SerializedENSIndexerPublicConfig, valueLabel?: string): ENSIndexerPublicConfig;
 
 /**
- * Makes a schema for parsing {@link IndexedChainIds}.
- */
-declare const makeIndexedChainIdsSchema: (valueLabel?: string) => z.ZodPipe<z.ZodArray<z.ZodInt>, z.ZodTransform<Set<number>, number[]>>;
-/**
- * Makes a schema for parsing a list of {@link PluginName} items.
- *
- * The list is guaranteed to include at least one item exists, and no duplicates.
- */
-declare const makePluginsListSchema: (valueLabel?: string) => z.ZodArray<z.ZodEnum<typeof PluginName>>;
-/**
- * Makes a schema for parsing a name for a database schema.
+ * Determines if the provided `config` results in indexing behavior compatible with the legacy ENS
+ * Subgraph.
  *
- * The name is guaranteed to be a non-empty string.
- */
-declare const makeDatabaseSchemaNameSchema: (valueLabel?: string) => z.ZodString;
-/**
- * Makes a schema for parsing a label set ID.
- *
- * The label set ID is guaranteed to be a string between 1-50 characters
- * containing only lowercase letters (a-z) and hyphens (-).
- *
- * @param valueLabel - The label to use in error messages (e.g., "Label set ID", "LABEL_SET_ID")
+ * @see https://ensnode.io/docs/reference/subgraph-compatibility/
  */
-declare const makeLabelSetIdSchema: (valueLabel: string) => z.ZodString;
-/**
- * Makes a schema for parsing a label set version.
- *
- * The label set version is guaranteed to be a non-negative integer.
- *
- * @param valueLabel - The label to use in error messages (e.g., "Label set version", "LABEL_SET_VERSION")
+declare function isSubgraphCompatible(config: Pick<ENSIndexerPublicConfig, "namespace" | "plugins" | "labelSet">): boolean;
 
- */
-declare const makeLabelSetVersionSchema: (valueLabel: string) => z.ZodPipe<z.coerce.ZodCoercedNumber<unknown>, z.ZodInt>;
-/**
- * Makes a schema for parsing a label set where both label set ID and label set version are required.
- *
- * @param valueLabel - The label to use in error messages (e.g., "Label set", "LABEL_SET")
- */
-declare const makeFullyPinnedLabelSetSchema: (valueLabel?: string) => z.ZodObject<{
-    labelSetId: z.ZodString;
-    labelSetVersion: z.ZodPipe<z.coerce.ZodCoercedNumber<unknown>, z.ZodInt>;
-}, z.core.$strip>;
-declare const makeDependencyInfoSchema: (valueLabel?: string) => z.ZodObject<{
-    nodejs: z.ZodString;
-    ponder: z.ZodString;
-    ensRainbow: z.ZodString;
-    ensRainbowSchema: z.ZodInt;
-}, z.core.$strict>;
-declare function invariant_reverseResolversPluginNeedsResolverRecords(ctx: ZodCheckFnInput<Pick<ENSIndexerPublicConfig, "plugins" | "indexAdditionalResolverRecords">>): void;
-declare function invariant_isSubgraphCompatibleRequirements(ctx: ZodCheckFnInput<Pick<ENSIndexerPublicConfig, "plugins" | "isSubgraphCompatible" | "healReverseAddresses" | "indexAdditionalResolverRecords" | "replaceUnnormalized" | "labelSet">>): void;
 /**
- * ENSIndexer Public Config Schema
- *
- * Makes a Zod schema definition for validating all important settings used
- * during runtime of the ENSIndexer instance.
+ * Converts a Labelhash to bytes, with validation
+ * @param labelHash The Labelhash to convert
+ * @returns A ByteArray containing the bytes
+ * @throws Error if `labelHash` is not a valid 32-byte hex string
  */
-declare const makeENSIndexerPublicConfigSchema: (valueLabel?: string) => z.ZodObject<{
-    ensAdminUrl: z.ZodPipe<z.ZodURL, z.ZodTransform<URL, string>>;
-    ensNodePublicUrl: z.ZodPipe<z.ZodURL, z.ZodTransform<URL, string>>;
-    labelSet: z.ZodObject<{
-        labelSetId: z.ZodString;
-        labelSetVersion: z.ZodPipe<z.coerce.ZodCoercedNumber<unknown>, z.ZodInt>;
-    }, z.core.$strip>;
-    healReverseAddresses: z.ZodBoolean;
-    indexAdditionalResolverRecords: z.ZodBoolean;
-    replaceUnnormalized: z.ZodBoolean;
-    indexedChainIds: z.ZodPipe<z.ZodArray<z.ZodInt>, z.ZodTransform<Set<number>, number[]>>;
-    isSubgraphCompatible: z.ZodBoolean;
-    namespace: z.ZodEnum<{
-        readonly Mainnet: "mainnet";
-        readonly Sepolia: "sepolia";
-        readonly Holesky: "holesky";
-        readonly EnsTestEnv: "ens-test-env";
-    }>;
-    plugins: z.ZodArray<z.ZodEnum<typeof PluginName>>;
-    databaseSchemaName: z.ZodString;
-    dependencyInfo: z.ZodObject<{
-        nodejs: z.ZodString;
-        ponder: z.ZodString;
-        ensRainbow: z.ZodString;
-        ensRainbowSchema: z.ZodInt;
-    }, z.core.$strict>;
-}, z.core.$strip>;
+declare function labelHashToBytes(labelHash: LabelHash): ByteArray;
 
 /**
  * Builds a valid LabelSetId from a string.
@@ -825,14 +1233,6 @@ declare function buildEnsRainbowClientLabelSet(labelSetId?: LabelSetId, labelSet
  */
 declare function validateSupportedLabelSetAndVersion(serverSet: EnsRainbowServerLabelSet, clientSet: EnsRainbowClientLabelSet): void;
 
-/**
- * Converts a Labelhash to bytes, with validation
- * @param labelHash The Labelhash to convert
- * @returns A ByteArray containing the bytes
- * @throws Error if `labelHash` is not a valid 32-byte hex string
- */
-declare function labelHashToBytes(labelHash: LabelHash): ByteArray;
-
 /**
  * Parses a string into a non-negative integer.
  * @param input The string to parse
@@ -841,484 +1241,1516 @@ declare function labelHashToBytes(labelHash: LabelHash): ByteArray;
  */
 declare function parseNonNegativeInteger(maybeNumber: string): number;
 
-declare const ChainIndexingStatusIds: {
-    readonly Unstarted: "unstarted";
-    readonly Backfill: "backfill";
-    readonly Following: "following";
-    readonly Completed: "completed";
-};
 /**
- * ChainIndexingStatusId is the derived string union of possible Chain Indexing Status identifiers.
+ * Serializes a {@link ChainConfig} object.
+ */
+declare function serializeIndexedChainIds(indexedChainIds: Set<ChainId>): SerializedIndexedChainIds;
+/**
+ * Serialize a {@link ENSIndexerPublicConfig} object.
  */
-type ChainIndexingStatusId = (typeof ChainIndexingStatusIds)[keyof typeof ChainIndexingStatusIds];
-declare const OverallIndexingStatusIds: {
-    readonly Unstarted: "unstarted";
-    readonly Backfill: "backfill";
-    readonly Following: "following";
-    readonly Completed: "completed";
-    readonly IndexerError: "indexer-error";
-};
+declare function serializeENSIndexerPublicConfig(config: ENSIndexerPublicConfig): SerializedENSIndexerPublicConfig;
+
 /**
- * OverallIndexingStatusId is the derived string union of possible Overall Indexing Status identifiers.
+ * The type of indexing configuration for a chain.
  */
-type OverallIndexingStatusId = (typeof OverallIndexingStatusIds)[keyof typeof OverallIndexingStatusIds];
-declare const ChainIndexingStrategyIds: {
+declare const ChainIndexingConfigTypeIds: {
+    /**
+     * Represents that indexing of the chain should be performed for an indefinite range.
+     */
     readonly Indefinite: "indefinite";
+    /**
+     * Represents that indexing of the chain should be performed for a definite range.
+     */
     readonly Definite: "definite";
 };
 /**
- * ChainIndexingStrategyIds is the derived string union of possible Chain Indexing Strategy identifiers.
+ * The derived string union of possible {@link ChainIndexingConfigTypeIds}.
  */
-type ChainIndexingStrategyId = (typeof ChainIndexingStrategyIds)[keyof typeof ChainIndexingStrategyIds];
+type ChainIndexingConfigTypeId = (typeof ChainIndexingConfigTypeIds)[keyof typeof ChainIndexingConfigTypeIds];
 /**
- * Chain Indexing Indefinite Config
+ * Chain indexing config for a chain whose indexing config `configType` is
+ * {@link ChainIndexingConfigTypeIds.Indefinite}.
  *
- * Configures a chain to be indexed for an indefinite range.
+ * Invariants:
+ * - `configType` is always `ChainIndexingConfigTypeIds.Indefinite`.
  */
-interface ChainIndexingIndefiniteConfig {
+interface ChainIndexingConfigIndefinite {
     /**
-     * Chain indexing strategy.
+     * The type of chain indexing config.
      */
-    strategy: typeof ChainIndexingStrategyIds.Indefinite;
+    configType: typeof ChainIndexingConfigTypeIds.Indefinite;
     /**
-     * The block where indexing of the chain starts.
-     *
-     * An indexed chain always has its `startBlock` defined.
+     * A {@link BlockRef} to the block where indexing of the chain should start.
      */
     startBlock: BlockRef;
-    /**
-     * Indefinite chain indexing configs always have a null `endBlock`.
-     */
-    endBlock?: null;
 }
 /**
- * Chain Indexing Definite Config
- *
- * Configures a chain to be indexed for a definite range.
+ * Chain indexing config for a chain whose indexing config `configType` is
+ * {@link ChainIndexingConfigTypeIds.Definite}.
  *
  * Invariants:
- * - `startBlock` is always before or the same as `endBlock`
+ * - `configType` is always `ChainIndexingConfigTypeIds.Definite`.
+ * - `startBlock` is always before or the same as `endBlock`.
  */
-interface ChainIndexingDefiniteConfig {
+interface ChainIndexingConfigDefinite {
     /**
-     * Chain indexing strategy.
+     * The type of chain indexing config.
      */
-    strategy: typeof ChainIndexingStrategyIds.Definite;
+    configType: typeof ChainIndexingConfigTypeIds.Definite;
     /**
-     * The block where indexing of the chain starts.
-     *
-     * `startBlock` must always be defined.
+     * A {@link BlockRef} to the block where indexing of the chain should start.
      */
     startBlock: BlockRef;
     /**
-     * The block where indexing of the chain ends.
-     *
-     * Definite chain indexing configs always have a defined `endBlock`.
+     * A {@link BlockRef} to the block where indexing of the chain should end.
      */
     endBlock: BlockRef;
 }
 /**
- * Chain Indexing Config
+ * Indexing configuration for a chain.
  *
- * Configuration of an indexed chain.
+ * Use the `configType` field to determine the specific type interpretation
+ * at runtime.
+ */
+type ChainIndexingConfig = ChainIndexingConfigIndefinite | ChainIndexingConfigDefinite;
+/**
+ * The status of indexing a chain at the time an indexing status snapshot
+ * is captured.
+ */
+declare const ChainIndexingStatusIds: {
+    /**
+     * Represents that indexing of the chain is not ready to begin yet because:
+     * - ENSIndexer is in its initialization phase and the data to build a
+     *   "true" {@link ChainIndexingSnapshot} for the chain is still being loaded; or
+     * - ENSIndexer is using an omnichain indexing strategy and the
+     *   `omnichainIndexingCursor` is <= `config.startBlock.timestamp` for the chain's
+     *   {@link ChainIndexingSnapshot}.
+     */
+    readonly Queued: "chain-queued";
+    /**
+     * Represents that indexing of the chain is in progress and under a special
+     * "backfill" phase that optimizes for accelerated indexing until reaching the
+     * "fixed target" `backfillEndBlock`.
+     */
+    readonly Backfill: "chain-backfill";
+    /**
+     * Represents that the "backfill" phase of indexing the chain is completed
+     * and that the chain is configured to be indexed for an indefinite range.
+     * Therefore, indexing of the chain remains indefinitely in progress where
+     * ENSIndexer will continuously work to discover and index new blocks as they
+     * are added to the chain across time.
+     */
+    readonly Following: "chain-following";
+    /**
+     * Represents that indexing of the chain is completed as the chain is configured
+     * to be indexed for a definite range and the indexing of all blocks through
+     * that definite range is completed.
+     */
+    readonly Completed: "chain-completed";
+};
+/**
+ * The derived string union of possible {@link ChainIndexingStatusIds}.
  */
-type ChainIndexingConfig = ChainIndexingIndefiniteConfig | ChainIndexingDefiniteConfig;
+type ChainIndexingStatusId = (typeof ChainIndexingStatusIds)[keyof typeof ChainIndexingStatusIds];
 /**
- * Chain Indexing Status: Unstarted
+ * Chain indexing status snapshot for a chain whose `chainStatus` is
+ * {@link ChainIndexingStatusIds.Queued}.
  *
- * Notes:
- * - The "unstarted" status applies when using omnichain ordering and
- *   the omnichainIndexingCursor from the overall indexing status <= config.startBlock.timestamp.
+ * Invariants:
+ * - `chainStatus` is always {@link ChainIndexingStatusIds.Queued}.
  */
-interface ChainIndexingUnstartedStatus {
-    status: typeof ChainIndexingStatusIds.Unstarted;
+interface ChainIndexingStatusSnapshotQueued {
+    /**
+     * The status of indexing the chain at the time the indexing status snapshot
+     * was captured.
+     */
+    chainStatus: typeof ChainIndexingStatusIds.Queued;
+    /**
+     * The indexing configuration of the chain.
+     */
     config: ChainIndexingConfig;
 }
 /**
- * Chain Indexing Status: Backfill
+ * Chain indexing status snapshot for a chain whose `chainStatus` is
+ * {@link ChainIndexingStatusIds.Backfill}.
  *
  * During a backfill, special performance optimizations are applied to
- * index all blocks between config.startBlock and backfillEndBlock
+ * index all blocks between `config.startBlock` and `backfillEndBlock`
  * as fast as possible.
  *
- * Notes:
- * - The backfillEndBlock is either config.endBlock (if present) or
- *   the latest block on the chain when the ENSIndexer process started up.
- *   Note how this means the backfillEndBlock is always a "fixed target".
- * - When latestIndexedBlock reaches backfillEndBlock, the backfill is complete.
- *   The moment backfill is complete the status does not immediately transition.
- *   Instead, internal processing is completed for a period of time while
- *   the status remains "backfill". After this internal processing is completed
- *   the status will change to "following" or "completed" depending on
- *   the configured indexing strategy. If the strategy is indefinite,
- *   changes to "following", else if the strategy is definite, changes to
- *   "completed".
+ * Note how `backfillEndBlock` is a "fixed target" that does not change during
+ * the lifetime of an ENSIndexer process instance:
+ * - If the `config` is {@link ChainIndexingConfigDefinite}:
+ *   `backfillEndBlock` is always the same as `config.endBlock`.
+ * - If the `config` is {@link ChainIndexingConfigIndefinite}:
+ *   `backfillEndBlock` is a {@link BlockRef} to what was the latest block on the
+ *    chain when the ENSIndexer process was performing its initialization. Note how
+ *    this means that if the backfill process takes X hours to complete, because the
+ *    `backfillEndBlock` is a "fixed target", when `chainStatus` transitions to
+ *    {@link ChainIndexingStatusIds.Following} the chain will be X hours behind
+ *    "realtime" indexing.
+ *
+ * When `latestIndexedBlock` reaches `backfillEndBlock` the backfill is complete.
+ * The moment backfill is complete the `chainStatus` may not immediately transition.
+ * Instead, internal processing is completed for a period of time while
+ * `chainStatus` remains {@link ChainIndexingStatusIds.Backfill}. After this internal
+ * processing is completed `chainStatus` will transition:
+ * - to {@link ChainIndexingStatusIds.Following} if the `config` is
+ *   {@link ChainIndexingConfigIndefinite}.
+ * - to {@link ChainIndexingStatusIds.Completed} if the `config` is
+ *   {@link ChainIndexingConfigDefinite}.
  *
  * Invariants:
+ * - `chainStatus` is always {@link ChainIndexingStatusIds.Backfill}.
  * - `config.startBlock` is always before or the same as `latestIndexedBlock`
- * - `latestIndexedBlock` is always before or the same as `latestSyncedBlock`
- * - `latestSyncedBlock` is always before or the same as `backfillEndBlock`
- * - `backfillEndBlock` is the same as `config.endBlock` if and only if
- *   the config is definite.
+ * - `config.endBlock` is always the same as `backfillEndBlock` if and only if
+ *   the config is {@link ChainIndexingConfigDefinite}.
+ * - `latestIndexedBlock` is always before or the same as `backfillEndBlock`
  */
-interface ChainIndexingBackfillStatus {
-    status: typeof ChainIndexingStatusIds.Backfill;
+interface ChainIndexingStatusSnapshotBackfill {
+    /**
+     * The status of indexing the chain at the time the indexing status snapshot
+     * was captured.
+     */
+    chainStatus: typeof ChainIndexingStatusIds.Backfill;
+    /**
+     * The indexing configuration of the chain.
+     */
     config: ChainIndexingConfig;
     /**
-     * The block that was most recently indexed.
+     * A {@link BlockRef} to the block that was most recently indexed as of the time the
+     * indexing status snapshot was captured.
      */
     latestIndexedBlock: BlockRef;
     /**
-     * The "highest" block that has been synced into RPC cache. Backfill indexing
-     * is accelerated by cached RPC calls through this block height.
+     * A {@link BlockRef} to the block where the backfill will end.
+     */
+    backfillEndBlock: BlockRef;
+}
+/**
+ * Chain indexing status snapshot for a chain whose `chainStatus` is
+ * {@link ChainIndexingStatusIds.Following}.
+ *
+ * Invariants:
+ * - `chainStatus` is always {@link ChainIndexingStatusIds.Following}.
+ * - `config` is always {@link ChainIndexingConfigIndefinite}
+ * - `config.startBlock` is always before or the same as `latestIndexedBlock`
+ * - `latestIndexedBlock` is always before or the same as `latestKnownBlock`
+ */
+interface ChainIndexingStatusSnapshotFollowing {
+    /**
+     * The status of indexing the chain at the time the indexing status snapshot
+     * was captured.
      */
-    latestSyncedBlock: BlockRef;
+    chainStatus: typeof ChainIndexingStatusIds.Following;
     /**
-     * The block that is the target for finishing the backfill.
+     * The indexing configuration of the chain.
      */
-    backfillEndBlock: BlockRef;
+    config: ChainIndexingConfigIndefinite;
+    /**
+     * A {@link BlockRef} to the block that was most recently indexed as of the time the
+     * indexing status snapshot was captured.
+     */
+    latestIndexedBlock: BlockRef;
+    /**
+     * A {@link BlockRef} to the "highest" block that has been discovered by RPCs
+     * and stored in the RPC cache as of the time the indexing status snapshot was
+     * captured.
+     */
+    latestKnownBlock: BlockRef;
+}
+/**
+ * Chain indexing status snapshot for a chain whose `chainStatus` is
+ * {@link ChainIndexingStatusIds.Completed}.
+ *
+ * After the backfill of a chain is completed, if the chain was configured
+ * to be indexed for a definite range, the chain indexing status will transition to
+ * {@link ChainIndexingStatusIds.Completed}.
+ *
+ * Invariants:
+ * - `chainStatus` is always {@link ChainIndexingStatusIds.Completed}.
+ * - `config` is always {@link ChainIndexingConfigDefinite}
+ * - `config.startBlock` is always before or the same as `latestIndexedBlock`
+ * - `latestIndexedBlock` is always the same as `config.endBlock`.
+ */
+interface ChainIndexingStatusSnapshotCompleted {
+    /**
+     * The status of indexing the chain at the time the indexing status snapshot
+     * was captured.
+     */
+    chainStatus: typeof ChainIndexingStatusIds.Completed;
+    /**
+     * The indexing configuration of the chain.
+     */
+    config: ChainIndexingConfigDefinite;
+    /**
+     * A {@link BlockRef} to the block that was most recently indexed as of the time the
+     * indexing status snapshot was captured.
+     */
+    latestIndexedBlock: BlockRef;
+}
+/**
+ * Indexing status snapshot for a single chain.
+ *
+ * Use the `chainStatus` field to determine the specific type interpretation
+ * at runtime.
+ */
+type ChainIndexingStatusSnapshot = ChainIndexingStatusSnapshotQueued | ChainIndexingStatusSnapshotBackfill | ChainIndexingStatusSnapshotFollowing | ChainIndexingStatusSnapshotCompleted;
+/**
+ * The status of omnichain indexing at the time an omnichain indexing status
+ * snapshot is captured.
+ */
+declare const OmnichainIndexingStatusIds: {
+    /**
+     * Represents that omnichain indexing is not ready to begin yet because
+     * ENSIndexer is in its initialization phase and the data to build a "true"
+     * {@link OmnichainIndexingStatusSnapshot} is still being loaded.
+     */
+    readonly Unstarted: "omnichain-unstarted";
+    /**
+     * Represents that omnichain indexing is in an overall "backfill" status because
+     * - At least one indexed chain has a `chainStatus` of
+     *   {@link ChainIndexingStatusIds.Backfill}; and
+     * - No indexed chain has a `chainStatus` of {@link ChainIndexingStatusIds.Following}.
+     */
+    readonly Backfill: "omnichain-backfill";
+    /**
+     * Represents that omnichain indexing is in an overall "following" status because
+     * at least one indexed chain has a `chainStatus` of
+     * {@link ChainIndexingStatusIds.Following}.
+     */
+    readonly Following: "omnichain-following";
+    /**
+     * Represents that omnichain indexing has completed because all indexed chains have
+     * a `chainStatus` of {@link ChainIndexingStatusIds.Completed}.
+     */
+    readonly Completed: "omnichain-completed";
+};
+/**
+ * The derived string union of possible {@link OmnichainIndexingStatusIds}.
+ */
+type OmnichainIndexingStatusId = (typeof OmnichainIndexingStatusIds)[keyof typeof OmnichainIndexingStatusIds];
+/**
+ * Omnichain indexing status snapshot when the overall `omnichainStatus` is
+ * {@link OmnichainIndexingStatusIds.Unstarted}.
+ *
+ * Invariants:
+ * - `omnichainStatus` is always {@link OmnichainIndexingStatusIds.Unstarted}.
+ * - `chains` is always a map to {@link ChainIndexingStatusSnapshotQueued} values exclusively.
+ * - `omnichainIndexingCursor` is always < the `config.startBlock.timestamp` for all
+ *   chains with `chainStatus` of {@link ChainIndexingStatusIds.Queued}.
+ */
+interface OmnichainIndexingStatusSnapshotUnstarted {
+    /**
+     * The status of omnichain indexing.
+     */
+    omnichainStatus: typeof OmnichainIndexingStatusIds.Unstarted;
+    /**
+     * The indexing status snapshot for each indexed chain.
+     */
+    chains: Map<ChainId, ChainIndexingStatusSnapshotQueued>;
+    /**
+     * The timestamp of omnichain indexing progress across all indexed chains.
+     */
+    omnichainIndexingCursor: UnixTimestamp;
+}
+/**
+ * The range of {@link ChainIndexingSnapshot} types allowed when the
+ * overall omnichain indexing status is {@link OmnichainIndexingStatusIds.Backfill}.
+ *
+ * Note that this is all of the {@link ChainIndexingSnapshot} types with the exception
+ * of {@link ChainIndexingStatusSnapshotFollowing}.
+ */
+type ChainIndexingStatusSnapshotForOmnichainIndexingStatusSnapshotBackfill = ChainIndexingStatusSnapshotQueued | ChainIndexingStatusSnapshotBackfill | ChainIndexingStatusSnapshotCompleted;
+/**
+ * Omnichain indexing status snapshot when the `omnichainStatus` is
+ * {@link OmnichainIndexingStatusIds.Backfill}.
+ *
+ * Invariants:
+ * - `omnichainStatus` is always {@link OmnichainIndexingStatusIds.Backfill}.
+ * - `chains` is guaranteed to contain at least one chain with a `chainStatus` of
+ *   {@link ChainIndexingStatusIds.Backfill}.
+ * - `chains` is guaranteed to not to contain any chain with a `chainStatus` of
+ *   {@link ChainIndexingStatusIds.Following}
+ * - `omnichainIndexingCursor` is always < the `config.startBlock.timestamp` for all
+ *   chains with `chainStatus` of {@link ChainIndexingStatusIds.Queued}.
+ * - `omnichainIndexingCursor` is always <= the `backfillEndBlock.timestamp` for all
+ *   chains with `chainStatus` of {@link ChainIndexingStatusIds.Backfill}.
+ * - `omnichainIndexingCursor` is always >= the `latestIndexedBlock.timestamp` for all
+ *    chains with `chainStatus` of {@link ChainIndexingStatusIds.Completed}.
+ * - `omnichainIndexingCursor` is always equal to the timestamp of the highest
+ *   `latestIndexedBlock` across all chains that have started indexing
+ *   (`chainStatus` is not {@link ChainIndexingStatusIds.Queued}).
+ */
+interface OmnichainIndexingStatusSnapshotBackfill {
+    /**
+     * The status of omnichain indexing.
+     */
+    omnichainStatus: typeof OmnichainIndexingStatusIds.Backfill;
+    /**
+     * The indexing status snapshot for each indexed chain.
+     */
+    chains: Map<ChainId, ChainIndexingStatusSnapshotForOmnichainIndexingStatusSnapshotBackfill>;
+    /**
+     * The timestamp of omnichain indexing progress across all indexed chains.
+     */
+    omnichainIndexingCursor: UnixTimestamp;
+}
+/**
+ * Omnichain indexing status snapshot when the overall `omnichainStatus` is
+ * {@link OmnichainIndexingStatusIds.Following}.
+ *
+ * Invariants:
+ * - `omnichainStatus` is always {@link OmnichainIndexingStatusIds.Following}.
+ * - `chains` is guaranteed to contain at least one chain with a `status` of
+ *   {@link ChainIndexingStatusIds.Following}.
+ * - `omnichainIndexingCursor` is always < the `config.startBlock.timestamp` for all
+ *   chains with `chainStatus` of {@link ChainIndexingStatusIds.Queued}.
+ * - `omnichainIndexingCursor` is always <= the `backfillEndBlock.timestamp` for all
+ *   chains with `chainStatus` of {@link ChainIndexingStatusIds.Backfill}.
+ * - `omnichainIndexingCursor` is always >= the `latestIndexedBlock.timestamp` for all
+ *    chains with `chainStatus` of {@link ChainIndexingStatusIds.Completed}.
+ * - `omnichainIndexingCursor` is always equal to the timestamp of the highest
+ *   `latestIndexedBlock` across all chains that have started indexing
+ *   (`chainStatus` is not {@link ChainIndexingStatusIds.Queued}).
+ */
+interface OmnichainIndexingStatusSnapshotFollowing {
+    /**
+     * The status of omnichain indexing.
+     */
+    omnichainStatus: typeof OmnichainIndexingStatusIds.Following;
+    /**
+     * The indexing status snapshot for each indexed chain.
+     */
+    chains: Map<ChainId, ChainIndexingStatusSnapshot>;
+    /**
+     * The timestamp of omnichain indexing progress across all indexed chains.
+     */
+    omnichainIndexingCursor: UnixTimestamp;
+}
+/**
+ * Omnichain indexing status snapshot when the overall `omnichainStatus` is
+ * {@link OmnichainIndexingStatusIds.Completed}.
+ *
+ * Invariants:
+ * - `omnichainStatus` is always {@link OmnichainIndexingStatusIds.Completed}.
+ * - `chains` is always a map to {@link ChainIndexingStatusSnapshotCompleted} values exclusively.
+ * - `omnichainIndexingCursor` is always equal to the highest
+ *   `latestIndexedBlock.timestamp` for all chains.
+ */
+interface OmnichainIndexingStatusSnapshotCompleted {
+    /**
+     * The status of omnichain indexing.
+     */
+    omnichainStatus: typeof OmnichainIndexingStatusIds.Completed;
+    /**
+     * The indexing status snapshot for each indexed chain.
+     */
+    chains: Map<ChainId, ChainIndexingStatusSnapshotCompleted>;
+    /**
+     * The timestamp of omnichain indexing progress across all indexed chains.
+     */
+    omnichainIndexingCursor: UnixTimestamp;
 }
 /**
- * Chain Indexing Status: Following
+ * Omnichain indexing status snapshot for one or more chains.
+ *
+ * Use the `omnichainStatus` field to determine the specific type interpretation
+ * at runtime.
+ */
+type OmnichainIndexingStatusSnapshot = OmnichainIndexingStatusSnapshotUnstarted | OmnichainIndexingStatusSnapshotBackfill | OmnichainIndexingStatusSnapshotCompleted | OmnichainIndexingStatusSnapshotFollowing;
+/**
+ * The strategy used for indexing one or more chains.
+ *
+ * @see https://ponder.sh/docs/api-reference/ponder/config#parameters
+ */
+declare const CrossChainIndexingStrategyIds: {
+    /**
+     * Represents that the indexing of events across all indexed chains will
+     * proceed in a deterministic "omnichain" ordering by block timestamp, chain ID,
+     * and block number.
+     *
+     * This strategy is "deterministic" in that the order of processing cross-chain indexed
+     * events and each resulting indexed data state transition recorded in ENSDb is always
+     * the same for each ENSIndexer instance operating with an equivalent
+     * `ENSIndexerConfig` and ENSIndexer version. However it also has the drawbacks of:
+     * - increased indexing latency that must wait for the slowest indexed chain to
+     *   add new blocks or to discover new blocks through the configured RPCs.
+     * - if any indexed chain gets "stuck" due to chain or RPC failures, all indexed chains
+     *   will be affected.
+     */
+    readonly Omnichain: "omnichain";
+};
+/**
+ * The derived string union of possible {@link CrossChainIndexingStrategyIds}.
+ */
+type CrossChainIndexingStrategyId = (typeof CrossChainIndexingStrategyIds)[keyof typeof CrossChainIndexingStrategyIds];
+/**
+ * Cross-chain indexing status snapshot when the `strategy` is
+ * {@link CrossChainIndexingStrategyId.Omnichain}.
+ *
+ * Invariants:
+ * - `strategy` is always {@link CrossChainIndexingStrategyId.Omnichain}.
+ * - `slowestChainIndexingCursor` is always equal to
+ *   `omnichainSnapshot.omnichainIndexingCursor`.
+ * - `snapshotTime` is always >= the "highest known block timestamp", defined as the max of:
+ *     - the `slowestChainIndexingCursor`.
+ *     - the `config.startBlock.timestamp` for all indexed chains.
+ *     - the `config.endBlock.timestamp` for all indexed chains with a `config.configType` of
+ *       {@link ChainIndexingConfigTypeIds.Definite}.
+ *     - the `backfillEndBlock.timestamp` for all chains with `chainStatus` of
+ *       {@link ChainIndexingStatusIds.Backfill}.
+ *     - the `latestKnownBlock.timestamp` for all chains with `chainStatus` of
+ *       {@link ChainIndexingStatusIds.Following}.
+ */
+interface CrossChainIndexingStatusSnapshotOmnichain {
+    /**
+     * The strategy used for indexing one or more chains.
+     */
+    strategy: typeof CrossChainIndexingStrategyIds.Omnichain;
+    /**
+     * The timestamp of the "slowest" latest indexed block timestamp
+     * across all indexed chains.
+     */
+    slowestChainIndexingCursor: UnixTimestamp;
+    /**
+     * The timestamp when the cross-chain indexing status snapshot was generated.
+     *
+     * Due to possible clock skew between different systems this value must be set
+     * to the max of each of the following values to ensure all invariants are followed:
+     * - the current system time of the system generating this cross-chain indexing
+     *   status snapshot.
+     * - the "highest known block timestamp" (see invariants above for full definition).
+     */
+    snapshotTime: UnixTimestamp;
+    /**
+     * The omnichain indexing status snapshot for one or more chains.
+     */
+    omnichainSnapshot: OmnichainIndexingStatusSnapshot;
+}
+/**
+ * Cross-chain indexing status snapshot for one or more chains.
+ *
+ * Use the `strategy` field to determine the specific type interpretation
+ * at runtime.
+ *
+ * Currently, only omnichain indexing is supported. This type could theoretically
+ * be extended to support other cross-chain indexing strategies in the future,
+ * such as Ponder's "multichain" indexing strategy that indexes each chain
+ * independently without deterministic ordering.
+ */
+type CrossChainIndexingStatusSnapshot = CrossChainIndexingStatusSnapshotOmnichain;
+/**
+ * A "realtime" indexing status projection based on worst-case assumptions
+ * from the `snapshot`.
+ *
+ * Invariants:
+ * - `projectedAt` is always >= `snapshot.snapshotTime`.
+ * - `worstCaseDistance` is always equal to
+ *   `projectedAt - snapshot.slowestChainIndexingCursor`.
+ */
+type RealtimeIndexingStatusProjection = {
+    /**
+     * The timestamp representing "now" as of the time this projection was generated.
+     */
+    projectedAt: UnixTimestamp;
+    /**
+     * The distance between `projectedAt` and `snapshot.slowestChainIndexingCursor`.
+     *
+     * This is "worst-case" because it assumes all of the following:
+     * - the `snapshot` (which may have `snapshot.snapshotTime < projectedAt`) is still the
+     *   latest snapshot and no indexing progress has been made since `snapshotTime`.
+     * - each indexed chain has added a new block as of `projectedAt`.
+     */
+    worstCaseDistance: Duration;
+    /**
+     * The {@link CrossChainIndexingStatusSnapshot} that this projection is based on.
+     */
+    snapshot: CrossChainIndexingStatusSnapshot;
+};
+
+/**
+ * Serialized representation of {@link ChainIndexingStatusSnapshot}
+ */
+type SerializedChainIndexingStatusSnapshot = ChainIndexingStatusSnapshot;
+/**
+ * Serialized representation of {@link ChainIndexingStatusSnapshotQueued}
+ */
+type SerializedChainIndexingStatusSnapshotQueued = ChainIndexingStatusSnapshotQueued;
+/**
+ * Serialized representation of {@link ChainIndexingStatusSnapshotBackfill}
+ */
+type SerializedChainIndexingStatusSnapshotBackfill = ChainIndexingStatusSnapshotBackfill;
+/**
+ * Serialized representation of {@link ChainIndexingStatusSnapshotCompleted}
+ */
+type SerializedChainIndexingStatusSnapshotCompleted = ChainIndexingStatusSnapshotCompleted;
+/**
+ * Serialized representation of {@link ChainIndexingStatusSnapshotFollowing}
+ */
+type SerializedChainIndexingStatusSnapshotFollowing = ChainIndexingStatusSnapshotFollowing;
+/**
+ * Serialized representation of {@link OmnichainIndexingStatusSnapshotUnstarted}
+ */
+interface SerializedOmnichainIndexingStatusSnapshotUnstarted extends Omit<OmnichainIndexingStatusSnapshotUnstarted, "chains"> {
+    chains: Record<ChainIdString, ChainIndexingStatusSnapshotQueued>;
+}
+/**
+ * Serialized representation of {@link OmnichainIndexingStatusSnapshotBackfill}
+ */
+interface SerializedOmnichainIndexingStatusSnapshotBackfill extends Omit<OmnichainIndexingStatusSnapshotBackfill, "chains"> {
+    chains: Record<ChainIdString, ChainIndexingStatusSnapshotForOmnichainIndexingStatusSnapshotBackfill>;
+}
+/**
+ * Serialized representation of {@link OmnichainIndexingStatusSnapshotCompleted}
+ */
+interface SerializedOmnichainIndexingStatusSnapshotCompleted extends Omit<OmnichainIndexingStatusSnapshotCompleted, "chains"> {
+    chains: Record<ChainIdString, ChainIndexingStatusSnapshotCompleted>;
+}
+/**
+ * Serialized representation of {@link OmnichainIndexingStatusSnapshotFollowing}
+ */
+interface SerializedOmnichainIndexingStatusSnapshotFollowing extends Omit<OmnichainIndexingStatusSnapshotFollowing, "chains"> {
+    chains: Record<ChainIdString, ChainIndexingStatusSnapshot>;
+}
+/**
+ * Serialized representation of {@link OmnichainIndexingStatusSnapshot}
+ */
+type SerializedOmnichainIndexingStatusSnapshot = SerializedOmnichainIndexingStatusSnapshotUnstarted | SerializedOmnichainIndexingStatusSnapshotBackfill | SerializedOmnichainIndexingStatusSnapshotCompleted | SerializedOmnichainIndexingStatusSnapshotFollowing;
+/**
+ * Serialized representation of {@link CrossChainIndexingStatusSnapshotOmnichain}
+ */
+interface SerializedCrossChainIndexingStatusSnapshotOmnichain extends Omit<CrossChainIndexingStatusSnapshotOmnichain, "omnichainSnapshot"> {
+    omnichainSnapshot: SerializedOmnichainIndexingStatusSnapshot;
+}
+/**
+ * Serialized representation of {@link CrossChainIndexingStatusSnapshot}
+ */
+type SerializedCrossChainIndexingStatusSnapshot = SerializedCrossChainIndexingStatusSnapshotOmnichain;
+/**
+ * Serialized representation of {@link RealtimeIndexingStatusProjection}
+ */
+interface SerializedCurrentIndexingProjectionOmnichain extends Omit<RealtimeIndexingStatusProjection, "snapshot"> {
+    snapshot: SerializedOmnichainIndexingStatusSnapshot;
+}
+/**
+ * Serialized representation of {@link RealtimeIndexingStatusProjection}
+ */
+interface SerializedRealtimeIndexingStatusProjection extends Omit<RealtimeIndexingStatusProjection, "snapshot"> {
+    snapshot: SerializedCrossChainIndexingStatusSnapshot;
+}
+
+/**
+ * Deserialize into a {@link ChainIndexingSnapshot} object.
+ */
+declare function deserializeChainIndexingStatusSnapshot(maybeSnapshot: SerializedChainIndexingStatusSnapshot, valueLabel?: string): ChainIndexingStatusSnapshot;
+/**
+ * Deserialize an {@link OmnichainIndexingStatusSnapshot} object.
+ */
+declare function deserializeOmnichainIndexingStatusSnapshot(maybeSnapshot: SerializedOmnichainIndexingStatusSnapshot, valueLabel?: string): OmnichainIndexingStatusSnapshot;
+/**
+ * Deserialize an {@link CrossChainIndexingStatusSnapshot} object.
+ */
+declare function deserializeCrossChainIndexingStatusSnapshot(maybeSnapshot: SerializedCrossChainIndexingStatusSnapshot, valueLabel?: string): CrossChainIndexingStatusSnapshot;
+/**
+ * Deserialize into a {@link RealtimeIndexingStatusProjection} object.
+ */
+declare function deserializeRealtimeIndexingStatusProjection(maybeProjection: SerializedRealtimeIndexingStatusProjection, valueLabel?: string): RealtimeIndexingStatusProjection;
+
+/**
+ * Get {@link OmnichainIndexingStatusId} based on indexed chains' statuses.
+ *
+ * This function decides what is the `OmnichainIndexingStatusId` is,
+ * based on provided chain indexing statuses.
+ *
+ * @throws an error if unable to determine overall indexing status
+ */
+declare function getOmnichainIndexingStatus(chains: ChainIndexingStatusSnapshot[]): OmnichainIndexingStatusId;
+/**
+ * Get the timestamp of the lowest `config.startBlock` across all chains
+ * in the provided array of {@link ChainIndexingStatusSnapshot}.
+ *
+ * Such timestamp is useful when presenting the "lowest" block
+ * to be indexed across all chains.
+ */
+declare function getTimestampForLowestOmnichainStartBlock(chains: ChainIndexingStatusSnapshot[]): UnixTimestamp;
+/**
+ * Get the timestamp of the "highest known block" across all chains
+ * in the provided array of {@link ChainIndexingStatusSnapshot}.
+ *
+ * Such timestamp is useful when presenting the "highest known block"
+ * to be indexed across all chains.
+ *
+ * The "highest known block" for a chain depends on its status:
+ * - `config.endBlock` for a "queued" chain,
+ * - `backfillEndBlock` for a "backfill" chain,
+ * - `latestIndexedBlock` for a "completed" chain,
+ * - `latestKnownBlock` for a "following" chain.
+ */
+declare function getTimestampForHighestOmnichainKnownBlock(chains: ChainIndexingStatusSnapshot[]): UnixTimestamp;
+/**
+ * Get Omnichain Indexing Cursor
+ *
+ * The cursor tracks the "highest" latest indexed block timestamp across
+ * all indexed chains. If all chains are queued, the cursor tracks the moment
+ * just before the earliest start block timestamp across those chains.
+ *
+ * @throws an error if no chains are provided
+ */
+declare function getOmnichainIndexingCursor(chains: ChainIndexingStatusSnapshot[]): UnixTimestamp;
+/**
+ * Create {@link ChainIndexingConfig} for given block refs.
+ *
+ * @param startBlock required block ref
+ * @param endBlock optional block ref
+ */
+declare function createIndexingConfig(startBlock: BlockRef, endBlock: BlockRef | null): ChainIndexingConfig;
+/**
+ * Check if Chain Indexing Status Snapshots fit the 'unstarted' overall status
+ * snapshot requirements:
+ * - All chains are guaranteed to have a status of "queued".
+ *
+ * Note: This function narrows the {@link ChainIndexingStatusSnapshot} type to
+ * {@link ChainIndexingStatusSnapshotQueued}.
+ */
+declare function checkChainIndexingStatusSnapshotsForOmnichainStatusSnapshotUnstarted(chains: ChainIndexingStatusSnapshot[]): chains is ChainIndexingStatusSnapshotQueued[];
+/**
+ * Check if Chain Indexing Status Snapshots fit the 'backfill' overall status
+ * snapshot requirements:
+ * - At least one chain is guaranteed to be in the "backfill" status.
+ * - Each chain is guaranteed to have a status of either "queued",
+ *   "backfill" or "completed".
+ *
+ * Note: This function narrows the {@link ChainIndexingStatusSnapshot} type to
+ * {@link ChainIndexingStatusSnapshotForOmnichainIndexingStatusSnapshotBackfill}.
+ */
+declare function checkChainIndexingStatusSnapshotsForOmnichainStatusSnapshotBackfill(chains: ChainIndexingStatusSnapshot[]): chains is ChainIndexingStatusSnapshotForOmnichainIndexingStatusSnapshotBackfill[];
+/**
+ * Checks if Chain Indexing Status Snapshots fit the 'completed' overall status
+ * snapshot requirements:
+ * - All chains are guaranteed to have a status of "completed".
+ *
+ * Note: This function narrows the {@link ChainIndexingStatusSnapshot} type to
+ * {@link ChainIndexingStatusSnapshotCompleted}.
+ */
+declare function checkChainIndexingStatusSnapshotsForOmnichainStatusSnapshotCompleted(chains: ChainIndexingStatusSnapshot[]): chains is ChainIndexingStatusSnapshotCompleted[];
+/**
+ * Checks Chain Indexing Status Snapshots fit the 'following' overall status
+ * snapshot requirements:
+ * - At least one chain is guaranteed to be in the "following" status.
+ * - Any other chain can have any status.
+ */
+declare function checkChainIndexingStatusSnapshotsForOmnichainStatusSnapshotFollowing(chains: ChainIndexingStatusSnapshot[]): chains is ChainIndexingStatusSnapshot[];
+/**
+ * Sort a list of [{@link ChainId}, {@link ChainIndexingStatusSnapshot}] tuples
+ * by the omnichain start block timestamp in ascending order.
+ */
+declare function sortChainStatusesByStartBlockAsc<ChainStatusType extends ChainIndexingStatusSnapshot>(chains: [ChainId, ChainStatusType][]): [ChainId, ChainStatusType][];
+
+/**
+ * Create realtime indexing status projection from
+ * a {@link CrossChainIndexingStatusSnapshot}.
+ */
+declare function createRealtimeIndexingStatusProjection(snapshot: CrossChainIndexingStatusSnapshot, now: UnixTimestamp): RealtimeIndexingStatusProjection;
+
+declare function serializeCrossChainIndexingStatusSnapshotOmnichain({ strategy, slowestChainIndexingCursor, snapshotTime, omnichainSnapshot, }: CrossChainIndexingStatusSnapshot): SerializedCrossChainIndexingStatusSnapshot;
+declare function serializeRealtimeIndexingStatusProjection(indexingProjection: RealtimeIndexingStatusProjection): SerializedRealtimeIndexingStatusProjection;
+/**
+ * Serialize chain indexing snapshots.
+ */
+declare function serializeChainIndexingSnapshots<ChainIndexingStatusSnapshotType extends ChainIndexingStatusSnapshot>(chains: Map<ChainId, ChainIndexingStatusSnapshotType>): Record<ChainIdString, ChainIndexingStatusSnapshotType>;
+/**
+ * Serialize a {@link OmnichainIndexingStatusSnapshot} object.
+ */
+declare function serializeOmnichainIndexingStatusSnapshot(indexingStatus: OmnichainIndexingStatusSnapshot): SerializedOmnichainIndexingStatusSnapshot;
+
+/**
+ * Gets the SubregistryId (an AccountId) of the Ethnames Subregistry contract (this is the
+ * "BaseRegistrar" contract for direct subnames of .eth) for the provided namespace.
+ *
+ * @param namespace The ENS namespace to get the Ethnames Subregistry ID for
+ * @returns The AccountId for the Ethnames Subregistry contract for the provided namespace.
+ * @throws Error if the contract is not found for the given namespace.
+ */
+declare function getEthnamesSubregistryId(namespace: ENSNamespaceId): AccountId;
+
+/**
+ * Subregistry
+ */
+interface Subregistry {
+    /**
+     * Subregistry ID
+     *
+     * The ID of the subregistry the "logical registrar action" was taken on.
+     *
+     * Identifies the chainId and address of the associated subregistry smart
+     * contract.
+     */
+    subregistryId: AccountId;
+    /**
+     * The node (namehash) of the name the subregistry manages subnames of.
+     * Example subregistry managed names:
+     * - `eth`
+     * - `base.eth`
+     * - `linea.eth`
+     */
+    node: Node;
+}
+/**
+ * Serialized representation of {@link Subregistry}.
+ */
+interface SerializedSubregistry extends Omit<Subregistry, "subregistryId"> {
+    subregistryId: SerializedAccountId;
+}
+declare function serializeSubregistry(subregistry: Subregistry): SerializedSubregistry;
+
+/**
+ * Registration Lifecycle Stages
+ *
+ * Important: this definition should not be used anywhere.
+ * It's only here to capture some ideas that were shared in the team.
+ */
+declare const RegistrationLifecycleStages: {
+    /**
+     * Active
+     *
+     * Happens when
+     * the current timestamp <= expiry.
+     */
+    readonly Active: "registrationLifecycle_active";
+    /**
+     * Grace Period
+     *
+     * Happens when
+     * `expiry < the current timestamp <= expiry + 90 days`.
+     */
+    readonly GracePeriod: "registrationLifecycle_gracePeriod";
+    /**
+     * Released with Temporary Premium Price
+     *
+     * Happens when
+     * `expiry + 90 days < the current timestamp <= expiry + 120 days`.
+     */
+    readonly ReleasedWithTempPrice: "registrationLifecycle_releasedWithTempPrice";
+    /**
+     * Fully Released (Regular Price)
+     *
+     * Happens when
+     * ` expiry + 120 days < the current timestamp`.
+     */
+    readonly FullyReleased: "registrationLifecycle_fullyReleased";
+};
+type RegistrationLifecycleStage = (typeof RegistrationLifecycleStages)[keyof typeof RegistrationLifecycleStages];
+/**
+ * Registration Lifecycle
+ */
+interface RegistrationLifecycle {
+    /**
+     * Subregistry that manages this Registration Lifecycle.
+     */
+    subregistry: Subregistry;
+    /**
+     * The node (namehash) of the FQDN of the domain the registration lifecycle
+     * is associated with.
+     *
+     * Guaranteed to be a subname of the node (namehash) of the subregistry
+     * identified by `subregistryId.subregistryId`.
+     */
+    node: Node;
+    /**
+     * Expires at
+     *
+     * Identifies when the Registration Lifecycle is scheduled to expire.
+     */
+    expiresAt: UnixTimestamp;
+}
+/**
+ * Serialized representation of {@link RegistrationLifecycle}.
+ */
+interface SerializedRegistrationLifecycle extends Omit<RegistrationLifecycle, "subregistry"> {
+    subregistry: SerializedSubregistry;
+}
+declare function serializeRegistrationLifecycle(registrationLifecycle: RegistrationLifecycle): SerializedRegistrationLifecycle;
+
+/**
+ * Globally unique, deterministic ID of an indexed onchain event
+ * associated with the "logical registrar action".
+ */
+type RegistrarActionEventId = string;
+/**
+ * Types of "logical registrar action".
+ */
+declare const RegistrarActionTypes: {
+    readonly Registration: "registration";
+    readonly Renewal: "renewal";
+};
+type RegistrarActionType = (typeof RegistrarActionTypes)[keyof typeof RegistrarActionTypes];
+/**
+ * Pricing information for a "logical registrar action".
+ */
+interface RegistrarActionPricingAvailable {
+    /**
+     * Base cost
+     *
+     * Base cost (before any `premium`) of Ether measured in units of Wei
+     * paid to execute the "logical registrar action".
+     *
+     * May be 0.
+     */
+    baseCost: PriceEth;
+    /**
+     * Premium
+     *
+     * "premium" cost (in excesses of the `baseCost`) of Ether measured in
+     * units of Wei paid to execute the "logical registrar action".
+     *
+     * May be 0.
+     */
+    premium: PriceEth;
+    /**
+     * Total
+     *
+     * Total cost of Ether measured in units of Wei paid to execute
+     * the "logical registrar action".
+     *
+     * May be 0.
+     */
+    total: PriceEth;
+}
+/**
+ * Pricing information for a "logical registrar action" when
+ * there is no known pricing data.
+ */
+interface RegistrarActionPricingUnknown {
+    /**
+     * Base cost
+     *
+     * Base cost (before any `premium`) of Ether measured in units of Wei
+     * paid to execute the "logical registrar action".
+     */
+    baseCost: null;
+    /**
+     * Premium
+     *
+     * "premium" cost (in excesses of the `baseCost`) of Ether measured in
+     * units of Wei paid to execute the "logical registrar action".
+     */
+    premium: null;
+    /**
+     * Total
+     *
+     * Total cost of Ether measured in units of Wei paid to execute
+     * the "logical registrar action".
+     */
+    total: null;
+}
+type RegistrarActionPricing = RegistrarActionPricingAvailable | RegistrarActionPricingUnknown;
+declare function isRegistrarActionPricingAvailable(registrarActionPricing: RegistrarActionPricing): registrarActionPricing is RegistrarActionPricingAvailable;
+/**
+ * * Referral information for performing a "logical registrar action".
+ */
+interface RegistrarActionReferralAvailable {
+    /**
+     * Encoded Referrer
+     *
+     * Represents the "raw" 32-byte "referrer" value emitted onchain in
+     * association with the registrar action.
+     */
+    encodedReferrer: EncodedReferrer;
+    /**
+     * Decoded Referrer
+     *
+     * Decoded referrer according to the subjective interpretation of
+     * `encodedReferrer` defined for ENS Holiday Awards.
+     *
+     * Identifies the interpreted address of the referrer.
+     * The "chainId" of this address is the same as is referenced in
+     * `subregistryId`.
+     *
+     * May be the "zero address" to represent that an `encodedReferrer` is
+     * defined but that it is interpreted as no referrer.
+     */
+    decodedReferrer: Address;
+}
+/**
+ * Referral information for performing a "logical registrar action" when
+ * registrar controller does not implement referrals.
+ */
+interface RegistrarActionReferralNotApplicable {
+    /**
+     * Encoded Referrer
+     *
+     * Represents the "raw" 32-byte "referrer" value emitted onchain in
+     * association with the registrar action.
+     */
+    encodedReferrer: null;
+    /**
+     * Decoded Referrer
+     *
+     * Decoded referrer according to the subjective interpretation of
+     * `encodedReferrer` defined for ENS Holiday Awards.
+     *
+     */
+    decodedReferrer: null;
+}
+type RegistrarActionReferral = RegistrarActionReferralAvailable | RegistrarActionReferralNotApplicable;
+declare function isRegistrarActionReferralAvailable(registrarActionReferral: RegistrarActionReferral): registrarActionReferral is RegistrarActionReferralAvailable;
+/**
+ * "Logical registrar action"
+ *
+ * Represents a state of "logical registrar action". May be built using data
+ * from multiple events within the same "logical" registration / renewal action.
+ */
+interface RegistrarAction {
+    /**
+     * "Logical registrar action" ID
+     *
+     * The `id` value is a deterministic and globally unique identifier for
+     * the "logical registrar action".
+     *
+     * The `id` value represents the *initial* onchain event associated with
+     * the "logical registrar action", but the full state of
+     * the "logical registrar action" is an aggregate across each of
+     * the onchain events referenced in the `eventIds` field.
+     *
+     * Guaranteed to be the very first element in `eventIds` array.
+     */
+    id: RegistrarActionEventId;
+    /**
+     * The type of the "logical registrar action".
+     */
+    type: RegistrarActionType;
+    /**
+     *
+     * Incremental Duration
+     *
+     * If `type` is "registration":
+     *   - Represents the duration between `block.timestamp` and
+     *     the initial `registrationLifecycle.expiresAt` value that the associated
+     *     "registration lifecycle" will be initialized with.
+     * If `type` is "renewal":
+     *   - Represents the incremental increase in duration made to
+     *     the `registrationLifecycle.expiresAt` value in the associated
+     *     "registration lifecycle".
+     *
+     * A "registration lifecycle" may be extended via renewal even after it
+     * expires if it is still within its grace period.
+     *
+     * Consider the following scenario:
+     *
+     * The "registration lifecycle" of a direct subname of .eth is scheduled to
+     * expire on Jan 1, midnight UTC. It is currently 30 days after this
+     * expiration time. Therefore, there are currently another 60 days of grace
+     * period remaining for this name. Anyone can still make a renewal to
+     * extend the "registration lifecycle" of this name.
+     *
+     * Given this scenario, consider the following examples:
+     *
+     * 1. If a renewal is made with 10 days incremental duration,
+     *    the "registration lifecycle" for this name will remain in
+     *    an "expired" state, but it will now have another 70 days of
+     *    grace period remaining.
+     *
+     * 2. If a renewal is made with 50 days incremental duration,
+     *    the "registration lifecycle" for this name will no longer be
+     *    "expired" and will become "active", but the "registration lifecycle"
+     *    will now be scheduled to expire again in 20 days.
+     *
+     * After the "registration lifecycle" for a name becomes expired by more
+     * than its grace period, it can no longer be renewed by anyone and is
+     * considered "released". The name must first be registered again, starting
+     * a new "registration lifecycle" of
+     * active / expired / grace period / released.
+     *
+     * May be 0.
+     *
+     * Guaranteed to be a non-negative bigint value.
+     */
+    incrementalDuration: Duration;
+    /**
+     * Registrant
+     *
+     * Identifies the address that initiated the "logical registrar action" and
+     * is paying the `pricing.total` cost (if applicable).
+     *
+     * It may not be the owner of the name:
+     * 1. When a name is registered, the initial owner of the name may be
+     *    distinct from the registrant.
+     * 2. There are no restrictions on who may renew a name.
+     *    Therefore the owner of the name may be distinct from the registrant.
+     *
+     * The "chainId" of this address is the same as is referenced in
+     * `registrationLifecycle.subregistry.subregistryId`.
+     */
+    registrant: Address;
+    /**
+     * Registration Lifecycle associated with this "logical registrar action".
+     */
+    registrationLifecycle: RegistrationLifecycle;
+    /**
+     * Pricing information associated with this "logical registrar action".
+     */
+    pricing: RegistrarActionPricing;
+    /**
+     * Referral information associated with this "logical registrar action".
+     */
+    referral: RegistrarActionReferral;
+    /**
+     * Block ref
+     *
+     * References the block where the "logical registrar action" was executed.
+     *
+     * The "chainId" of this block is the same as is referenced in
+     * `registrationLifecycle.subregistry.subregistryId`.
+     */
+    block: BlockRef;
+    /**
+     * Transaction hash
+     *
+     * Transaction hash of the transaction associated with
+     * the "logical registrar action".
+     *
+     * The "chainId" of this transaction is the same as is referenced in
+     * `registrationLifecycle.subregistry.subregistryId`.
+     *
+     * Note that a single transaction may be associated with any number of
+     * "logical registrar actions".
+     */
+    transactionHash: Hash;
+    /**
+     * Event IDs
+     *
+     * Array of the eventIds that have contributed to the state of
+     * the "logical registrar action" record.
+     *
+     * Each eventId is a deterministic and globally unique onchain event
+     * identifier.
+     *
+     * Guarantees:
+     * - Each eventId is of events that occurred within the block
+     *   referenced by `block.number`.
+     * - At least 1 eventId.
+     * - Ordered chronologically (ascending) by logIndex within `block.number`.
+     * - The first element in the array is equal to the `id` of
+     *   the overall "logical registrar action" record.
+     *
+     * The following ideas are not generalized for ENS overall but happen to
+     * be a characteristic of the scope of our current indexing logic:
+     * 1. These id's always reference events emitted by
+     *    a related "BaseRegistrar" contract.
+     * 2. These id's optionally reference events emitted by
+     *    a related "Registrar Controller" contract. This is because our
+     *    current indexing logic doesn't guarantee to index
+     *    all "Registrar Controller" contracts.
+     */
+    eventIds: [RegistrarActionEventId, ...RegistrarActionEventId[]];
+}
+/**
+ * Serialized representation of {@link RegistrarActionPricingUnknown}.
+ */
+type SerializedRegistrarActionPricingUnknown = RegistrarActionPricingUnknown;
+/**
+ * Serialized representation of {@link RegistrarActionPricingAvailable}.
+ */
+interface SerializedRegistrarActionPricingAvailable {
+    baseCost: SerializedPriceEth;
+    premium: SerializedPriceEth;
+    total: SerializedPriceEth;
+}
+/**
+ * Serialized representation of {@link RegistrarActionPricing}.
+ */
+type SerializedRegistrarActionPricing = SerializedRegistrarActionPricingAvailable | SerializedRegistrarActionPricingUnknown;
+/**
+ * Serialized representation of {@link RegistrarAction}.
+ */
+interface SerializedRegistrarAction extends Omit<RegistrarAction, "registrationLifecycle" | "pricing"> {
+    registrationLifecycle: SerializedRegistrationLifecycle;
+    pricing: SerializedRegistrarActionPricing;
+}
+declare function serializeRegistrarActionPricing(pricing: RegistrarActionPricing): SerializedRegistrarActionPricing;
+declare function serializeRegistrarAction(registrarAction: RegistrarAction): SerializedRegistrarAction;
+
+declare const TheGraphCannotFallbackReasonSchema: z.ZodEnum<{
+    readonly NotSubgraphCompatible: "not-subgraph-compatible";
+    readonly NoApiKey: "no-api-key";
+    readonly NoSubgraphUrl: "no-subgraph-url";
+}>;
+declare const TheGraphFallbackSchema: z.ZodObject<{
+    canFallback: z.ZodBoolean;
+    reason: z.ZodNullable<z.ZodEnum<{
+        readonly NotSubgraphCompatible: "not-subgraph-compatible";
+        readonly NoApiKey: "no-api-key";
+        readonly NoSubgraphUrl: "no-subgraph-url";
+    }>>;
+}, z.core.$strict>;
+/**
+ * Create a Zod schema for validating a serialized ENSApiPublicConfig.
  *
- * Following occurs after the backfill of a chain is completed and represents
- * the process of indefinitely following (and indexing!) new blocks as they are
- * added to the indexed chain across time.
+ * @param valueLabel - Optional label for the value being validated (used in error messages)
+ */
+declare function makeENSApiPublicConfigSchema(valueLabel?: string): z.ZodObject<{
+    version: z.ZodString;
+    theGraphFallback: z.ZodObject<{
+        canFallback: z.ZodBoolean;
+        reason: z.ZodNullable<z.ZodEnum<{
+            readonly NotSubgraphCompatible: "not-subgraph-compatible";
+            readonly NoApiKey: "no-api-key";
+            readonly NoSubgraphUrl: "no-subgraph-url";
+        }>>;
+    }, z.core.$strict>;
+    ensIndexerPublicConfig: z.ZodObject<{
+        labelSet: z.ZodObject<{
+            labelSetId: z.ZodString;
+            labelSetVersion: z.ZodPipe<z.ZodCoercedNumber<unknown>, z.ZodInt>;
+        }, z.core.$strip>;
+        indexedChainIds: z.ZodPipe<z.ZodArray<z.ZodPipe<z.ZodInt, z.ZodTransform<number, number>>>, z.ZodTransform<Set<number>, number[]>>;
+        isSubgraphCompatible: z.ZodBoolean;
+        namespace: z.ZodEnum<{
+            readonly Mainnet: "mainnet";
+            readonly Sepolia: "sepolia";
+            readonly Holesky: "holesky";
+            readonly EnsTestEnv: "ens-test-env";
+        }>;
+        plugins: z.ZodArray<z.ZodString>;
+        databaseSchemaName: z.ZodString;
+        versionInfo: z.ZodObject<{
+            nodejs: z.ZodString;
+            ponder: z.ZodString;
+            ensDb: z.ZodString;
+            ensIndexer: z.ZodString;
+            ensNormalize: z.ZodString;
+            ensRainbow: z.ZodString;
+            ensRainbowSchema: z.ZodInt;
+        }, z.core.$strict>;
+    }, z.core.$strip>;
+}, z.core.$strict>;
+
+type TheGraphCannotFallbackReason = z.infer<typeof TheGraphCannotFallbackReasonSchema>;
+type TheGraphFallback = z.infer<typeof TheGraphFallbackSchema>;
+/**
+ * Complete public configuration object for ENSApi.
  *
- * Invariants:
- * - `config.startBlock` is always before or the same as `latestIndexedBlock`
- * - `latestIndexedBlock` is always before or the same as `latestKnownBlock`
+ * Contains ENSApi-specific configuration at the top level and
+ * embeds the complete ENSIndexer public configuration.
  */
-interface ChainIndexingFollowingStatus {
-    status: typeof ChainIndexingStatusIds.Following;
-    config: ChainIndexingIndefiniteConfig;
+interface ENSApiPublicConfig {
     /**
-     * The block that was most recently indexed.
+     * ENSApi service version
+     *
+     * @see https://ghcr.io/namehash/ensnode/ensapi
      */
-    latestIndexedBlock: BlockRef;
+    version: string;
     /**
-     * The "highest" block that has been fetched by RPC calls and stored in
-     * the RPC cache as part of the indexing process.
+     * The Graph Fallback-related info.
      */
-    latestKnownBlock: BlockRef;
+    theGraphFallback: TheGraphFallback;
     /**
-     * The number of seconds between `latestIndexedBlock.timestamp` and
-     * the current time in ENSIndexer. This represents the upper-bound worst case
-     * distance approximation between the latest block on the chain (independent
-     * of it becoming known to us) and the latest block that has completed
-     * indexing. The true distance to the latest block on the chain will be less
-     * if the latest block on the chain was not issued at the current second.
+     * Complete ENSIndexer public configuration
+     *
+     * Contains all ENSIndexer public configuration including
+     * namespace, plugins, version info, etc.
      */
-    approxRealtimeDistance: Duration;
+    ensIndexerPublicConfig: ENSIndexerPublicConfig;
 }
+
 /**
- * Chain Indexing Status: Completed
- *
- * Indexing of a chain is completed after the backfill when the chain is
- * not configured to be indefinitely indexed.
- *
- * Invariants:
- * - `config.startBlock` is always before or the same as `latestIndexedBlock`
- * - `latestIndexedBlock` is always the same as `config.endBlock`.
+ * Serialized representation of {@link ENSApiPublicConfig}
  */
-interface ChainIndexingCompletedStatus {
-    status: typeof ChainIndexingStatusIds.Completed;
-    config: ChainIndexingDefiniteConfig;
+interface SerializedENSApiPublicConfig extends Omit<ENSApiPublicConfig, "ensIndexerPublicConfig"> {
     /**
-     * The block that was most recently indexed.
+     * Serialized representation of {@link ENSApiPublicConfig.ensIndexerPublicConfig}.
      */
-    latestIndexedBlock: BlockRef;
+    ensIndexerPublicConfig: SerializedENSIndexerPublicConfig;
 }
+
 /**
- * Chain Indexing Status
- *
- * Use the `status` field to determine the correct type interpretation at runtime.
- */
-type ChainIndexingStatus = ChainIndexingUnstartedStatus | ChainIndexingBackfillStatus | ChainIndexingFollowingStatus | ChainIndexingCompletedStatus;
-/**
- * Chain Indexing Status: Active
- *
- * Represents a chain where indexing is currently active.
- * The `latestIndexedBlock` field will be available.
+ * Deserialize a {@link ENSApiPublicConfig} object.
  */
-type ChainIndexingActiveStatus = ChainIndexingBackfillStatus | ChainIndexingFollowingStatus;
+declare function deserializeENSApiPublicConfig(maybeConfig: SerializedENSApiPublicConfig, valueLabel?: string): ENSApiPublicConfig;
+
 /**
- * Chain Indexing Status: Standby
- *
- * Represents a chain where indexing is currently on standby (not happening).
- * The `latestIndexedBlock` field will not be available.
+ * Serialize a {@link ENSApiPublicConfig} object.
  */
-type ChainIndexingStandbyStatus = ChainIndexingUnstartedStatus | ChainIndexingCompletedStatus;
+declare function serializeENSApiPublicConfig(config: ENSApiPublicConfig): SerializedENSApiPublicConfig;
+
 /**
- * ENSIndexer Overall Indexing Status: Unstarted
- *
- * Describes the current state of indexing operations across all indexed chains
- * when the overall indexing status is {@link OverallIndexingStatusIds.Unstarted}.
+ * The resolution status for an `Identity`.
  */
-interface ENSIndexerOverallIndexingUnstartedStatus {
+declare const ResolutionStatusIds: {
     /**
-     * Overall Indexing Status
+     * Represents that the `Identity` is not resolved yet.
      */
-    overallStatus: typeof OverallIndexingStatusIds.Unstarted;
+    readonly Unresolved: "unresolved";
     /**
-     * Indexing Status for each chain.
-     *
-     * Each chain is guaranteed to have the "unstarted" status.
-     * It's impossible for any chain to have status other than "unstarted".
+     * Represents that resolution of the `Identity` resulted in a named identity.
      */
-    chains: Map<ChainId, ChainIndexingUnstartedStatus>;
-}
+    readonly Named: "named";
+    /**
+     * Represents that resolution of the `Identity` resulted in an unnamed identity.
+     */
+    readonly Unnamed: "unnamed";
+    /**
+     * Represents that attempted resolution of the `Identity` resulted in an error
+     * and therefore it is unknown if the `Identity` resolves to a named or unnamed identity.
+     */
+    readonly Unknown: "unknown";
+};
 /**
- * Chain Indexing Status allowed when overall status is 'backfill'.
+ * The derived string union of possible {@link ResolutionStatusIds}.
  */
-type ChainIndexingStatusForBackfillOverallStatus = ChainIndexingUnstartedStatus | ChainIndexingBackfillStatus | ChainIndexingCompletedStatus;
+type ResolutionStatusId = (typeof ResolutionStatusIds)[keyof typeof ResolutionStatusIds];
 /**
- * ENSIndexer Overall Indexing Status: Backfill
+ * Represents an {@link Identity} that has not become a {@link ResolvedIdentity} yet.
  *
- * Describes the current state of indexing operations across all indexed chains
- * when the overall indexing status is {@link OverallIndexingStatusIds.Backfill}.
+ * Invariants:
+ * - `resolutionStatus` is always {@link ResolutionStatusIds.Unresolved}.
  */
-interface ENSIndexerOverallIndexingBackfillStatus {
-    /**
-     * Overall Indexing Status
-     */
-    overallStatus: typeof OverallIndexingStatusIds.Backfill;
+interface UnresolvedIdentity {
+    resolutionStatus: typeof ResolutionStatusIds.Unresolved;
     /**
-     * Omnichain Indexing Cursor
-     *
-     * Identifies the timestamp of the progress of omnichain indexing across
-     * all chains in {@link ChainIndexingBackfillStatus} status.
-     *
-     * Invariants:
-     * - the cursor value is guaranteed to be lower than or equal to
-     *   the timestamp of the earliest `config.startBlock` across all chains
-     *   in {@link ChainIndexingStandbyStatus} status.
+     * The {@link DefaultableChainId} for an ENSIP-19 primary name lookup of the
+     * identity associated with `address`.
      */
-    omnichainIndexingCursor: UnixTimestamp;
+    chainId: DefaultableChainId;
     /**
-     * Indexing Status for each chain.
-     *
-     * At least one chain is guaranteed to be in the "backfill" status.
-     * Each chain is guaranteed to have a status of either "unstarted",
-     * "backfill" or "completed". It's impossible for any chain to be
-     * in the "following" status.
+     * The {@link Address} of the identity.
      */
-    chains: Map<ChainId, ChainIndexingStatusForBackfillOverallStatus>;
+    address: Address;
 }
 /**
- * ENSIndexer Overall Indexing Status: Completed
+ * Represents an `Identity` that resolved to a primary name.
  *
- * Describes the final state of indexing operations across all indexed chains
- * when all indexed chains are configured for a definite indexing strategy and
- * all indexing of that definite range is completed.
+ * Invariants:
+ * - `resolutionStatus` is always {@link ResolutionStatusIds.Named}.
  */
-interface ENSIndexerOverallIndexingCompletedStatus {
+interface NamedIdentity {
+    resolutionStatus: typeof ResolutionStatusIds.Named;
     /**
-     * Overall Indexing Status
+     * The {@link DefaultableChainId} for an ENSIP-19 primary name lookup of the
+     * identity associated with `address`.
      */
-    overallStatus: typeof OverallIndexingStatusIds.Completed;
+    chainId: DefaultableChainId;
     /**
-     * Indexing Status for each chain.
-     *
-     * Each chain is guaranteed to have the "completed" status.
-     * It's impossible for any chain to have status other than "completed".
+     * The address of the identity.
      */
-    chains: Map<ChainId, ChainIndexingCompletedStatus>;
+    address: Address;
+    /**
+     * The ENSIP-19 primary name lookup result of `address` on `chainId`.
+     */
+    name: Name;
 }
 /**
- * ENSIndexer Overall Indexing Status: Following
+ * Represents an `Identity` that did not resolve to a primary name.
  *
- * Describes the state when the overall indexing status is
- * {@link OverallIndexingStatusIds.Following}.
+ * Invariants:
+ * - `resolutionStatus` is always {@link ResolutionStatusIds.Unnamed}.
+ * - `name` is always `null`.
  */
-interface ENSIndexerOverallIndexingFollowingStatus {
-    /**
-     * Overall Indexing Status
-     */
-    overallStatus: typeof OverallIndexingStatusIds.Following;
+interface UnnamedIdentity {
+    resolutionStatus: typeof ResolutionStatusIds.Unnamed;
     /**
-     * Omnichain Indexing Cursor
-     *
-     * Identifies the timestamp of the progress of omnichain indexing across
-     * all chains in {@link ChainIndexingActiveStatus} status.
-     *
-     * Invariants:
-     * - the cursor value is guaranteed to be lower than or equal to
-     *   the timestamp of the earliest `config.startBlock` across all chains
-     *   in {@link ChainIndexingStandbyStatus} status.
+     * The {@link DefaultableChainId} for an ENSIP-19 primary name lookup of the
+     * identity associated with `address`.
      */
-    omnichainIndexingCursor: UnixTimestamp;
+    chainId: DefaultableChainId;
     /**
-     * Indexing Status for each chain.
-     *
-     * At least one chain is guaranteed to be in the "following" status.
-     * Each chain is guaranteed to have a status of either "unstarted",
-     * "backfill", "following" or "completed".
+     * The address of the identity.
      */
-    chains: Map<ChainId, ChainIndexingStatus>;
+    address: Address;
     /**
-     * The maximum
-     * {@link ChainIndexingFollowingStatus.approxRealtimeDistance} value
-     * across all chains with status: 'following'.
+     * The ENSIP-19 primary name lookup result of `address` on `chainId`.
      */
-    overallApproxRealtimeDistance: Duration;
+    name: null;
 }
 /**
- * ENSIndexer Overall Indexing Status: Error
- *
- * Describes the state when ENSIndexer failed to return the indexing status for
- * all indexed chains.
+ * Represents an `Identity` that was attempted to be resolved but the resolution attempt
+ * resulted in an error and therefore it is unknown if the `Identity` resolves to a named
+ * or unnamed identity.
  *
- * This state suggests an error with the "primary" ENSIndexer.
+ * Invariants:
+ * - `resolutionStatus` is always {@link ResolutionStatusIds.Unknown}.
  */
-interface ENSIndexerOverallIndexingErrorStatus {
+interface UnknownIdentity {
+    resolutionStatus: typeof ResolutionStatusIds.Unknown;
+    /**
+     * The {@link DefaultableChainId} for an ENSIP-19 primary name lookup of the
+     * identity associated with `address`.
+     */
+    chainId: DefaultableChainId;
     /**
-     * Overall Indexing Status
+     * The address of the identity.
      */
-    overallStatus: typeof OverallIndexingStatusIds.IndexerError;
+    address: Address;
 }
 /**
- * ENSIndexer Overall Indexing Status
+ * Represents an ENSIP-19 identity resolution result.
  *
- * Describes the overall state of indexing operations.
- */
-type ENSIndexerOverallIndexingStatus = ENSIndexerOverallIndexingUnstartedStatus | ENSIndexerOverallIndexingBackfillStatus | ENSIndexerOverallIndexingCompletedStatus | ENSIndexerOverallIndexingFollowingStatus | ENSIndexerOverallIndexingErrorStatus;
-
-/**
- * Serialized representation of {@link ENSIndexerOverallIndexingUnstartedStatus}
- */
-interface SerializedENSIndexerOverallIndexingUnstartedStatus extends Omit<ENSIndexerOverallIndexingUnstartedStatus, "chains"> {
-    chains: Record<ChainIdString, ChainIndexingUnstartedStatus>;
-}
-/**
- * Serialized representation of {@link ENSIndexerOverallIndexingBackfillStatus}
- */
-interface SerializedENSIndexerOverallIndexingBackfillStatus extends Omit<ENSIndexerOverallIndexingBackfillStatus, "chains"> {
-    chains: Record<ChainIdString, ChainIndexingStatusForBackfillOverallStatus>;
-}
-/**
- * Serialized representation of {@link ENSIndexerOverallIndexingCompletedStatus}
- */
-interface SerializedENSIndexerOverallIndexingCompletedStatus extends Omit<ENSIndexerOverallIndexingCompletedStatus, "chains"> {
-    chains: Record<ChainIdString, ChainIndexingCompletedStatus>;
-}
-/**
- * Serialized representation of {@link ENSIndexerOverallIndexingFollowingStatus}
- */
-interface SerializedENSIndexerOverallIndexingFollowingStatus extends Omit<ENSIndexerOverallIndexingFollowingStatus, "chains"> {
-    chains: Record<ChainIdString, ChainIndexingStatus>;
-}
-/**
- * Serialized representation of {@link ENSIndexerOverallIndexingErrorStatus}
- */
-interface SerializedENSIndexerOverallIndexingErrorStatus extends ENSIndexerOverallIndexingErrorStatus {
-}
-/**
- * Serialized representation of {@link ENSIndexerOverallIndexingStatus}
+ * Use the `resolutionStatus` field to determine the specific type interpretation
+ * at runtime.
  */
-type SerializedENSIndexerOverallIndexingStatus = SerializedENSIndexerOverallIndexingUnstartedStatus | SerializedENSIndexerOverallIndexingBackfillStatus | SerializedENSIndexerOverallIndexingCompletedStatus | SerializedENSIndexerOverallIndexingFollowingStatus | SerializedENSIndexerOverallIndexingErrorStatus;
-
+type ResolvedIdentity = NamedIdentity | UnnamedIdentity | UnknownIdentity;
 /**
- * Serialize a {@link ENSIndexerOverallIndexingStatus} object.
+ * Represents an ENSIP-19 identity resolution (which may or not have been
+ * resolved to a result yet).
+ *
+ * Use the `resolutionStatus` field to determine the specific type interpretation
+ * at runtime.
  */
-declare function deserializeENSIndexerIndexingStatus(maybeStatus: SerializedENSIndexerOverallIndexingStatus, valueLabel?: string): ENSIndexerOverallIndexingStatus;
+type Identity = UnresolvedIdentity | ResolvedIdentity;
 
 /**
- * Get {@link OverallIndexingStatusId} based on indexed chains' statuses.
+ * Builds an {@link UnresolvedIdentity} for the provided {@link Address},
+ * {@link DefaultableChainId} and {@link ENSNamespaceId}.
  *
- * This function decides what is the current overall indexing status,
- * based on provided chain indexing statuses. The fact that chain indexing
- * statuses were provided to this function guarantees there was no indexer
- * error, and that the overall indexing status is never
- * an {@link OverallIndexingStatusIds.IndexerError}
+ * If no `chainId` is provided, uses the ENS Root Chain Id for the provided
+ * `namespaceId`.
  */
-declare function getOverallIndexingStatus(chains: ChainIndexingStatus[]): Exclude<OverallIndexingStatusId, typeof OverallIndexingStatusIds.IndexerError>;
+declare function buildUnresolvedIdentity(address: Address, namespaceId: ENSNamespaceId, chainId?: DefaultableChainId): UnresolvedIdentity;
 /**
- * Get overall approximate realtime distance across all indexed chains.
+ * Returns whether the provided {@link Identity} is a {@link ResolvedIdentity}.
  *
- * @throws an error if none of the indexed chains was in the 'following' status.
- */
-declare function getOverallApproxRealtimeDistance(chains: ChainIndexingStatus[]): Duration;
-/**
- * Get lowest of the highest end block across all chains which status is
- * {@link ChainIndexingStatus}.
+ * @param identity - The {@link Identity} to check.
+ * @returns Whether the provided {@link Identity} is a {@link ResolvedIdentity}.
  */
-declare function getTimestampForLowestOmnichainStartBlock(chains: ChainIndexingStatus[]): UnixTimestamp;
+declare function isResolvedIdentity(identity: Identity): identity is ResolvedIdentity;
+
 /**
- * Get timestamp of the highest known block across all chains which status is
- * {@link ChainIndexingStatusForBackfillOverallStatus}.
+ * Gets the "chainId param" that should be used for a primary name resolution
+ * request.
+ *
+ * ENSIP-19 defines special rules for the "chainId param" used
+ * in primary name resolutions for the case that the `chainId` is the
+ * ENS Root Chain Id for the provided `namespaceId`.
+ *
+ * Whenever this case happens, ENSIP-19 requires that the
+ * "chainId param" is always set to chainId: 1 (mainnet), even if the
+ * `chainId` where the primary name lookup is actually happening
+ * on a non-mainnet ENS Root Chain, such as on a testnet or
+ * the ens-test-env.
+ *
+ * @param namespaceId The namespace id for the primary name lookup.
+ * @param chainId The chain id where the primary name lookup will actually happen.
+ * @returns The "chainId param" that should be used for the primary name lookup.
  */
-declare function getTimestampForHighestOmnichainKnownBlock(chains: ChainIndexingStatus[]): UnixTimestamp;
+declare const getResolvePrimaryNameChainIdParam: (chainId: DefaultableChainId, namespaceId: ENSNamespaceId) => DefaultableChainId;
 /**
- * Get Omnichain Indexing Cursor across all chains which status is
- * {@link ChainIndexingActiveStatus}.
+ * Translates a `DefaultableChainId` a `ChainId`
+ * such that if the provided `chainId` is `DEFAULT_EVM_CHAIN_ID`,
+ * the `ChainId` of the ENS Root Chain for the provided `namespaceId` is returned.
+ *
+ * @param chainId The `DefaultableChainId` to translate.
+ * @param namespaceId The namespace id for the translation.
+ * @returns the translated `ChainId`.
  */
-declare function getOmnichainIndexingCursor(chains: ChainIndexingActiveStatus[]): UnixTimestamp;
+declare const translateDefaultableChainIdToChainId: (chainId: DefaultableChainId, namespaceId: ENSNamespaceId) => ChainId;
+
 /**
- * Get all chains which status is {@link ChainIndexingActiveStatus}.
+ * Encodes a selection of Resolver records in the context of a specific Name.
  */
-declare function getActiveChains(chains: ChainIndexingStatus[]): ChainIndexingActiveStatus[];
+interface ResolverRecordsSelection {
+    /**
+     * Whether to fetch the name's `name` record. This value is primarily used in the context of
+     * Reverse Resolution.
+     *
+     * @see https://docs.ens.domains/ensip/19/#reverse-resolution
+     */
+    name?: boolean;
+    /**
+     * Which coinTypes to fetch address records for.
+     */
+    addresses?: CoinType[];
+    /**
+     * Which keys to fetch text records for.
+     */
+    texts?: string[];
+}
+declare const isSelectionEmpty: (selection: ResolverRecordsSelection) => boolean;
+
 /**
- * Get all chains which status is {@link ChainIndexingStandbyStatus}.
+ * An internal type representing a non-inferred ResolverRecordsResponse, used in situations where
+ * access to the more specific inferred type (ResolverRecordsResponse<SELECTION>) is difficult or
+ * unnecessary.
  */
-declare function getStandbyChains(chains: ChainIndexingStatus[]): ChainIndexingStandbyStatus[];
+type ResolverRecordsResponseBase = {
+    /**
+     * The name record, relevant in the context of Reverse Resolution.
+     * Null if no name record is set.
+     */
+    name: Name | null;
+    /**
+     * Address records, keyed by CoinType.
+     * Value is null if no record for the specified CoinType is set.
+     *
+     * NOTE: ENS resolver address records can store arbitrary string values,
+     * including non-EVM addresses — always validate the record value against
+     * the format your application expects.
+     */
+    addresses: Record<CoinType, string | null>;
+    /**
+     * Text records, keyed by key.
+     * Value is null if no record for the specified key is set.
+     */
+    texts: Record<string, string | null>;
+};
 /**
- * Create {@link ChainIndexingConfig} for given block refs.
+ * Represents the strongly-typed set of records based on the provided SELECTION
  *
- * @param startBlock required block ref
- * @param endBlock optional block ref
- */
-declare function createIndexingConfig(startBlock: BlockRef, endBlock: BlockRef | null): ChainIndexingConfig;
-/**
- * Check if Chain Indexing Statuses fit the 'unstarted' overall status
- * requirements:
- * - All chains are guaranteed to have a status of "unstarted".
+ * @example
+ * ```typescript
+ * const selection = {
+ *   name: true,
+ *   addresses: [60],
+ *   texts: ["com.twitter", "avatar"],
+ * } as const satisfies ResolverRecordsSelection;
  *
- * Note: This function narrows the {@link ChainIndexingStatus} type to
- * {@link ChainIndexingUnstartedStatus}.
+ * type Response = ResolverRecordsResponse<typeof selection>;
+ *
+ * // results in the following type
+ * type Response = {
+ *   readonly name: Name | null;
+ *   readonly addresses: Record<"60", string | null>;
+ *   readonly texts: Record<"avatar" | "com.twitter", string | null>;
+ * }
+ * ```
  */
-declare function checkChainIndexingStatusesForUnstartedOverallStatus(chains: ChainIndexingStatus[]): chains is ChainIndexingUnstartedStatus[];
+type ResolverRecordsResponse<T extends ResolverRecordsSelection = ResolverRecordsSelection> = {
+    [K in keyof T as T[K] extends true | any[] ? K : never]: K extends "addresses" ? Record<`${T["addresses"] extends readonly CoinType[] ? T["addresses"][number] : never}`, string | null> : K extends "texts" ? Record<T["texts"] extends readonly string[] ? T["texts"][number] : never, string | null> : ResolverRecordsResponseBase[K & keyof ResolverRecordsResponseBase];
+};
+
 /**
- * Check if Chain Indexing Statuses fit the 'backfill' overall status
- * requirements:
- * - At least one chain is guaranteed to be in the "backfill" status.
- * - Each chain is guaranteed to have a status of either "unstarted",
- *   "backfill" or "completed".
- *
- * Note: This function narrows the {@linkChainIndexingStatus} type to
- * {@link ChainIndexingStatusForBackfillOverallStatus}.
+ * Arguments required to perform Forward Resolution
  */
-declare function checkChainIndexingStatusesForBackfillOverallStatus(chains: ChainIndexingStatus[]): chains is ChainIndexingStatusForBackfillOverallStatus[];
+interface ForwardResolutionArgs<SELECTION extends ResolverRecordsSelection> {
+    name: Name;
+    selection: SELECTION;
+}
 /**
- * Checks if Chain Indexing Statuses fit the 'completed' overall status
- * requirements:
- * - All chains are guaranteed to have a status of "completed".
- *
- * Note: This function narrows the {@linkChainIndexingStatus} type to
- * {@link ChainIndexingCompletedStatus}.
+ * The result of performing ForwardResolution
  */
-declare function checkChainIndexingStatusesForCompletedOverallStatus(chains: ChainIndexingStatus[]): chains is ChainIndexingCompletedStatus[];
+type ForwardResolutionResult<SELECTION extends ResolverRecordsSelection> = ResolverRecordsResponse<SELECTION>;
 /**
- * Checks Chain Indexing Statuses fit the 'following' overall status
- * requirements:
- * - At least one chain is guaranteed to be in the "following" status.
- * - Any other chain can have any status.
+ * Arguments required to perform Reverse Resolution
  */
-declare function checkChainIndexingStatusesForFollowingOverallStatus(chains: ChainIndexingStatus[]): chains is ChainIndexingStatus[];
+interface ReverseResolutionArgs {
+    address: Address;
+    chainId: ChainId;
+}
 /**
- * Sort a list of [{@link ChainId}, {@link ChainIndexingStatus}] tuples
- * by the omnichain start block timestamp in ascending order.
+ * The result of performing ReverseResolution
  */
-declare function sortAscChainStatusesByStartBlock<ChainStatusType extends ChainIndexingStatus>(chains: [ChainId, ChainStatusType][]): [ChainId, ChainStatusType][];
-
+type ReverseResolutionResult = Name | null;
 /**
- * Serialize chain indexing statuses.
+ * Arguments required to perform Multichain Primary Name Resolution
  */
-declare function serializeChainIndexingStatuses<ChainIndexingStatusType extends ChainIndexingStatus>(chainIndexingStatuses: Map<ChainId, ChainIndexingStatusType>): Record<ChainIdString, ChainIndexingStatusType>;
+interface MultichainPrimaryNameResolutionArgs {
+    address: Address;
+    chainIds?: ChainId[];
+}
 /**
- * Serialize a {@link ENSIndexerIndexingStatus} object.
+ * The result of performing MultichainPrimaryNameResolution
  */
-declare function serializeENSIndexerIndexingStatus(indexingStatus: ENSIndexerOverallIndexingStatus): SerializedENSIndexerOverallIndexingStatus;
+type MultichainPrimaryNameResolutionResult = Record<ChainId, Name | null>;
 
 /**
  * Identifiers for each traceable ENS protocol.
@@ -1383,220 +2815,469 @@ interface ProtocolSpan {
 type ProtocolSpanTreeNode = ProtocolSpan & {
     children: ProtocolSpanTreeNode[];
 };
-type ProtocolTrace = ProtocolSpanTreeNode[];
-
+type ProtocolTrace = ProtocolSpanTreeNode[];
+
+declare const ErrorResponseSchema: z$1.ZodObject<{
+    message: z$1.ZodString;
+    details: z$1.ZodOptional<z$1.ZodUnknown>;
+}, z$1.core.$strip>;
+
+/**
+ * API Error Response Type
+ */
+type ErrorResponse = z$1.infer<typeof ErrorResponseSchema>;
+interface TraceableRequest {
+    trace?: boolean;
+}
+interface TraceableResponse {
+    trace?: ProtocolTrace;
+}
+interface AcceleratableRequest {
+    accelerate?: boolean;
+}
+interface AcceleratableResponse {
+    accelerationRequested: boolean;
+    accelerationAttempted: boolean;
+}
+/**
+ * Resolve Records Request Type
+ */
+interface ResolveRecordsRequest<SELECTION extends ResolverRecordsSelection> extends ForwardResolutionArgs<SELECTION>, AcceleratableRequest, TraceableRequest {
+}
+/**
+ * Resolve Records Response Type
+ */
+interface ResolveRecordsResponse<SELECTION extends ResolverRecordsSelection> extends AcceleratableResponse, TraceableResponse {
+    records: ResolverRecordsResponse<SELECTION>;
+}
+/**
+ * Resolve Primary Name Request Type
+ */
+interface ResolvePrimaryNameRequest extends ReverseResolutionArgs, AcceleratableRequest, TraceableRequest {
+}
+/**
+ * Resolve Primary Name Response Type
+ */
+interface ResolvePrimaryNameResponse extends AcceleratableResponse, TraceableResponse {
+    name: ReverseResolutionResult;
+}
+interface ResolvePrimaryNamesRequest extends MultichainPrimaryNameResolutionArgs, AcceleratableRequest, TraceableRequest {
+}
+interface ResolvePrimaryNamesResponse extends AcceleratableResponse, TraceableResponse {
+    names: MultichainPrimaryNameResolutionResult;
+}
+/**
+ * ENSIndexer Public Config Response
+ */
+type ConfigResponse = ENSApiPublicConfig;
+/**
+ * Represents a request to Indexing Status API.
+ */
+type IndexingStatusRequest = {};
+/**
+ * A status code for indexing status responses.
+ */
+declare const IndexingStatusResponseCodes: {
+    /**
+     * Represents that the indexing status is available.
+     */
+    readonly Ok: "ok";
+    /**
+     * Represents that the indexing status is unavailable.
+     */
+    readonly Error: "error";
+};
+/**
+ * The derived string union of possible {@link IndexingStatusResponseCodes}.
+ */
+type IndexingStatusResponseCode = (typeof IndexingStatusResponseCodes)[keyof typeof IndexingStatusResponseCodes];
+/**
+ * An indexing status response when the indexing status is available.
+ */
+type IndexingStatusResponseOk = {
+    responseCode: typeof IndexingStatusResponseCodes.Ok;
+    realtimeProjection: RealtimeIndexingStatusProjection;
+};
 /**
- * Encodes a selection of Resolver records in the context of a specific Name.
+ * An indexing status response when the indexing status is unavailable.
  */
-interface ResolverRecordsSelection {
+type IndexingStatusResponseError = {
+    responseCode: typeof IndexingStatusResponseCodes.Error;
+};
+/**
+ * Indexing status response.
+ *
+ * Use the `responseCode` field to determine the specific type interpretation
+ * at runtime.
+ */
+type IndexingStatusResponse = IndexingStatusResponseOk | IndexingStatusResponseError;
+/**
+ * Registrar Actions response
+ */
+/**
+ * Records Filters: Filter Types
+ */
+declare const RegistrarActionsFilterTypes: {
+    readonly BySubregistryNode: "bySubregistryNode";
+    readonly WithEncodedReferral: "withEncodedReferral";
+};
+type RegistrarActionsFilterType = (typeof RegistrarActionsFilterTypes)[keyof typeof RegistrarActionsFilterTypes];
+type RegistrarActionsFilterBySubregistryNode = {
+    filterType: typeof RegistrarActionsFilterTypes.BySubregistryNode;
+    value: Node;
+};
+type RegistrarActionsFilterWithEncodedReferral = {
+    filterType: typeof RegistrarActionsFilterTypes.WithEncodedReferral;
+};
+type RegistrarActionsFilter = RegistrarActionsFilterBySubregistryNode | RegistrarActionsFilterWithEncodedReferral;
+/**
+ * Records Orders
+ */
+declare const RegistrarActionsOrders: {
+    readonly LatestRegistrarActions: "orderBy[timestamp]=desc";
+};
+type RegistrarActionsOrder = (typeof RegistrarActionsOrders)[keyof typeof RegistrarActionsOrders];
+/**
+ * Represents a request to Registrar Actions API.
+ */
+type RegistrarActionsRequest = {
     /**
-     * Whether to fetch the name's `name` record. This value is primarily used in the context of
-     * Reverse Resolution.
-     *
-     * @see https://docs.ens.domains/ensip/19/#reverse-resolution
+     * Filters to be applied while generating results.
      */
-    name?: boolean;
+    filters?: RegistrarActionsFilter[];
     /**
-     * Which coinTypes to fetch address records for.
+     * Order applied while generating results.
      */
-    addresses?: CoinType[];
+    order?: RegistrarActionsOrder;
     /**
-     * Which keys to fetch text records for.
+     * Limit the count of items per page to selected count of records.
+     *
+     * Guaranteed to be a positive integer (if defined).
      */
-    texts?: string[];
-}
-declare const isSelectionEmpty: (selection: ResolverRecordsSelection) => boolean;
-
+    itemsPerPage?: number;
+};
 /**
- * An internal type representing a non-inferred ResolverRecordsResponse, used in situations where
- * access to the more specific inferred type (ResolverRecordsResponse<SELECTION>) is difficult or
- * unnecessary.
+ * A status code for Registrar Actions API responses.
  */
-type ResolverRecordsResponseBase = {
+declare const RegistrarActionsResponseCodes: {
     /**
-     * The name record, relevant in the context of Reverse Resolution.
-     * Null if no name record is set.
+     * Represents that Registrar Actions are available.
      */
-    name: Name | null;
+    readonly Ok: "ok";
     /**
-     * Address records, keyed by CoinType.
-     * Value is null if no record for the specified CoinType is set.
-     *
-     * NOTE: ENS resolver address records can store arbitrary string values,
-     * including non-EVM addresses — always validate the record value against
-     * the format your application expects.
+     * Represents that Registrar Actions are unavailable.
      */
-    addresses: Record<CoinType, string | null>;
+    readonly Error: "error";
+};
+/**
+ * The derived string union of possible {@link RegistrarActionsResponseCodes}.
+ */
+type RegistrarActionsResponseCode = (typeof RegistrarActionsResponseCodes)[keyof typeof RegistrarActionsResponseCodes];
+/**
+ * "Logical registrar action" with its associated name.
+ */
+interface NamedRegistrarAction {
+    action: RegistrarAction;
     /**
-     * Text records, keyed by key.
-     * Value is null if no record for the specified key is set.
+     * Name
+     *
+     * FQDN of the name associated with `action`.
+     *
+     * Guarantees:
+     * - `namehash(name)` is always `action.registrationLifecycle.node`.
      */
-    texts: Record<string, string | null>;
+    name: InterpretedName;
+}
+/**
+ * A response when Registrar Actions are available.
+ */
+type RegistrarActionsResponseOk = {
+    responseCode: typeof RegistrarActionsResponseCodes.Ok;
+    registrarActions: NamedRegistrarAction[];
 };
 /**
- * Represents the strongly-typed set of records based on the provided SELECTION
- *
- * @example
- * ```typescript
- * const selection = {
- *   name: true,
- *   addresses: [60],
- *   texts: ["com.twitter", "avatar"],
- * } as const satisfies ResolverRecordsSelection;
- *
- * type Response = ResolverRecordsResponse<typeof selection>;
+ * A response when Registrar Actions are unavailable.
+ */
+interface RegistrarActionsResponseError {
+    responseCode: typeof IndexingStatusResponseCodes.Error;
+    error: ErrorResponse;
+}
+/**
+ * Registrar Actions response.
  *
- * // results in the following type
- * type Response = {
- *   readonly name: Name | null;
- *   readonly addresses: Record<"60", string | null>;
- *   readonly texts: Record<"avatar" | "com.twitter", string | null>;
- * }
- * ```
+ * Use the `responseCode` field to determine the specific type interpretation
+ * at runtime.
  */
-type ResolverRecordsResponse<T extends ResolverRecordsSelection = ResolverRecordsSelection> = {
-    [K in keyof T as T[K] extends true | any[] ? K : never]: K extends "addresses" ? Record<`${T["addresses"] extends readonly CoinType[] ? T["addresses"][number] : never}`, string | null> : K extends "texts" ? Record<T["texts"] extends readonly string[] ? T["texts"][number] : never, string | null> : ResolverRecordsResponseBase[K & keyof ResolverRecordsResponseBase];
-};
+type RegistrarActionsResponse = RegistrarActionsResponseOk | RegistrarActionsResponseError;
 
 /**
- * Arguments required to perform Forward Resolution
+ * Serialized representation of {@link IndexingStatusResponseError}.
  */
-interface ForwardResolutionArgs<SELECTION extends ResolverRecordsSelection> {
-    name: Name;
-    selection: SELECTION;
+type SerializedIndexingStatusResponseError = IndexingStatusResponseError;
+/**
+ * Serialized representation of {@link IndexingStatusResponseOk}.
+ */
+interface SerializedIndexingStatusResponseOk extends Omit<IndexingStatusResponseOk, "realtimeProjection"> {
+    realtimeProjection: SerializedRealtimeIndexingStatusProjection;
 }
 /**
- * The result of performing ForwardResolution
+ * Serialized representation of {@link IndexingStatusResponse}.
  */
-type ForwardResolutionResult<SELECTION extends ResolverRecordsSelection> = ResolverRecordsResponse<SELECTION>;
+type SerializedIndexingStatusResponse = SerializedIndexingStatusResponseOk | SerializedIndexingStatusResponseError;
 /**
- * Arguments required to perform Reverse Resolution
+ * Serialized representation of {@link RegistrarActionsResponseError}.
  */
-interface ReverseResolutionArgs {
-    address: Address;
-    chainId: ChainId;
-}
+type SerializedRegistrarActionsResponseError = RegistrarActionsResponseError;
 /**
- * The result of performing ReverseResolution
+ * Serialized representation of {@link NamedRegistrarAction}.
  */
-type ReverseResolutionResult = Name | null;
+interface SerializedNamedRegistrarAction extends Omit<NamedRegistrarAction, "action"> {
+    action: SerializedRegistrarAction;
+}
 /**
- * Arguments required to perform Multichain Primary Name Resolution
+ * Serialized representation of {@link RegistrarActionsResponseOk}.
  */
-interface MultichainPrimaryNameResolutionArgs {
-    address: Address;
-    chainIds?: ChainId[];
+interface SerializedRegistrarActionsResponseOk extends Omit<RegistrarActionsResponseOk, "registrarActions"> {
+    registrarActions: SerializedNamedRegistrarAction[];
 }
 /**
- * The result of performing MultichainPrimaryNameResolution
+ * Serialized representation of {@link SerializedRegistrarActionsResponse}.
  */
-type MultichainPrimaryNameResolutionResult = Record<ChainId, Name | null>;
+type SerializedRegistrarActionsResponse = SerializedRegistrarActionsResponseOk | SerializedRegistrarActionsResponseError;
 
-declare const DefaultRecordsSelection: {
-    readonly mainnet: {
-        readonly addresses: [_ensdomains_address_encoder.CoinType, ..._ensdomains_address_encoder.CoinType[]];
-        readonly texts: ["url", "avatar", "header", "description", "email", "com.twitter", "com.farcaster", "com.github"];
-    };
-    readonly sepolia: {
-        readonly addresses: [_ensdomains_address_encoder.CoinType, ..._ensdomains_address_encoder.CoinType[]];
-        readonly texts: ["url", "avatar", "header", "description", "email", "com.twitter", "com.farcaster", "com.github"];
-    };
-    readonly holesky: {
-        readonly addresses: [_ensdomains_address_encoder.CoinType, ..._ensdomains_address_encoder.CoinType[]];
-        readonly texts: ["url", "avatar", "header", "description", "email", "com.twitter", "com.farcaster", "com.github"];
-    };
-    readonly "ens-test-env": {
-        readonly addresses: [_ensdomains_address_encoder.CoinType, ..._ensdomains_address_encoder.CoinType[]];
-        readonly texts: ["url", "avatar", "header", "description", "email", "com.twitter", "com.farcaster", "com.github"];
-    };
+declare function deserializeErrorResponse(maybeErrorResponse: unknown): ErrorResponse;
+declare function deserializeIndexingStatusResponse(maybeResponse: SerializedIndexingStatusResponse): IndexingStatusResponse;
+declare function deserializeRegistrarActionsResponse(maybeResponse: SerializedRegistrarActionsResponse): RegistrarActionsResponse;
+
+/**
+ * Build a "parent node" filter object for Registrar Actions query.
+ */
+declare function byParentNode(parentNode: Node): RegistrarActionsFilter;
+declare function byParentNode(parentNode: undefined): undefined;
+/**
+ * Build a "with referral" filter object for Registrar Actions query.
+ */
+declare function withReferral(withReferral: true): RegistrarActionsFilter;
+declare function withReferral(withReferral: false | undefined): undefined;
+declare const registrarActionsFilter: {
+    byParentNode: typeof byParentNode;
+    withReferral: typeof withReferral;
 };
 
+declare const registrarActionsPrerequisites: Readonly<{
+    /**
+     * Required plugins to enable Registrar Actions API routes.
+     *
+     * 1. `registrars` plugin is required so that data in the `registrarActions`
+     *    table is populated.
+     * 2. `subgraph`, `basenames`, and `lineanames` are required to get the data
+     *    for the name associated with each registrar action.
+     * 3. In theory not all of `subgraph`, `basenames`, and `lineanames` plugins
+     *    might be required. Ex: At least one, but the current logic in
+     *    the `registrars` plugin always indexes registrar actions across
+     *    Ethnames (subgraph), Basenames, and Lineanames and therefore we need to
+     *    ensure each value in the registrar actions table has
+     *    an associated record in the domains table.
+     */
+    requiredPlugins: readonly [PluginName.Subgraph, PluginName.Basenames, PluginName.Lineanames, PluginName.Registrars];
+    /**
+     * Check if provided ENSApiPublicConfig supports the Registrar Actions API.
+     */
+    hasEnsIndexerConfigSupport(config: ENSIndexerPublicConfig): boolean;
+    /**
+     * Required Indexing Status IDs
+     *
+     * Database indexes are created by the time the omnichain indexing status
+     * is either `completed` or `following`.
+     */
+    supportedIndexingStatusIds: ("omnichain-following" | "omnichain-completed")[];
+    /**
+     * Check if provided indexing status supports the Registrar Actions API.
+     */
+    hasIndexingStatusSupport(omnichainIndexingStatusId: OmnichainIndexingStatusId): boolean;
+}>;
+
+declare function serializeIndexingStatusResponse(response: IndexingStatusResponse): SerializedIndexingStatusResponse;
+declare function serializeNamedRegistrarAction({ action, name, }: NamedRegistrarAction): SerializedNamedRegistrarAction;
+declare function serializeRegistrarActionsResponse(response: RegistrarActionsResponse): SerializedRegistrarActionsResponse;
+
 /**
- * API Error Response Type
+ * The default number of items per page for paginated aggregated referrer queries.
  */
-interface ErrorResponse {
-    message: string;
-    details?: unknown;
-}
-interface TraceableRequest {
-    trace?: boolean;
-}
-interface TraceableResponse {
-    trace?: ProtocolTrace;
-}
-interface AcceleratableRequest {
-    accelerate?: boolean;
-}
-interface AcceleratableResponse {
-    accelerationAttempted: boolean;
-}
+declare const ITEMS_PER_PAGE_DEFAULT = 25;
 /**
- * Resolve Records Request Type
+ * The maximum number of items per page for paginated aggregated referrer queries.
  */
-interface ResolveRecordsRequest<SELECTION extends ResolverRecordsSelection> extends ForwardResolutionArgs<SELECTION>, AcceleratableRequest, TraceableRequest {
-}
+declare const ITEMS_PER_PAGE_MAX = 100;
 /**
- * Resolve Records Response Type
+ * Represents the aggregated metrics for a single referrer.
  */
-interface ResolveRecordsResponse<SELECTION extends ResolverRecordsSelection> extends AcceleratableResponse, TraceableResponse {
-    records: ResolverRecordsResponse<SELECTION>;
+interface AggregatedReferrerMetrics {
+    /** The Ethereum address of the referrer */
+    referrer: Address;
+    /**
+     * The total number of qualified referrals made by this referrer
+     * @invariant Guaranteed to be a positive integer (> 0)
+     */
+    totalReferrals: number;
+    /**
+     * The total incremental duration (in seconds) of all referrals made by this referrer
+     * @invariant Guaranteed to be a non-negative integer (>= 0), measured in seconds
+     */
+    totalIncrementalDuration: Duration;
 }
 /**
- * Resolve Primary Name Request Type
+ * Represents the aggregated metrics for a single referrer with contribution percentages.
+ * Extends {@link AggregatedReferrerMetrics} with additional fields that show the referrer's
+ * contribution as a percentage of the grand totals.
  */
-interface ResolvePrimaryNameRequest extends ReverseResolutionArgs, AcceleratableRequest, TraceableRequest {
+interface AggregatedReferrerMetricsContribution extends AggregatedReferrerMetrics {
+    /**
+     * The referrer's contribution to the grand total referrals as a decimal between 0 and 1 (inclusive).
+     * Calculated as: totalReferrals / grandTotalReferrals
+     * @invariant 0 <= totalReferralsContribution <= 1
+     */
+    totalReferralsContribution: number;
+    /**
+     * The referrer's contribution to the grand total incremental duration as a decimal between 0 and 1 (inclusive).
+     * Calculated as: totalIncrementalDuration / grandTotalIncrementalDuration
+     * @invariant 0 <= totalIncrementalDurationContribution <= 1
+     */
+    totalIncrementalDurationContribution: number;
 }
 /**
- * Resolve Primary Name Response Type
+ * Base pagination parameters for paginated queries.
  */
-interface ResolvePrimaryNameResponse extends AcceleratableResponse, TraceableResponse {
-    name: ReverseResolutionResult;
-}
-interface ResolvePrimaryNamesRequest extends MultichainPrimaryNameResolutionArgs, AcceleratableRequest, TraceableRequest {
-}
-interface ResolvePrimaryNamesResponse extends AcceleratableResponse, TraceableResponse {
-    names: MultichainPrimaryNameResolutionResult;
+interface PaginationParams {
+    /**
+     * Requested page number (1-indexed)
+     * @invariant Must be a positive integer (>= 1)
+     * @default 1
+     */
+    page?: number;
+    /**
+     * Maximum number of items per page
+     * @invariant Must be a positive integer (>= 1) and less than or equal to {@link ITEMS_PER_PAGE_MAX}
+     * @default {@link ITEMS_PER_PAGE_DEFAULT}
+     */
+    itemsPerPage?: number;
 }
 /**
- * ENSIndexer Public Config Response
+ * Request parameters for paginated aggregated referrers query.
  */
-type ConfigResponse = ENSIndexerPublicConfig;
+interface PaginatedAggregatedReferrersRequest extends PaginationParams {
+}
 /**
- * ENSIndexer Overall Indexing Status Request
+ * Paginated aggregated referrers data with metadata.
  */
-interface IndexingStatusRequest {
+interface PaginatedAggregatedReferrers {
     /**
-     * Max Realtime Distance (optional)
-     *
-     * A duration value in seconds, representing the max allowed distance
-     * between the latest indexed block of each chain and the “tip” of
-     * all indexed chains. Setting this parameter influences the HTTP response
-     * code as follows:
-     * - Success (200 OK): The latest indexed block of each chain
-     *   is within the requested distance from realtime.
-     * - Service Unavailable (503): The latest indexed block of each chain
-     *   is NOT within the requested distance from realtime.
+     * Array of aggregated referrers for the current page with contribution percentages
+     * @invariant Array may be empty for the first page if there are no qualified referrers.
+     */
+    referrers: AggregatedReferrerMetricsContribution[];
+    /**
+     * Total number of aggregated referrers across all pages
+     * @invariant Guaranteed to be a non-negative integer (>= 0)
+     */
+    total: number;
+    /**
+     * Pagination parameters
+     * @invariant Stores the pagination parameters from the request
+     */
+    paginationParams: PaginationParams;
+    /**
+     * Indicates whether there is a next page available
+     * @invariant true if and only if (page * itemsPerPage < total)
+     */
+    hasNext: boolean;
+    /**
+     * Indicates whether there is a previous page available
+     * @invariant true if and only if (page > 1)
      */
-    maxRealtimeDistance?: Duration;
+    hasPrev: boolean;
+    /** Unix timestamp of when the leaderboard was last updated */
+    updatedAt: UnixTimestamp;
 }
 /**
- * ENSIndexer Overall Indexing Status Response
+ * A status code for paginated aggregated referrers API responses.
  */
-type IndexingStatusResponse = ENSIndexerOverallIndexingStatus;
+declare const PaginatedAggregatedReferrersResponseCodes: {
+    /**
+     * Represents that the aggregated referrers data is available.
+     * @note The response may contain an empty array for the first page if there are no qualified referrers.
+     * When the array is empty, total will be 0, page will be 1, and both hasNext and hasPrev will be false.
+     */
+    readonly Ok: "ok";
+    /**
+     * Represents that the aggregated referrers data is not available.
+     */
+    readonly Error: "error";
+};
 /**
- * ENSIndexer Overall Indexing Status Response Codes
- *
- * Define a custom response code for known responses.
+ * The derived string union of possible {@link PaginatedAggregatedReferrersResponseCodes}.
  */
-declare const IndexingStatusResponseCodes: {
-    readonly IndexerError: 512;
-    readonly RequestedDistanceNotAchievedError: 513;
+type PaginatedAggregatedReferrersResponseCode = (typeof PaginatedAggregatedReferrersResponseCodes)[keyof typeof PaginatedAggregatedReferrersResponseCodes];
+/**
+ * A paginated aggregated referrers response when the data is available.
+ */
+type PaginatedAggregatedReferrersResponseOk = {
+    responseCode: typeof PaginatedAggregatedReferrersResponseCodes.Ok;
+    data: PaginatedAggregatedReferrers;
+};
+/**
+ * A paginated aggregated referrers response when the data is not available.
+ */
+type PaginatedAggregatedReferrersResponseError = {
+    responseCode: typeof PaginatedAggregatedReferrersResponseCodes.Error;
+    error: string;
+    errorMessage: string;
 };
+/**
+ * A paginated aggregated referrers API response.
+ *
+ * Use the `responseCode` field to determine the specific type interpretation
+ * at runtime.
+ */
+type PaginatedAggregatedReferrersResponse = PaginatedAggregatedReferrersResponseOk | PaginatedAggregatedReferrersResponseError;
+
+/**
+ * Serialized representation of {@link PaginatedAggregatedReferrersResponseError}.
+ *
+ * Note: All fields are already serializable, so this type is identical to the source type.
+ */
+type SerializedPaginatedAggregatedReferrersResponseError = PaginatedAggregatedReferrersResponseError;
+/**
+ * Serialized representation of {@link PaginatedAggregatedReferrersResponseOk}.
+ *
+ * Note: All fields are already serializable, so this type is identical to the source type.
+ */
+type SerializedPaginatedAggregatedReferrersResponseOk = PaginatedAggregatedReferrersResponseOk;
+/**
+ * Serialized representation of {@link PaginatedAggregatedReferrersResponse}.
+ */
+type SerializedPaginatedAggregatedReferrersResponse = SerializedPaginatedAggregatedReferrersResponseOk | SerializedPaginatedAggregatedReferrersResponseError;
+
+/**
+ * Deserialize a {@link PaginatedAggregatedReferrersResponse} object.
+ *
+ * Note: While the serialized and deserialized types are identical (all fields
+ * are primitives), this function performs critical validation using Zod schemas
+ * to enforce invariants on the data. This ensures data integrity when receiving
+ * responses from the API.
+ */
+declare function deserializePaginatedAggregatedReferrersResponse(maybeResponse: SerializedPaginatedAggregatedReferrersResponse, valueLabel?: string): PaginatedAggregatedReferrersResponse;
 
 /**
- * Default ENSNode API endpoint URL
+ * Serialize a {@link PaginatedAggregatedReferrersResponse} object.
+ *
+ * Note: Since all fields in PaginatedAggregatedReferrersResponse are already
+ * serializable primitives, this function performs an identity transformation.
+ * It exists to maintain consistency with the serialization pattern used
+ * throughout the codebase.
  */
-declare const DEFAULT_ENSNODE_API_URL: "https://api.alpha.ensnode.io";
+declare function serializePaginatedAggregatedReferrersResponse(response: PaginatedAggregatedReferrersResponse): SerializedPaginatedAggregatedReferrersResponse;
+
 /**
  * Configuration options for ENSNode API client
  */
@@ -1609,6 +3290,7 @@ interface ClientOptions {
  *
  * Provides access to the following ENSNode APIs:
  * - Resolution API
+ * - ENSAnalytics API
  * - 🚧 Configuration API
  * - 🚧 Indexing Status API
  *
@@ -1674,9 +3356,10 @@ declare class ENSNodeClient {
     /**
      * Resolves the primary name of a specified address (Reverse Resolution) on a specific chain.
      *
-     * If the `address` specifies a valid [ENSIP-19 Default Name](https://docs.ens.domains/ensip/19/#default-primary-name),
-     * the Default Name will be returned. You _may_ query the Default EVM Chain Id (`0`) in order to
-     * determine the `address`'s Default Name directly.
+     * If the chainId-specific Primary Name is not defined, but the `address` specifies a valid
+     * [ENSIP-19 Default Name](https://docs.ens.domains/ensip/19/#default-primary-name), the Default
+     * Name will be returned. You _may_ query the Default EVM Chain Id (`0`) in order to determine the
+     * `address`'s Default Name directly.
      *
      * The returned Primary Name, if set, is guaranteed to be a [Normalized Name](https://ensnode.io/docs/reference/terminology#normalized-name).
      * If the primary name set for the address is not normalized, `null` is returned as if no primary name was set.
@@ -1708,13 +3391,14 @@ declare class ENSNodeClient {
     /**
      * Resolves the primary names of a specified address across multiple chains.
      *
-     * If the `address` specifies a valid [ENSIP-19 Default Name](https://docs.ens.domains/ensip/19/#default-primary-name),
-     * the Default Name will be returned for all chainIds for which there is not a chain-specific
-     * Primary Name. To avoid misuse, you _may not_ query the Default EVM Chain Id (`0`) directly, and
-     * should rely on the aforementioned per-chain defaulting behavior.
+     * For each Primary Name, if the chainId-specific Primary Name is not defined, but the `address`
+     * specifies a valid [ENSIP-19 Default Name](https://docs.ens.domains/ensip/19/#default-primary-name),
+     * the Default Name will be returned. You _may not_ query the Default EVM Chain Id (`0`) directly,
+     * and should rely on the aforementioned per-chain defaulting behavior.
      *
      * Each returned Primary Name, if set, is guaranteed to be a [Normalized Name](https://ensnode.io/docs/reference/terminology#normalized-name).
-     * If the primary name set for the address on any chain is not normalized, `null` is returned for that chain as if no primary name was set.
+     * If the primary name set for the address on any chain is not normalized, `null` is returned for
+     * that chain as if no primary name was set.
      *
      * @param address The Address whose Primary Names to resolve
      * @param options additional options
@@ -1732,12 +3416,12 @@ declare class ENSNodeClient {
      *
      * console.log(names);
      * // {
-     * //   "1": "gregskril.eth",
-     * //   "10": "gregskril.eth",
-     * //   "8453": "greg.base.eth", // base-specific Primary Name!
-     * //   "42161": "gregskril.eth",
-     * //   "59144": "gregskril.eth",
-     * //   "534352": "gregskril.eth"
+     * //   "1": "gregskril.eth", // Default Primary Name
+     * //   "10": "gregskril.eth", // Default Primary Name
+     * //   "8453": "greg.base.eth", // Base-specific Primary Name!
+     * //   "42161": "gregskril.eth", // Default Primary Name
+     * //   "59144": "gregskril.eth", // Default Primary Name
+     * //   "534352": "gregskril.eth" // Default Primary Name
      * // }
      *
      * // Resolve the address' Primary Names on specific chain Ids
@@ -1766,32 +3450,107 @@ declare class ENSNodeClient {
     /**
      * Fetch ENSNode Indexing Status
      *
-     * Fetch the ENSNode's multichain indexing status.
+     * @returns {IndexingStatusResponse}
      *
-     * @param options additional options
-     * @param options.maxRealtimeDistance the max allowed distance between the
-     *  latest indexed block of each chain and the "tip" of all indexed chains.
-     *  Setting this parameter influences the HTTP response code as follows:
-     *  - Success (200 OK): The latest indexed block of each chain is within the
-     *    requested distance from realtime.
-     *  - Service Unavailable (503): The latest indexed block of each chain is NOT
-     *    within the requested distance from realtime.
+     * @throws if the ENSNode request fails
+     * @throws if the ENSNode API returns an error response
+     * @throws if the ENSNode response breaks required invariants
+     */
+    indexingStatus(): Promise<IndexingStatusResponse>;
+    /**
+     * Fetch Paginated Aggregated Referrers
      *
-     * @returns {IndexingStatusResponse}
+     * Retrieves a paginated list of aggregated referrer metrics with contribution percentages.
+     * Each referrer's contribution is calculated as a percentage of the grand totals across all referrers.
+     *
+     * @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)
+     * @returns {PaginatedAggregatedReferrersResponse}
+     *
+     * @throws if the ENSNode request fails
+     * @throws if the ENSNode API returns an error response
+     * @throws if the ENSNode response breaks required invariants
+     *
+     * @example
+     * ```typescript
+     * // Get first page with default page size (25 items)
+     * const response = await client.getAggregatedReferrers();
+     * if (response.responseCode === 'ok') {
+     *   console.log(response.data.referrers);
+     *   console.log(`Page ${response.data.paginationParams.page} of ${Math.ceil(response.data.total / response.data.paginationParams.itemsPerPage)}`);
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Get second page with 50 items per page
+     * const response = await client.getAggregatedReferrers({ page: 2, itemsPerPage: 50 });
+     * ```
+     */
+    getAggregatedReferrers(request?: PaginatedAggregatedReferrersRequest): Promise<PaginatedAggregatedReferrersResponse>;
+    /**
+     * 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.
+     * @returns {RegistrarActionsResponse}
      *
      * @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 {
+     *   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 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 latest registrar action records associated with
+     * // subregistry managing `eth` name
+     * await client.registrarActions({
+     *   filters: [registrarActionsFilter.byParentNode(namehash('eth'))],
+     * });
+     *
+     * // get latest registrar action records which include referral info
+     * await client.registrarActions({
+     *   filters: [registrarActionsFilter.withReferral(true)],
+     * });
+     *
+     * // get latest 10 registrar action records associated with
+     * // subregistry managing `base.eth` name
+     * await client.registrarActions({
+     *   filters: [registrarActionsFilter.byParentNode(namehash('base.eth'))],
+     *   limit: 10
+     * });
+     * ```
      */
-    indexingStatus(options?: IndexingStatusRequest): Promise<IndexingStatusResponse>;
+    registrarActions(request?: RegistrarActionsRequest): Promise<RegistrarActionsResponse>;
 }
 
-declare function deserializeErrorResponse(maybeErrorResponse: unknown): ErrorResponse;
-
 declare class ClientError extends Error {
     details?: unknown;
     constructor(message: string, details?: unknown);
     static fromErrorResponse({ message, details }: ErrorResponse): ClientError;
 }
 
-export { ATTR_PROTOCOL_NAME, ATTR_PROTOCOL_STEP, ATTR_PROTOCOL_STEP_RESULT, type AcceleratableRequest, type AcceleratableResponse, type AccountId, BASENAMES_NODE, type BlockNumber, type BlockRef, type Blockrange, type Cache, type ChainId, type ChainIdString, type ChainIndexingActiveStatus, type ChainIndexingBackfillStatus, type ChainIndexingCompletedStatus, type ChainIndexingConfig, type ChainIndexingDefiniteConfig, type ChainIndexingFollowingStatus, type ChainIndexingIndefiniteConfig, type ChainIndexingStandbyStatus, type ChainIndexingStatus, type ChainIndexingStatusForBackfillOverallStatus, type ChainIndexingStatusId, ChainIndexingStatusIds, type ChainIndexingStrategyId, ChainIndexingStrategyIds, type ChainIndexingUnstartedStatus, ClientError, type ClientOptions, type ConfigResponse, DEFAULT_ENSNODE_API_URL, DEFAULT_EVM_CHAIN_ID, DEFAULT_EVM_COIN_TYPE, type Datetime, type DatetimeISO8601, type DeepPartial, DefaultRecordsSelection, type DependencyInfo, type Duration, type ENSIndexerOverallIndexingBackfillStatus, type ENSIndexerOverallIndexingCompletedStatus, type ENSIndexerOverallIndexingErrorStatus, type ENSIndexerOverallIndexingFollowingStatus, type ENSIndexerOverallIndexingStatus, type ENSIndexerOverallIndexingUnstartedStatus, type ENSIndexerPublicConfig, ENSNodeClient, ETH_COIN_TYPE, ETH_NODE, type EncodedLabelHash, type EnsRainbowClientLabelSet, type EnsRainbowServerLabelSet, type ErrorResponse, type ForwardResolutionArgs, ForwardResolutionProtocolStep, type ForwardResolutionResult, type IndexingStatusRequest, type IndexingStatusResponse, IndexingStatusResponseCodes, LINEANAMES_NODE, type Label, type LabelHash, type LabelSetId, type LabelSetVersion, LruCache, type MultichainPrimaryNameResolutionArgs, type MultichainPrimaryNameResolutionResult, type Name, type Node, type OverallIndexingStatusId, OverallIndexingStatusIds, PROTOCOL_ATTRIBUTE_PREFIX, PluginName, type ProtocolSpan, type ProtocolSpanTreeNode, type ProtocolTrace, REVERSE_ROOT_NODES, ROOT_NODE, type ResolvePrimaryNameRequest, type ResolvePrimaryNameResponse, type ResolvePrimaryNamesRequest, type ResolvePrimaryNamesResponse, type ResolveRecordsRequest, type ResolveRecordsResponse, type ResolverRecordsResponse, type ResolverRecordsResponseBase, type ResolverRecordsSelection, type ReverseResolutionArgs, ReverseResolutionProtocolStep, type ReverseResolutionResult, type RpcUrl, type SerializedENSIndexerOverallIndexingBackfillStatus, type SerializedENSIndexerOverallIndexingCompletedStatus, type SerializedENSIndexerOverallIndexingErrorStatus, type SerializedENSIndexerOverallIndexingFollowingStatus, type SerializedENSIndexerOverallIndexingStatus, type SerializedENSIndexerOverallIndexingUnstartedStatus, type SerializedENSIndexerPublicConfig, type SerializedIndexedChainIds, TraceableENSProtocol, type TraceableRequest, type TraceableResponse, type UnixTimestamp, type UrlString, accountIdEqual, addrReverseLabel, bigintToCoinType, buildEnsRainbowClientLabelSet, buildLabelSetId, buildLabelSetVersion, checkChainIndexingStatusesForBackfillOverallStatus, checkChainIndexingStatusesForCompletedOverallStatus, checkChainIndexingStatusesForFollowingOverallStatus, checkChainIndexingStatusesForUnstartedOverallStatus, coinTypeReverseLabel, coinTypeToEvmChainId, createIndexingConfig, deserializeBlockNumber, deserializeBlockRef, deserializeBlockrange, deserializeChainId, deserializeDatetime, deserializeDuration, deserializeENSIndexerIndexingStatus, deserializeENSIndexerPublicConfig, deserializeErrorResponse, deserializeUrl, encodeLabelHash, evmChainIdToCoinType, getActiveChains, getNameHierarchy, getOmnichainIndexingCursor, getOverallApproxRealtimeDistance, getOverallIndexingStatus, getStandbyChains, getTimestampForHighestOmnichainKnownBlock, getTimestampForLowestOmnichainStartBlock, interpretLiteralLabel, interpretLiteralName, invariant_isSubgraphCompatibleRequirements, invariant_reverseResolversPluginNeedsResolverRecords, isLabelIndexable, isNormalizedLabel, isNormalizedName, isSelectionEmpty, isSubgraphCompatible, labelHashToBytes, makeDatabaseSchemaNameSchema, makeDependencyInfoSchema, makeENSIndexerPublicConfigSchema, makeFullyPinnedLabelSetSchema, makeIndexedChainIdsSchema, makeLabelSetIdSchema, makeLabelSetVersionSchema, makePluginsListSchema, makeSubdomainNode, maybeHealLabelByReverseAddress, parseNonNegativeInteger, parseReverseName, reverseName, serializeChainId, serializeChainIndexingStatuses, serializeDatetime, serializeENSIndexerIndexingStatus, serializeENSIndexerPublicConfig, serializeIndexedChainIds, serializeUrl, sortAscChainStatusesByStartBlock, uint256ToHex32, uniq, validateSupportedLabelSetAndVersion };
+export { ADDR_REVERSE_NODE, ATTR_PROTOCOL_NAME, ATTR_PROTOCOL_STEP, ATTR_PROTOCOL_STEP_RESULT, type AcceleratableRequest, type AcceleratableResponse, type AccountId, type AggregatedReferrerMetrics, type AggregatedReferrerMetricsContribution, BASENAMES_NODE, type BlockNumber, type BlockRef, type Blockrange, type Cache, type ChainId, type ChainIdString, type ChainIndexingConfig, type ChainIndexingConfigDefinite, type ChainIndexingConfigIndefinite, type ChainIndexingConfigTypeId, ChainIndexingConfigTypeIds, type ChainIndexingStatusId, ChainIndexingStatusIds, type ChainIndexingStatusSnapshot, type ChainIndexingStatusSnapshotBackfill, type ChainIndexingStatusSnapshotCompleted, type ChainIndexingStatusSnapshotFollowing, type ChainIndexingStatusSnapshotForOmnichainIndexingStatusSnapshotBackfill, type ChainIndexingStatusSnapshotQueued, ClientError, type ClientOptions, type ConfigResponse, type CrossChainIndexingStatusSnapshot, type CrossChainIndexingStatusSnapshotOmnichain, type CrossChainIndexingStrategyId, CrossChainIndexingStrategyIds, type CurrencyAmount, type CurrencyId, CurrencyIds, type CurrencyInfo, DEFAULT_EVM_CHAIN_ID, DEFAULT_EVM_COIN_TYPE, type DNSEncodedLiteralName, type DNSEncodedName, type DNSEncodedPartiallyInterpretedName, type Datetime, type DatetimeISO8601, type DeepPartial, type DefaultableChainId, type Duration, type ENSApiPublicConfig, type ENSIndexerPublicConfig, type ENSIndexerVersionInfo, ENSNodeClient, ETH_COIN_TYPE, ETH_NODE, type EncodedLabelHash, type EnsRainbowClientLabelSet, type EnsRainbowServerLabelSet, type ErrorResponse, type ForwardResolutionArgs, ForwardResolutionProtocolStep, type ForwardResolutionResult, ITEMS_PER_PAGE_DEFAULT, ITEMS_PER_PAGE_MAX, type Identity, type IndexingStatusRequest, type IndexingStatusResponse, type IndexingStatusResponseCode, IndexingStatusResponseCodes, type IndexingStatusResponseError, type IndexingStatusResponseOk, type InterpretedLabel, type InterpretedName, LINEANAMES_NODE, type Label, type LabelHash, type LabelSetId, type LabelSetVersion, type LiteralLabel, type LiteralName, LruCache, type MultichainPrimaryNameResolutionArgs, type MultichainPrimaryNameResolutionResult, type Name, type NamedIdentity, type NamedRegistrarAction, type Node, type NormalizedName, type OmnichainIndexingStatusId, OmnichainIndexingStatusIds, type OmnichainIndexingStatusSnapshot, type OmnichainIndexingStatusSnapshotBackfill, type OmnichainIndexingStatusSnapshotCompleted, type OmnichainIndexingStatusSnapshotFollowing, type OmnichainIndexingStatusSnapshotUnstarted, PROTOCOL_ATTRIBUTE_PREFIX, type PaginatedAggregatedReferrers, type PaginatedAggregatedReferrersRequest, type PaginatedAggregatedReferrersResponse, type PaginatedAggregatedReferrersResponseCode, PaginatedAggregatedReferrersResponseCodes, type PaginatedAggregatedReferrersResponseError, type PaginatedAggregatedReferrersResponseOk, type PaginationParams, PluginName, type Price, type PriceDai, type PriceEth, type PriceUsdc, type ProtocolSpan, type ProtocolSpanTreeNode, type ProtocolTrace, ROOT_NODE, type RealtimeIndexingStatusProjection, type RegistrarAction, type RegistrarActionEventId, type RegistrarActionPricing, type RegistrarActionPricingAvailable, type RegistrarActionPricingUnknown, type RegistrarActionReferral, type RegistrarActionReferralAvailable, type RegistrarActionReferralNotApplicable, type RegistrarActionType, RegistrarActionTypes, type RegistrarActionsFilter, type RegistrarActionsFilterBySubregistryNode, type RegistrarActionsFilterType, RegistrarActionsFilterTypes, type RegistrarActionsFilterWithEncodedReferral, type RegistrarActionsOrder, RegistrarActionsOrders, type RegistrarActionsRequest, type RegistrarActionsResponse, type RegistrarActionsResponseCode, RegistrarActionsResponseCodes, type RegistrarActionsResponseError, type RegistrarActionsResponseOk, type RegistrationLifecycle, type RegistrationLifecycleStage, type ResolutionStatusId, ResolutionStatusIds, type ResolvePrimaryNameRequest, type ResolvePrimaryNameResponse, type ResolvePrimaryNamesRequest, type ResolvePrimaryNamesResponse, type ResolveRecordsRequest, type ResolveRecordsResponse, type ResolvedIdentity, type ResolverRecordsResponse, type ResolverRecordsResponseBase, type ResolverRecordsSelection, type ReverseResolutionArgs, ReverseResolutionProtocolStep, type ReverseResolutionResult, type RpcUrl, type SerializedAccountId, type SerializedChainIndexingStatusSnapshot, type SerializedChainIndexingStatusSnapshotBackfill, type SerializedChainIndexingStatusSnapshotCompleted, type SerializedChainIndexingStatusSnapshotFollowing, type SerializedChainIndexingStatusSnapshotQueued, type SerializedCrossChainIndexingStatusSnapshot, type SerializedCrossChainIndexingStatusSnapshotOmnichain, type SerializedCurrencyAmount, type SerializedCurrentIndexingProjectionOmnichain, type SerializedENSApiPublicConfig, type SerializedENSIndexerPublicConfig, type SerializedENSIndexerVersionInfo, type SerializedIndexedChainIds, type SerializedIndexingStatusResponse, type SerializedIndexingStatusResponseError, type SerializedIndexingStatusResponseOk, type SerializedNamedRegistrarAction, type SerializedOmnichainIndexingStatusSnapshot, type SerializedOmnichainIndexingStatusSnapshotBackfill, type SerializedOmnichainIndexingStatusSnapshotCompleted, type SerializedOmnichainIndexingStatusSnapshotFollowing, type SerializedOmnichainIndexingStatusSnapshotUnstarted, type SerializedPaginatedAggregatedReferrersResponse, type SerializedPaginatedAggregatedReferrersResponseError, type SerializedPaginatedAggregatedReferrersResponseOk, type SerializedPrice, type SerializedPriceDai, type SerializedPriceEth, type SerializedPriceUsdc, type SerializedRealtimeIndexingStatusProjection, type SerializedRegistrarAction, type SerializedRegistrarActionPricing, type SerializedRegistrarActionPricingAvailable, type SerializedRegistrarActionPricingUnknown, type SerializedRegistrarActionsResponse, type SerializedRegistrarActionsResponseError, type SerializedRegistrarActionsResponseOk, type SerializedRegistrationLifecycle, type SerializedSubregistry, type SubgraphInterpretedLabel, type SubgraphInterpretedName, type Subregistry, type TheGraphCannotFallbackReason, TheGraphCannotFallbackReasonSchema, type TheGraphFallback, TheGraphFallbackSchema, TraceableENSProtocol, type TraceableRequest, type TraceableResponse, TtlCache, type UnixTimestamp, type UnknownIdentity, type UnnamedIdentity, type UnresolvedIdentity, type UrlString, accountIdEqual, addDuration, addPrices, addrReverseLabel, asLowerCaseAddress, beautifyName, bigIntToNumber, bigintToCoinType, buildEnsRainbowClientLabelSet, buildLabelSetId, buildLabelSetVersion, buildUnresolvedIdentity, checkChainIndexingStatusSnapshotsForOmnichainStatusSnapshotBackfill, checkChainIndexingStatusSnapshotsForOmnichainStatusSnapshotCompleted, checkChainIndexingStatusSnapshotsForOmnichainStatusSnapshotFollowing, checkChainIndexingStatusSnapshotsForOmnichainStatusSnapshotUnstarted, coinTypeReverseLabel, coinTypeToEvmChainId, createIndexingConfig, createRealtimeIndexingStatusProjection, decodeDNSEncodedLiteralName, decodeDNSEncodedName, deserializeAccountId, deserializeBlockNumber, deserializeBlockRef, deserializeBlockrange, deserializeChainId, deserializeChainIndexingStatusSnapshot, deserializeCrossChainIndexingStatusSnapshot, deserializeDatetime, deserializeDuration, deserializeENSApiPublicConfig, deserializeENSIndexerPublicConfig, deserializeErrorResponse, deserializeIndexingStatusResponse, deserializeOmnichainIndexingStatusSnapshot, deserializePaginatedAggregatedReferrersResponse, deserializeRealtimeIndexingStatusProjection, deserializeRegistrarActionsResponse, deserializeUnixTimestamp, deserializeUrl, durationBetween, encodeLabelHash, evmChainIdToCoinType, getCurrencyInfo, getEthnamesSubregistryId, getNameHierarchy, getOmnichainIndexingCursor, getOmnichainIndexingStatus, getResolvePrimaryNameChainIdParam, getTimestampForHighestOmnichainKnownBlock, getTimestampForLowestOmnichainStartBlock, hasNullByte, interpretedLabelsToInterpretedName, isEncodedLabelHash, isHttpProtocol, isLabelHash, isNormalizedLabel, isNormalizedName, isPriceCurrencyEqual, isPriceEqual, isRegistrarActionPricingAvailable, isRegistrarActionReferralAvailable, isResolvedIdentity, isSelectionEmpty, isSubgraphCompatible, isWebSocketProtocol, labelHashToBytes, labelhashLiteralLabel, literalLabelToInterpretedLabel, literalLabelsToInterpretedName, literalLabelsToLiteralName, makeENSApiPublicConfigSchema, makeSubdomainNode, parseNonNegativeInteger, parseReverseName, priceDai, priceEth, priceUsdc, registrarActionsFilter, registrarActionsPrerequisites, reverseName, serializeAccountId, serializeChainId, serializeChainIndexingSnapshots, serializeCrossChainIndexingStatusSnapshotOmnichain, serializeDatetime, serializeENSApiPublicConfig, serializeENSIndexerPublicConfig, serializeIndexedChainIds, serializeIndexingStatusResponse, serializeNamedRegistrarAction, serializeOmnichainIndexingStatusSnapshot, serializePaginatedAggregatedReferrersResponse, serializePrice, serializePriceEth, serializeRealtimeIndexingStatusProjection, serializeRegistrarAction, serializeRegistrarActionPricing, serializeRegistrarActionsResponse, serializeRegistrationLifecycle, serializeSubregistry, serializeUrl, sortChainStatusesByStartBlockAsc, staleWhileRevalidate, stripNullBytes, translateDefaultableChainIdToChainId, uint256ToHex32, uniq, validateSupportedLabelSetAndVersion };