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

package/dist/migrations/healAssetsInfoMetadata.cjs

@@ -0,0 +1,539 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanSpamAssets = exports.isUnlockCleanupEnabled = exports.healAssetsInfoMetadata = exports.tempHealAssetsInfoMetadata = void 0;
+const utils_1 = require("@metamask/utils");
+const lodash_1 = require("lodash");
+const batch_js_1 = require("../data-sources/evm-rpc-services/utils/batch.cjs");
+const defaults_js_1 = require("../defaults.cjs");
+const logger_js_1 = require("../logger.cjs");
+const fetchWithTimeout_js_1 = require("../utils/fetchWithTimeout.cjs");
+const log = (0, logger_js_1.createModuleLogger)(logger_js_1.projectLogger, 'tempHealAssetsInfoMetadata');
+/**
+ * TEMPORARY — will be removed in a future release.
+ *
+ * @param options - The options bag.
+ * @param options.state - Current controller state to compute the patch against.
+ * @param options.getMigrationState - Getter for the untrusted legacy state root.
+ * @param options.captureException - Optional reporter for healing failures.
+ * @returns Updated controller state with the healing patch applied, or the
+ * original state when there is nothing to heal or healing fails.
+ */
+function tempHealAssetsInfoMetadata({ state, getMigrationState, captureException, }) {
+    const reportError = (error) => {
+        log('Failed to heal assetsInfo metadata', error);
+        captureException?.(new Error(`AssetsController: temporary assetsInfo metadata healing failed: ${(0, utils_1.getErrorMessage)(error)}`));
+    };
+    let patch = null;
+    try {
+        patch = healAssetsInfoMetadata(getMigrationState(), state);
+    }
+    catch (error) {
+        reportError(error);
+    }
+    if (!patch) {
+        return state;
+    }
+    try {
+        const nextState = (0, lodash_1.cloneDeep)(state);
+        applyHealingPatch(nextState, patch);
+        log('Healed wiped assetsInfo metadata for niche-chain tokens', {
+            healedAssetsInfoCount: Object.keys(patch.assetsInfo).length,
+            healedCustomAssetsAccounts: Object.keys(patch.customAssets).length,
+        });
+        return nextState;
+    }
+    catch (error) {
+        reportError(error);
+        return state;
+    }
+}
+exports.tempHealAssetsInfoMetadata = tempHealAssetsInfoMetadata;
+/**
+ * Apply a healing patch to (draft) controller state. Defensive against
+ * concurrent writes: fills `assetsInfo` gaps only and dedupes `customAssets`
+ * against the current draft rather than trusting the patch blindly.
+ *
+ * @param state - Mutable controller state copy.
+ * @param patch - The additions computed by {@link healAssetsInfoMetadata}.
+ */
+function applyHealingPatch(state, patch) {
+    var _a, _b;
+    for (const [assetId, metadata] of Object.entries(patch.assetsInfo)) {
+        (_a = state.assetsInfo)[_b = assetId] ?? (_a[_b] = metadata);
+    }
+    for (const [accountId, assetIds] of Object.entries(patch.customAssets)) {
+        const existing = state.customAssets[accountId] ?? [];
+        state.customAssets[accountId] = [
+            ...existing,
+            ...assetIds.filter((assetId) => !existing.includes(assetId)),
+        ];
+    }
+}
+const EVM_CHAIN_NAMESPACE = 'eip155';
+const EVM_ADDRESS_REGEX = /^0x[0-9a-fA-F]{40}$/u;
+/**
+ * Popular networks (covered by the Accounts API) can self-heal through
+ * auto-detection, so their tokens must not be touched. Frozen snapshot from
+ * extension migration #215.
+ */
+const ACCOUNT_API_SUPPORTED_CHAIN_IDS = new Set([
+    'eip155:1', // Ethereum Mainnet
+    'eip155:10', // Optimism
+    'eip155:56', // BNB Smart Chain
+    'eip155:137', // Polygon
+    'eip155:143', // Monad
+    'eip155:999', // HyperEVM
+    'eip155:1329', // Sei
+    'eip155:5042', // Arc
+    'eip155:8453', // Base
+    'eip155:42161', // Arbitrum One
+    'eip155:43114', // Avalanche
+    'eip155:59144', // Linea
+]);
+/**
+ * Compute the additions required to heal `assetsInfo` metadata (and custom
+ * asset tracking) for tokens on niche EVM chains, based on the legacy
+ * `TokensController` state.
+ *
+ * What it deliberately skips:
+ *
+ * - Accounts-API-supported chains — see `ACCOUNT_API_SUPPORTED_CHAIN_IDS`.
+ * - Tokens the user hid/removed, detected via either the legacy
+ *   `TokensController.allIgnoredTokens` or the current
+ *   `assetPreferences` (`hidden: true`).
+ * - Non-EVM assets, ERC-721s, and tokens with invalid addresses or metadata.
+ *
+ * @param legacyState - Untrusted legacy state root. Expected (but not
+ * required) to contain `TokensController.allTokens`,
+ * `TokensController.allIgnoredTokens`, and
+ * `AccountsController.internalAccounts.accounts`.
+ * @param currentState - Current `AssetsController` state slices (read-only).
+ * @returns The additions to apply, or `null` when there is nothing to heal.
+ */
+function healAssetsInfoMetadata(legacyState, currentState) {
+    const allTokens = readPath(legacyState, ['TokensController', 'allTokens']);
+    if (!(0, utils_1.isObject)(allTokens)) {
+        return null;
+    }
+    const addressToAccountId = buildAddressToAccountIdMap(legacyState);
+    const hiddenAssetIds = collectHiddenAssetIds(currentState);
+    const allIgnoredTokens = readPath(legacyState, [
+        'TokensController',
+        'allIgnoredTokens',
+    ]);
+    const assetsInfoAdditions = {};
+    const customAssetAdditions = {};
+    for (const [hexChainId, accountTokens] of Object.entries(allTokens)) {
+        if (!(0, utils_1.isObject)(accountTokens)) {
+            continue;
+        }
+        const caip2 = hexChainIdToCaip2(hexChainId);
+        // Skip chains we can't parse or that self-heal via the accounts API.
+        if (!caip2 || ACCOUNT_API_SUPPORTED_CHAIN_IDS.has(caip2)) {
+            continue;
+        }
+        for (const [rawAddress, tokens] of Object.entries(accountTokens)) {
+            if (!Array.isArray(tokens) || tokens.length === 0) {
+                continue;
+            }
+            const accountId = addressToAccountId[rawAddress.toLowerCase()];
+            const ignoredAddresses = collectIgnoredAddresses(allIgnoredTokens, hexChainId, rawAddress);
+            for (const token of tokens) {
+                const restorable = getRestorableAsset(token, caip2, ignoredAddresses, hiddenAssetIds);
+                if (!restorable) {
+                    continue;
+                }
+                const { assetId, info } = restorable;
+                // `assetsInfo` is a global registry; fill gaps only, never overwrite.
+                if (currentState.assetsInfo[assetId] === undefined &&
+                    assetsInfoAdditions[assetId] === undefined) {
+                    assetsInfoAdditions[assetId] = info;
+                }
+                // Ensure the asset is tracked for its account.
+                if (accountId) {
+                    addCustomAssetAddition(currentState, customAssetAdditions, accountId, assetId);
+                }
+            }
+        }
+    }
+    if (Object.keys(assetsInfoAdditions).length === 0 &&
+        Object.keys(customAssetAdditions).length === 0) {
+        return null;
+    }
+    return {
+        assetsInfo: assetsInfoAdditions,
+        customAssets: customAssetAdditions,
+    };
+}
+exports.healAssetsInfoMetadata = healAssetsInfoMetadata;
+/**
+ * Resolve a raw `TokensController` token entry to the CAIP-19 asset ID and
+ * metadata that should be healed, or `null` when the token must be skipped
+ * (not an object, missing/invalid address or symbol, an ERC-721, or hidden
+ * in either the legacy or the current controller).
+ *
+ * @param token - Raw token entry from `allTokens`.
+ * @param caip2 - The CAIP-2 chain ID of the token's chain (e.g. 'eip155:14').
+ * @param ignoredAddresses - Lowercase addresses hidden via legacy `allIgnoredTokens`.
+ * @param hiddenAssetIds - Lowercase asset IDs hidden via current `assetPreferences`.
+ * @returns The restorable asset, or `null` to skip.
+ */
+function getRestorableAsset(token, caip2, ignoredAddresses, hiddenAssetIds) {
+    if (!(0, utils_1.isObject)(token)) {
+        return null;
+    }
+    // Skip NFTs — AssetsController tracks them separately.
+    if (token.isERC721 === true) {
+        return null;
+    }
+    if (typeof token.address !== 'string' ||
+        !EVM_ADDRESS_REGEX.test(token.address)) {
+        return null;
+    }
+    // Healed metadata with no symbol would be unusable in the UI; skip it.
+    if (typeof token.symbol !== 'string' || token.symbol.length === 0) {
+        return null;
+    }
+    const assetId = buildErc20AssetId(caip2, token.address);
+    if (!assetId) {
+        return null;
+    }
+    // Skip tokens the user hid/removed — in the legacy controller…
+    if (ignoredAddresses.has(token.address.toLowerCase())) {
+        return null;
+    }
+    // …or in the current controller.
+    if (hiddenAssetIds.has(assetId.toLowerCase())) {
+        return null;
+    }
+    return { assetId, info: buildEvmAssetInfo(token) };
+}
+/**
+ * Build a `FungibleAssetMetadata` from a raw `TokensController` token entry.
+ * The caller has already validated `symbol` as a non-empty string.
+ *
+ * @param token - Raw token object.
+ * @returns The metadata to write into `assetsInfo`.
+ */
+function buildEvmAssetInfo(token) {
+    const symbol = token.symbol;
+    const name = typeof token.name === 'string' && token.name.length > 0
+        ? token.name
+        : symbol;
+    const decimals = typeof token.decimals === 'number' && Number.isFinite(token.decimals)
+        ? token.decimals
+        : 0;
+    const image = typeof token.image === 'string' && token.image.length > 0
+        ? token.image
+        : undefined;
+    const aggregators = Array.isArray(token.aggregators)
+        ? token.aggregators.filter((aggregator) => typeof aggregator === 'string')
+        : undefined;
+    return {
+        type: 'erc20',
+        symbol,
+        name,
+        decimals,
+        ...(image ? { image } : {}),
+        ...(aggregators ? { aggregators } : {}),
+    };
+}
+/**
+ * Build a map from lowercase account address to account UUID using the
+ * legacy `AccountsController.internalAccounts.accounts`.
+ *
+ * @param legacyState - Untrusted legacy state root.
+ * @returns Map of lowercase address to account ID (empty on invalid input).
+ */
+function buildAddressToAccountIdMap(legacyState) {
+    const accounts = readPath(legacyState, [
+        'AccountsController',
+        'internalAccounts',
+        'accounts',
+    ]);
+    if (!(0, utils_1.isObject)(accounts)) {
+        return {};
+    }
+    const map = {};
+    for (const [id, account] of Object.entries(accounts)) {
+        if ((0, utils_1.isObject)(account) &&
+            typeof account.address === 'string' &&
+            account.address.length > 0) {
+            map[account.address.toLowerCase()] = id;
+        }
+    }
+    return map;
+}
+/**
+ * Collect the set of CAIP-19 asset IDs (lowercased) marked `hidden: true` in
+ * the current `assetPreferences`. Lowercasing lets callers compare against
+ * checksummed asset IDs case-insensitively.
+ *
+ * @param currentState - Current `AssetsController` state slices.
+ * @returns Set of lowercase hidden asset IDs.
+ */
+function collectHiddenAssetIds(currentState) {
+    const hidden = new Set();
+    for (const [assetId, preference] of Object.entries(currentState.assetPreferences)) {
+        if ((0, utils_1.isObject)(preference) && preference.hidden === true) {
+            hidden.add(assetId.toLowerCase());
+        }
+    }
+    return hidden;
+}
+/**
+ * Collect the lowercase token addresses ignored (hidden) in the legacy
+ * `TokensController.allIgnoredTokens` for a given chain and account. The
+ * account key is matched case-insensitively.
+ *
+ * @param allIgnoredTokens - The legacy `allIgnoredTokens` map (possibly missing).
+ * @param hexChainId - The hex chain ID being processed.
+ * @param accountAddress - The account address whose ignored list to read.
+ * @returns Set of lowercase ignored token addresses.
+ */
+function collectIgnoredAddresses(allIgnoredTokens, hexChainId, accountAddress) {
+    const result = new Set();
+    if (!(0, utils_1.isObject)(allIgnoredTokens)) {
+        return result;
+    }
+    const chainEntry = allIgnoredTokens[hexChainId];
+    if (!(0, utils_1.isObject)(chainEntry)) {
+        return result;
+    }
+    const lowerAccount = accountAddress.toLowerCase();
+    for (const [address, list] of Object.entries(chainEntry)) {
+        if (address.toLowerCase() !== lowerAccount || !Array.isArray(list)) {
+            continue;
+        }
+        for (const ignored of list) {
+            if (typeof ignored === 'string') {
+                result.add(ignored.toLowerCase());
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Convert a hex chain ID (e.g. '0x1') to a CAIP-2 chain ID (e.g. 'eip155:1').
+ *
+ * @param hexChainId - The hex-encoded EVM chain ID.
+ * @returns The CAIP-2 chain ID, or `null` when the input cannot be parsed.
+ */
+function hexChainIdToCaip2(hexChainId) {
+    if (!/^0x[0-9a-fA-F]+$/u.test(hexChainId)) {
+        return null;
+    }
+    const decimal = Number.parseInt(hexChainId, 16);
+    if (!Number.isFinite(decimal)) {
+        return null;
+    }
+    return `${EVM_CHAIN_NAMESPACE}:${decimal}`;
+}
+/**
+ * Build the checksummed CAIP-19 asset ID for an ERC-20 token.
+ *
+ * @param caip2 - The CAIP-2 chain ID (e.g. 'eip155:14').
+ * @param tokenAddress - The ERC-20 contract address.
+ * @returns The asset ID, or `null` when the address cannot be checksummed.
+ */
+function buildErc20AssetId(caip2, tokenAddress) {
+    let checksummed;
+    try {
+        checksummed = (0, utils_1.getChecksumAddress)(tokenAddress);
+    }
+    catch {
+        return null;
+    }
+    return `${caip2}/erc20:${checksummed}`;
+}
+/**
+ * Read a nested path on an unknown value, returning `undefined` if any
+ * intermediate key is missing or not an object.
+ *
+ * @param root - The value to read from.
+ * @param path - Sequence of keys to traverse.
+ * @returns The value at the path, or `undefined`.
+ */
+function readPath(root, path) {
+    return path.reduce((cursor, key) => {
+        if (!(0, utils_1.isObject)(cursor) || !(0, utils_1.hasProperty)(cursor, key)) {
+            return undefined;
+        }
+        return cursor[key];
+    }, root);
+}
+/**
+ * Record `assetId` as a custom-asset addition for `accountId` unless it is
+ * already tracked in the current `assetsBalance` (mutual exclusion), already
+ * present in the current `customAssets`, or already queued as an addition.
+ *
+ * @param currentState - Current `AssetsController` state slices.
+ * @param additions - The custom-asset additions accumulated so far (mutated).
+ * @param accountId - The account UUID.
+ * @param assetId - CAIP-19 asset identifier.
+ */
+function addCustomAssetAddition(currentState, additions, accountId, assetId) {
+    if (currentState.assetsBalance[accountId]?.[assetId]) {
+        return;
+    }
+    if (currentState.customAssets[accountId]?.includes(assetId)) {
+        return;
+    }
+    const queued = additions[accountId] ?? [];
+    if (!queued.includes(assetId)) {
+        queued.push(assetId);
+    }
+    additions[accountId] = queued;
+}
+const cleanupLog = (0, logger_js_1.createModuleLogger)(logger_js_1.projectLogger, 'cleanSpamAssets');
+/**
+ * TEMPORARY — feature flag for unlock spam cleanup
+ *
+ * @param remoteFeatureFlags - RemoteFeatureFlag state.
+ * @returns `true` only when the flag explicitly enables the cleanup.
+ */
+function isUnlockCleanupEnabled(remoteFeatureFlags) {
+    if (!(0, utils_1.isObject)(remoteFeatureFlags)) {
+        return false;
+    }
+    const flag = remoteFeatureFlags.assetsUnifyState;
+    return ((0, utils_1.isObject)(flag) &&
+        (0, utils_1.hasProperty)(flag, 'useUnlockCleanup') &&
+        flag.useUnlockCleanup === true);
+}
+exports.isUnlockCleanupEnabled = isUnlockCleanupEnabled;
+const FETCH_TIMEOUT_MS = 15000;
+const DEFAULT_OCCURRENCE_FLOOR = 3;
+/**
+ * Cleanup of Spam Assets.
+ * The state can be persisted with spam tokens through boundary faults (API loosened, WS passing in spam)
+ *
+ * @param options - Input params.
+ * @param options.state - Current controller state (read-only).
+ * @param options.apiClient - Token API client.
+ * @param options.captureException - Optional reporter for failures.
+ * @returns Updated or original controller state
+ */
+async function cleanSpamAssets({ state, apiClient, captureException, }) {
+    const candidates = collectSpamCleanupCandidates(state);
+    if (candidates.length === 0) {
+        return null;
+    }
+    try {
+        const floors = await fetchSuggestedOccurrenceFloors(apiClient);
+        const spamAssetIds = [];
+        for (const batch of (0, batch_js_1.divideIntoBatches)(candidates, {
+            batchSize: 50,
+        })) {
+            const belowFloorAssetIds = await findBelowFloorAssetIds(batch, floors, apiClient).catch(() => []);
+            if (belowFloorAssetIds.length > 0) {
+                cleanupLog('Classified a batch of assets as spam', {
+                    batchSize: batch.length,
+                    spamCount: belowFloorAssetIds.length,
+                });
+                spamAssetIds.push(...belowFloorAssetIds);
+            }
+        }
+        if (spamAssetIds.length === 0) {
+            return null;
+        }
+        return { spamAssetIds, applyPatch: applyCleanupPatch };
+    }
+    catch (error) {
+        // API calls failed, cleanup not performed. Will be retried when next invoked.
+        cleanupLog('Spam cleanup failed; leaving remaining assets untouched', error);
+        captureException?.(new Error(`AssetsController: assetsInfo spam cleanup failed: ${(0, utils_1.getErrorMessage)(error)}`));
+        return null;
+    }
+}
+exports.cleanSpamAssets = cleanSpamAssets;
+/**
+ * Collect the assets eligible for cleanup:
+ * - ERC-20 token
+ * - Not in excluded list
+ * - Not a custom asset
+ * - On Account API covered chains
+ *
+ * @param state - Current controller state.
+ * @param state.assetsInfo - Tracked asset metadata, keyed by CAIP-19 ID.
+ * @param state.customAssets - Per-account custom asset IDs.
+ * @returns Candidate asset IDs.
+ */
+function collectSpamCleanupCandidates({ assetsInfo, customAssets, }) {
+    const customAssetIds = new Set(Object.values(customAssets)
+        .flat()
+        .map((assetId) => assetId.toLowerCase()));
+    const excludedAssets = [...defaults_js_1.DEFAULT_TRACKED_ASSETS_BY_CHAIN.values()]
+        .flat()
+        .map((a) => a.toLowerCase());
+    return Object.keys(assetsInfo).filter((assetId) => {
+        const lowerId = assetId.toLowerCase();
+        const [chainId, asset] = lowerId.split('/');
+        const isERC20 = Boolean(asset?.startsWith('erc20:'));
+        const isNotExcluded = !excludedAssets.includes(lowerId);
+        const isNotCustomAsset = !customAssetIds.has(lowerId);
+        const isOnAccountAPICoveredChain = ACCOUNT_API_SUPPORTED_CHAIN_IDS.has(chainId);
+        return (isERC20 && isNotExcluded && isNotCustomAsset && isOnAccountAPICoveredChain);
+    });
+}
+/**
+ * Fetch and filter assets by occurrence floor.
+ * If fetch fails, error is propagated (fail-close, cleanup not performed)
+ *
+ * @param assetIds - A single batch of candidate asset IDs.
+ * @param floors - Suggested occurrence floors keyed by decimal chain ID.
+ * @param apiClient - Token API client.
+ * @returns The subset of `assetIds` that falls below its chain's floor.
+ */
+async function findBelowFloorAssetIds(assetIds, floors, apiClient) {
+    try {
+        const assets = await (0, fetchWithTimeout_js_1.fetchWithTimeout)(() => apiClient.tokens.fetchV3Assets(assetIds, { includeOccurrences: true }, { staleTime: 0, gcTime: 0 }), FETCH_TIMEOUT_MS);
+        const occurrencesByLowerId = new Map(assets.map((asset) => [asset.assetId.toLowerCase(), asset.occurrences]));
+        return assetIds.filter((assetId) => {
+            const chainReference = assetId.split(':')[1]?.split('/')[0] ?? '';
+            const floor = floors[chainReference] ?? DEFAULT_OCCURRENCE_FLOOR;
+            return (occurrencesByLowerId.get(assetId.toLowerCase()) ?? 0) < floor;
+        });
+    }
+    catch (error) {
+        cleanupLog('Failed to fetch assets', error);
+        throw error;
+    }
+}
+/**
+ * Fetch per-chain suggested occurrence floors.
+ * If fetch fails, error is propagated (fail-close, cleanup not performed)
+ *
+ * @param apiClient - Token API client.
+ * @returns Map of decimal chain ID to suggested floor.
+ */
+async function fetchSuggestedOccurrenceFloors(apiClient) {
+    try {
+        return await (0, fetchWithTimeout_js_1.fetchWithTimeout)(() => apiClient.token.fetchV1SuggestedOccurrenceFloors({
+            staleTime: 0,
+            gcTime: 0,
+        }), FETCH_TIMEOUT_MS);
+    }
+    catch (error) {
+        cleanupLog('Failed to fetch suggested occurrence floors', error);
+        throw error;
+    }
+}
+function applyCleanupPatch(state, patch) {
+    const { spamAssetIds } = patch;
+    const spam = new Set(spamAssetIds.map((assetId) => assetId.toLowerCase()));
+    if (spam.size === 0) {
+        return;
+    }
+    const isSpam = (assetId) => spam.has(assetId.toLowerCase());
+    for (const assetId of Object.keys(state.assetsInfo).filter(isSpam)) {
+        delete state.assetsInfo[assetId];
+    }
+    for (const balances of Object.values(state.assetsBalance)) {
+        for (const assetId of Object.keys(balances).filter(isSpam)) {
+            delete balances[assetId];
+        }
+    }
+    cleanupLog('Removed spam assets', { count: spam.size });
+}
+//# sourceMappingURL=healAssetsInfoMetadata.cjs.map

package/dist/migrations/healAssetsInfoMetadata.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"healAssetsInfoMetadata.cjs","sourceRoot":"","sources":["../../src/migrations/healAssetsInfoMetadata.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AccountsControllerState } from '@metamask/accounts-controller';\nimport type { TokensControllerState } from '@metamask/assets-controllers';\nimport type { ApiPlatformClient } from '@metamask/core-backend';\nimport type { Hex } from '@metamask/utils';\nimport {\n  getChecksumAddress,\n  getErrorMessage,\n  hasProperty,\n  isObject,\n} from '@metamask/utils';\nimport { cloneDeep } from 'lodash';\n\nimport { divideIntoBatches } from '../data-sources/evm-rpc-services/utils/batch.js';\nimport { DEFAULT_TRACKED_ASSETS_BY_CHAIN } from '../defaults.js';\nimport { createModuleLogger, projectLogger } from '../logger.js';\nimport type {\n  AccountId,\n  Caip19AssetId,\n  FungibleAssetMetadata,\n  AssetsControllerStateInternal,\n} from '../types.js';\nimport { fetchWithTimeout } from '../utils/fetchWithTimeout.js';\n\n/**\n * TEMPORARY MODULE — remove in a future release.\n *\n * Port of extension migration #215 (Assets Controller Metadata Healing).\n * Issue: https://consensyssoftware.atlassian.net/browse/ASSETS-3346\n * Incident: #incident-metamask-1731\n *\n * Background: after a prior defect in AssetsController, metadata for custom\n * tokens was wiped. Most popular chains support auto-detection and can\n * self-heal, however not all.\n *\n * This module computes the state additions needed to restore metadata for\n * custom tokens on niche EVM chains (chains that cannot auto-detect and\n * self-heal), using the legacy `TokensController.allTokens` state as the\n * source of truth. It is a pure function so it can be tested in isolation;\n * the controller applies the returned patch in its constructor.\n *\n * The legacy state is treated as fully untrusted (`unknown`): every shape is\n * validated before use, and any unexpected input results in that entry being\n * skipped (or `null` being returned when nothing is restorable).\n */\n\n/**\n * The slices of current `AssetsController` state the healing computation\n * reads. Never mutated.\n */\nexport type CurrentAssetsState = Pick<\n  AssetsControllerStateInternal,\n  'assetsInfo' | 'assetsBalance' | 'customAssets' | 'assetPreferences'\n>;\n\n/**\n * TEMPORARY — will be removed in a future release.\n *\n * Shape of the legacy persisted state the ASSETS-3346 healing reads, derived\n * from the real `TokensControllerState` and `AccountsControllerState` types.\n * Use it to type the `tempMigrateAssetsInfoMetadataAssets3346` getter when\n * integrating in a client.\n *\n * Everything is optional and only the listed slices are read:\n *\n * - `TokensController.allTokens` — required for any healing to happen.\n * - `TokensController.allIgnoredTokens` — tokens the user hid/removed\n *   (skipped during healing).\n * - `AccountsController.internalAccounts.accounts` — maps addresses to\n *   account IDs so healed tokens are also tracked in `customAssets`\n *   (without it only `assetsInfo` is healed).\n *\n * At runtime the value still crosses the boundary as `unknown`: every shape\n * is re-validated by the migration, so a partial or malformed object is safe\n * and simply skipped.\n */\nexport type Assets3346MigrationState = {\n  // eslint-disable-next-line @typescript-eslint/naming-convention -- must match the persisted controller state key\n  TokensController?: Partial<\n    Pick<TokensControllerState, 'allTokens' | 'allIgnoredTokens'>\n  >;\n  // eslint-disable-next-line @typescript-eslint/naming-convention -- must match the persisted controller state key\n  AccountsController?: {\n    internalAccounts?: {\n      accounts?: Record<\n        string,\n        Pick<\n          AccountsControllerState['internalAccounts']['accounts'][string],\n          'address'\n        >\n      >;\n    };\n  };\n};\n\nexport type AssetsInfoHealingPatch = {\n  assetsInfo: Record<Caip19AssetId, FungibleAssetMetadata>;\n  customAssets: Record<AccountId, Caip19AssetId[]>;\n};\n\nconst log = createModuleLogger(projectLogger, 'tempHealAssetsInfoMetadata');\n\nexport type TempHealAssetsInfoMetadataOptions = {\n  /** Current `AssetsController` state the healing patch is computed against. */\n  state: AssetsControllerStateInternal;\n  /**\n   * Host-provided getter for the untrusted legacy state root (see\n   * `AssetsControllerOptions.tempMigrateAssetsInfoMetadataAssets3346`).\n   */\n  getMigrationState: () => unknown;\n  /** Optional Sentry-compatible reporter for healing failures. */\n  captureException?: (error: Error) => void;\n};\n\n/**\n * TEMPORARY — will be removed in a future release.\n *\n * @param options - The options bag.\n * @param options.state - Current controller state to compute the patch against.\n * @param options.getMigrationState - Getter for the untrusted legacy state root.\n * @param options.captureException - Optional reporter for healing failures.\n * @returns Updated controller state with the healing patch applied, or the\n * original state when there is nothing to heal or healing fails.\n */\nexport function tempHealAssetsInfoMetadata({\n  state,\n  getMigrationState,\n  captureException,\n}: TempHealAssetsInfoMetadataOptions): AssetsControllerStateInternal {\n  const reportError = (error: unknown): void => {\n    log('Failed to heal assetsInfo metadata', error);\n    captureException?.(\n      new Error(\n        `AssetsController: temporary assetsInfo metadata healing failed: ${getErrorMessage(\n          error,\n        )}`,\n      ),\n    );\n  };\n\n  let patch: AssetsInfoHealingPatch | null = null;\n  try {\n    patch = healAssetsInfoMetadata(getMigrationState(), state);\n  } catch (error) {\n    reportError(error);\n  }\n\n  if (!patch) {\n    return state;\n  }\n\n  try {\n    const nextState = cloneDeep(state);\n    applyHealingPatch(nextState, patch);\n\n    log('Healed wiped assetsInfo metadata for niche-chain tokens', {\n      healedAssetsInfoCount: Object.keys(patch.assetsInfo).length,\n      healedCustomAssetsAccounts: Object.keys(patch.customAssets).length,\n    });\n\n    return nextState;\n  } catch (error) {\n    reportError(error);\n    return state;\n  }\n}\n\n/**\n * Apply a healing patch to (draft) controller state. Defensive against\n * concurrent writes: fills `assetsInfo` gaps only and dedupes `customAssets`\n * against the current draft rather than trusting the patch blindly.\n *\n * @param state - Mutable controller state copy.\n * @param patch - The additions computed by {@link healAssetsInfoMetadata}.\n */\nfunction applyHealingPatch(\n  state: CurrentAssetsState,\n  patch: AssetsInfoHealingPatch,\n): void {\n  for (const [assetId, metadata] of Object.entries(patch.assetsInfo)) {\n    state.assetsInfo[assetId as Caip19AssetId] ??= metadata;\n  }\n\n  for (const [accountId, assetIds] of Object.entries(patch.customAssets)) {\n    const existing = state.customAssets[accountId] ?? [];\n    state.customAssets[accountId] = [\n      ...existing,\n      ...assetIds.filter((assetId) => !existing.includes(assetId)),\n    ];\n  }\n}\n\nconst EVM_CHAIN_NAMESPACE = 'eip155';\n\nconst EVM_ADDRESS_REGEX = /^0x[0-9a-fA-F]{40}$/u;\n\n/**\n * Popular networks (covered by the Accounts API) can self-heal through\n * auto-detection, so their tokens must not be touched. Frozen snapshot from\n * extension migration #215.\n */\nconst ACCOUNT_API_SUPPORTED_CHAIN_IDS: ReadonlySet<string> = new Set([\n  'eip155:1', // Ethereum Mainnet\n  'eip155:10', // Optimism\n  'eip155:56', // BNB Smart Chain\n  'eip155:137', // Polygon\n  'eip155:143', // Monad\n  'eip155:999', // HyperEVM\n  'eip155:1329', // Sei\n  'eip155:5042', // Arc\n  'eip155:8453', // Base\n  'eip155:42161', // Arbitrum One\n  'eip155:43114', // Avalanche\n  'eip155:59144', // Linea\n]);\n\n/**\n * Compute the additions required to heal `assetsInfo` metadata (and custom\n * asset tracking) for tokens on niche EVM chains, based on the legacy\n * `TokensController` state.\n *\n * What it deliberately skips:\n *\n * - Accounts-API-supported chains — see `ACCOUNT_API_SUPPORTED_CHAIN_IDS`.\n * - Tokens the user hid/removed, detected via either the legacy\n *   `TokensController.allIgnoredTokens` or the current\n *   `assetPreferences` (`hidden: true`).\n * - Non-EVM assets, ERC-721s, and tokens with invalid addresses or metadata.\n *\n * @param legacyState - Untrusted legacy state root. Expected (but not\n * required) to contain `TokensController.allTokens`,\n * `TokensController.allIgnoredTokens`, and\n * `AccountsController.internalAccounts.accounts`.\n * @param currentState - Current `AssetsController` state slices (read-only).\n * @returns The additions to apply, or `null` when there is nothing to heal.\n */\nexport function healAssetsInfoMetadata(\n  legacyState: unknown,\n  currentState: CurrentAssetsState,\n): AssetsInfoHealingPatch | null {\n  const allTokens = readPath(legacyState, ['TokensController', 'allTokens']);\n  if (!isObject(allTokens)) {\n    return null;\n  }\n\n  const addressToAccountId = buildAddressToAccountIdMap(legacyState);\n  const hiddenAssetIds = collectHiddenAssetIds(currentState);\n  const allIgnoredTokens = readPath(legacyState, [\n    'TokensController',\n    'allIgnoredTokens',\n  ]);\n\n  const assetsInfoAdditions: Record<Caip19AssetId, FungibleAssetMetadata> = {};\n  const customAssetAdditions: Record<AccountId, Caip19AssetId[]> = {};\n\n  for (const [hexChainId, accountTokens] of Object.entries(allTokens)) {\n    if (!isObject(accountTokens)) {\n      continue;\n    }\n\n    const caip2 = hexChainIdToCaip2(hexChainId);\n    // Skip chains we can't parse or that self-heal via the accounts API.\n    if (!caip2 || ACCOUNT_API_SUPPORTED_CHAIN_IDS.has(caip2)) {\n      continue;\n    }\n\n    for (const [rawAddress, tokens] of Object.entries(accountTokens)) {\n      if (!Array.isArray(tokens) || tokens.length === 0) {\n        continue;\n      }\n\n      const accountId = addressToAccountId[rawAddress.toLowerCase()];\n      const ignoredAddresses = collectIgnoredAddresses(\n        allIgnoredTokens,\n        hexChainId,\n        rawAddress,\n      );\n\n      for (const token of tokens) {\n        const restorable = getRestorableAsset(\n          token,\n          caip2,\n          ignoredAddresses,\n          hiddenAssetIds,\n        );\n        if (!restorable) {\n          continue;\n        }\n        const { assetId, info } = restorable;\n\n        // `assetsInfo` is a global registry; fill gaps only, never overwrite.\n        if (\n          currentState.assetsInfo[assetId] === undefined &&\n          assetsInfoAdditions[assetId] === undefined\n        ) {\n          assetsInfoAdditions[assetId] = info;\n        }\n\n        // Ensure the asset is tracked for its account.\n        if (accountId) {\n          addCustomAssetAddition(\n            currentState,\n            customAssetAdditions,\n            accountId,\n            assetId,\n          );\n        }\n      }\n    }\n  }\n\n  if (\n    Object.keys(assetsInfoAdditions).length === 0 &&\n    Object.keys(customAssetAdditions).length === 0\n  ) {\n    return null;\n  }\n\n  return {\n    assetsInfo: assetsInfoAdditions,\n    customAssets: customAssetAdditions,\n  };\n}\n\n/**\n * Resolve a raw `TokensController` token entry to the CAIP-19 asset ID and\n * metadata that should be healed, or `null` when the token must be skipped\n * (not an object, missing/invalid address or symbol, an ERC-721, or hidden\n * in either the legacy or the current controller).\n *\n * @param token - Raw token entry from `allTokens`.\n * @param caip2 - The CAIP-2 chain ID of the token's chain (e.g. 'eip155:14').\n * @param ignoredAddresses - Lowercase addresses hidden via legacy `allIgnoredTokens`.\n * @param hiddenAssetIds - Lowercase asset IDs hidden via current `assetPreferences`.\n * @returns The restorable asset, or `null` to skip.\n */\nfunction getRestorableAsset(\n  token: unknown,\n  caip2: string,\n  ignoredAddresses: Set<string>,\n  hiddenAssetIds: Set<string>,\n): { assetId: Caip19AssetId; info: FungibleAssetMetadata } | null {\n  if (!isObject(token)) {\n    return null;\n  }\n  // Skip NFTs — AssetsController tracks them separately.\n  if (token.isERC721 === true) {\n    return null;\n  }\n  if (\n    typeof token.address !== 'string' ||\n    !EVM_ADDRESS_REGEX.test(token.address)\n  ) {\n    return null;\n  }\n  // Healed metadata with no symbol would be unusable in the UI; skip it.\n  if (typeof token.symbol !== 'string' || token.symbol.length === 0) {\n    return null;\n  }\n\n  const assetId = buildErc20AssetId(caip2, token.address as Hex);\n  if (!assetId) {\n    return null;\n  }\n\n  // Skip tokens the user hid/removed — in the legacy controller…\n  if (ignoredAddresses.has(token.address.toLowerCase())) {\n    return null;\n  }\n  // …or in the current controller.\n  if (hiddenAssetIds.has(assetId.toLowerCase())) {\n    return null;\n  }\n\n  return { assetId, info: buildEvmAssetInfo(token) };\n}\n\n/**\n * Build a `FungibleAssetMetadata` from a raw `TokensController` token entry.\n * The caller has already validated `symbol` as a non-empty string.\n *\n * @param token - Raw token object.\n * @returns The metadata to write into `assetsInfo`.\n */\nfunction buildEvmAssetInfo(\n  token: Record<string, unknown>,\n): FungibleAssetMetadata {\n  const symbol = token.symbol as string;\n  const name =\n    typeof token.name === 'string' && token.name.length > 0\n      ? token.name\n      : symbol;\n  const decimals =\n    typeof token.decimals === 'number' && Number.isFinite(token.decimals)\n      ? token.decimals\n      : 0;\n\n  const image =\n    typeof token.image === 'string' && token.image.length > 0\n      ? token.image\n      : undefined;\n  const aggregators = Array.isArray(token.aggregators)\n    ? token.aggregators.filter(\n        (aggregator): aggregator is string => typeof aggregator === 'string',\n      )\n    : undefined;\n\n  return {\n    type: 'erc20',\n    symbol,\n    name,\n    decimals,\n    ...(image ? { image } : {}),\n    ...(aggregators ? { aggregators } : {}),\n  };\n}\n\n/**\n * Build a map from lowercase account address to account UUID using the\n * legacy `AccountsController.internalAccounts.accounts`.\n *\n * @param legacyState - Untrusted legacy state root.\n * @returns Map of lowercase address to account ID (empty on invalid input).\n */\nfunction buildAddressToAccountIdMap(\n  legacyState: unknown,\n): Record<string, AccountId> {\n  const accounts = readPath(legacyState, [\n    'AccountsController',\n    'internalAccounts',\n    'accounts',\n  ]);\n  if (!isObject(accounts)) {\n    return {};\n  }\n\n  const map: Record<string, AccountId> = {};\n  for (const [id, account] of Object.entries(accounts)) {\n    if (\n      isObject(account) &&\n      typeof account.address === 'string' &&\n      account.address.length > 0\n    ) {\n      map[account.address.toLowerCase()] = id;\n    }\n  }\n  return map;\n}\n\n/**\n * Collect the set of CAIP-19 asset IDs (lowercased) marked `hidden: true` in\n * the current `assetPreferences`. Lowercasing lets callers compare against\n * checksummed asset IDs case-insensitively.\n *\n * @param currentState - Current `AssetsController` state slices.\n * @returns Set of lowercase hidden asset IDs.\n */\nfunction collectHiddenAssetIds(currentState: CurrentAssetsState): Set<string> {\n  const hidden = new Set<string>();\n  for (const [assetId, preference] of Object.entries(\n    currentState.assetPreferences,\n  )) {\n    if (isObject(preference) && preference.hidden === true) {\n      hidden.add(assetId.toLowerCase());\n    }\n  }\n  return hidden;\n}\n\n/**\n * Collect the lowercase token addresses ignored (hidden) in the legacy\n * `TokensController.allIgnoredTokens` for a given chain and account. The\n * account key is matched case-insensitively.\n *\n * @param allIgnoredTokens - The legacy `allIgnoredTokens` map (possibly missing).\n * @param hexChainId - The hex chain ID being processed.\n * @param accountAddress - The account address whose ignored list to read.\n * @returns Set of lowercase ignored token addresses.\n */\nfunction collectIgnoredAddresses(\n  allIgnoredTokens: unknown,\n  hexChainId: string,\n  accountAddress: string,\n): Set<string> {\n  const result = new Set<string>();\n  if (!isObject(allIgnoredTokens)) {\n    return result;\n  }\n\n  const chainEntry = allIgnoredTokens[hexChainId];\n  if (!isObject(chainEntry)) {\n    return result;\n  }\n\n  const lowerAccount = accountAddress.toLowerCase();\n  for (const [address, list] of Object.entries(chainEntry)) {\n    if (address.toLowerCase() !== lowerAccount || !Array.isArray(list)) {\n      continue;\n    }\n    for (const ignored of list) {\n      if (typeof ignored === 'string') {\n        result.add(ignored.toLowerCase());\n      }\n    }\n  }\n  return result;\n}\n\n/**\n * Convert a hex chain ID (e.g. '0x1') to a CAIP-2 chain ID (e.g. 'eip155:1').\n *\n * @param hexChainId - The hex-encoded EVM chain ID.\n * @returns The CAIP-2 chain ID, or `null` when the input cannot be parsed.\n */\nfunction hexChainIdToCaip2(hexChainId: string): string | null {\n  if (!/^0x[0-9a-fA-F]+$/u.test(hexChainId)) {\n    return null;\n  }\n  const decimal = Number.parseInt(hexChainId, 16);\n  if (!Number.isFinite(decimal)) {\n    return null;\n  }\n  return `${EVM_CHAIN_NAMESPACE}:${decimal}`;\n}\n\n/**\n * Build the checksummed CAIP-19 asset ID for an ERC-20 token.\n *\n * @param caip2 - The CAIP-2 chain ID (e.g. 'eip155:14').\n * @param tokenAddress - The ERC-20 contract address.\n * @returns The asset ID, or `null` when the address cannot be checksummed.\n */\nfunction buildErc20AssetId(\n  caip2: string,\n  tokenAddress: Hex,\n): Caip19AssetId | null {\n  let checksummed: string;\n  try {\n    checksummed = getChecksumAddress(tokenAddress);\n  } catch {\n    return null;\n  }\n  return `${caip2}/erc20:${checksummed}` as Caip19AssetId;\n}\n\n/**\n * Read a nested path on an unknown value, returning `undefined` if any\n * intermediate key is missing or not an object.\n *\n * @param root - The value to read from.\n * @param path - Sequence of keys to traverse.\n * @returns The value at the path, or `undefined`.\n */\nfunction readPath(root: unknown, path: string[]): unknown {\n  return path.reduce<unknown>((cursor, key) => {\n    if (!isObject(cursor) || !hasProperty(cursor, key)) {\n      return undefined;\n    }\n    return cursor[key];\n  }, root);\n}\n\n/**\n * Record `assetId` as a custom-asset addition for `accountId` unless it is\n * already tracked in the current `assetsBalance` (mutual exclusion), already\n * present in the current `customAssets`, or already queued as an addition.\n *\n * @param currentState - Current `AssetsController` state slices.\n * @param additions - The custom-asset additions accumulated so far (mutated).\n * @param accountId - The account UUID.\n * @param assetId - CAIP-19 asset identifier.\n */\nfunction addCustomAssetAddition(\n  currentState: CurrentAssetsState,\n  additions: Record<AccountId, Caip19AssetId[]>,\n  accountId: AccountId,\n  assetId: Caip19AssetId,\n): void {\n  if (currentState.assetsBalance[accountId]?.[assetId]) {\n    return;\n  }\n  if (currentState.customAssets[accountId]?.includes(assetId)) {\n    return;\n  }\n\n  const queued = additions[accountId] ?? [];\n  if (!queued.includes(assetId)) {\n    queued.push(assetId);\n  }\n  additions[accountId] = queued;\n}\n\nconst cleanupLog = createModuleLogger(projectLogger, 'cleanSpamAssets');\n\n/**\n * TEMPORARY — feature flag for unlock spam cleanup\n *\n * @param remoteFeatureFlags - RemoteFeatureFlag state.\n * @returns `true` only when the flag explicitly enables the cleanup.\n */\nexport function isUnlockCleanupEnabled(remoteFeatureFlags: unknown): boolean {\n  if (!isObject(remoteFeatureFlags)) {\n    return false;\n  }\n\n  const flag = remoteFeatureFlags.assetsUnifyState;\n  return (\n    isObject(flag) &&\n    hasProperty(flag, 'useUnlockCleanup') &&\n    flag.useUnlockCleanup === true\n  );\n}\n\nconst FETCH_TIMEOUT_MS = 15_000;\nconst DEFAULT_OCCURRENCE_FLOOR = 3;\n\n/** The slices of Token API surface the cleanup uses. */\nexport type SpamTokensApiClient = Pick<ApiPlatformClient, 'tokens' | 'token'>;\n\nexport type CleanSpamAssetsState = Pick<\n  AssetsControllerStateInternal,\n  'assetsInfo' | 'assetsBalance' | 'customAssets'\n>;\n\nexport type CleanSpamAssetsOptions = {\n  state: CleanSpamAssetsState;\n  apiClient: SpamTokensApiClient;\n  captureException?: (error: Error) => void;\n};\n\n/**\n * Cleanup of Spam Assets.\n * The state can be persisted with spam tokens through boundary faults (API loosened, WS passing in spam)\n *\n * @param options - Input params.\n * @param options.state - Current controller state (read-only).\n * @param options.apiClient - Token API client.\n * @param options.captureException - Optional reporter for failures.\n * @returns Updated or original controller state\n */\nexport async function cleanSpamAssets({\n  state,\n  apiClient,\n  captureException,\n}: CleanSpamAssetsOptions): Promise<{\n  spamAssetIds: Caip19AssetId[];\n  applyPatch: typeof applyCleanupPatch;\n} | null> {\n  const candidates = collectSpamCleanupCandidates(state);\n  if (candidates.length === 0) {\n    return null;\n  }\n\n  try {\n    const floors = await fetchSuggestedOccurrenceFloors(apiClient);\n    const spamAssetIds: Caip19AssetId[] = [];\n\n    for (const batch of divideIntoBatches(candidates, {\n      batchSize: 50,\n    })) {\n      const belowFloorAssetIds = await findBelowFloorAssetIds(\n        batch,\n        floors,\n        apiClient,\n      ).catch(() => []);\n      if (belowFloorAssetIds.length > 0) {\n        cleanupLog('Classified a batch of assets as spam', {\n          batchSize: batch.length,\n          spamCount: belowFloorAssetIds.length,\n        });\n        spamAssetIds.push(...belowFloorAssetIds);\n      }\n    }\n\n    if (spamAssetIds.length === 0) {\n      return null;\n    }\n\n    return { spamAssetIds, applyPatch: applyCleanupPatch };\n  } catch (error) {\n    // API calls failed, cleanup not performed. Will be retried when next invoked.\n    cleanupLog(\n      'Spam cleanup failed; leaving remaining assets untouched',\n      error,\n    );\n    captureException?.(\n      new Error(\n        `AssetsController: assetsInfo spam cleanup failed: ${getErrorMessage(\n          error,\n        )}`,\n      ),\n    );\n    return null;\n  }\n}\n\n/**\n * Collect the assets eligible for cleanup:\n * - ERC-20 token\n * - Not in excluded list\n * - Not a custom asset\n * - On Account API covered chains\n *\n * @param state - Current controller state.\n * @param state.assetsInfo - Tracked asset metadata, keyed by CAIP-19 ID.\n * @param state.customAssets - Per-account custom asset IDs.\n * @returns Candidate asset IDs.\n */\nfunction collectSpamCleanupCandidates({\n  assetsInfo,\n  customAssets,\n}: Pick<CleanSpamAssetsState, 'assetsInfo' | 'customAssets'>): Caip19AssetId[] {\n  const customAssetIds = new Set(\n    Object.values(customAssets)\n      .flat()\n      .map((assetId) => assetId.toLowerCase()),\n  );\n\n  const excludedAssets = [...DEFAULT_TRACKED_ASSETS_BY_CHAIN.values()]\n    .flat()\n    .map((a) => a.toLowerCase());\n\n  return (Object.keys(assetsInfo) as Caip19AssetId[]).filter((assetId) => {\n    const lowerId = assetId.toLowerCase();\n    const [chainId, asset] = lowerId.split('/');\n\n    const isERC20 = Boolean(asset?.startsWith('erc20:'));\n    const isNotExcluded = !excludedAssets.includes(lowerId);\n    const isNotCustomAsset = !customAssetIds.has(lowerId);\n    const isOnAccountAPICoveredChain =\n      ACCOUNT_API_SUPPORTED_CHAIN_IDS.has(chainId);\n\n    return (\n      isERC20 && isNotExcluded && isNotCustomAsset && isOnAccountAPICoveredChain\n    );\n  });\n}\n\n/**\n * Fetch and filter assets by occurrence floor.\n * If fetch fails, error is propagated (fail-close, cleanup not performed)\n *\n * @param assetIds - A single batch of candidate asset IDs.\n * @param floors - Suggested occurrence floors keyed by decimal chain ID.\n * @param apiClient - Token API client.\n * @returns The subset of `assetIds` that falls below its chain's floor.\n */\nasync function findBelowFloorAssetIds(\n  assetIds: Caip19AssetId[],\n  floors: Record<string, number>,\n  apiClient: SpamTokensApiClient,\n): Promise<Caip19AssetId[]> {\n  try {\n    const assets = await fetchWithTimeout(\n      () =>\n        apiClient.tokens.fetchV3Assets(\n          assetIds,\n          { includeOccurrences: true },\n          { staleTime: 0, gcTime: 0 },\n        ),\n      FETCH_TIMEOUT_MS,\n    );\n\n    const occurrencesByLowerId = new Map(\n      assets.map((asset) => [asset.assetId.toLowerCase(), asset.occurrences]),\n    );\n\n    return assetIds.filter((assetId) => {\n      const chainReference = assetId.split(':')[1]?.split('/')[0] ?? '';\n      const floor = floors[chainReference] ?? DEFAULT_OCCURRENCE_FLOOR;\n      return (occurrencesByLowerId.get(assetId.toLowerCase()) ?? 0) < floor;\n    });\n  } catch (error) {\n    cleanupLog('Failed to fetch assets', error);\n    throw error;\n  }\n}\n\n/**\n * Fetch per-chain suggested occurrence floors.\n * If fetch fails, error is propagated (fail-close, cleanup not performed)\n *\n * @param apiClient - Token API client.\n * @returns Map of decimal chain ID to suggested floor.\n */\nasync function fetchSuggestedOccurrenceFloors(\n  apiClient: SpamTokensApiClient,\n): Promise<Record<string, number>> {\n  try {\n    return await fetchWithTimeout(\n      () =>\n        apiClient.token.fetchV1SuggestedOccurrenceFloors({\n          staleTime: 0,\n          gcTime: 0,\n        }),\n      FETCH_TIMEOUT_MS,\n    );\n  } catch (error) {\n    cleanupLog('Failed to fetch suggested occurrence floors', error);\n    throw error;\n  }\n}\n\nfunction applyCleanupPatch(\n  state: Pick<CleanSpamAssetsState, 'assetsInfo' | 'assetsBalance'>,\n  patch: {\n    spamAssetIds: Caip19AssetId[];\n  },\n): void {\n  const { spamAssetIds } = patch;\n\n  const spam = new Set(spamAssetIds.map((assetId) => assetId.toLowerCase()));\n  if (spam.size === 0) {\n    return;\n  }\n  const isSpam = (assetId: string): boolean => spam.has(assetId.toLowerCase());\n\n  for (const assetId of Object.keys(state.assetsInfo).filter(isSpam)) {\n    delete state.assetsInfo[assetId as Caip19AssetId];\n  }\n  for (const balances of Object.values(state.assetsBalance)) {\n    for (const assetId of Object.keys(balances).filter(isSpam)) {\n      delete balances[assetId as Caip19AssetId];\n    }\n  }\n\n  cleanupLog('Removed spam assets', { count: spam.size });\n}\n"]}

package/dist/migrations/{healAssetsInfoMetadata.d.ts → healAssetsInfoMetadata.d.cts}

@@ -1,7 +1,7 @@
-import type { AccountsControllerState } from '@metamask/accounts-controller';
-import type { TokensControllerState } from '@metamask/assets-controllers';
-import type { ApiPlatformClient } from '@metamask/core-backend';
-import type { AccountId, Caip19AssetId, FungibleAssetMetadata, AssetsControllerStateInternal } from '../types.js';
+import type { AccountsControllerState } from "@metamask/accounts-controller";
+import type { TokensControllerState } from "@metamask/assets-controllers";
+import type { ApiPlatformClient } from "@metamask/core-backend";
+import type { AccountId, Caip19AssetId, FungibleAssetMetadata, AssetsControllerStateInternal } from "../types.cjs";
 /**
  * TEMPORARY MODULE — remove in a future release.
  *
@@ -137,4 +137,4 @@ declare function applyCleanupPatch(state: Pick<CleanSpamAssetsState, 'assetsInfo
     spamAssetIds: Caip19AssetId[];
 }): void;
 export {};
-//# sourceMappingURL=healAssetsInfoMetadata.d.ts.map
+//# sourceMappingURL=healAssetsInfoMetadata.d.cts.map

package/dist/migrations/healAssetsInfoMetadata.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healAssetsInfoMetadata.d.cts","sourceRoot":"","sources":["../../src/migrations/healAssetsInfoMetadata.ts"],"names":[],"mappings":"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"}