@metamask/assets-controller 8.3.3 → 9.0.0

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

@@ -10,7 +10,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     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_fetchTokenListUncached;
+var _TokensApiClient_instances, _TokensApiClient_fetch, _TokensApiClient_queryClient, _TokensApiClient_supportedChainIds, _TokensApiClient_supportedChainIdsCachedAt, _TokensApiClient_supportedChainIdsRefreshPromise, _TokensApiClient_isSupportedChain, _TokensApiClient_refreshSupportedChainIds, _TokensApiClient_fetchTokenListUncached;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TokensApiClient = void 0;
 const controller_utils_1 = require("@metamask/controller-utils");
@@ -21,6 +21,19 @@ const controller_utils_1 = require("@metamask/controller-utils");
  * (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`;
+/**
+ * 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;
 /**
  * Tempo Mainnet — not yet present in `@metamask/controller-utils`'s `ChainId`
  * map at the time of writing, so it's spelled out as a literal here exactly as
@@ -63,26 +76,50 @@ const TOKEN_LIST_GC_TIME_MS = 60 * 60000;
  * Linea aggregator filter. This keeps RPC token detection in lockstep with
  * the wallet's primary token list.
  *
- * When constructed with a `queryClient`, 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.
+ * 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);
         __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.
-     * @throws If the API responds with a non-2xx status.
+     * @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);
@@ -103,7 +140,56 @@ class TokensApiClient {
     }
 }
 exports.TokensApiClient = TokensApiClient;
-_TokensApiClient_fetch = new WeakMap(), _TokensApiClient_queryClient = new WeakMap(), _TokensApiClient_instances = new WeakSet(), _TokensApiClient_fetchTokenListUncached = async function _TokensApiClient_fetchTokenListUncached(hexChainId) {
+_TokensApiClient_fetch = new WeakMap(), _TokensApiClient_queryClient = new WeakMap(), _TokensApiClient_supportedChainIds = new WeakMap(), _TokensApiClient_supportedChainIdsCachedAt = new WeakMap(), _TokensApiClient_supportedChainIdsRefreshPromise = 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_fetchTokenListUncached = async function _TokensApiClient_fetchTokenListUncached(hexChainId) {
     const decimalChainId = (0, controller_utils_1.convertHexToDecimal)(hexChainId);
     const occurrenceFloor = getOccurrenceFloor(hexChainId);
     // Mirrors `TokenListController.getTokensURL` exactly (token-service.ts).
@@ -117,9 +203,17 @@ _TokensApiClient_fetch = new WeakMap(), _TokensApiClient_queryClient = new WeakM
         `&includeERC20Permit=false` +
         `&includeStorage=false` +
         `&includeRwaData=true`;
-    const response = await __classPrivateFieldGet(this, _TokensApiClient_fetch, "f").call(this, url);
+    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) {
-        throw new Error(`Tokens API responded with ${response.status} for chain ${hexChainId}`);
+        console.error(`Tokens API responded with ${response.status} for chain ${hexChainId}`);
+        return [];
     }
     const raw = (await response.json());
     const items = Array.isArray(raw)

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

@@ -1 +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';\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 * Tempo Mainnet — not yet present in `@metamask/controller-utils`'s `ChainId`\n * map at the time of writing, so it's spelled out as a literal here exactly as\n * `TokenListController` does (see `token-service.ts:getTokensURL`).\n */\nconst TEMPO_MAINNET_CHAIN_ID = '0x1079' as const;\n\n/**\n * Per-chain occurrence floor, mirroring `TokenListController.getTokensURL`:\n * Linea mainnet, MegaETH mainnet, and Tempo mainnet have thinner aggregator\n * coverage so we lower the floor; everything else uses the default 3.\n *\n * @param hexChainId - Hex chain ID.\n * @returns The occurrence floor to send to the Tokens API.\n */\nfunction getOccurrenceFloor(hexChainId: ChainId): number {\n  if (\n    hexChainId === ControllerChainId['linea-mainnet'] ||\n    hexChainId === ControllerChainId['megaeth-mainnet'] ||\n    hexChainId === TEMPO_MAINNET_CHAIN_ID\n  ) {\n    return 1;\n  }\n  return 3;\n}\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 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 and the same per-chain occurrence floor /\n * Linea aggregator filter. This keeps RPC token detection in lockstep with\n * the wallet's primary token list.\n *\n * When constructed with a `queryClient`, results are cached and deduped via\n * TanStack Query (5 min staleTime, 1 h gcTime), so concurrent detection cycles\n * 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  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   * @param hexChainId - Chain ID in hex format (e.g. `'0x1'` for Ethereum mainnet).\n   * @returns Array of token list entries with address and metadata.\n   * @throws If the API responds with a non-2xx status.\n   */\n  async fetchTokenList(hexChainId: ChainId): Promise<TokenListEntry[]> {\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  async #fetchTokenListUncached(\n    hexChainId: ChainId,\n  ): Promise<TokenListEntry[]> {\n    const decimalChainId = convertHexToDecimal(hexChainId);\n    const occurrenceFloor = getOccurrenceFloor(hexChainId);\n\n    // Mirrors `TokenListController.getTokensURL` exactly (token-service.ts).\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    const response = await this.#fetch(url);\n    if (!response.ok) {\n      throw new Error(\n        `Tokens API responded with ${response.status} for chain ${hexChainId}`,\n      );\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"]}
+{"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';\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 * 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 * Tempo Mainnet — not yet present in `@metamask/controller-utils`'s `ChainId`\n * map at the time of writing, so it's spelled out as a literal here exactly as\n * `TokenListController` does (see `token-service.ts:getTokensURL`).\n */\nconst TEMPO_MAINNET_CHAIN_ID = '0x1079' as const;\n\n/**\n * Per-chain occurrence floor, mirroring `TokenListController.getTokensURL`:\n * Linea mainnet, MegaETH mainnet, and Tempo mainnet have thinner aggregator\n * coverage so we lower the floor; everything else uses the default 3.\n *\n * @param hexChainId - Hex chain ID.\n * @returns The occurrence floor to send to the Tokens API.\n */\nfunction getOccurrenceFloor(hexChainId: ChainId): number {\n  if (\n    hexChainId === ControllerChainId['linea-mainnet'] ||\n    hexChainId === ControllerChainId['megaeth-mainnet'] ||\n    hexChainId === TEMPO_MAINNET_CHAIN_ID\n  ) {\n    return 1;\n  }\n  return 3;\n}\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 and the same per-chain occurrence floor /\n * Linea aggregator filter. This keeps RPC token detection in lockstep with\n * the wallet's primary token list.\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  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  async #fetchTokenListUncached(\n    hexChainId: ChainId,\n  ): Promise<TokenListEntry[]> {\n    const decimalChainId = convertHexToDecimal(hexChainId);\n    const occurrenceFloor = getOccurrenceFloor(hexChainId);\n\n    // Mirrors `TokenListController.getTokensURL` exactly (token-service.ts).\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.cts

@@ -32,9 +32,14 @@ export type TokensApiClientConfig = {
  * Linea aggregator filter. This keeps RPC token detection in lockstep with
  * the wallet's primary token list.
  *
- * When constructed with a `queryClient`, 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.
+ * 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;
@@ -42,9 +47,13 @@ export declare class TokensApiClient {
     /**
      * 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.
-     * @throws If the API responds with a non-2xx status.
+     * @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[]>;
 }

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

@@ -1 +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,2BAAiB;AAgExD;;;;;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;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;;gBAKd,MAAM,CAAC,EAAE,qBAAqB;IAK1C;;;;;;OAMG;IACG,cAAc,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAgErE"}
+{"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,2BAAiB;AAuFxD;;;;;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;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAe;;gBAkBd,MAAM,CAAC,EAAE,qBAAqB;IAK1C;;;;;;;;;;OAUG;IACG,cAAc,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAwIrE"}

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

@@ -32,9 +32,14 @@ export type TokensApiClientConfig = {
  * Linea aggregator filter. This keeps RPC token detection in lockstep with
  * the wallet's primary token list.
  *
- * When constructed with a `queryClient`, 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.
+ * 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;
@@ -42,9 +47,13 @@ export declare class TokensApiClient {
     /**
      * 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.
-     * @throws If the API responds with a non-2xx status.
+     * @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[]>;
 }

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

@@ -1 +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,2BAAiB;AAgExD;;;;;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;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;;gBAKd,MAAM,CAAC,EAAE,qBAAqB;IAK1C;;;;;;OAMG;IACG,cAAc,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAgErE"}
+{"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,2BAAiB;AAuFxD;;;;;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;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAe;;gBAkBd,MAAM,CAAC,EAAE,qBAAqB;IAK1C;;;;;;;;;;OAUG;IACG,cAAc,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAwIrE"}

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

@@ -9,7 +9,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     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_fetchTokenListUncached;
+var _TokensApiClient_instances, _TokensApiClient_fetch, _TokensApiClient_queryClient, _TokensApiClient_supportedChainIds, _TokensApiClient_supportedChainIdsCachedAt, _TokensApiClient_supportedChainIdsRefreshPromise, _TokensApiClient_isSupportedChain, _TokensApiClient_refreshSupportedChainIds, _TokensApiClient_fetchTokenListUncached;
 import { ChainId as ControllerChainId, convertHexToDecimal } from "@metamask/controller-utils";
 /**
  * Same host + path that `TokenListController` (assets-controllers) uses
@@ -18,6 +18,19 @@ import { ChainId as ControllerChainId, convertHexToDecimal } from "@metamask/con
  * (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`;
+/**
+ * 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;
 /**
  * Tempo Mainnet — not yet present in `@metamask/controller-utils`'s `ChainId`
  * map at the time of writing, so it's spelled out as a literal here exactly as
@@ -60,26 +73,50 @@ const TOKEN_LIST_GC_TIME_MS = 60 * 60000;
  * Linea aggregator filter. This keeps RPC token detection in lockstep with
  * the wallet's primary token list.
  *
- * When constructed with a `queryClient`, 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.
+ * 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 {
     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);
         __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.
-     * @throws If the API responds with a non-2xx status.
+     * @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);
@@ -99,7 +136,56 @@ export class TokensApiClient {
         });
     }
 }
-_TokensApiClient_fetch = new WeakMap(), _TokensApiClient_queryClient = new WeakMap(), _TokensApiClient_instances = new WeakSet(), _TokensApiClient_fetchTokenListUncached = async function _TokensApiClient_fetchTokenListUncached(hexChainId) {
+_TokensApiClient_fetch = new WeakMap(), _TokensApiClient_queryClient = new WeakMap(), _TokensApiClient_supportedChainIds = new WeakMap(), _TokensApiClient_supportedChainIdsCachedAt = new WeakMap(), _TokensApiClient_supportedChainIdsRefreshPromise = 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:${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_fetchTokenListUncached = async function _TokensApiClient_fetchTokenListUncached(hexChainId) {
     const decimalChainId = convertHexToDecimal(hexChainId);
     const occurrenceFloor = getOccurrenceFloor(hexChainId);
     // Mirrors `TokenListController.getTokensURL` exactly (token-service.ts).
@@ -113,9 +199,17 @@ _TokensApiClient_fetch = new WeakMap(), _TokensApiClient_queryClient = new WeakM
         `&includeERC20Permit=false` +
         `&includeStorage=false` +
         `&includeRwaData=true`;
-    const response = await __classPrivateFieldGet(this, _TokensApiClient_fetch, "f").call(this, url);
+    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) {
-        throw new Error(`Tokens API responded with ${response.status} for chain ${hexChainId}`);
+        console.error(`Tokens API responded with ${response.status} for chain ${hexChainId}`);
+        return [];
     }
     const raw = (await response.json());
     const items = Array.isArray(raw)

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

@@ -1 +1 @@
-{"version":3,"file":"TokensApiClient.mjs","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';\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 * Tempo Mainnet — not yet present in `@metamask/controller-utils`'s `ChainId`\n * map at the time of writing, so it's spelled out as a literal here exactly as\n * `TokenListController` does (see `token-service.ts:getTokensURL`).\n */\nconst TEMPO_MAINNET_CHAIN_ID = '0x1079' as const;\n\n/**\n * Per-chain occurrence floor, mirroring `TokenListController.getTokensURL`:\n * Linea mainnet, MegaETH mainnet, and Tempo mainnet have thinner aggregator\n * coverage so we lower the floor; everything else uses the default 3.\n *\n * @param hexChainId - Hex chain ID.\n * @returns The occurrence floor to send to the Tokens API.\n */\nfunction getOccurrenceFloor(hexChainId: ChainId): number {\n  if (\n    hexChainId === ControllerChainId['linea-mainnet'] ||\n    hexChainId === ControllerChainId['megaeth-mainnet'] ||\n    hexChainId === TEMPO_MAINNET_CHAIN_ID\n  ) {\n    return 1;\n  }\n  return 3;\n}\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 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 and the same per-chain occurrence floor /\n * Linea aggregator filter. This keeps RPC token detection in lockstep with\n * the wallet's primary token list.\n *\n * When constructed with a `queryClient`, results are cached and deduped via\n * TanStack Query (5 min staleTime, 1 h gcTime), so concurrent detection cycles\n * 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  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   * @param hexChainId - Chain ID in hex format (e.g. `'0x1'` for Ethereum mainnet).\n   * @returns Array of token list entries with address and metadata.\n   * @throws If the API responds with a non-2xx status.\n   */\n  async fetchTokenList(hexChainId: ChainId): Promise<TokenListEntry[]> {\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  async #fetchTokenListUncached(\n    hexChainId: ChainId,\n  ): Promise<TokenListEntry[]> {\n    const decimalChainId = convertHexToDecimal(hexChainId);\n    const occurrenceFloor = getOccurrenceFloor(hexChainId);\n\n    // Mirrors `TokenListController.getTokensURL` exactly (token-service.ts).\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    const response = await this.#fetch(url);\n    if (!response.ok) {\n      throw new Error(\n        `Tokens API responded with ${response.status} for chain ${hexChainId}`,\n      );\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"]}
+{"version":3,"file":"TokensApiClient.mjs","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';\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 * 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 * Tempo Mainnet — not yet present in `@metamask/controller-utils`'s `ChainId`\n * map at the time of writing, so it's spelled out as a literal here exactly as\n * `TokenListController` does (see `token-service.ts:getTokensURL`).\n */\nconst TEMPO_MAINNET_CHAIN_ID = '0x1079' as const;\n\n/**\n * Per-chain occurrence floor, mirroring `TokenListController.getTokensURL`:\n * Linea mainnet, MegaETH mainnet, and Tempo mainnet have thinner aggregator\n * coverage so we lower the floor; everything else uses the default 3.\n *\n * @param hexChainId - Hex chain ID.\n * @returns The occurrence floor to send to the Tokens API.\n */\nfunction getOccurrenceFloor(hexChainId: ChainId): number {\n  if (\n    hexChainId === ControllerChainId['linea-mainnet'] ||\n    hexChainId === ControllerChainId['megaeth-mainnet'] ||\n    hexChainId === TEMPO_MAINNET_CHAIN_ID\n  ) {\n    return 1;\n  }\n  return 3;\n}\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 and the same per-chain occurrence floor /\n * Linea aggregator filter. This keeps RPC token detection in lockstep with\n * the wallet's primary token list.\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  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  async #fetchTokenListUncached(\n    hexChainId: ChainId,\n  ): Promise<TokenListEntry[]> {\n    const decimalChainId = convertHexToDecimal(hexChainId);\n    const occurrenceFloor = getOccurrenceFloor(hexChainId);\n\n    // Mirrors `TokenListController.getTokensURL` exactly (token-service.ts).\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/defaults.cjs

@@ -25,6 +25,20 @@ const MUSD_METADATA = {
     name: 'MetaMask USD',
     decimals: 6,
 };
+/**
+ * Harcoded metadata for USDC on Arc (5042/0x13b2).
+ * USDC exists as both native (18 decimals) and ERC20 (6 decimals).
+ * We choose to force-hide the native version to avoid double listing using
+ * `CHAIN_IDS_WITH_NO_NATIVE_TOKEN`.
+ * In the meantime, the code below force-shows USDC the ERC20 token.
+ */
+const USDC_ON_ARC_ASSET_ID = 'eip155:5042/erc20:0x3600000000000000000000000000000000000000';
+const USDC_ON_ARC_METADATA = {
+    type: 'erc20',
+    symbol: 'USDC',
+    name: 'USDC',
+    decimals: 6,
+};
 /**
  * Build the CAIP-19 asset ID for the mUSD ERC-20 token on a given EVM
  * chain.
@@ -49,6 +63,7 @@ exports.DEFAULT_TRACKED_ASSETS_BY_CHAIN = new Map([
     ['eip155:1', [musdAssetId('eip155:1')]],
     ['eip155:59144', [musdAssetId('eip155:59144')]],
     ['eip155:143', [musdAssetId('eip155:143')]],
+    ['eip155:5042', [USDC_ON_ARC_ASSET_ID]],
 ]);
 /**
  * Chains that have at least one default tracked asset. Useful for
@@ -64,6 +79,7 @@ exports.DEFAULT_ASSET_METADATA = new Map([
     [musdAssetId('eip155:1'), MUSD_METADATA],
     [musdAssetId('eip155:59144'), MUSD_METADATA],
     [musdAssetId('eip155:143'), MUSD_METADATA],
+    [USDC_ON_ARC_ASSET_ID, USDC_ON_ARC_METADATA],
 ]);
 /**
  * Return the default tracked assets for a CAIP-2 chain id. Empty when
@@ -100,7 +116,10 @@ function buildDefaultAssetsInfo() {
     const info = {};
     for (const assetIds of exports.DEFAULT_TRACKED_ASSETS_BY_CHAIN.values()) {
         for (const assetId of assetIds) {
-            info[assetId] = MUSD_METADATA;
+            const metadata = exports.DEFAULT_ASSET_METADATA.get(assetId);
+            if (metadata) {
+                info[assetId] = metadata;
+            }
         }
     }
     return info;