@metamask-previews/assets-controller 14.0.2-preview-4f4c98e → 14.0.2-preview-eb263b0ee

package/dist/data-sources/evm-rpc-services/clients/TokensApiClient.cjs

@@ -0,0 +1,312 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _TokensApiClient_instances, _TokensApiClient_fetch, _TokensApiClient_queryClient, _TokensApiClient_supportedChainIds, _TokensApiClient_supportedChainIdsCachedAt, _TokensApiClient_supportedChainIdsRefreshPromise, _TokensApiClient_suggestedOccurrenceFloors, _TokensApiClient_suggestedOccurrenceFloorsCachedAt, _TokensApiClient_suggestedOccurrenceFloorsRefreshPromise, _TokensApiClient_isSupportedChain, _TokensApiClient_refreshSupportedChainIds, _TokensApiClient_getOccurrenceFloor, _TokensApiClient_refreshSuggestedOccurrenceFloors, _TokensApiClient_fetchTokenListUncached;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokensApiClient = void 0;
+const controller_utils_1 = require("@metamask/controller-utils");
+/**
+ * Same host + path that `TokenListController` (assets-controllers) uses
+ * (`token-service.ts` → `getTokensURL`). Sharing this endpoint keeps the
+ * RPC token detector aligned with the rest of the wallet's token listing
+ * (occurrence floors, aggregator filters, icon URLs, etc.).
+ */
+const TOKEN_END_POINT_API = 'https://token.api.cx.metamask.io';
+/**
+ * Endpoint that returns which CAIP chain IDs the Tokens API supports.
+ * Used to skip detection (and avoid unnecessary network requests) for chains
+ * that are not in the supported-networks list.
+ */
+const SUPPORTED_NETWORKS_URL = `${TOKEN_END_POINT_API}/v2/supportedNetworks`;
+/**
+ * Per-chain suggested occurrence floors used as the `occurrenceFloor` query
+ * param when fetching token lists (and aligned with TokenDataSource spam
+ * filtering). Keys are decimal chain IDs.
+ */
+const SUGGESTED_OCCURRENCE_FLOORS_URL = `${TOKEN_END_POINT_API}/v1/suggestedOccurrenceFloors`;
+/**
+ * Fallback `occurrenceFloor` when `/v1/suggestedOccurrenceFloors` has no entry
+ * for the chain, or the floors request fails.
+ */
+const DEFAULT_OCCURRENCE_FLOOR = 3;
+/**
+ * How long to keep the supported-networks response in the instance-level
+ * cache before refreshing it. One hour is sufficient — the list rarely
+ * changes and a stale cache just means we may do an unnecessary token-list
+ * fetch for a newly-unsupported chain (harmless).
+ */
+const SUPPORTED_NETWORKS_CACHE_TTL_MS = 60 * 60000;
+/**
+ * How long to keep suggested occurrence floors cached. Same TTL as supported
+ * networks — floors change infrequently.
+ */
+const SUGGESTED_OCCURRENCE_FLOORS_CACHE_TTL_MS = 60 * 60000;
+/**
+ * TanStack-Query cache config for the cached `fetchTokenList` path.
+ *
+ * The Tokens API per-chain list barely changes between polls, so we keep
+ * results fresh for a few minutes (`staleTime`) and retain them in cache for
+ * an hour (`gcTime`) so re-detections across accounts/chains hit the cache.
+ * These tunings only apply when a `queryClient` is provided to the client;
+ * the uncached fallback path (used in standalone tests) is unaffected.
+ */
+const TOKEN_LIST_STALE_TIME_MS = 5 * 60000;
+const TOKEN_LIST_GC_TIME_MS = 60 * 60000;
+/**
+ * Client for the MetaMask Tokens API.
+ *
+ * Fetches the per-chain ERC-20 token list from the same endpoint that
+ * `TokenListController` uses (`token.api.cx.metamask.io/tokens/{chainId}`),
+ * with the same query parameters. The `occurrenceFloor` query param comes from
+ * Token API `/v1/suggestedOccurrenceFloors` (fallback {@link DEFAULT_OCCURRENCE_FLOOR}),
+ * matching `TokenDataSource` spam filtering. Linea's post-response aggregator
+ * filter is still applied client-side.
+ *
+ * Before fetching a chain's token list, the client checks
+ * `/v2/supportedNetworks` and returns `[]` immediately for chains that are
+ * not in the supported list, avoiding unnecessary API calls. The supported-
+ * networks response is cached in-memory for one hour.
+ *
+ * When constructed with a `queryClient`, token-list results are cached and
+ * deduped via TanStack Query (5 min staleTime, 1 h gcTime), so concurrent
+ * detection cycles for the same chain coalesce into a single network request.
+ */
+class TokensApiClient {
+    constructor(config) {
+        _TokensApiClient_instances.add(this);
+        _TokensApiClient_fetch.set(this, void 0);
+        _TokensApiClient_queryClient.set(this, void 0);
+        /** CAIP chain IDs returned by `/v2/supportedNetworks` (both tiers). */
+        _TokensApiClient_supportedChainIds.set(this, void 0);
+        /** Timestamp of the last successful `/v2/supportedNetworks` fetch. */
+        _TokensApiClient_supportedChainIdsCachedAt.set(this, 0);
+        /**
+         * In-flight `/v2/supportedNetworks` request shared across concurrent callers
+         * so only one network request is made even when multiple `fetchTokenList`
+         * calls arrive before the first one resolves.
+         */
+        _TokensApiClient_supportedChainIdsRefreshPromise.set(this, void 0);
+        /** Decimal chain ID → suggested occurrence floor from Token API. */
+        _TokensApiClient_suggestedOccurrenceFloors.set(this, void 0);
+        /** Timestamp of the last successful floors fetch. */
+        _TokensApiClient_suggestedOccurrenceFloorsCachedAt.set(this, 0);
+        /** In-flight floors request shared across concurrent callers. */
+        _TokensApiClient_suggestedOccurrenceFloorsRefreshPromise.set(this, void 0);
+        __classPrivateFieldSet(this, _TokensApiClient_fetch, config?.fetch ?? globalThis.fetch.bind(globalThis), "f");
+        __classPrivateFieldSet(this, _TokensApiClient_queryClient, config?.queryClient, "f");
+    }
+    /**
+     * Fetch the list of ERC-20 tokens for a chain from the Tokens API.
+     *
+     * Returns `[]` immediately (without hitting the token-list endpoint) when
+     * the chain is not in the `/v2/supportedNetworks` response, or when the
+     * supported-networks check fails for any reason.
+     *
+     * @param hexChainId - Chain ID in hex format (e.g. `'0x1'` for Ethereum mainnet).
+     * @returns Array of token list entries with address and metadata, or an empty
+     * array if the chain is unsupported or the request fails.
+     */
+    async fetchTokenList(hexChainId) {
+        // Treat any error from the supported-networks check as "not supported":
+        // the token-list endpoint is only contacted for known-supported chains.
+        if (!(await __classPrivateFieldGet(this, _TokensApiClient_instances, "m", _TokensApiClient_isSupportedChain).call(this, hexChainId).catch(() => false))) {
+            return [];
+        }
+        const queryClient = __classPrivateFieldGet(this, _TokensApiClient_queryClient, "f");
+        if (queryClient === undefined) {
+            return __classPrivateFieldGet(this, _TokensApiClient_instances, "m", _TokensApiClient_fetchTokenListUncached).call(this, hexChainId);
+        }
+        return queryClient.fetchQuery({
+            // Namespacing keeps this key from colliding with other clients that
+            // share the same QueryClient (e.g. core-backend's ApiPlatformClient).
+            queryKey: [
+                'assets-controller',
+                'rpc-detection',
+                'token-list',
+                { chainId: hexChainId },
+            ],
+            queryFn: () => __classPrivateFieldGet(this, _TokensApiClient_instances, "m", _TokensApiClient_fetchTokenListUncached).call(this, hexChainId),
+            staleTime: TOKEN_LIST_STALE_TIME_MS,
+            gcTime: TOKEN_LIST_GC_TIME_MS,
+        });
+    }
+}
+exports.TokensApiClient = TokensApiClient;
+_TokensApiClient_fetch = new WeakMap(), _TokensApiClient_queryClient = new WeakMap(), _TokensApiClient_supportedChainIds = new WeakMap(), _TokensApiClient_supportedChainIdsCachedAt = new WeakMap(), _TokensApiClient_supportedChainIdsRefreshPromise = new WeakMap(), _TokensApiClient_suggestedOccurrenceFloors = new WeakMap(), _TokensApiClient_suggestedOccurrenceFloorsCachedAt = new WeakMap(), _TokensApiClient_suggestedOccurrenceFloorsRefreshPromise = new WeakMap(), _TokensApiClient_instances = new WeakSet(), _TokensApiClient_isSupportedChain = 
+/**
+ * Check whether the given chain is present in the supported-networks list.
+ *
+ * Uses an instance-level cache (1 h TTL). Throws if the network request
+ * fails — callers should handle this (e.g. via `.catch(() => false)`).
+ *
+ * @param hexChainId - Hex chain ID to check.
+ * @returns `true` when the chain is in the supported-networks list.
+ */
+async function _TokensApiClient_isSupportedChain(hexChainId) {
+    const now = Date.now();
+    if (__classPrivateFieldGet(this, _TokensApiClient_supportedChainIds, "f") === undefined ||
+        now - __classPrivateFieldGet(this, _TokensApiClient_supportedChainIdsCachedAt, "f") >= SUPPORTED_NETWORKS_CACHE_TTL_MS) {
+        await __classPrivateFieldGet(this, _TokensApiClient_instances, "m", _TokensApiClient_refreshSupportedChainIds).call(this, now);
+    }
+    const caipChainId = `eip155:${(0, controller_utils_1.convertHexToDecimal)(hexChainId)}`;
+    return __classPrivateFieldGet(this, _TokensApiClient_supportedChainIds, "f")?.has(caipChainId) ?? false;
+}, _TokensApiClient_refreshSupportedChainIds = 
+/**
+ * Fetch `/v2/supportedNetworks` and update the instance cache.
+ * Concurrent callers share the same in-flight Promise so only one network
+ * request is made. If the response is not 2xx the cache is left unchanged
+ * (the chain will be treated as unsupported this cycle).
+ *
+ * @param now - Current timestamp used to stamp the cache entry.
+ * @returns A promise that resolves once the cache has been refreshed.
+ */
+async function _TokensApiClient_refreshSupportedChainIds(now) {
+    if (__classPrivateFieldGet(this, _TokensApiClient_supportedChainIdsRefreshPromise, "f") !== undefined) {
+        return __classPrivateFieldGet(this, _TokensApiClient_supportedChainIdsRefreshPromise, "f");
+    }
+    __classPrivateFieldSet(this, _TokensApiClient_supportedChainIdsRefreshPromise, (async () => {
+        try {
+            const response = await __classPrivateFieldGet(this, _TokensApiClient_fetch, "f").call(this, SUPPORTED_NETWORKS_URL);
+            if (response.ok) {
+                const data = (await response.json());
+                __classPrivateFieldSet(this, _TokensApiClient_supportedChainIds, new Set([
+                    ...(data.fullSupport ?? []),
+                    ...(data.partialSupport ?? []),
+                ]), "f");
+                __classPrivateFieldSet(this, _TokensApiClient_supportedChainIdsCachedAt, now, "f");
+            }
+        }
+        finally {
+            __classPrivateFieldSet(this, _TokensApiClient_supportedChainIdsRefreshPromise, undefined, "f");
+        }
+    })(), "f");
+    return __classPrivateFieldGet(this, _TokensApiClient_supportedChainIdsRefreshPromise, "f");
+}, _TokensApiClient_getOccurrenceFloor = 
+/**
+ * Resolve the `occurrenceFloor` query param for a chain from Token API
+ * `/v1/suggestedOccurrenceFloors`. Falls back to
+ * {@link DEFAULT_OCCURRENCE_FLOOR} when the chain is missing or the request
+ * fails.
+ *
+ * @param hexChainId - Hex chain ID.
+ * @returns Occurrence floor to send to `/tokens/{chainId}`.
+ */
+async function _TokensApiClient_getOccurrenceFloor(hexChainId) {
+    const now = Date.now();
+    if (__classPrivateFieldGet(this, _TokensApiClient_suggestedOccurrenceFloors, "f") === undefined ||
+        now - __classPrivateFieldGet(this, _TokensApiClient_suggestedOccurrenceFloorsCachedAt, "f") >=
+            SUGGESTED_OCCURRENCE_FLOORS_CACHE_TTL_MS) {
+        await __classPrivateFieldGet(this, _TokensApiClient_instances, "m", _TokensApiClient_refreshSuggestedOccurrenceFloors).call(this, now);
+    }
+    const decimalChainId = String((0, controller_utils_1.convertHexToDecimal)(hexChainId));
+    return (__classPrivateFieldGet(this, _TokensApiClient_suggestedOccurrenceFloors, "f")?.[decimalChainId] ??
+        DEFAULT_OCCURRENCE_FLOOR);
+}, _TokensApiClient_refreshSuggestedOccurrenceFloors = 
+/**
+ * Fetch `/v1/suggestedOccurrenceFloors` and update the instance cache.
+ * Concurrent callers share the in-flight Promise. Failures leave the cache
+ * empty so {@link #getOccurrenceFloor} falls back to the default.
+ *
+ * @param now - Current timestamp used to stamp the cache entry.
+ * @returns A promise that resolves once the cache has been refreshed.
+ */
+async function _TokensApiClient_refreshSuggestedOccurrenceFloors(now) {
+    if (__classPrivateFieldGet(this, _TokensApiClient_suggestedOccurrenceFloorsRefreshPromise, "f") !== undefined) {
+        return __classPrivateFieldGet(this, _TokensApiClient_suggestedOccurrenceFloorsRefreshPromise, "f");
+    }
+    __classPrivateFieldSet(this, _TokensApiClient_suggestedOccurrenceFloorsRefreshPromise, (async () => {
+        try {
+            const response = await __classPrivateFieldGet(this, _TokensApiClient_fetch, "f").call(this, SUGGESTED_OCCURRENCE_FLOORS_URL);
+            if (response.ok) {
+                const data = (await response.json());
+                __classPrivateFieldSet(this, _TokensApiClient_suggestedOccurrenceFloors, data && typeof data === 'object' && !Array.isArray(data)
+                    ? data
+                    : {}, "f");
+                __classPrivateFieldSet(this, _TokensApiClient_suggestedOccurrenceFloorsCachedAt, now, "f");
+            }
+            else {
+                __classPrivateFieldSet(this, _TokensApiClient_suggestedOccurrenceFloors, {}, "f");
+                __classPrivateFieldSet(this, _TokensApiClient_suggestedOccurrenceFloorsCachedAt, now, "f");
+            }
+        }
+        catch {
+            __classPrivateFieldSet(this, _TokensApiClient_suggestedOccurrenceFloors, {}, "f");
+            __classPrivateFieldSet(this, _TokensApiClient_suggestedOccurrenceFloorsCachedAt, now, "f");
+        }
+        finally {
+            __classPrivateFieldSet(this, _TokensApiClient_suggestedOccurrenceFloorsRefreshPromise, undefined, "f");
+        }
+    })(), "f");
+    return __classPrivateFieldGet(this, _TokensApiClient_suggestedOccurrenceFloorsRefreshPromise, "f");
+}, _TokensApiClient_fetchTokenListUncached = async function _TokensApiClient_fetchTokenListUncached(hexChainId) {
+    const decimalChainId = (0, controller_utils_1.convertHexToDecimal)(hexChainId);
+    const occurrenceFloor = await __classPrivateFieldGet(this, _TokensApiClient_instances, "m", _TokensApiClient_getOccurrenceFloor).call(this, hexChainId);
+    // Same query shape as `TokenListController.getTokensURL` (token-service.ts),
+    // but `occurrenceFloor` comes from `/v1/suggestedOccurrenceFloors`.
+    // No `first=...` cap — the API returns the full per-chain list bounded
+    // server-side by `occurrenceFloor`.
+    const url = `${TOKEN_END_POINT_API}/tokens/${decimalChainId}` +
+        `?occurrenceFloor=${occurrenceFloor}` +
+        `&includeNativeAssets=false` +
+        `&includeTokenFees=false` +
+        `&includeAssetType=false` +
+        `&includeERC20Permit=false` +
+        `&includeStorage=false` +
+        `&includeRwaData=true`;
+    let response;
+    try {
+        response = await __classPrivateFieldGet(this, _TokensApiClient_fetch, "f").call(this, url);
+    }
+    catch (error) {
+        console.error(`Tokens API request failed for chain ${hexChainId}:`, error);
+        return [];
+    }
+    if (!response.ok) {
+        console.error(`Tokens API responded with ${response.status} for chain ${hexChainId}`);
+        return [];
+    }
+    const raw = (await response.json());
+    const items = Array.isArray(raw)
+        ? raw
+        : [];
+    const filtered = applyChainSpecificFilters(hexChainId, items);
+    return filtered.map((item) => ({
+        address: item.address,
+        symbol: item.symbol ?? '',
+        name: item.name ?? '',
+        decimals: item.decimals ?? 18,
+        iconUrl: item.iconUrl,
+        aggregators: item.aggregators,
+        occurrences: item.occurrences,
+    }));
+};
+/**
+ * Apply chain-specific filters to a raw token list response, mirroring
+ * `fetchTokenListByChainId` in `assets-controllers/src/token-service.ts`.
+ *
+ * For Linea mainnet, the API returns extras with low aggregator coverage, so
+ * we keep only entries flagged by Linea's own team or seen by ≥3 aggregators.
+ *
+ * @param hexChainId - Hex chain ID.
+ * @param items - Raw items from the API response.
+ * @returns Items after chain-specific filtering.
+ */
+function applyChainSpecificFilters(hexChainId, items) {
+    if (hexChainId === controller_utils_1.ChainId['linea-mainnet']) {
+        return items.filter((item) => {
+            const aggregators = item.aggregators ?? [];
+            return aggregators.includes('lineaTeam') || aggregators.length >= 3;
+        });
+    }
+    return items;
+}
+//# sourceMappingURL=TokensApiClient.cjs.map

package/dist/data-sources/evm-rpc-services/clients/TokensApiClient.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokensApiClient.cjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/TokensApiClient.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  ChainId as ControllerChainId,\n  convertHexToDecimal,\n} from '@metamask/controller-utils';\n\nimport type { ChainId, TokenListEntry } from '../types/index.js';\n\n/**\n * Same host + path that `TokenListController` (assets-controllers) uses\n * (`token-service.ts` → `getTokensURL`). Sharing this endpoint keeps the\n * RPC token detector aligned with the rest of the wallet's token listing\n * (occurrence floors, aggregator filters, icon URLs, etc.).\n */\nconst TOKEN_END_POINT_API = 'https://token.api.cx.metamask.io';\n\n/**\n * Endpoint that returns which CAIP chain IDs the Tokens API supports.\n * Used to skip detection (and avoid unnecessary network requests) for chains\n * that are not in the supported-networks list.\n */\nconst SUPPORTED_NETWORKS_URL = `${TOKEN_END_POINT_API}/v2/supportedNetworks`;\n\n/**\n * Per-chain suggested occurrence floors used as the `occurrenceFloor` query\n * param when fetching token lists (and aligned with TokenDataSource spam\n * filtering). Keys are decimal chain IDs.\n */\nconst SUGGESTED_OCCURRENCE_FLOORS_URL = `${TOKEN_END_POINT_API}/v1/suggestedOccurrenceFloors`;\n\n/**\n * Fallback `occurrenceFloor` when `/v1/suggestedOccurrenceFloors` has no entry\n * for the chain, or the floors request fails.\n */\nconst DEFAULT_OCCURRENCE_FLOOR = 3;\n\n/**\n * How long to keep the supported-networks response in the instance-level\n * cache before refreshing it. One hour is sufficient — the list rarely\n * changes and a stale cache just means we may do an unnecessary token-list\n * fetch for a newly-unsupported chain (harmless).\n */\nconst SUPPORTED_NETWORKS_CACHE_TTL_MS = 60 * 60_000;\n\n/**\n * How long to keep suggested occurrence floors cached. Same TTL as supported\n * networks — floors change infrequently.\n */\nconst SUGGESTED_OCCURRENCE_FLOORS_CACHE_TTL_MS = 60 * 60_000;\n\n/**\n * TanStack-Query cache config for the cached `fetchTokenList` path.\n *\n * The Tokens API per-chain list barely changes between polls, so we keep\n * results fresh for a few minutes (`staleTime`) and retain them in cache for\n * an hour (`gcTime`) so re-detections across accounts/chains hit the cache.\n * These tunings only apply when a `queryClient` is provided to the client;\n * the uncached fallback path (used in standalone tests) is unaffected.\n */\nconst TOKEN_LIST_STALE_TIME_MS = 5 * 60_000;\nconst TOKEN_LIST_GC_TIME_MS = 60 * 60_000;\n\n/**\n * Shape of the `/v2/supportedNetworks` response.\n */\ntype SupportedNetworksResponse = {\n  fullSupport?: string[];\n  partialSupport?: string[];\n};\n\n/**\n * Shape of a single item returned by the Tokens API `/tokens/{chainId}`\n * endpoint. Mirrors `TokenListToken` in\n * `packages/assets-controllers/src/TokenListController.ts` and the response\n * parsed by `fetchTokenListByChainId` in `token-service.ts`.\n */\ntype ApiTokenListItem = {\n  address: string;\n  symbol?: string;\n  name?: string;\n  decimals?: number;\n  occurrences?: number;\n  aggregators?: string[];\n  iconUrl?: string;\n};\n\n/**\n * Minimal structural type for the TanStack Query client method we use.\n * Avoids a direct dependency on `@tanstack/query-core` while still being\n * fully compatible with the shared `QueryClient` exposed by\n * `ApiPlatformClient.queryClient` (`@metamask/core-backend`).\n */\nexport type TokenListQueryClient = {\n  fetchQuery<TData>(options: {\n    queryKey: readonly unknown[];\n    queryFn: () => Promise<TData>;\n    staleTime?: number;\n    gcTime?: number;\n  }): Promise<TData>;\n};\n\nexport type TokensApiClientConfig = {\n  /** Fetch function (defaults to globalThis.fetch). */\n  fetch?: typeof globalThis.fetch;\n  /**\n   * Optional TanStack-Query client used to cache token-list responses across\n   * detector polls / accounts / instances. When omitted, every call hits the\n   * network directly (preserves prior behaviour for tests and standalone use).\n   */\n  queryClient?: TokenListQueryClient;\n};\n\n/**\n * Client for the MetaMask Tokens API.\n *\n * Fetches the per-chain ERC-20 token list from the same endpoint that\n * `TokenListController` uses (`token.api.cx.metamask.io/tokens/{chainId}`),\n * with the same query parameters. The `occurrenceFloor` query param comes from\n * Token API `/v1/suggestedOccurrenceFloors` (fallback {@link DEFAULT_OCCURRENCE_FLOOR}),\n * matching `TokenDataSource` spam filtering. Linea's post-response aggregator\n * filter is still applied client-side.\n *\n * Before fetching a chain's token list, the client checks\n * `/v2/supportedNetworks` and returns `[]` immediately for chains that are\n * not in the supported list, avoiding unnecessary API calls. The supported-\n * networks response is cached in-memory for one hour.\n *\n * When constructed with a `queryClient`, token-list results are cached and\n * deduped via TanStack Query (5 min staleTime, 1 h gcTime), so concurrent\n * detection cycles for the same chain coalesce into a single network request.\n */\nexport class TokensApiClient {\n  readonly #fetch: typeof globalThis.fetch;\n\n  readonly #queryClient: TokenListQueryClient | undefined;\n\n  /** CAIP chain IDs returned by `/v2/supportedNetworks` (both tiers). */\n  #supportedChainIds: Set<string> | undefined;\n\n  /** Timestamp of the last successful `/v2/supportedNetworks` fetch. */\n  #supportedChainIdsCachedAt = 0;\n\n  /**\n   * In-flight `/v2/supportedNetworks` request shared across concurrent callers\n   * so only one network request is made even when multiple `fetchTokenList`\n   * calls arrive before the first one resolves.\n   */\n  #supportedChainIdsRefreshPromise: Promise<void> | undefined;\n\n  /** Decimal chain ID → suggested occurrence floor from Token API. */\n  #suggestedOccurrenceFloors: Record<string, number> | undefined;\n\n  /** Timestamp of the last successful floors fetch. */\n  #suggestedOccurrenceFloorsCachedAt = 0;\n\n  /** In-flight floors request shared across concurrent callers. */\n  #suggestedOccurrenceFloorsRefreshPromise: Promise<void> | undefined;\n\n  constructor(config?: TokensApiClientConfig) {\n    this.#fetch = config?.fetch ?? globalThis.fetch.bind(globalThis);\n    this.#queryClient = config?.queryClient;\n  }\n\n  /**\n   * Fetch the list of ERC-20 tokens for a chain from the Tokens API.\n   *\n   * Returns `[]` immediately (without hitting the token-list endpoint) when\n   * the chain is not in the `/v2/supportedNetworks` response, or when the\n   * supported-networks check fails for any reason.\n   *\n   * @param hexChainId - Chain ID in hex format (e.g. `'0x1'` for Ethereum mainnet).\n   * @returns Array of token list entries with address and metadata, or an empty\n   * array if the chain is unsupported or the request fails.\n   */\n  async fetchTokenList(hexChainId: ChainId): Promise<TokenListEntry[]> {\n    // Treat any error from the supported-networks check as \"not supported\":\n    // the token-list endpoint is only contacted for known-supported chains.\n    if (!(await this.#isSupportedChain(hexChainId).catch(() => false))) {\n      return [];\n    }\n\n    const queryClient = this.#queryClient;\n    if (queryClient === undefined) {\n      return this.#fetchTokenListUncached(hexChainId);\n    }\n\n    return queryClient.fetchQuery({\n      // Namespacing keeps this key from colliding with other clients that\n      // share the same QueryClient (e.g. core-backend's ApiPlatformClient).\n      queryKey: [\n        'assets-controller',\n        'rpc-detection',\n        'token-list',\n        { chainId: hexChainId },\n      ],\n      queryFn: () => this.#fetchTokenListUncached(hexChainId),\n      staleTime: TOKEN_LIST_STALE_TIME_MS,\n      gcTime: TOKEN_LIST_GC_TIME_MS,\n    });\n  }\n\n  /**\n   * Check whether the given chain is present in the supported-networks list.\n   *\n   * Uses an instance-level cache (1 h TTL). Throws if the network request\n   * fails — callers should handle this (e.g. via `.catch(() => false)`).\n   *\n   * @param hexChainId - Hex chain ID to check.\n   * @returns `true` when the chain is in the supported-networks list.\n   */\n  async #isSupportedChain(hexChainId: ChainId): Promise<boolean> {\n    const now = Date.now();\n    if (\n      this.#supportedChainIds === undefined ||\n      now - this.#supportedChainIdsCachedAt >= SUPPORTED_NETWORKS_CACHE_TTL_MS\n    ) {\n      await this.#refreshSupportedChainIds(now);\n    }\n\n    const caipChainId = `eip155:${convertHexToDecimal(hexChainId)}`;\n    return this.#supportedChainIds?.has(caipChainId) ?? false;\n  }\n\n  /**\n   * Fetch `/v2/supportedNetworks` and update the instance cache.\n   * Concurrent callers share the same in-flight Promise so only one network\n   * request is made. If the response is not 2xx the cache is left unchanged\n   * (the chain will be treated as unsupported this cycle).\n   *\n   * @param now - Current timestamp used to stamp the cache entry.\n   * @returns A promise that resolves once the cache has been refreshed.\n   */\n  async #refreshSupportedChainIds(now: number): Promise<void> {\n    if (this.#supportedChainIdsRefreshPromise !== undefined) {\n      return this.#supportedChainIdsRefreshPromise;\n    }\n\n    this.#supportedChainIdsRefreshPromise = (async (): Promise<void> => {\n      try {\n        const response = await this.#fetch(SUPPORTED_NETWORKS_URL);\n        if (response.ok) {\n          const data = (await response.json()) as SupportedNetworksResponse;\n          this.#supportedChainIds = new Set([\n            ...(data.fullSupport ?? []),\n            ...(data.partialSupport ?? []),\n          ]);\n          this.#supportedChainIdsCachedAt = now;\n        }\n      } finally {\n        this.#supportedChainIdsRefreshPromise = undefined;\n      }\n    })();\n\n    return this.#supportedChainIdsRefreshPromise;\n  }\n\n  /**\n   * Resolve the `occurrenceFloor` query param for a chain from Token API\n   * `/v1/suggestedOccurrenceFloors`. Falls back to\n   * {@link DEFAULT_OCCURRENCE_FLOOR} when the chain is missing or the request\n   * fails.\n   *\n   * @param hexChainId - Hex chain ID.\n   * @returns Occurrence floor to send to `/tokens/{chainId}`.\n   */\n  async #getOccurrenceFloor(hexChainId: ChainId): Promise<number> {\n    const now = Date.now();\n    if (\n      this.#suggestedOccurrenceFloors === undefined ||\n      now - this.#suggestedOccurrenceFloorsCachedAt >=\n        SUGGESTED_OCCURRENCE_FLOORS_CACHE_TTL_MS\n    ) {\n      await this.#refreshSuggestedOccurrenceFloors(now);\n    }\n\n    const decimalChainId = String(convertHexToDecimal(hexChainId));\n    return (\n      this.#suggestedOccurrenceFloors?.[decimalChainId] ??\n      DEFAULT_OCCURRENCE_FLOOR\n    );\n  }\n\n  /**\n   * Fetch `/v1/suggestedOccurrenceFloors` and update the instance cache.\n   * Concurrent callers share the in-flight Promise. Failures leave the cache\n   * empty so {@link #getOccurrenceFloor} falls back to the default.\n   *\n   * @param now - Current timestamp used to stamp the cache entry.\n   * @returns A promise that resolves once the cache has been refreshed.\n   */\n  async #refreshSuggestedOccurrenceFloors(now: number): Promise<void> {\n    if (this.#suggestedOccurrenceFloorsRefreshPromise !== undefined) {\n      return this.#suggestedOccurrenceFloorsRefreshPromise;\n    }\n\n    this.#suggestedOccurrenceFloorsRefreshPromise =\n      (async (): Promise<void> => {\n        try {\n          const response = await this.#fetch(SUGGESTED_OCCURRENCE_FLOORS_URL);\n          if (response.ok) {\n            const data = (await response.json()) as Record<string, number>;\n            this.#suggestedOccurrenceFloors =\n              data && typeof data === 'object' && !Array.isArray(data)\n                ? data\n                : {};\n            this.#suggestedOccurrenceFloorsCachedAt = now;\n          } else {\n            this.#suggestedOccurrenceFloors = {};\n            this.#suggestedOccurrenceFloorsCachedAt = now;\n          }\n        } catch {\n          this.#suggestedOccurrenceFloors = {};\n          this.#suggestedOccurrenceFloorsCachedAt = now;\n        } finally {\n          this.#suggestedOccurrenceFloorsRefreshPromise = undefined;\n        }\n      })();\n\n    return this.#suggestedOccurrenceFloorsRefreshPromise;\n  }\n\n  async #fetchTokenListUncached(\n    hexChainId: ChainId,\n  ): Promise<TokenListEntry[]> {\n    const decimalChainId = convertHexToDecimal(hexChainId);\n    const occurrenceFloor = await this.#getOccurrenceFloor(hexChainId);\n\n    // Same query shape as `TokenListController.getTokensURL` (token-service.ts),\n    // but `occurrenceFloor` comes from `/v1/suggestedOccurrenceFloors`.\n    // No `first=...` cap — the API returns the full per-chain list bounded\n    // server-side by `occurrenceFloor`.\n    const url =\n      `${TOKEN_END_POINT_API}/tokens/${decimalChainId}` +\n      `?occurrenceFloor=${occurrenceFloor}` +\n      `&includeNativeAssets=false` +\n      `&includeTokenFees=false` +\n      `&includeAssetType=false` +\n      `&includeERC20Permit=false` +\n      `&includeStorage=false` +\n      `&includeRwaData=true`;\n\n    let response: Response;\n    try {\n      response = await this.#fetch(url);\n    } catch (error) {\n      console.error(\n        `Tokens API request failed for chain ${hexChainId}:`,\n        error,\n      );\n      return [];\n    }\n\n    if (!response.ok) {\n      console.error(\n        `Tokens API responded with ${response.status} for chain ${hexChainId}`,\n      );\n      return [];\n    }\n\n    const raw = (await response.json()) as unknown;\n    const items: ApiTokenListItem[] = Array.isArray(raw)\n      ? (raw as ApiTokenListItem[])\n      : [];\n\n    const filtered = applyChainSpecificFilters(hexChainId, items);\n\n    return filtered.map((item) => ({\n      address: item.address,\n      symbol: item.symbol ?? '',\n      name: item.name ?? '',\n      decimals: item.decimals ?? 18,\n      iconUrl: item.iconUrl,\n      aggregators: item.aggregators,\n      occurrences: item.occurrences,\n    }));\n  }\n}\n\n/**\n * Apply chain-specific filters to a raw token list response, mirroring\n * `fetchTokenListByChainId` in `assets-controllers/src/token-service.ts`.\n *\n * For Linea mainnet, the API returns extras with low aggregator coverage, so\n * we keep only entries flagged by Linea's own team or seen by ≥3 aggregators.\n *\n * @param hexChainId - Hex chain ID.\n * @param items - Raw items from the API response.\n * @returns Items after chain-specific filtering.\n */\nfunction applyChainSpecificFilters(\n  hexChainId: ChainId,\n  items: ApiTokenListItem[],\n): ApiTokenListItem[] {\n  if (hexChainId === ControllerChainId['linea-mainnet']) {\n    return items.filter((item) => {\n      const aggregators = item.aggregators ?? [];\n      return aggregators.includes('lineaTeam') || aggregators.length >= 3;\n    });\n  }\n  return items;\n}\n"]}

package/dist/data-sources/evm-rpc-services/clients/{TokensApiClient.d.ts → TokensApiClient.d.cts}

@@ -1,4 +1,4 @@
-import type { ChainId, TokenListEntry } from '../types/index.js';
+import type { ChainId, TokenListEntry } from "../types/index.cjs";
 /**
  * Minimal structural type for the TanStack Query client method we use.
  * Avoids a direct dependency on `@tanstack/query-core` while still being
@@ -58,4 +58,4 @@ export declare class TokensApiClient {
      */
     fetchTokenList(hexChainId: ChainId): Promise<TokenListEntry[]>;
 }
-//# sourceMappingURL=TokensApiClient.d.ts.map
+//# sourceMappingURL=TokensApiClient.d.cts.map

package/dist/data-sources/evm-rpc-services/clients/TokensApiClient.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokensApiClient.d.cts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/TokensApiClient.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,2BAA0B;AAgFjE;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE;QACzB,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;QAC7B,OAAO,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,oBAAoB,CAAC;CACpC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAe;;gBA2Bd,MAAM,CAAC,EAAE,qBAAqB;IAK1C;;;;;;;;;;OAUG;IACG,cAAc,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CA0MrE"}

package/dist/data-sources/evm-rpc-services/clients/TokensApiClient.d.mts

@@ -0,0 +1,61 @@
+import type { ChainId, TokenListEntry } from "../types/index.mjs";
+/**
+ * Minimal structural type for the TanStack Query client method we use.
+ * Avoids a direct dependency on `@tanstack/query-core` while still being
+ * fully compatible with the shared `QueryClient` exposed by
+ * `ApiPlatformClient.queryClient` (`@metamask/core-backend`).
+ */
+export type TokenListQueryClient = {
+    fetchQuery<TData>(options: {
+        queryKey: readonly unknown[];
+        queryFn: () => Promise<TData>;
+        staleTime?: number;
+        gcTime?: number;
+    }): Promise<TData>;
+};
+export type TokensApiClientConfig = {
+    /** Fetch function (defaults to globalThis.fetch). */
+    fetch?: typeof globalThis.fetch;
+    /**
+     * Optional TanStack-Query client used to cache token-list responses across
+     * detector polls / accounts / instances. When omitted, every call hits the
+     * network directly (preserves prior behaviour for tests and standalone use).
+     */
+    queryClient?: TokenListQueryClient;
+};
+/**
+ * Client for the MetaMask Tokens API.
+ *
+ * Fetches the per-chain ERC-20 token list from the same endpoint that
+ * `TokenListController` uses (`token.api.cx.metamask.io/tokens/{chainId}`),
+ * with the same query parameters. The `occurrenceFloor` query param comes from
+ * Token API `/v1/suggestedOccurrenceFloors` (fallback {@link DEFAULT_OCCURRENCE_FLOOR}),
+ * matching `TokenDataSource` spam filtering. Linea's post-response aggregator
+ * filter is still applied client-side.
+ *
+ * Before fetching a chain's token list, the client checks
+ * `/v2/supportedNetworks` and returns `[]` immediately for chains that are
+ * not in the supported list, avoiding unnecessary API calls. The supported-
+ * networks response is cached in-memory for one hour.
+ *
+ * When constructed with a `queryClient`, token-list results are cached and
+ * deduped via TanStack Query (5 min staleTime, 1 h gcTime), so concurrent
+ * detection cycles for the same chain coalesce into a single network request.
+ */
+export declare class TokensApiClient {
+    #private;
+    constructor(config?: TokensApiClientConfig);
+    /**
+     * Fetch the list of ERC-20 tokens for a chain from the Tokens API.
+     *
+     * Returns `[]` immediately (without hitting the token-list endpoint) when
+     * the chain is not in the `/v2/supportedNetworks` response, or when the
+     * supported-networks check fails for any reason.
+     *
+     * @param hexChainId - Chain ID in hex format (e.g. `'0x1'` for Ethereum mainnet).
+     * @returns Array of token list entries with address and metadata, or an empty
+     * array if the chain is unsupported or the request fails.
+     */
+    fetchTokenList(hexChainId: ChainId): Promise<TokenListEntry[]>;
+}
+//# sourceMappingURL=TokensApiClient.d.mts.map

package/dist/data-sources/evm-rpc-services/clients/TokensApiClient.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokensApiClient.d.mts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/TokensApiClient.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,2BAA0B;AAgFjE;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE;QACzB,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;QAC7B,OAAO,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,oBAAoB,CAAC;CACpC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAe;;gBA2Bd,MAAM,CAAC,EAAE,qBAAqB;IAK1C;;;;;;;;;;OAUG;IACG,cAAc,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CA0MrE"}

package/dist/data-sources/evm-rpc-services/clients/{TokensApiClient.js → TokensApiClient.mjs}

@@ -10,7 +10,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _TokensApiClient_instances, _TokensApiClient_fetch, _TokensApiClient_queryClient, _TokensApiClient_supportedChainIds, _TokensApiClient_supportedChainIdsCachedAt, _TokensApiClient_supportedChainIdsRefreshPromise, _TokensApiClient_suggestedOccurrenceFloors, _TokensApiClient_suggestedOccurrenceFloorsCachedAt, _TokensApiClient_suggestedOccurrenceFloorsRefreshPromise, _TokensApiClient_isSupportedChain, _TokensApiClient_refreshSupportedChainIds, _TokensApiClient_getOccurrenceFloor, _TokensApiClient_refreshSuggestedOccurrenceFloors, _TokensApiClient_fetchTokenListUncached;
-import { ChainId as ControllerChainId, convertHexToDecimal, } from '@metamask/controller-utils';
+import { ChainId as ControllerChainId, convertHexToDecimal } from "@metamask/controller-utils";
 /**
  * Same host + path that `TokenListController` (assets-controllers) uses
  * (`token-service.ts` → `getTokensURL`). Sharing this endpoint keeps the
@@ -305,4 +305,4 @@ function applyChainSpecificFilters(hexChainId, items) {
     }
     return items;
 }
-//# sourceMappingURL=TokensApiClient.js.map
+//# sourceMappingURL=TokensApiClient.mjs.map

package/dist/data-sources/evm-rpc-services/clients/TokensApiClient.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokensApiClient.mjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/TokensApiClient.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EACL,OAAO,IAAI,iBAAiB,EAC5B,mBAAmB,EACpB,mCAAmC;AAIpC;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG,kCAAkC,CAAC;AAE/D;;;;GAIG;AACH,MAAM,sBAAsB,GAAG,GAAG,mBAAmB,uBAAuB,CAAC;AAE7E;;;;GAIG;AACH,MAAM,+BAA+B,GAAG,GAAG,mBAAmB,+BAA+B,CAAC;AAE9F;;;GAGG;AACH,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,+BAA+B,GAAG,EAAE,GAAG,KAAM,CAAC;AAEpD;;;GAGG;AACH,MAAM,wCAAwC,GAAG,EAAE,GAAG,KAAM,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,wBAAwB,GAAG,CAAC,GAAG,KAAM,CAAC;AAC5C,MAAM,qBAAqB,GAAG,EAAE,GAAG,KAAM,CAAC;AAoD1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,eAAe;IA2B1B,YAAY,MAA8B;;QA1BjC,yCAAgC;QAEhC,+CAA+C;QAExD,uEAAuE;QACvE,qDAA4C;QAE5C,sEAAsE;QACtE,qDAA6B,CAAC,EAAC;QAE/B;;;;WAIG;QACH,mEAA4D;QAE5D,oEAAoE;QACpE,6DAA+D;QAE/D,qDAAqD;QACrD,6DAAqC,CAAC,EAAC;QAEvC,iEAAiE;QACjE,2EAAoE;QAGlE,uBAAA,IAAI,0BAAU,MAAM,EAAE,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAA,CAAC;QACjE,uBAAA,IAAI,gCAAgB,MAAM,EAAE,WAAW,MAAA,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,cAAc,CAAC,UAAmB;QACtC,wEAAwE;QACxE,wEAAwE;QACxE,IAAI,CAAC,CAAC,MAAM,uBAAA,IAAI,qEAAkB,MAAtB,IAAI,EAAmB,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACnE,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,WAAW,GAAG,uBAAA,IAAI,oCAAa,CAAC;QACtC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,uBAAA,IAAI,2EAAwB,MAA5B,IAAI,EAAyB,UAAU,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,WAAW,CAAC,UAAU,CAAC;YAC5B,oEAAoE;YACpE,sEAAsE;YACtE,QAAQ,EAAE;gBACR,mBAAmB;gBACnB,eAAe;gBACf,YAAY;gBACZ,EAAE,OAAO,EAAE,UAAU,EAAE;aACxB;YACD,OAAO,EAAE,GAAG,EAAE,CAAC,uBAAA,IAAI,2EAAwB,MAA5B,IAAI,EAAyB,UAAU,CAAC;YACvD,SAAS,EAAE,wBAAwB;YACnC,MAAM,EAAE,qBAAqB;SAC9B,CAAC,CAAC;IACL,CAAC;CAiLF;;AA/KC;;;;;;;;GAQG;AACH,KAAK,4CAAmB,UAAmB;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IACE,uBAAA,IAAI,0CAAmB,KAAK,SAAS;QACrC,GAAG,GAAG,uBAAA,IAAI,kDAA2B,IAAI,+BAA+B,EACxE,CAAC;QACD,MAAM,uBAAA,IAAI,6EAA0B,MAA9B,IAAI,EAA2B,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,WAAW,GAAG,UAAU,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;IAChE,OAAO,uBAAA,IAAI,0CAAmB,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC;AAC5D,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,oDAA2B,GAAW;IACzC,IAAI,uBAAA,IAAI,wDAAiC,KAAK,SAAS,EAAE,CAAC;QACxD,OAAO,uBAAA,IAAI,wDAAiC,CAAC;IAC/C,CAAC;IAED,uBAAA,IAAI,oDAAoC,CAAC,KAAK,IAAmB,EAAE;QACjE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,uBAAA,IAAI,8BAAO,MAAX,IAAI,EAAQ,sBAAsB,CAAC,CAAC;YAC3D,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA8B,CAAC;gBAClE,uBAAA,IAAI,sCAAsB,IAAI,GAAG,CAAC;oBAChC,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;oBAC3B,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC;iBAC/B,CAAC,MAAA,CAAC;gBACH,uBAAA,IAAI,8CAA8B,GAAG,MAAA,CAAC;YACxC,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,uBAAA,IAAI,oDAAoC,SAAS,MAAA,CAAC;QACpD,CAAC;IACH,CAAC,CAAC,EAAE,MAAA,CAAC;IAEL,OAAO,uBAAA,IAAI,wDAAiC,CAAC;AAC/C,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,8CAAqB,UAAmB;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IACE,uBAAA,IAAI,kDAA2B,KAAK,SAAS;QAC7C,GAAG,GAAG,uBAAA,IAAI,0DAAmC;YAC3C,wCAAwC,EAC1C,CAAC;QACD,MAAM,uBAAA,IAAI,qFAAkC,MAAtC,IAAI,EAAmC,GAAG,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAC;IAC/D,OAAO,CACL,uBAAA,IAAI,kDAA2B,EAAE,CAAC,cAAc,CAAC;QACjD,wBAAwB,CACzB,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,4DAAmC,GAAW;IACjD,IAAI,uBAAA,IAAI,gEAAyC,KAAK,SAAS,EAAE,CAAC;QAChE,OAAO,uBAAA,IAAI,gEAAyC,CAAC;IACvD,CAAC;IAED,uBAAA,IAAI,4DACF,CAAC,KAAK,IAAmB,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,uBAAA,IAAI,8BAAO,MAAX,IAAI,EAAQ,+BAA+B,CAAC,CAAC;YACpE,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA2B,CAAC;gBAC/D,uBAAA,IAAI,8CACF,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;oBACtD,CAAC,CAAC,IAAI;oBACN,CAAC,CAAC,EAAE,MAAA,CAAC;gBACT,uBAAA,IAAI,sDAAsC,GAAG,MAAA,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACN,uBAAA,IAAI,8CAA8B,EAAE,MAAA,CAAC;gBACrC,uBAAA,IAAI,sDAAsC,GAAG,MAAA,CAAC;YAChD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uBAAA,IAAI,8CAA8B,EAAE,MAAA,CAAC;YACrC,uBAAA,IAAI,sDAAsC,GAAG,MAAA,CAAC;QAChD,CAAC;gBAAS,CAAC;YACT,uBAAA,IAAI,4DAA4C,SAAS,MAAA,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,EAAE,MAAA,CAAC;IAEP,OAAO,uBAAA,IAAI,gEAAyC,CAAC;AACvD,CAAC,4CAED,KAAK,kDACH,UAAmB;IAEnB,MAAM,cAAc,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACvD,MAAM,eAAe,GAAG,MAAM,uBAAA,IAAI,uEAAoB,MAAxB,IAAI,EAAqB,UAAU,CAAC,CAAC;IAEnE,6EAA6E;IAC7E,oEAAoE;IACpE,uEAAuE;IACvE,oCAAoC;IACpC,MAAM,GAAG,GACP,GAAG,mBAAmB,WAAW,cAAc,EAAE;QACjD,oBAAoB,eAAe,EAAE;QACrC,4BAA4B;QAC5B,yBAAyB;QACzB,yBAAyB;QACzB,2BAA2B;QAC3B,uBAAuB;QACvB,sBAAsB,CAAC;IAEzB,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,uBAAA,IAAI,8BAAO,MAAX,IAAI,EAAQ,GAAG,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,uCAAuC,UAAU,GAAG,EACpD,KAAK,CACN,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CACX,6BAA6B,QAAQ,CAAC,MAAM,cAAc,UAAU,EAAE,CACvE,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAY,CAAC;IAC/C,MAAM,KAAK,GAAuB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAClD,CAAC,CAAE,GAA0B;QAC7B,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,QAAQ,GAAG,yBAAyB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAE9D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC,CAAC,CAAC;AACN,CAAC;AAGH;;;;;;;;;;GAUG;AACH,SAAS,yBAAyB,CAChC,UAAmB,EACnB,KAAyB;IAEzB,IAAI,UAAU,KAAK,iBAAiB,CAAC,eAAe,CAAC,EAAE,CAAC;QACtD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;YAC3C,OAAO,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import {\n  ChainId as ControllerChainId,\n  convertHexToDecimal,\n} from '@metamask/controller-utils';\n\nimport type { ChainId, TokenListEntry } from '../types/index.js';\n\n/**\n * Same host + path that `TokenListController` (assets-controllers) uses\n * (`token-service.ts` → `getTokensURL`). Sharing this endpoint keeps the\n * RPC token detector aligned with the rest of the wallet's token listing\n * (occurrence floors, aggregator filters, icon URLs, etc.).\n */\nconst TOKEN_END_POINT_API = 'https://token.api.cx.metamask.io';\n\n/**\n * Endpoint that returns which CAIP chain IDs the Tokens API supports.\n * Used to skip detection (and avoid unnecessary network requests) for chains\n * that are not in the supported-networks list.\n */\nconst SUPPORTED_NETWORKS_URL = `${TOKEN_END_POINT_API}/v2/supportedNetworks`;\n\n/**\n * Per-chain suggested occurrence floors used as the `occurrenceFloor` query\n * param when fetching token lists (and aligned with TokenDataSource spam\n * filtering). Keys are decimal chain IDs.\n */\nconst SUGGESTED_OCCURRENCE_FLOORS_URL = `${TOKEN_END_POINT_API}/v1/suggestedOccurrenceFloors`;\n\n/**\n * Fallback `occurrenceFloor` when `/v1/suggestedOccurrenceFloors` has no entry\n * for the chain, or the floors request fails.\n */\nconst DEFAULT_OCCURRENCE_FLOOR = 3;\n\n/**\n * How long to keep the supported-networks response in the instance-level\n * cache before refreshing it. One hour is sufficient — the list rarely\n * changes and a stale cache just means we may do an unnecessary token-list\n * fetch for a newly-unsupported chain (harmless).\n */\nconst SUPPORTED_NETWORKS_CACHE_TTL_MS = 60 * 60_000;\n\n/**\n * How long to keep suggested occurrence floors cached. Same TTL as supported\n * networks — floors change infrequently.\n */\nconst SUGGESTED_OCCURRENCE_FLOORS_CACHE_TTL_MS = 60 * 60_000;\n\n/**\n * TanStack-Query cache config for the cached `fetchTokenList` path.\n *\n * The Tokens API per-chain list barely changes between polls, so we keep\n * results fresh for a few minutes (`staleTime`) and retain them in cache for\n * an hour (`gcTime`) so re-detections across accounts/chains hit the cache.\n * These tunings only apply when a `queryClient` is provided to the client;\n * the uncached fallback path (used in standalone tests) is unaffected.\n */\nconst TOKEN_LIST_STALE_TIME_MS = 5 * 60_000;\nconst TOKEN_LIST_GC_TIME_MS = 60 * 60_000;\n\n/**\n * Shape of the `/v2/supportedNetworks` response.\n */\ntype SupportedNetworksResponse = {\n  fullSupport?: string[];\n  partialSupport?: string[];\n};\n\n/**\n * Shape of a single item returned by the Tokens API `/tokens/{chainId}`\n * endpoint. Mirrors `TokenListToken` in\n * `packages/assets-controllers/src/TokenListController.ts` and the response\n * parsed by `fetchTokenListByChainId` in `token-service.ts`.\n */\ntype ApiTokenListItem = {\n  address: string;\n  symbol?: string;\n  name?: string;\n  decimals?: number;\n  occurrences?: number;\n  aggregators?: string[];\n  iconUrl?: string;\n};\n\n/**\n * Minimal structural type for the TanStack Query client method we use.\n * Avoids a direct dependency on `@tanstack/query-core` while still being\n * fully compatible with the shared `QueryClient` exposed by\n * `ApiPlatformClient.queryClient` (`@metamask/core-backend`).\n */\nexport type TokenListQueryClient = {\n  fetchQuery<TData>(options: {\n    queryKey: readonly unknown[];\n    queryFn: () => Promise<TData>;\n    staleTime?: number;\n    gcTime?: number;\n  }): Promise<TData>;\n};\n\nexport type TokensApiClientConfig = {\n  /** Fetch function (defaults to globalThis.fetch). */\n  fetch?: typeof globalThis.fetch;\n  /**\n   * Optional TanStack-Query client used to cache token-list responses across\n   * detector polls / accounts / instances. When omitted, every call hits the\n   * network directly (preserves prior behaviour for tests and standalone use).\n   */\n  queryClient?: TokenListQueryClient;\n};\n\n/**\n * Client for the MetaMask Tokens API.\n *\n * Fetches the per-chain ERC-20 token list from the same endpoint that\n * `TokenListController` uses (`token.api.cx.metamask.io/tokens/{chainId}`),\n * with the same query parameters. The `occurrenceFloor` query param comes from\n * Token API `/v1/suggestedOccurrenceFloors` (fallback {@link DEFAULT_OCCURRENCE_FLOOR}),\n * matching `TokenDataSource` spam filtering. Linea's post-response aggregator\n * filter is still applied client-side.\n *\n * Before fetching a chain's token list, the client checks\n * `/v2/supportedNetworks` and returns `[]` immediately for chains that are\n * not in the supported list, avoiding unnecessary API calls. The supported-\n * networks response is cached in-memory for one hour.\n *\n * When constructed with a `queryClient`, token-list results are cached and\n * deduped via TanStack Query (5 min staleTime, 1 h gcTime), so concurrent\n * detection cycles for the same chain coalesce into a single network request.\n */\nexport class TokensApiClient {\n  readonly #fetch: typeof globalThis.fetch;\n\n  readonly #queryClient: TokenListQueryClient | undefined;\n\n  /** CAIP chain IDs returned by `/v2/supportedNetworks` (both tiers). */\n  #supportedChainIds: Set<string> | undefined;\n\n  /** Timestamp of the last successful `/v2/supportedNetworks` fetch. */\n  #supportedChainIdsCachedAt = 0;\n\n  /**\n   * In-flight `/v2/supportedNetworks` request shared across concurrent callers\n   * so only one network request is made even when multiple `fetchTokenList`\n   * calls arrive before the first one resolves.\n   */\n  #supportedChainIdsRefreshPromise: Promise<void> | undefined;\n\n  /** Decimal chain ID → suggested occurrence floor from Token API. */\n  #suggestedOccurrenceFloors: Record<string, number> | undefined;\n\n  /** Timestamp of the last successful floors fetch. */\n  #suggestedOccurrenceFloorsCachedAt = 0;\n\n  /** In-flight floors request shared across concurrent callers. */\n  #suggestedOccurrenceFloorsRefreshPromise: Promise<void> | undefined;\n\n  constructor(config?: TokensApiClientConfig) {\n    this.#fetch = config?.fetch ?? globalThis.fetch.bind(globalThis);\n    this.#queryClient = config?.queryClient;\n  }\n\n  /**\n   * Fetch the list of ERC-20 tokens for a chain from the Tokens API.\n   *\n   * Returns `[]` immediately (without hitting the token-list endpoint) when\n   * the chain is not in the `/v2/supportedNetworks` response, or when the\n   * supported-networks check fails for any reason.\n   *\n   * @param hexChainId - Chain ID in hex format (e.g. `'0x1'` for Ethereum mainnet).\n   * @returns Array of token list entries with address and metadata, or an empty\n   * array if the chain is unsupported or the request fails.\n   */\n  async fetchTokenList(hexChainId: ChainId): Promise<TokenListEntry[]> {\n    // Treat any error from the supported-networks check as \"not supported\":\n    // the token-list endpoint is only contacted for known-supported chains.\n    if (!(await this.#isSupportedChain(hexChainId).catch(() => false))) {\n      return [];\n    }\n\n    const queryClient = this.#queryClient;\n    if (queryClient === undefined) {\n      return this.#fetchTokenListUncached(hexChainId);\n    }\n\n    return queryClient.fetchQuery({\n      // Namespacing keeps this key from colliding with other clients that\n      // share the same QueryClient (e.g. core-backend's ApiPlatformClient).\n      queryKey: [\n        'assets-controller',\n        'rpc-detection',\n        'token-list',\n        { chainId: hexChainId },\n      ],\n      queryFn: () => this.#fetchTokenListUncached(hexChainId),\n      staleTime: TOKEN_LIST_STALE_TIME_MS,\n      gcTime: TOKEN_LIST_GC_TIME_MS,\n    });\n  }\n\n  /**\n   * Check whether the given chain is present in the supported-networks list.\n   *\n   * Uses an instance-level cache (1 h TTL). Throws if the network request\n   * fails — callers should handle this (e.g. via `.catch(() => false)`).\n   *\n   * @param hexChainId - Hex chain ID to check.\n   * @returns `true` when the chain is in the supported-networks list.\n   */\n  async #isSupportedChain(hexChainId: ChainId): Promise<boolean> {\n    const now = Date.now();\n    if (\n      this.#supportedChainIds === undefined ||\n      now - this.#supportedChainIdsCachedAt >= SUPPORTED_NETWORKS_CACHE_TTL_MS\n    ) {\n      await this.#refreshSupportedChainIds(now);\n    }\n\n    const caipChainId = `eip155:${convertHexToDecimal(hexChainId)}`;\n    return this.#supportedChainIds?.has(caipChainId) ?? false;\n  }\n\n  /**\n   * Fetch `/v2/supportedNetworks` and update the instance cache.\n   * Concurrent callers share the same in-flight Promise so only one network\n   * request is made. If the response is not 2xx the cache is left unchanged\n   * (the chain will be treated as unsupported this cycle).\n   *\n   * @param now - Current timestamp used to stamp the cache entry.\n   * @returns A promise that resolves once the cache has been refreshed.\n   */\n  async #refreshSupportedChainIds(now: number): Promise<void> {\n    if (this.#supportedChainIdsRefreshPromise !== undefined) {\n      return this.#supportedChainIdsRefreshPromise;\n    }\n\n    this.#supportedChainIdsRefreshPromise = (async (): Promise<void> => {\n      try {\n        const response = await this.#fetch(SUPPORTED_NETWORKS_URL);\n        if (response.ok) {\n          const data = (await response.json()) as SupportedNetworksResponse;\n          this.#supportedChainIds = new Set([\n            ...(data.fullSupport ?? []),\n            ...(data.partialSupport ?? []),\n          ]);\n          this.#supportedChainIdsCachedAt = now;\n        }\n      } finally {\n        this.#supportedChainIdsRefreshPromise = undefined;\n      }\n    })();\n\n    return this.#supportedChainIdsRefreshPromise;\n  }\n\n  /**\n   * Resolve the `occurrenceFloor` query param for a chain from Token API\n   * `/v1/suggestedOccurrenceFloors`. Falls back to\n   * {@link DEFAULT_OCCURRENCE_FLOOR} when the chain is missing or the request\n   * fails.\n   *\n   * @param hexChainId - Hex chain ID.\n   * @returns Occurrence floor to send to `/tokens/{chainId}`.\n   */\n  async #getOccurrenceFloor(hexChainId: ChainId): Promise<number> {\n    const now = Date.now();\n    if (\n      this.#suggestedOccurrenceFloors === undefined ||\n      now - this.#suggestedOccurrenceFloorsCachedAt >=\n        SUGGESTED_OCCURRENCE_FLOORS_CACHE_TTL_MS\n    ) {\n      await this.#refreshSuggestedOccurrenceFloors(now);\n    }\n\n    const decimalChainId = String(convertHexToDecimal(hexChainId));\n    return (\n      this.#suggestedOccurrenceFloors?.[decimalChainId] ??\n      DEFAULT_OCCURRENCE_FLOOR\n    );\n  }\n\n  /**\n   * Fetch `/v1/suggestedOccurrenceFloors` and update the instance cache.\n   * Concurrent callers share the in-flight Promise. Failures leave the cache\n   * empty so {@link #getOccurrenceFloor} falls back to the default.\n   *\n   * @param now - Current timestamp used to stamp the cache entry.\n   * @returns A promise that resolves once the cache has been refreshed.\n   */\n  async #refreshSuggestedOccurrenceFloors(now: number): Promise<void> {\n    if (this.#suggestedOccurrenceFloorsRefreshPromise !== undefined) {\n      return this.#suggestedOccurrenceFloorsRefreshPromise;\n    }\n\n    this.#suggestedOccurrenceFloorsRefreshPromise =\n      (async (): Promise<void> => {\n        try {\n          const response = await this.#fetch(SUGGESTED_OCCURRENCE_FLOORS_URL);\n          if (response.ok) {\n            const data = (await response.json()) as Record<string, number>;\n            this.#suggestedOccurrenceFloors =\n              data && typeof data === 'object' && !Array.isArray(data)\n                ? data\n                : {};\n            this.#suggestedOccurrenceFloorsCachedAt = now;\n          } else {\n            this.#suggestedOccurrenceFloors = {};\n            this.#suggestedOccurrenceFloorsCachedAt = now;\n          }\n        } catch {\n          this.#suggestedOccurrenceFloors = {};\n          this.#suggestedOccurrenceFloorsCachedAt = now;\n        } finally {\n          this.#suggestedOccurrenceFloorsRefreshPromise = undefined;\n        }\n      })();\n\n    return this.#suggestedOccurrenceFloorsRefreshPromise;\n  }\n\n  async #fetchTokenListUncached(\n    hexChainId: ChainId,\n  ): Promise<TokenListEntry[]> {\n    const decimalChainId = convertHexToDecimal(hexChainId);\n    const occurrenceFloor = await this.#getOccurrenceFloor(hexChainId);\n\n    // Same query shape as `TokenListController.getTokensURL` (token-service.ts),\n    // but `occurrenceFloor` comes from `/v1/suggestedOccurrenceFloors`.\n    // No `first=...` cap — the API returns the full per-chain list bounded\n    // server-side by `occurrenceFloor`.\n    const url =\n      `${TOKEN_END_POINT_API}/tokens/${decimalChainId}` +\n      `?occurrenceFloor=${occurrenceFloor}` +\n      `&includeNativeAssets=false` +\n      `&includeTokenFees=false` +\n      `&includeAssetType=false` +\n      `&includeERC20Permit=false` +\n      `&includeStorage=false` +\n      `&includeRwaData=true`;\n\n    let response: Response;\n    try {\n      response = await this.#fetch(url);\n    } catch (error) {\n      console.error(\n        `Tokens API request failed for chain ${hexChainId}:`,\n        error,\n      );\n      return [];\n    }\n\n    if (!response.ok) {\n      console.error(\n        `Tokens API responded with ${response.status} for chain ${hexChainId}`,\n      );\n      return [];\n    }\n\n    const raw = (await response.json()) as unknown;\n    const items: ApiTokenListItem[] = Array.isArray(raw)\n      ? (raw as ApiTokenListItem[])\n      : [];\n\n    const filtered = applyChainSpecificFilters(hexChainId, items);\n\n    return filtered.map((item) => ({\n      address: item.address,\n      symbol: item.symbol ?? '',\n      name: item.name ?? '',\n      decimals: item.decimals ?? 18,\n      iconUrl: item.iconUrl,\n      aggregators: item.aggregators,\n      occurrences: item.occurrences,\n    }));\n  }\n}\n\n/**\n * Apply chain-specific filters to a raw token list response, mirroring\n * `fetchTokenListByChainId` in `assets-controllers/src/token-service.ts`.\n *\n * For Linea mainnet, the API returns extras with low aggregator coverage, so\n * we keep only entries flagged by Linea's own team or seen by ≥3 aggregators.\n *\n * @param hexChainId - Hex chain ID.\n * @param items - Raw items from the API response.\n * @returns Items after chain-specific filtering.\n */\nfunction applyChainSpecificFilters(\n  hexChainId: ChainId,\n  items: ApiTokenListItem[],\n): ApiTokenListItem[] {\n  if (hexChainId === ControllerChainId['linea-mainnet']) {\n    return items.filter((item) => {\n      const aggregators = item.aggregators ?? [];\n      return aggregators.includes('lineaTeam') || aggregators.length >= 3;\n    });\n  }\n  return items;\n}\n"]}

package/dist/data-sources/evm-rpc-services/clients/index.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokensApiClient = exports.MulticallClient = exports.encodeAggregate3 = exports.decodeAggregate3Response = void 0;
+var MulticallClient_js_1 = require("./MulticallClient.cjs");
+Object.defineProperty(exports, "decodeAggregate3Response", { enumerable: true, get: function () { return MulticallClient_js_1.decodeAggregate3Response; } });
+Object.defineProperty(exports, "encodeAggregate3", { enumerable: true, get: function () { return MulticallClient_js_1.encodeAggregate3; } });
+Object.defineProperty(exports, "MulticallClient", { enumerable: true, get: function () { return MulticallClient_js_1.MulticallClient; } });
+var TokensApiClient_js_1 = require("./TokensApiClient.cjs");
+Object.defineProperty(exports, "TokensApiClient", { enumerable: true, get: function () { return TokensApiClient_js_1.TokensApiClient; } });
+//# sourceMappingURL=index.cjs.map

package/dist/data-sources/evm-rpc-services/clients/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/index.ts"],"names":[],"mappings":";;;AAAA,4DAK8B;AAJ5B,8HAAA,wBAAwB,OAAA;AACxB,sHAAA,gBAAgB,OAAA;AAChB,qHAAA,eAAe,OAAA;AAIjB,4DAI8B;AAH5B,qHAAA,eAAe,OAAA","sourcesContent":["export {\n  decodeAggregate3Response,\n  encodeAggregate3,\n  MulticallClient,\n  type MulticallClientConfig,\n} from './MulticallClient.js';\n\nexport {\n  TokensApiClient,\n  type TokensApiClientConfig,\n  type TokenListQueryClient,\n} from './TokensApiClient.js';\n\n// Re-export provider types from types module\nexport type { GetProviderFunction, Provider } from '../types/index.js';\n"]}

package/dist/data-sources/evm-rpc-services/clients/index.d.cts

@@ -0,0 +1,4 @@
+export { decodeAggregate3Response, encodeAggregate3, MulticallClient, type MulticallClientConfig, } from "./MulticallClient.cjs";
+export { TokensApiClient, type TokensApiClientConfig, type TokenListQueryClient, } from "./TokensApiClient.cjs";
+export type { GetProviderFunction, Provider } from "../types/index.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/data-sources/evm-rpc-services/clients/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,eAAe,EACf,KAAK,qBAAqB,GAC3B,8BAA6B;AAE9B,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,8BAA6B;AAG9B,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,2BAA0B"}

package/dist/data-sources/evm-rpc-services/clients/index.d.mts

@@ -0,0 +1,4 @@
+export { decodeAggregate3Response, encodeAggregate3, MulticallClient, type MulticallClientConfig, } from "./MulticallClient.mjs";
+export { TokensApiClient, type TokensApiClientConfig, type TokenListQueryClient, } from "./TokensApiClient.mjs";
+export type { GetProviderFunction, Provider } from "../types/index.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/data-sources/evm-rpc-services/clients/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,eAAe,EACf,KAAK,qBAAqB,GAC3B,8BAA6B;AAE9B,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,8BAA6B;AAG9B,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,2BAA0B"}

package/dist/data-sources/evm-rpc-services/clients/index.mjs

@@ -0,0 +1,3 @@
+export { decodeAggregate3Response, encodeAggregate3, MulticallClient } from "./MulticallClient.mjs";
+export { TokensApiClient } from "./TokensApiClient.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/data-sources/evm-rpc-services/clients/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,eAAe,EAEhB,8BAA6B;AAE9B,OAAO,EACL,eAAe,EAGhB,8BAA6B","sourcesContent":["export {\n  decodeAggregate3Response,\n  encodeAggregate3,\n  MulticallClient,\n  type MulticallClientConfig,\n} from './MulticallClient.js';\n\nexport {\n  TokensApiClient,\n  type TokensApiClientConfig,\n  type TokenListQueryClient,\n} from './TokensApiClient.js';\n\n// Re-export provider types from types module\nexport type { GetProviderFunction, Provider } from '../types/index.js';\n"]}

package/dist/data-sources/evm-rpc-services/index.cjs

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reduceInBatchesSerially = exports.divideIntoBatches = exports.isStakingContractAssetId = exports.getStakingContractAddress = exports.getSupportedStakingChainIds = exports.StakedBalanceFetcher = exports.TokenDetector = exports.BalanceFetcher = exports.TokensApiClient = exports.MulticallClient = void 0;
+var index_js_1 = require("./clients/index.cjs");
+Object.defineProperty(exports, "MulticallClient", { enumerable: true, get: function () { return index_js_1.MulticallClient; } });
+Object.defineProperty(exports, "TokensApiClient", { enumerable: true, get: function () { return index_js_1.TokensApiClient; } });
+var index_js_2 = require("./services/index.cjs");
+Object.defineProperty(exports, "BalanceFetcher", { enumerable: true, get: function () { return index_js_2.BalanceFetcher; } });
+Object.defineProperty(exports, "TokenDetector", { enumerable: true, get: function () { return index_js_2.TokenDetector; } });
+Object.defineProperty(exports, "StakedBalanceFetcher", { enumerable: true, get: function () { return index_js_2.StakedBalanceFetcher; } });
+Object.defineProperty(exports, "getSupportedStakingChainIds", { enumerable: true, get: function () { return index_js_2.getSupportedStakingChainIds; } });
+Object.defineProperty(exports, "getStakingContractAddress", { enumerable: true, get: function () { return index_js_2.getStakingContractAddress; } });
+Object.defineProperty(exports, "isStakingContractAssetId", { enumerable: true, get: function () { return index_js_2.isStakingContractAssetId; } });
+var index_js_3 = require("./utils/index.cjs");
+Object.defineProperty(exports, "divideIntoBatches", { enumerable: true, get: function () { return index_js_3.divideIntoBatches; } });
+Object.defineProperty(exports, "reduceInBatchesSerially", { enumerable: true, get: function () { return index_js_3.reduceInBatchesSerially; } });
+//# sourceMappingURL=index.cjs.map

package/dist/data-sources/evm-rpc-services/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/data-sources/evm-rpc-services/index.ts"],"names":[],"mappings":";;;AAaA,gDAM4B;AAL1B,2GAAA,eAAe,OAAA;AAEf,2GAAA,eAAe,OAAA;AAIjB,iDAc6B;AAb3B,0GAAA,cAAc,OAAA;AACd,yGAAA,aAAa,OAAA;AACb,gHAAA,oBAAoB,OAAA;AACpB,uHAAA,2BAA2B,OAAA;AAC3B,qHAAA,yBAAyB,OAAA;AACzB,oHAAA,wBAAwB,OAAA;AAS1B,8CAA8E;AAArE,6GAAA,iBAAiB,OAAA;AAAE,mHAAA,uBAAuB,OAAA","sourcesContent":["export type {\n  Address,\n  AssetFetchEntry,\n  AssetsBalanceState,\n  ChainId,\n  GetProviderFunction,\n  Provider,\n  BalanceOfRequest,\n  BalanceOfResponse,\n  TokenListState,\n  BalanceFetchResult,\n  TokenDetectionResult,\n} from './types/index.js';\nexport {\n  MulticallClient,\n  type MulticallClientConfig,\n  TokensApiClient,\n  type TokensApiClientConfig,\n  type TokenListQueryClient,\n} from './clients/index.js';\nexport {\n  BalanceFetcher,\n  TokenDetector,\n  StakedBalanceFetcher,\n  getSupportedStakingChainIds,\n  getStakingContractAddress,\n  isStakingContractAssetId,\n  type BalancePollingInput,\n  type DetectionPollingInput,\n  type StakedBalancePollingInput,\n  type StakedBalanceFetchResult,\n  type OnBalanceUpdateCallback,\n  type OnDetectionUpdateCallback,\n  type OnStakedBalanceUpdateCallback,\n} from './services/index.js';\nexport { divideIntoBatches, reduceInBatchesSerially } from './utils/index.js';\n"]}

package/dist/data-sources/evm-rpc-services/{index.d.ts → index.d.cts}

@@ -1,5 +1,5 @@
-export type { Address, AssetFetchEntry, AssetsBalanceState, ChainId, GetProviderFunction, Provider, BalanceOfRequest, BalanceOfResponse, TokenListState, BalanceFetchResult, TokenDetectionResult, } from './types/index.js';
-export { MulticallClient, type MulticallClientConfig, TokensApiClient, type TokensApiClientConfig, type TokenListQueryClient, } from './clients/index.js';
-export { BalanceFetcher, TokenDetector, StakedBalanceFetcher, getSupportedStakingChainIds, getStakingContractAddress, isStakingContractAssetId, type BalancePollingInput, type DetectionPollingInput, type StakedBalancePollingInput, type StakedBalanceFetchResult, type OnBalanceUpdateCallback, type OnDetectionUpdateCallback, type OnStakedBalanceUpdateCallback, } from './services/index.js';
-export { divideIntoBatches, reduceInBatchesSerially } from './utils/index.js';
-//# sourceMappingURL=index.d.ts.map
+export type { Address, AssetFetchEntry, AssetsBalanceState, ChainId, GetProviderFunction, Provider, BalanceOfRequest, BalanceOfResponse, TokenListState, BalanceFetchResult, TokenDetectionResult, } from "./types/index.cjs";
+export { MulticallClient, type MulticallClientConfig, TokensApiClient, type TokensApiClientConfig, type TokenListQueryClient, } from "./clients/index.cjs";
+export { BalanceFetcher, TokenDetector, StakedBalanceFetcher, getSupportedStakingChainIds, getStakingContractAddress, isStakingContractAssetId, type BalancePollingInput, type DetectionPollingInput, type StakedBalancePollingInput, type StakedBalanceFetchResult, type OnBalanceUpdateCallback, type OnDetectionUpdateCallback, type OnStakedBalanceUpdateCallback, } from "./services/index.cjs";
+export { divideIntoBatches, reduceInBatchesSerially } from "./utils/index.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/data-sources/evm-rpc-services/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/data-sources/evm-rpc-services/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,eAAe,EACf,kBAAkB,EAClB,OAAO,EACP,mBAAmB,EACnB,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,GACrB,0BAAyB;AAC1B,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,4BAA2B;AAC5B,OAAO,EACL,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,GACnC,6BAA4B;AAC7B,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,0BAAyB"}

package/dist/data-sources/evm-rpc-services/index.d.mts

@@ -0,0 +1,5 @@
+export type { Address, AssetFetchEntry, AssetsBalanceState, ChainId, GetProviderFunction, Provider, BalanceOfRequest, BalanceOfResponse, TokenListState, BalanceFetchResult, TokenDetectionResult, } from "./types/index.mjs";
+export { MulticallClient, type MulticallClientConfig, TokensApiClient, type TokensApiClientConfig, type TokenListQueryClient, } from "./clients/index.mjs";
+export { BalanceFetcher, TokenDetector, StakedBalanceFetcher, getSupportedStakingChainIds, getStakingContractAddress, isStakingContractAssetId, type BalancePollingInput, type DetectionPollingInput, type StakedBalancePollingInput, type StakedBalanceFetchResult, type OnBalanceUpdateCallback, type OnDetectionUpdateCallback, type OnStakedBalanceUpdateCallback, } from "./services/index.mjs";
+export { divideIntoBatches, reduceInBatchesSerially } from "./utils/index.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/data-sources/evm-rpc-services/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/data-sources/evm-rpc-services/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,eAAe,EACf,kBAAkB,EAClB,OAAO,EACP,mBAAmB,EACnB,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,GACrB,0BAAyB;AAC1B,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,4BAA2B;AAC5B,OAAO,EACL,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,GACnC,6BAA4B;AAC7B,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,0BAAyB"}