@metamask-previews/assets-controller 14.0.2-preview-3866c0ff1 → 14.0.2-preview-e3275932a

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

@@ -1,297 +0,0 @@
-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
- * 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 * 60_000;
-/**
- * How long to keep suggested occurrence floors cached. Same TTL as supported
- * networks — floors change infrequently.
- */
-const SUGGESTED_OCCURRENCE_FLOORS_CACHE_TTL_MS = 60 * 60_000;
-/**
- * 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 * 60_000;
-const TOKEN_LIST_GC_TIME_MS = 60 * 60_000;
-/**
- * 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 class TokensApiClient {
-    #fetch;
-    #queryClient;
-    /** CAIP chain IDs returned by `/v2/supportedNetworks` (both tiers). */
-    #supportedChainIds;
-    /** Timestamp of the last successful `/v2/supportedNetworks` fetch. */
-    #supportedChainIdsCachedAt = 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.
-     */
-    #supportedChainIdsRefreshPromise;
-    /** Decimal chain ID → suggested occurrence floor from Token API. */
-    #suggestedOccurrenceFloors;
-    /** Timestamp of the last successful floors fetch. */
-    #suggestedOccurrenceFloorsCachedAt = 0;
-    /** In-flight floors request shared across concurrent callers. */
-    #suggestedOccurrenceFloorsRefreshPromise;
-    constructor(config) {
-        this.#fetch = config?.fetch ?? globalThis.fetch.bind(globalThis);
-        this.#queryClient = config?.queryClient;
-    }
-    /**
-     * 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 this.#isSupportedChain(hexChainId).catch(() => false))) {
-            return [];
-        }
-        const queryClient = this.#queryClient;
-        if (queryClient === undefined) {
-            return this.#fetchTokenListUncached(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: () => this.#fetchTokenListUncached(hexChainId),
-            staleTime: TOKEN_LIST_STALE_TIME_MS,
-            gcTime: TOKEN_LIST_GC_TIME_MS,
-        });
-    }
-    /**
-     * 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 #isSupportedChain(hexChainId) {
-        const now = Date.now();
-        if (this.#supportedChainIds === undefined ||
-            now - this.#supportedChainIdsCachedAt >= SUPPORTED_NETWORKS_CACHE_TTL_MS) {
-            await this.#refreshSupportedChainIds(now);
-        }
-        const caipChainId = `eip155:${convertHexToDecimal(hexChainId)}`;
-        return this.#supportedChainIds?.has(caipChainId) ?? false;
-    }
-    /**
-     * 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 #refreshSupportedChainIds(now) {
-        if (this.#supportedChainIdsRefreshPromise !== undefined) {
-            return this.#supportedChainIdsRefreshPromise;
-        }
-        this.#supportedChainIdsRefreshPromise = (async () => {
-            try {
-                const response = await this.#fetch(SUPPORTED_NETWORKS_URL);
-                if (response.ok) {
-                    const data = (await response.json());
-                    this.#supportedChainIds = new Set([
-                        ...(data.fullSupport ?? []),
-                        ...(data.partialSupport ?? []),
-                    ]);
-                    this.#supportedChainIdsCachedAt = now;
-                }
-            }
-            finally {
-                this.#supportedChainIdsRefreshPromise = undefined;
-            }
-        })();
-        return this.#supportedChainIdsRefreshPromise;
-    }
-    /**
-     * 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 #getOccurrenceFloor(hexChainId) {
-        const now = Date.now();
-        if (this.#suggestedOccurrenceFloors === undefined ||
-            now - this.#suggestedOccurrenceFloorsCachedAt >=
-                SUGGESTED_OCCURRENCE_FLOORS_CACHE_TTL_MS) {
-            await this.#refreshSuggestedOccurrenceFloors(now);
-        }
-        const decimalChainId = String(convertHexToDecimal(hexChainId));
-        return (this.#suggestedOccurrenceFloors?.[decimalChainId] ??
-            DEFAULT_OCCURRENCE_FLOOR);
-    }
-    /**
-     * 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 #refreshSuggestedOccurrenceFloors(now) {
-        if (this.#suggestedOccurrenceFloorsRefreshPromise !== undefined) {
-            return this.#suggestedOccurrenceFloorsRefreshPromise;
-        }
-        this.#suggestedOccurrenceFloorsRefreshPromise =
-            (async () => {
-                try {
-                    const response = await this.#fetch(SUGGESTED_OCCURRENCE_FLOORS_URL);
-                    if (response.ok) {
-                        const data = (await response.json());
-                        this.#suggestedOccurrenceFloors =
-                            data && typeof data === 'object' && !Array.isArray(data)
-                                ? data
-                                : {};
-                        this.#suggestedOccurrenceFloorsCachedAt = now;
-                    }
-                    else {
-                        this.#suggestedOccurrenceFloors = {};
-                        this.#suggestedOccurrenceFloorsCachedAt = now;
-                    }
-                }
-                catch {
-                    this.#suggestedOccurrenceFloors = {};
-                    this.#suggestedOccurrenceFloorsCachedAt = now;
-                }
-                finally {
-                    this.#suggestedOccurrenceFloorsRefreshPromise = undefined;
-                }
-            })();
-        return this.#suggestedOccurrenceFloorsRefreshPromise;
-    }
-    async #fetchTokenListUncached(hexChainId) {
-        const decimalChainId = convertHexToDecimal(hexChainId);
-        const occurrenceFloor = await this.#getOccurrenceFloor(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 this.#fetch(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 === ControllerChainId['linea-mainnet']) {
-        return items.filter((item) => {
-            const aggregators = item.aggregators ?? [];
-            return aggregators.includes('lineaTeam') || aggregators.length >= 3;
-        });
-    }
-    return items;
-}
-//# sourceMappingURL=TokensApiClient.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"TokensApiClient.js","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/index.d.ts

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","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,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC"}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,eAAe,GAEhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,GAGhB,MAAM,sBAAsB,CAAC","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.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","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,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;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,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}

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

@@ -1,4 +0,0 @@
-export { MulticallClient, TokensApiClient, } from './clients/index.js';
-export { BalanceFetcher, TokenDetector, StakedBalanceFetcher, getSupportedStakingChainIds, getStakingContractAddress, isStakingContractAssetId, } from './services/index.js';
-export { divideIntoBatches, reduceInBatchesSerially } from './utils/index.js';
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/data-sources/evm-rpc-services/index.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,eAAe,EAEf,eAAe,GAGhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,GAQzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC","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/services/BalanceFetcher.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"BalanceFetcher.d.ts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/BalanceFetcher.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EACV,SAAS,EACT,OAAO,EAEP,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAGlB,aAAa,EACb,OAAO,EACR,MAAM,mBAAmB,CAAC;AAK3B;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,CAAC,MAAM,EAAE,2BAA2B,KAAK,kBAAkB,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,aAAa,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC;CACpD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,sBAAsB;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CACpC,MAAM,EAAE,kBAAkB,KACvB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;;;;;;;;;;;;;;;;;;AAE1B;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,mBAA0D;;IAa5F,YACE,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,uBAAuB,EAClC,MAAM,EAAE,oBAAoB,EAa7B;IAED;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAE1D;IAED;;;;;OAKG;IACG,YAAY,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5D;IAmGD;;;;;;;;;;;OAWG;IACG,sBAAsB,CAC1B,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,OAAO,EACvB,MAAM,EAAE,eAAe,EAAE,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAqE7B;CAqFF"}

package/dist/data-sources/evm-rpc-services/services/BalanceFetcher.js

@@ -1,241 +0,0 @@
-import { StaticIntervalPollingControllerOnly } from '@metamask/polling-controller';
-import { parseCaipAssetType } from '@metamask/utils';
-import { ZERO_ADDRESS } from '../../../utils/constants.js';
-import { reduceInBatchesSerially } from '../utils/index.js';
-const DEFAULT_BALANCE_INTERVAL = 30_000; // 30 seconds
-/**
- * BalanceFetcher - Fetches token balances via multicall.
- * Extends StaticIntervalPollingControllerOnly for built-in polling support.
- *
- * Callers provide CAIP-19 asset IDs; the fetcher extracts on-chain addresses
- * (or uses the zero address for native assets) and maps multicall responses
- * back to the original asset IDs. This ensures the returned balance entries
- * always carry the correct identifier regardless of chain.
- */
-export class BalanceFetcher extends StaticIntervalPollingControllerOnly() {
-    #multicallClient;
-    #messenger;
-    #config;
-    #isNativeAsset;
-    #onBalanceUpdate;
-    constructor(multicallClient, messenger, config) {
-        super();
-        this.#multicallClient = multicallClient;
-        this.#messenger = messenger;
-        this.#config = {
-            defaultBatchSize: config.defaultBatchSize ?? 300,
-            defaultTimeoutMs: config.defaultTimeoutMs ?? 30000,
-        };
-        this.#isNativeAsset = config.isNativeAsset;
-        // Set the polling interval
-        this.setIntervalLength(config?.pollingInterval ?? DEFAULT_BALANCE_INTERVAL);
-    }
-    /**
-     * Set the callback to receive balance updates during polling.
-     *
-     * @param callback - Function to call with balance results.
-     */
-    setOnBalanceUpdate(callback) {
-        this.#onBalanceUpdate = callback;
-    }
-    /**
-     * Execute a poll cycle (required by base class).
-     * Fetches balances and calls the update callback.
-     *
-     * @param input - The polling input.
-     */
-    async _executePoll(input) {
-        const result = await this.#fetchBalances(input.chainId, input.accountId, input.accountAddress, input.customAssetsOnly === true);
-        if (this.#onBalanceUpdate && result.balances.length > 0) {
-            await this.#onBalanceUpdate(result);
-        }
-    }
-    /**
-     * Return asset fetch entries tracked in state for the given account and
-     * chain. Both native (`slip44:`) and ERC-20 (`erc20:`) entries are included.
-     *
-     * @param chainId - Hex chain ID (e.g. "0x1").
-     * @param accountId - Account UUID.
-     * @param customAssetsOnly - When true, skip `assetsBalance` and only include `customAssets`.
-     * @returns Array of asset fetch entries from state for the requested chain.
-     */
-    #getAssetsToFetch(chainId, accountId, customAssetsOnly) {
-        const state = this.#messenger.call('AssetsController:getState');
-        // Convert hex chainId to decimal for CAIP-2 matching
-        // This is safe because we are filtring with an accountId that is for evm balances only
-        const chainIdDecimal = parseInt(chainId, 16).toString();
-        const assetsToFetch = new Map();
-        const collect = (assetId) => {
-            const parsed = parseCaipAssetType(assetId);
-            if (parsed.chain.reference !== chainIdDecimal) {
-                return;
-            }
-            const normalizedAssetId = assetId.toLowerCase();
-            if (assetsToFetch.has(normalizedAssetId)) {
-                return;
-            }
-            const isNative = this.#isNativeAsset(assetId);
-            assetsToFetch.set(normalizedAssetId, {
-                assetId,
-                address: isNative
-                    ? ZERO_ADDRESS
-                    : parsed.assetReference.toLowerCase(),
-            });
-        };
-        // 1. Assets already tracked with a balance entry — only when not in
-        //    "customAssetsOnly" mode (otherwise another data source is already
-        //    refreshing them and we'd double-poll).
-        if (!customAssetsOnly) {
-            const accountBalances = state?.assetsBalance?.[accountId];
-            if (accountBalances) {
-                for (const assetId of Object.keys(accountBalances)) {
-                    collect(assetId);
-                }
-            }
-        }
-        // 2. User-added custom assets — RPC is the sole balance fetcher for
-        //    these, so they must be polled even if they have no balance entry
-        //    yet (e.g. zero balance, first fetch failed, or state was hydrated
-        //    from disk before any successful fetch).
-        const customAssets = state?.customAssets?.[accountId];
-        if (customAssets) {
-            for (const assetId of customAssets) {
-                collect(assetId);
-            }
-        }
-        return Array.from(assetsToFetch.values());
-    }
-    /**
-     * Fetch balances for assets already tracked in state for the given
-     * account and chain.
-     *
-     * @param chainId - Hex chain ID.
-     * @param accountId - Account UUID.
-     * @param accountAddress - On-chain address of the account.
-     * @param customAssetsOnly - When true, skip `assetsBalance` and only include `customAssets`.
-     * @returns Balance fetch result.
-     */
-    async #fetchBalances(chainId, accountId, accountAddress, customAssetsOnly) {
-        const assets = this.#getAssetsToFetch(chainId, accountId, customAssetsOnly);
-        return this.fetchBalancesForAssets(chainId, accountId, accountAddress, assets);
-    }
-    /**
-     * Fetch balances for the given assets via multicall.
-     *
-     * Each entry bundles a CAIP-19 asset ID with its on-chain address and
-     * optional decimals.
-     *
-     * @param chainId - Hex chain ID.
-     * @param accountId - Account UUID.
-     * @param accountAddress - On-chain address of the account.
-     * @param assets - Asset fetch entries to fetch balances for.
-     * @returns Balance fetch result.
-     */
-    async fetchBalancesForAssets(chainId, accountId, accountAddress, assets) {
-        const timestamp = Date.now();
-        // Build a single map keyed by lowercase address that holds all info
-        // needed to match multicall responses back to their original entries.
-        const balanceRequests = [];
-        const entryByAddress = new Map();
-        for (const entry of assets) {
-            const lowerAddress = entry.address.toLowerCase();
-            if (entryByAddress.has(lowerAddress)) {
-                continue; // deduplicate
-            }
-            entryByAddress.set(lowerAddress, entry);
-            balanceRequests.push({ tokenAddress: entry.address, accountAddress });
-        }
-        if (balanceRequests.length === 0) {
-            return {
-                chainId,
-                accountId,
-                accountAddress,
-                balances: [],
-                failedAddresses: [],
-                timestamp,
-            };
-        }
-        const result = await reduceInBatchesSerially({
-            values: balanceRequests,
-            batchSize: this.#config.defaultBatchSize,
-            initialResult: {
-                balances: [],
-                failedAddresses: [],
-            },
-            eachBatch: async (workingResult, batch) => {
-                const responses = await this.#multicallClient.batchBalanceOf(chainId, batch, { fallbackToSingleCalls: true });
-                return this.#processBalanceResponses(responses, workingResult, chainId, accountId, timestamp, entryByAddress);
-            },
-        });
-        return {
-            chainId,
-            accountId,
-            accountAddress,
-            ...result,
-            timestamp,
-        };
-    }
-    #processBalanceResponses(responses, accumulator, chainId, accountId, timestamp, entryByAddress) {
-        const { balances, failedAddresses } = accumulator;
-        for (const response of responses) {
-            if (!response.success) {
-                failedAddresses.push(response.tokenAddress);
-                continue;
-            }
-            const lowerAddress = response.tokenAddress.toLowerCase();
-            const entry = entryByAddress.get(lowerAddress);
-            if (!entry) {
-                continue;
-            }
-            const balance = response.balance ?? '0';
-            const isNative = lowerAddress === ZERO_ADDRESS.toLowerCase();
-            let decimals;
-            let formattedBalance;
-            if (isNative) {
-                decimals = 18;
-                formattedBalance = this.#formatBalance(balance, decimals);
-            }
-            else if (entry.decimals === undefined) {
-                formattedBalance = balance;
-            }
-            else {
-                decimals = entry.decimals;
-                formattedBalance = this.#formatBalance(balance, decimals);
-            }
-            const balanceEntry = {
-                assetId: entry.assetId,
-                accountId,
-                chainId,
-                balance,
-                formattedBalance,
-                timestamp,
-            };
-            if (typeof decimals === 'number') {
-                balanceEntry.decimals = decimals;
-            }
-            balances.push(balanceEntry);
-        }
-        return { balances, failedAddresses };
-    }
-    #formatBalance(rawBalance, decimals) {
-        if (rawBalance === '0') {
-            return '0';
-        }
-        try {
-            const balanceBigInt = BigInt(rawBalance);
-            const divisor = BigInt(10 ** decimals);
-            const integerPart = balanceBigInt / divisor;
-            const remainder = balanceBigInt % divisor;
-            const fractionalStr = remainder.toString().padStart(decimals, '0');
-            const trimmedFractional = fractionalStr.replace(/0+$/u, '');
-            if (trimmedFractional === '') {
-                return integerPart.toString();
-            }
-            return `${integerPart}.${trimmedFractional}`;
-        }
-        catch {
-            return rawBalance;
-        }
-    }
-}
-//# sourceMappingURL=BalanceFetcher.js.map