@metamask-previews/assets-controller 18.0.1-preview-44b7ded21 → 18.0.1-preview-cbae429b5

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

@@ -0,0 +1,297 @@
+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

@@ -0,0 +1 @@
+{"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,3 +1,4 @@
 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 +1 @@
-{"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;AAG9B,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC"}
+{"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,2 +1,3 @@
 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 +1 @@
-{"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","sourcesContent":["export {\n  decodeAggregate3Response,\n  encodeAggregate3,\n  MulticallClient,\n  type MulticallClientConfig,\n} from './MulticallClient.js';\n\n// Re-export provider types from types module\nexport type { GetProviderFunction, Provider } from '../types/index.js';\n"]}
+{"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

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

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

@@ -1 +1 @@
-{"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,GAC3B,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"}
+{"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 +1,4 @@
-export { MulticallClient, } from './clients/index.js';
+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 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/data-sources/evm-rpc-services/index.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,eAAe,GAEhB,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} 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"]}
+{"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/TokenDetector.d.ts

@@ -1,11 +1,6 @@
-import type { TokenApiClient } from '@metamask/core-backend';
 import type { MulticallClient } from '../clients/index.js';
-import type { AccountId, Address, ChainId, TokenDetectionOptions, TokenDetectionResult, TokenListEntry } from '../types/index.js';
-/**
- * Token-list calls TokenDetector makes. `TokenApiClient` satisfies this, and
- * tests can pass an object with only these methods.
- */
-type TokenListApi = Pick<TokenApiClient, 'fetchV2SupportedNetworks' | 'fetchV1SuggestedOccurrenceFloors' | 'fetchTokenList'>;
+import type { TokensApiClient } from '../clients/TokensApiClient.js';
+import type { AccountId, Address, ChainId, TokenDetectionOptions, TokenDetectionResult } from '../types/index.js';
 export type TokenDetectorConfig = {
     /** Function returning whether token detection is enabled (avoids stale value) */
     tokenDetectionEnabled?: () => boolean;
@@ -55,7 +50,7 @@ declare const TokenDetector_base: (abstract new (...args: any[]) => {
  */
 export declare class TokenDetector extends TokenDetector_base {
     #private;
-    constructor(multicallClient: MulticallClient, tokenApi: TokenListApi, config?: TokenDetectorConfig);
+    constructor(multicallClient: MulticallClient, tokensApiClient: TokensApiClient, config?: TokenDetectorConfig);
     /**
      * Set the callback to receive detection updates during polling.
      *
@@ -77,13 +72,6 @@ export declare class TokenDetector extends TokenDetector_base {
      * @returns Array of token contract addresses.
      */
     getTokensToCheck(chainId: ChainId): Promise<Address[]>;
-    /**
-     * Fetch the mapped token list for a chain and keep it for metadata lookups.
-     *
-     * @param chainId - Chain ID in hex format.
-     * @returns Token list entries, including fields the address list drops.
-     */
-    fetchAndCacheTokenList(chainId: ChainId): Promise<TokenListEntry[]>;
     detectTokens(chainId: ChainId, accountId: AccountId, accountAddress: Address, options?: TokenDetectionOptions): Promise<TokenDetectionResult>;
 }
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"TokenDetector.d.ts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/TokenDetector.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAK7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EACV,SAAS,EACT,OAAO,EAKP,OAAO,EACP,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAgC3B;;;GAGG;AACH,KAAK,YAAY,GAAG,IAAI,CACtB,cAAc,EACZ,0BAA0B,GAC1B,kCAAkC,GAClC,gBAAgB,CACnB,CAAC;AAMF,MAAM,MAAM,mBAAmB,GAAG;IAChC,iFAAiF;IACjF,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC;IACtC,yGAAyG;IACzG,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,sBAAsB;IACtB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;;;;;;;;;;;;;;;;;;AAE/E;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,kBAA4D;;IAiB7F,YACE,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,YAAY,EACtB,MAAM,CAAC,EAAE,mBAAmB,EAgB7B;IAED;;;;OAIG;IACH,oBAAoB,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CAE9D;IAED;;;;;OAKG;IACG,YAAY,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAc9D;IAED;;;;;;OAMG;IACG,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAG3D;IAED;;;;;OAKG;IACG,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAcxE;IAEK,YAAY,CAChB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAoF/B;CA8PF"}
+{"version":3,"file":"TokenDetector.d.ts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/TokenDetector.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EACV,SAAS,EACT,OAAO,EAKP,OAAO,EACP,qBAAqB,EACrB,oBAAoB,EAErB,MAAM,mBAAmB,CAAC;AAO3B,MAAM,MAAM,mBAAmB,GAAG;IAChC,iFAAiF;IACjF,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC;IACtC,yGAAyG;IACzG,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,sBAAsB;IACtB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;;;;;;;;;;;;;;;;;;AAE/E;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,kBAA4D;;IAW7F,YACE,eAAe,EAAE,eAAe,EAChC,eAAe,EAAE,eAAe,EAChC,MAAM,CAAC,EAAE,mBAAmB,EAgB7B;IAED;;;;OAIG;IACH,oBAAoB,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CAE9D;IAED;;;;;OAKG;IACG,YAAY,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAc9D;IAED;;;;;;OAMG;IACG,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAG3D;IAEK,YAAY,CAChB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAoF/B;CAsJF"}