@ensnode/ensnode-sdk 1.0.2 → 1.1.0

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 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 { EncodedReferrer, ReferrerLeaderboardPaginationParams, ReferrerLeaderboardPage } from '@namehash/ens-referrals';
+export { EncodedReferrer, ZERO_ENCODED_REFERRER, decodeEncodedReferrer } from '@namehash/ens-referrals';
 import z$1, { z } from 'zod/v4';
 import { ENSNamespaceId } from '@ensnode/datasources';
 export { ENSNamespaceId, ENSNamespaceIds, getENSRootChainId } from '@ensnode/datasources';
@@ -622,6 +622,7 @@ interface Cache<KeyType extends string, ValueType> {
      */
     get capacity(): number;
 }
+
 /**
  * Cache that maps from string -> ValueType with a LRU (least recently used) eviction policy.
  *
@@ -645,60 +646,74 @@ declare class LruCache<KeyType extends string, ValueType> implements Cache<KeyTy
     get size(): number;
     get capacity(): number;
 }
+
 /**
- * Cache that maps from string -> ValueType with TTL (time-to-live) expiration.
- *
- * Items are automatically removed when they expire.
+ * Data structure for a single cached value.
  */
-declare class TtlCache<KeyType extends string, ValueType> implements Cache<KeyType, ValueType> {
-    private readonly _cache;
-    private readonly _ttl;
+interface CachedValue<ValueType> {
     /**
-     * Create a new TTL cache with the given TTL.
-     *
-     * @param ttl Time-to-live duration in seconds. Items expire after this duration.
+     * The cached value of type ValueType.
      */
-    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;
+    value: ValueType;
+    /**
+     * Unix timestamp indicating when the cached `value` was generated.
+     */
+    updatedAt: UnixTimestamp;
 }
-interface StaleWhileRevalidateOptions<ValueType> {
+interface SWRCacheOptions<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`.
+     * The async function generating a value of `ValueType` 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.
+     * considered stale but is still retained in the cache until successfully replaced with a new value.
      */
     ttl: Duration;
+    /**
+     * Optional time-to-proactively-revalidate duration in seconds. After this duration, automated attempts
+     * to asynchronously revalidate the cached value will be made in the background.
+     *
+     * If defined:
+     * - Proactive asynchronous revalidation attempts will be automatically triggered in the background
+     *   on this interval.
+     *
+     * If undefined:
+     * - Revalidation only occurs lazily when an explicit request for the cached value is
+     *   made after the `ttl` duration of the latest successfully cached value expires.
+     */
+    revalidationInterval?: Duration;
+    /**
+     * Proactively initialize
+     *
+     * Optional. Defaults to `false`.
+     *
+     * If `true`:
+     * - The SWR cache will proactively work to initialize itself, even before any explicit request to
+     *    access the cached value is made.
+     *
+     * If `false`:
+     * - The SWR cache will lazily wait to initialize itself only when one of the following occurs:
+     *    - Background revalidation occurred (if requested); or
+     *    - An explicit attempt to access the cached value is made.
+     */
+    proactivelyInitialize?: boolean;
 }
 /**
- * Stale-While-Revalidate (SWR) cache wrapper for async functions.
+ * Stale-While-Revalidate (SWR) cache 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.
+ * - Automatic background updates (triggered lazily when new requests
+ *   are made for the cached data or when the `revalidationInterval` is reached)
  *
  * @example
  * ```typescript
@@ -707,27 +722,96 @@ interface StaleWhileRevalidateOptions<ValueType> {
  *   return response.json();
  * };
  *
- * const cachedFetch = staleWhileRevalidate(fetchExpensiveData, 60); // 60 second TTL
+ * const cache = await SWRCache.create({
+ *   fn: fetchExpensiveData,
+ *   ttl: 60, // 1 minute TTL
+ *   revalidationInterval: 5 * 60 // proactive revalidation after 5 minutes from latest cache update
+ * });
  *
- * // First call: fetches data (slow)
- * const data1 = await cachedFetch();
+ * // [T0: 0] First call: fetches data (slow)
+ * const firstRead = await cache.readCache();
  *
- * // Within TTL: returns cached data (fast)
- * const data2 = await cachedFetch();
+ * // [T1: T0 + 59s] Within TTL: returns data cache at T0 (fast)
+ * const secondRead = await cache.readCache();
  *
- * // After TTL: returns stale data immediately, revalidates asynchronously in the background
- * const data3 = await cachedFetch(); // Still fast!
- * ```
+ * // [T2: T0 + 1m30s] After TTL: returns stale data that was cached at T0 immediately
+ * // revalidates asynchronously in the background
+ * const thirdRead = await cache.readCache(); // 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.
+ * // [T3: T2 + 90m] Background revalidation kicks in
+ *
+ * // [T4: T3 + 1m] Within TTL: returns data cache at T3 (fast)
+ * const fourthRead = await cache.readCache(); // Still fast!
+ *
+ * // Please note how using `SWRCache` enabled action at T3 to happen.
+ * // If no `revalidationInterval` value was set, the action at T3 would not happen.
+ * // Therefore, the `fourthRead` would return stale data cached at T2.
  *
  * @link https://web.dev/stale-while-revalidate/
  * @link https://datatracker.ietf.org/doc/html/rfc5861
  */
-declare function staleWhileRevalidate<ValueType>(options: StaleWhileRevalidateOptions<ValueType>): () => Promise<ValueType | null>;
+declare class SWRCache<ValueType> {
+    readonly options: SWRCacheOptions<ValueType>;
+    private cache;
+    /**
+     * Optional promise of the current in-progress attempt to revalidate the `cache`.
+     *
+     * If null, no revalidation attempt is currently in progress.
+     * If not null, identifies the revalidation attempt that is currently in progress.
+     *
+     * Used to enforce no concurrent revalidation attempts.
+     */
+    private inProgressRevalidate;
+    /**
+     * The callback function being managed by `BackgroundRevalidationScheduler`.
+     *
+     * If null, no background revalidation is scheduled.
+     * If not null, identifies the background revalidation that is currently scheduled.
+     *
+     * Used to enforce no concurrent background revalidation attempts.
+     */
+    private scheduledBackgroundRevalidate;
+    private constructor();
+    /**
+     * Asynchronously create a new `SWRCache` instance.
+     *
+     * @param options - The {@link SWRCacheOptions} for the SWR cache.
+     * @returns a new `SWRCache` instance.
+     */
+    static create<ValueType>(options: SWRCacheOptions<ValueType>): Promise<SWRCache<ValueType>>;
+    private revalidate;
+    /**
+     * Read the most recently cached `CachedValue` from the `SWRCache`.
+     *
+     * @returns a `CachedValue` holding 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,
+     */
+    readCache: () => Promise<CachedValue<ValueType> | null>;
+}
+
+/**
+ * Cache that maps from string -> ValueType with TTL (time-to-live) expiration.
+ *
+ * Items are automatically removed when they expire.
+ */
+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;
+}
 
 /**
  * Filter out duplicates.
@@ -1946,6 +2030,13 @@ declare function checkChainIndexingStatusSnapshotsForOmnichainStatusSnapshotFoll
  * by the omnichain start block timestamp in ascending order.
  */
 declare function sortChainStatusesByStartBlockAsc<ChainStatusType extends ChainIndexingStatusSnapshot>(chains: [ChainId, ChainStatusType][]): [ChainId, ChainStatusType][];
+/**
+ * Gets the latest indexed {@link BlockRef} for the given {@link ChainId}.
+ *
+ * @returns the latest indexed {@link BlockRef} for the given {@link ChainId}, or null if the chain
+ *          isn't being indexed at all or is queued and therefore hasn't started indexing yet.
+ */
+declare function getLatestIndexedBlockRef(indexingStatus: CrossChainIndexingStatusSnapshot, chainId: ChainId): BlockRef | null;
 
 /**
  * Create realtime indexing status projection from
@@ -3102,181 +3193,86 @@ declare function serializeNamedRegistrarAction({ action, name, }: NamedRegistrar
 declare function serializeRegistrarActionsResponse(response: RegistrarActionsResponse): SerializedRegistrarActionsResponse;
 
 /**
- * The default number of items per page for paginated aggregated referrer queries.
- */
-declare const ITEMS_PER_PAGE_DEFAULT = 25;
-/**
- * The maximum number of items per page for paginated aggregated referrer queries.
- */
-declare const ITEMS_PER_PAGE_MAX = 100;
-/**
- * Represents the aggregated metrics for a single referrer.
- */
-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;
-}
-/**
- * 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.
+ * Request parameters for a referrer leaderboard page query.
  */
-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;
+interface ReferrerLeaderboardPaginationRequest extends ReferrerLeaderboardPaginationParams {
 }
 /**
- * Base pagination parameters for paginated queries.
+ * A status code for a referrer leaderboard page API response.
  */
-interface PaginationParams {
+declare const ReferrerLeaderboardPageResponseCodes: {
     /**
-     * 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;
-}
-/**
- * Request parameters for paginated aggregated referrers query.
- */
-interface PaginatedAggregatedReferrersRequest extends PaginationParams {
-}
-/**
- * Paginated aggregated referrers data with metadata.
- */
-interface PaginatedAggregatedReferrers {
-    /**
-     * 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)
-     */
-    hasPrev: boolean;
-    /** Unix timestamp of when the leaderboard was last updated */
-    updatedAt: UnixTimestamp;
-}
-/**
- * A status code for paginated aggregated referrers API responses.
- */
-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.
+     * Represents that the requested referrer leaderboard page is available.
      */
     readonly Ok: "ok";
     /**
-     * Represents that the aggregated referrers data is not available.
+     * Represents that the referrer leaderboard data is not available.
      */
     readonly Error: "error";
 };
 /**
- * The derived string union of possible {@link PaginatedAggregatedReferrersResponseCodes}.
+ * The derived string union of possible {@link ReferrerLeaderboardPageResponseCodes}.
  */
-type PaginatedAggregatedReferrersResponseCode = (typeof PaginatedAggregatedReferrersResponseCodes)[keyof typeof PaginatedAggregatedReferrersResponseCodes];
+type ReferrerLeaderboardPageResponseCode = (typeof ReferrerLeaderboardPageResponseCodes)[keyof typeof ReferrerLeaderboardPageResponseCodes];
 /**
- * A paginated aggregated referrers response when the data is available.
+ * A referrer leaderboard page response when the data is available.
  */
-type PaginatedAggregatedReferrersResponseOk = {
-    responseCode: typeof PaginatedAggregatedReferrersResponseCodes.Ok;
-    data: PaginatedAggregatedReferrers;
+type ReferrerLeaderboardPageResponseOk = {
+    responseCode: typeof ReferrerLeaderboardPageResponseCodes.Ok;
+    data: ReferrerLeaderboardPage;
 };
 /**
- * A paginated aggregated referrers response when the data is not available.
+ * A referrer leaderboard page response when the data is not available.
  */
-type PaginatedAggregatedReferrersResponseError = {
-    responseCode: typeof PaginatedAggregatedReferrersResponseCodes.Error;
+type ReferrerLeaderboardPageResponseError = {
+    responseCode: typeof ReferrerLeaderboardPageResponseCodes.Error;
     error: string;
     errorMessage: string;
 };
 /**
- * A paginated aggregated referrers API response.
+ * A referrer leaderboard page API response.
  *
  * Use the `responseCode` field to determine the specific type interpretation
  * at runtime.
  */
-type PaginatedAggregatedReferrersResponse = PaginatedAggregatedReferrersResponseOk | PaginatedAggregatedReferrersResponseError;
+type ReferrerLeaderboardPageResponse = ReferrerLeaderboardPageResponseOk | ReferrerLeaderboardPageResponseError;
 
 /**
- * Serialized representation of {@link PaginatedAggregatedReferrersResponseError}.
+ * Serialized representation of {@link ReferrerLeaderboardPageResponseError}.
  *
  * Note: All fields are already serializable, so this type is identical to the source type.
  */
-type SerializedPaginatedAggregatedReferrersResponseError = PaginatedAggregatedReferrersResponseError;
+type SerializedReferrerLeaderboardPageResponseError = ReferrerLeaderboardPageResponseError;
 /**
- * Serialized representation of {@link PaginatedAggregatedReferrersResponseOk}.
+ * Serialized representation of {@link ReferrerLeaderboardPageResponseOk}.
  *
  * Note: All fields are already serializable, so this type is identical to the source type.
  */
-type SerializedPaginatedAggregatedReferrersResponseOk = PaginatedAggregatedReferrersResponseOk;
+type SerializedReferrerLeaderboardPageResponseOk = ReferrerLeaderboardPageResponseOk;
 /**
- * Serialized representation of {@link PaginatedAggregatedReferrersResponse}.
+ * Serialized representation of {@link ReferrerLeaderboardPageResponse}.
  */
-type SerializedPaginatedAggregatedReferrersResponse = SerializedPaginatedAggregatedReferrersResponseOk | SerializedPaginatedAggregatedReferrersResponseError;
+type SerializedReferrerLeaderboardPageResponse = SerializedReferrerLeaderboardPageResponseOk | SerializedReferrerLeaderboardPageResponseError;
 
 /**
- * Deserialize a {@link PaginatedAggregatedReferrersResponse} object.
+ * Deserialize a {@link ReferrerLeaderboardPageResponse} 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;
+declare function deserializeReferrerLeaderboardPageResponse(maybeResponse: SerializedReferrerLeaderboardPageResponse, valueLabel?: string): ReferrerLeaderboardPageResponse;
 
 /**
- * Serialize a {@link PaginatedAggregatedReferrersResponse} object.
+ * Serialize a {@link ReferrerLeaderboardPageResponse} object.
  *
- * Note: Since all fields in PaginatedAggregatedReferrersResponse are already
+ * Note: Since all fields in ReferrerLeaderboardPageResponse are already
  * serializable primitives, this function performs an identity transformation.
  * It exists to maintain consistency with the serialization pattern used
  * throughout the codebase.
  */
-declare function serializePaginatedAggregatedReferrersResponse(response: PaginatedAggregatedReferrersResponse): SerializedPaginatedAggregatedReferrersResponse;
+declare function serializeReferrerLeaderboardPageResponse(response: ReferrerLeaderboardPageResponse): SerializedReferrerLeaderboardPageResponse;
 
 /**
  * Configuration options for ENSNode API client
@@ -3458,15 +3454,15 @@ declare class ENSNodeClient {
      */
     indexingStatus(): Promise<IndexingStatusResponse>;
     /**
-     * Fetch Paginated Aggregated Referrers
+     * Fetch Referrer Leaderboard Page
      *
-     * Retrieves a paginated list of aggregated referrer metrics with contribution percentages.
+     * Retrieves a paginated list of referrer leaderboard 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}
+     * @returns {ReferrerLeaderboardPageResponse}
      *
      * @throws if the ENSNode request fails
      * @throws if the ENSNode API returns an error response
@@ -3475,20 +3471,41 @@ declare class ENSNodeClient {
      * @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)}`);
+     * const response = await client.getReferrerLeaderboard();
+     * if (response.responseCode === ReferrerLeaderboardPageResponseCodes.Ok) {
+     *   const {
+     *     aggregatedMetrics,
+     *     referrers,
+     *     rules,
+     *     paginationContext,
+     *     updatedAt
+     *   } = response.data;
+     *   console.log(aggregatedMetrics);
+     *   console.log(referrers);
+     *   console.log(rules);
+     *   console.log(updatedAt);
+     *   console.log(`Page ${paginationContext.page} of ${paginationContext.totalPages}`);
      * }
      * ```
      *
      * @example
      * ```typescript
      * // Get second page with 50 items per page
-     * const response = await client.getAggregatedReferrers({ page: 2, itemsPerPage: 50 });
+     * const response = await client.getReferrerLeaderboard({ page: 2, itemsPerPage: 50 });
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Handle error response, ie. when Referrer Leaderboard is not currently available.
+     * const response = await client.getReferrerLeaderboard();
+     *
+     * if (response.responseCode === ReferrerLeaderboardPageResponseCodes.Error) {
+     *   console.error(response.error);
+     *   console.error(response.errorMessage);
+     * }
      * ```
      */
-    getAggregatedReferrers(request?: PaginatedAggregatedReferrersRequest): Promise<PaginatedAggregatedReferrersResponse>;
+    getReferrerLeaderboard(request?: ReferrerLeaderboardPaginationRequest): Promise<ReferrerLeaderboardPageResponse>;
     /**
      * Fetch ENSNode Registrar Actions
      *
@@ -3553,4 +3570,4 @@ declare class ClientError extends Error {
     static fromErrorResponse({ message, details }: ErrorResponse): ClientError;
 }
 
-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 };
+export { ADDR_REVERSE_NODE, 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 CachedValue, 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, 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, PluginName, type Price, type PriceDai, type PriceEth, type PriceUsdc, type ProtocolSpan, type ProtocolSpanTreeNode, type ProtocolTrace, ROOT_NODE, type RealtimeIndexingStatusProjection, type ReferrerLeaderboardPageResponse, type ReferrerLeaderboardPageResponseCode, ReferrerLeaderboardPageResponseCodes, type ReferrerLeaderboardPageResponseError, type ReferrerLeaderboardPageResponseOk, type ReferrerLeaderboardPaginationRequest, 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, SWRCache, type SWRCacheOptions, 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 SerializedPrice, type SerializedPriceDai, type SerializedPriceEth, type SerializedPriceUsdc, type SerializedRealtimeIndexingStatusProjection, type SerializedReferrerLeaderboardPageResponse, type SerializedReferrerLeaderboardPageResponseError, type SerializedReferrerLeaderboardPageResponseOk, 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, deserializeRealtimeIndexingStatusProjection, deserializeReferrerLeaderboardPageResponse, deserializeRegistrarActionsResponse, deserializeUnixTimestamp, deserializeUrl, durationBetween, encodeLabelHash, evmChainIdToCoinType, getCurrencyInfo, getEthnamesSubregistryId, getLatestIndexedBlockRef, 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, serializePrice, serializePriceEth, serializeRealtimeIndexingStatusProjection, serializeReferrerLeaderboardPageResponse, serializeRegistrarAction, serializeRegistrarActionPricing, serializeRegistrarActionsResponse, serializeRegistrationLifecycle, serializeSubregistry, serializeUrl, sortChainStatusesByStartBlockAsc, stripNullBytes, translateDefaultableChainIdToChainId, uint256ToHex32, uniq, validateSupportedLabelSetAndVersion };