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

package/dist/utils/normalizeAssetId.cjs

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearNormalizeAssetIdCacheForTesting = exports.safeNormalizeAssetId = exports.normalizeAssetId = void 0;
+const util_1 = require("@ethereumjs/util");
+const utils_1 = require("@metamask/utils");
+const memoize_1 = __importDefault(require("lodash/memoize.js"));
+/**
+ * Normalizes a CAIP-19 asset ID by checksumming EVM addresses.
+ * This ensures consistent asset IDs regardless of the data source format.
+ *
+ * For EVM ERC20 tokens (e.g., "eip155:1/erc20:0x..."), the address is checksummed.
+ * All other asset types are returned unchanged.
+ *
+ * Results are memoized with lodash: repeated calls with the same ID (common after
+ * the first pipeline pass, when IDs are already checksummed) skip re-parsing and
+ * keccak256 checksum work.
+ *
+ * @param assetId - The CAIP-19 asset ID to normalize
+ * @returns The normalized asset ID with checksummed address (for EVM tokens)
+ */
+exports.normalizeAssetId = (0, memoize_1.default)((assetId) => {
+    const parsed = (0, utils_1.parseCaipAssetType)(assetId);
+    const chainIdParsed = (0, utils_1.parseCaipChainId)(parsed.chainId);
+    // Only checksum EVM ERC20 addresses
+    if (chainIdParsed.namespace === 'eip155' &&
+        parsed.assetNamespace === 'erc20') {
+        const checksummedAddress = (0, util_1.toChecksumAddress)(parsed.assetReference);
+        return `${parsed.chainId}/${parsed.assetNamespace}:${checksummedAddress}`;
+    }
+    return assetId;
+});
+/**
+ * Normalize a CAIP-19 asset ID, returning the original on failure. Some
+ * malformed IDs (e.g. an asset reference that fails address checksumming)
+ * make {@link normalizeAssetId} throw; callers processing untrusted input
+ * use this so one bad ID cannot abort a whole batch.
+ *
+ * @param assetId - The CAIP-19 asset ID to normalize.
+ * @returns The normalized ID, or the original on failure.
+ */
+function safeNormalizeAssetId(assetId) {
+    try {
+        return (0, exports.normalizeAssetId)(assetId);
+    }
+    catch {
+        return assetId;
+    }
+}
+exports.safeNormalizeAssetId = safeNormalizeAssetId;
+/**
+ * Clears the {@link normalizeAssetId} memoize cache. Exported for unit tests.
+ */
+function clearNormalizeAssetIdCacheForTesting() {
+    exports.normalizeAssetId.cache.clear?.();
+}
+exports.clearNormalizeAssetIdCacheForTesting = clearNormalizeAssetIdCacheForTesting;
+//# sourceMappingURL=normalizeAssetId.cjs.map

package/dist/utils/normalizeAssetId.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeAssetId.cjs","sourceRoot":"","sources":["../../src/utils/normalizeAssetId.ts"],"names":[],"mappings":";;;;;;AAAA,2CAAqD;AACrD,2CAAuE;AAEvE,gEAAqC;AAIrC;;;;;;;;;;;;;GAaG;AACU,QAAA,gBAAgB,GACR,IAAA,iBAAO,EAAC,CAAC,OAAsB,EAAiB,EAAE;IACrE,MAAM,MAAM,GAAG,IAAA,0BAAkB,EAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,IAAA,wBAAgB,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEvD,oCAAoC;IACpC,IACE,aAAa,CAAC,SAAS,KAAK,QAAQ;QACpC,MAAM,CAAC,cAAc,KAAK,OAAO,EACjC,CAAC;QACD,MAAM,kBAAkB,GAAG,IAAA,wBAAiB,EAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACpE,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,cAAc,IAAI,kBAAkB,EAAmB,CAAC;IAC7F,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,SAAgB,oBAAoB,CAAC,OAAsB;IACzD,IAAI,CAAC;QACH,OAAO,IAAA,wBAAgB,EAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAND,oDAMC;AAED;;GAEG;AACH,SAAgB,oCAAoC;IAClD,wBAAgB,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;AACnC,CAAC;AAFD,oFAEC","sourcesContent":["import { toChecksumAddress } from '@ethereumjs/util';\nimport { parseCaipAssetType, parseCaipChainId } from '@metamask/utils';\nimport type { MemoizedFunction } from 'lodash';\nimport memoize from 'lodash/memoize';\n\nimport type { Caip19AssetId } from '../types.js';\n\n/**\n * Normalizes a CAIP-19 asset ID by checksumming EVM addresses.\n * This ensures consistent asset IDs regardless of the data source format.\n *\n * For EVM ERC20 tokens (e.g., \"eip155:1/erc20:0x...\"), the address is checksummed.\n * All other asset types are returned unchanged.\n *\n * Results are memoized with lodash: repeated calls with the same ID (common after\n * the first pipeline pass, when IDs are already checksummed) skip re-parsing and\n * keccak256 checksum work.\n *\n * @param assetId - The CAIP-19 asset ID to normalize\n * @returns The normalized asset ID with checksummed address (for EVM tokens)\n */\nexport const normalizeAssetId: ((assetId: Caip19AssetId) => Caip19AssetId) &\n  MemoizedFunction = memoize((assetId: Caip19AssetId): Caip19AssetId => {\n  const parsed = parseCaipAssetType(assetId);\n  const chainIdParsed = parseCaipChainId(parsed.chainId);\n\n  // Only checksum EVM ERC20 addresses\n  if (\n    chainIdParsed.namespace === 'eip155' &&\n    parsed.assetNamespace === 'erc20'\n  ) {\n    const checksummedAddress = toChecksumAddress(parsed.assetReference);\n    return `${parsed.chainId}/${parsed.assetNamespace}:${checksummedAddress}` as Caip19AssetId;\n  }\n\n  return assetId;\n});\n\n/**\n * Normalize a CAIP-19 asset ID, returning the original on failure. Some\n * malformed IDs (e.g. an asset reference that fails address checksumming)\n * make {@link normalizeAssetId} throw; callers processing untrusted input\n * use this so one bad ID cannot abort a whole batch.\n *\n * @param assetId - The CAIP-19 asset ID to normalize.\n * @returns The normalized ID, or the original on failure.\n */\nexport function safeNormalizeAssetId(assetId: Caip19AssetId): Caip19AssetId {\n  try {\n    return normalizeAssetId(assetId);\n  } catch {\n    return assetId;\n  }\n}\n\n/**\n * Clears the {@link normalizeAssetId} memoize cache. Exported for unit tests.\n */\nexport function clearNormalizeAssetIdCacheForTesting(): void {\n  normalizeAssetId.cache.clear?.();\n}\n"]}

package/dist/utils/{normalizeAssetId.d.ts → normalizeAssetId.d.cts}

@@ -1,5 +1,5 @@
-import type { MemoizedFunction } from 'lodash';
-import type { Caip19AssetId } from '../types.js';
+import type { MemoizedFunction } from "lodash";
+import type { Caip19AssetId } from "../types.cjs";
 /**
  * Normalizes a CAIP-19 asset ID by checksumming EVM addresses.
  * This ensures consistent asset IDs regardless of the data source format.
@@ -29,4 +29,4 @@ export declare function safeNormalizeAssetId(assetId: Caip19AssetId): Caip19Asse
  * Clears the {@link normalizeAssetId} memoize cache. Exported for unit tests.
  */
 export declare function clearNormalizeAssetIdCacheForTesting(): void;
-//# sourceMappingURL=normalizeAssetId.d.ts.map
+//# sourceMappingURL=normalizeAssetId.d.cts.map

package/dist/utils/normalizeAssetId.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeAssetId.d.cts","sourceRoot":"","sources":["../../src/utils/normalizeAssetId.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe;AAG/C,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAoB;AAEjD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,aAAa,KAAK,aAAa,CAAC,GACxE,gBAcA,CAAC;AAEH;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAM1E;AAED;;GAEG;AACH,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D"}

package/dist/utils/normalizeAssetId.d.mts

@@ -0,0 +1,32 @@
+import type { MemoizedFunction } from "lodash";
+import type { Caip19AssetId } from "../types.mjs";
+/**
+ * Normalizes a CAIP-19 asset ID by checksumming EVM addresses.
+ * This ensures consistent asset IDs regardless of the data source format.
+ *
+ * For EVM ERC20 tokens (e.g., "eip155:1/erc20:0x..."), the address is checksummed.
+ * All other asset types are returned unchanged.
+ *
+ * Results are memoized with lodash: repeated calls with the same ID (common after
+ * the first pipeline pass, when IDs are already checksummed) skip re-parsing and
+ * keccak256 checksum work.
+ *
+ * @param assetId - The CAIP-19 asset ID to normalize
+ * @returns The normalized asset ID with checksummed address (for EVM tokens)
+ */
+export declare const normalizeAssetId: ((assetId: Caip19AssetId) => Caip19AssetId) & MemoizedFunction;
+/**
+ * Normalize a CAIP-19 asset ID, returning the original on failure. Some
+ * malformed IDs (e.g. an asset reference that fails address checksumming)
+ * make {@link normalizeAssetId} throw; callers processing untrusted input
+ * use this so one bad ID cannot abort a whole batch.
+ *
+ * @param assetId - The CAIP-19 asset ID to normalize.
+ * @returns The normalized ID, or the original on failure.
+ */
+export declare function safeNormalizeAssetId(assetId: Caip19AssetId): Caip19AssetId;
+/**
+ * Clears the {@link normalizeAssetId} memoize cache. Exported for unit tests.
+ */
+export declare function clearNormalizeAssetIdCacheForTesting(): void;
+//# sourceMappingURL=normalizeAssetId.d.mts.map

package/dist/utils/normalizeAssetId.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeAssetId.d.mts","sourceRoot":"","sources":["../../src/utils/normalizeAssetId.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe;AAG/C,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAoB;AAEjD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,aAAa,KAAK,aAAa,CAAC,GACxE,gBAcA,CAAC;AAEH;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAM1E;AAED;;GAEG;AACH,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D"}

package/dist/utils/{normalizeAssetId.js → normalizeAssetId.mjs}

@@ -1,6 +1,13 @@
-import { toChecksumAddress } from '@ethereumjs/util';
-import { parseCaipAssetType, parseCaipChainId } from '@metamask/utils';
-import { memoize } from 'lodash-es';
+function $importDefault(module) {
+    if (module?.__esModule) {
+        return module.default;
+    }
+    return module;
+}
+import { toChecksumAddress } from "@ethereumjs/util";
+import { parseCaipAssetType, parseCaipChainId } from "@metamask/utils";
+import $memoize from "lodash/memoize.js";
+const memoize = $importDefault($memoize);
 /**
  * Normalizes a CAIP-19 asset ID by checksumming EVM addresses.
  * This ensures consistent asset IDs regardless of the data source format.
@@ -49,4 +56,4 @@ export function safeNormalizeAssetId(assetId) {
 export function clearNormalizeAssetIdCacheForTesting() {
     normalizeAssetId.cache.clear?.();
 }
-//# sourceMappingURL=normalizeAssetId.js.map
+//# sourceMappingURL=normalizeAssetId.mjs.map

package/dist/utils/normalizeAssetId.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeAssetId.mjs","sourceRoot":"","sources":["../../src/utils/normalizeAssetId.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,iBAAiB,EAAE,yBAAyB;AACrD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,wBAAwB;AAEvE,OAAO,QAAO,0BAAuB;;AAIrC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,gBAAgB,GACR,OAAO,CAAC,CAAC,OAAsB,EAAiB,EAAE;IACrE,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEvD,oCAAoC;IACpC,IACE,aAAa,CAAC,SAAS,KAAK,QAAQ;QACpC,MAAM,CAAC,cAAc,KAAK,OAAO,EACjC,CAAC;QACD,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACpE,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,cAAc,IAAI,kBAAkB,EAAmB,CAAC;IAC7F,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAsB;IACzD,IAAI,CAAC;QACH,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oCAAoC;IAClD,gBAAgB,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;AACnC,CAAC","sourcesContent":["import { toChecksumAddress } from '@ethereumjs/util';\nimport { parseCaipAssetType, parseCaipChainId } from '@metamask/utils';\nimport type { MemoizedFunction } from 'lodash';\nimport memoize from 'lodash/memoize';\n\nimport type { Caip19AssetId } from '../types.js';\n\n/**\n * Normalizes a CAIP-19 asset ID by checksumming EVM addresses.\n * This ensures consistent asset IDs regardless of the data source format.\n *\n * For EVM ERC20 tokens (e.g., \"eip155:1/erc20:0x...\"), the address is checksummed.\n * All other asset types are returned unchanged.\n *\n * Results are memoized with lodash: repeated calls with the same ID (common after\n * the first pipeline pass, when IDs are already checksummed) skip re-parsing and\n * keccak256 checksum work.\n *\n * @param assetId - The CAIP-19 asset ID to normalize\n * @returns The normalized asset ID with checksummed address (for EVM tokens)\n */\nexport const normalizeAssetId: ((assetId: Caip19AssetId) => Caip19AssetId) &\n  MemoizedFunction = memoize((assetId: Caip19AssetId): Caip19AssetId => {\n  const parsed = parseCaipAssetType(assetId);\n  const chainIdParsed = parseCaipChainId(parsed.chainId);\n\n  // Only checksum EVM ERC20 addresses\n  if (\n    chainIdParsed.namespace === 'eip155' &&\n    parsed.assetNamespace === 'erc20'\n  ) {\n    const checksummedAddress = toChecksumAddress(parsed.assetReference);\n    return `${parsed.chainId}/${parsed.assetNamespace}:${checksummedAddress}` as Caip19AssetId;\n  }\n\n  return assetId;\n});\n\n/**\n * Normalize a CAIP-19 asset ID, returning the original on failure. Some\n * malformed IDs (e.g. an asset reference that fails address checksumming)\n * make {@link normalizeAssetId} throw; callers processing untrusted input\n * use this so one bad ID cannot abort a whole batch.\n *\n * @param assetId - The CAIP-19 asset ID to normalize.\n * @returns The normalized ID, or the original on failure.\n */\nexport function safeNormalizeAssetId(assetId: Caip19AssetId): Caip19AssetId {\n  try {\n    return normalizeAssetId(assetId);\n  } catch {\n    return assetId;\n  }\n}\n\n/**\n * Clears the {@link normalizeAssetId} memoize cache. Exported for unit tests.\n */\nexport function clearNormalizeAssetIdCacheForTesting(): void {\n  normalizeAssetId.cache.clear?.();\n}\n"]}

package/dist/utils/snaps-assets-migration.cjs

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldSupportChain = exports.getMigrationStages = exports.isMigrationStageActive = exports.parseSnapsAssetsMigrationStage = exports.isSnapsAssetsMigrationNamespace = exports.getSnapsAssetsMigrationNamespace = exports.SNAPS_ASSETS_MIGRATION_FLAG_KEYS = exports.SNAPS_ASSETS_MIGRATION_NAMESPACES = exports.SnapsAssetsMigrationStage = void 0;
+const utils_1 = require("@metamask/utils");
+/**
+ * Per-network rollout stage for the Snaps → AssetsController assets migration.
+ *
+ * The stage is resolved per CAIP-2 chain id, so each migration network (Solana,
+ * Stellar, Tron) advances and rolls back independently. A network with no flag
+ * (or an unknown/malformed value) resolves to {@link Off}.
+ */
+var SnapsAssetsMigrationStage;
+(function (SnapsAssetsMigrationStage) {
+    /**
+     * Status quo — the Snap uses its own AssetsService and the AssetsController
+     * does NOT ingest for the network.
+     */
+    SnapsAssetsMigrationStage[SnapsAssetsMigrationStage["Off"] = 0] = "Off";
+    /**
+     * The AssetsController ingests for the network (Account Activity WebSocket +
+     * AccountsAPI) and reads route through it, falling back to the Snap's
+     * AssetsService when the controller has no value.
+     */
+    SnapsAssetsMigrationStage[SnapsAssetsMigrationStage["ReadAssetsControllerWithFallback"] = 1] = "ReadAssetsControllerWithFallback";
+    /**
+     * Reads come from the AssetsController only (no fallback), but the Snap still
+     * tracks/persists in the background so rollback stays safe.
+     */
+    SnapsAssetsMigrationStage[SnapsAssetsMigrationStage["ReadAssetsControllerWithoutFallback"] = 2] = "ReadAssetsControllerWithoutFallback";
+    /**
+     * The Snap stops tracking/persisting; the AssetsController is the only source.
+     */
+    SnapsAssetsMigrationStage[SnapsAssetsMigrationStage["ReadAssetsControllerOnly"] = 3] = "ReadAssetsControllerOnly";
+})(SnapsAssetsMigrationStage || (exports.SnapsAssetsMigrationStage = SnapsAssetsMigrationStage = {}));
+/**
+ * CAIP-2 namespaces covered by the Snaps → AssetsController assets migration.
+ * Only chains in these namespaces are stage-gated; every other namespace
+ * (e.g. `eip155`) keeps its existing, ungated ingestion behavior.
+ */
+exports.SNAPS_ASSETS_MIGRATION_NAMESPACES = [
+    'solana',
+    'stellar',
+    'tron',
+];
+/**
+ * Per-network remote feature flag keys (LaunchDarkly) that drive the migration.
+ * Each flag's resolved value carries the {@link SnapsAssetsMigrationStage} for
+ * that network — see {@link parseSnapsAssetsMigrationStage}.
+ */
+exports.SNAPS_ASSETS_MIGRATION_FLAG_KEYS = {
+    solana: 'networkAssetsSnapsMigrationSolana',
+    stellar: 'networkAssetsSnapsMigrationStellar',
+    tron: 'networkAssetsSnapsMigrationTron',
+};
+/**
+ * Resolve the CAIP-2 namespace of a chain when it belongs to a migration
+ * network (Solana, Stellar, Tron).
+ *
+ * @param chainId - The CAIP-2 chain id.
+ * @returns The migration namespace, or `undefined` for any other chain.
+ */
+function getSnapsAssetsMigrationNamespace(chainId) {
+    try {
+        const { namespace } = (0, utils_1.parseCaipChainId)(chainId);
+        return exports.SNAPS_ASSETS_MIGRATION_NAMESPACES.includes(namespace)
+            ? namespace
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+exports.getSnapsAssetsMigrationNamespace = getSnapsAssetsMigrationNamespace;
+/**
+ * Whether a CAIP-2 chain id belongs to a network covered by the assets
+ * migration (Solana, Stellar, Tron).
+ *
+ * @param chainId - The CAIP-2 chain id to check.
+ * @returns True when the chain's namespace is a migration namespace.
+ */
+function isSnapsAssetsMigrationNamespace(chainId) {
+    return getSnapsAssetsMigrationNamespace(chainId) !== undefined;
+}
+exports.isSnapsAssetsMigrationNamespace = isSnapsAssetsMigrationNamespace;
+/**
+ * Coerce a resolved remote feature flag value into a {@link SnapsAssetsMigrationStage}.
+ *
+ * `RemoteFeatureFlagController` resolves a threshold-scoped flag to a
+ * `{ name, value }` variant, so the migration payload
+ * `{ featureVersion, minimumSnapVersion, stage }` (and thus `stage`) lives under
+ * `value` — the same nesting the sibling `assetsAccountsApiV6` flag uses. The
+ * top-level object is used as a fallback so a plain, unscoped `{ stage }`
+ * variation still resolves. Anything missing, malformed, or carrying an unknown
+ * `stage` resolves to {@link SnapsAssetsMigrationStage.Off}.
+ *
+ * @param flagValue - The resolved remote feature flag value for a network.
+ * @returns The migration stage.
+ */
+function parseSnapsAssetsMigrationStage(flagValue) {
+    if (typeof flagValue !== 'object' ||
+        flagValue === null ||
+        Array.isArray(flagValue)) {
+        return SnapsAssetsMigrationStage.Off;
+    }
+    const { value } = flagValue;
+    const payload = typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : flagValue;
+    const { stage } = payload;
+    switch (stage) {
+        case SnapsAssetsMigrationStage.ReadAssetsControllerWithFallback:
+        case SnapsAssetsMigrationStage.ReadAssetsControllerWithoutFallback:
+        case SnapsAssetsMigrationStage.ReadAssetsControllerOnly:
+            return stage;
+        default:
+            return SnapsAssetsMigrationStage.Off;
+    }
+}
+exports.parseSnapsAssetsMigrationStage = parseSnapsAssetsMigrationStage;
+/**
+ * Whether a network's migration stage is active, i.e. the AssetsController
+ * (rather than the Snap) is the source of assets for the network.
+ *
+ * A stage is active from {@link SnapsAssetsMigrationStage.ReadAssetsControllerWithFallback}
+ * onward and inactive at {@link SnapsAssetsMigrationStage.Off}.
+ *
+ * @param stage - The resolved per-network migration stage.
+ * @returns True when the migration is active for the network.
+ */
+function isMigrationStageActive(stage) {
+    return stage >= SnapsAssetsMigrationStage.ReadAssetsControllerWithFallback;
+}
+exports.isMigrationStageActive = isMigrationStageActive;
+/**
+ * Resolve the Snaps → AssetsController migration stage for each migration
+ * network (Solana, Stellar, Tron) from the remote feature flags. The order
+ * matches {@link SNAPS_ASSETS_MIGRATION_NAMESPACES}, so the result can be joined
+ * into a stable primitive signature for change detection.
+ *
+ * @param remoteFeatureFlags - The remote feature flags state to resolve stages from.
+ * @returns An array of each migration namespace's resolved stage.
+ */
+function getMigrationStages(remoteFeatureFlags) {
+    return exports.SNAPS_ASSETS_MIGRATION_NAMESPACES.map((namespace) => parseSnapsAssetsMigrationStage(remoteFeatureFlags[exports.SNAPS_ASSETS_MIGRATION_FLAG_KEYS[namespace]]));
+}
+exports.getMigrationStages = getMigrationStages;
+/**
+ * Whether a supported network should be surfaced as an active chain, gated by
+ * the Snaps → AssetsController migration feature flags.
+ *
+ * Non-migration namespaces (e.g. `eip155`) are always surfaced. Migration
+ * networks (Solana, Stellar, Tron) are only surfaced once their per-network
+ * stage reaches {@link SnapsAssetsMigrationStage.ReadAssetsControllerWithFallback};
+ * they are excluded when the stage is `Off` (also the fail-safe when the flag is
+ * missing or the flags are unavailable).
+ *
+ * @param chainId - The CAIP-2 chain id to check.
+ * @param remoteFeatureFlags - The remote feature flags state, or `undefined` when unavailable.
+ * @returns `true` when the chain should be surfaced as an active chain.
+ */
+function shouldSupportChain(chainId, remoteFeatureFlags) {
+    const namespace = getSnapsAssetsMigrationNamespace(chainId);
+    // Non-migration namespaces (e.g. `eip155`) are never gated.
+    if (!namespace) {
+        return true;
+    }
+    const stage = parseSnapsAssetsMigrationStage(remoteFeatureFlags?.[exports.SNAPS_ASSETS_MIGRATION_FLAG_KEYS[namespace]]);
+    return isMigrationStageActive(stage);
+}
+exports.shouldSupportChain = shouldSupportChain;
+//# sourceMappingURL=snaps-assets-migration.cjs.map

package/dist/utils/snaps-assets-migration.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"snaps-assets-migration.cjs","sourceRoot":"","sources":["../../src/utils/snaps-assets-migration.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FeatureFlags } from '@metamask/remote-feature-flag-controller';\nimport type { Json } from '@metamask/utils';\nimport { parseCaipChainId } from '@metamask/utils';\n\nimport type { ChainId } from '../types.js';\n\n/**\n * Per-network rollout stage for the Snaps → AssetsController assets migration.\n *\n * The stage is resolved per CAIP-2 chain id, so each migration network (Solana,\n * Stellar, Tron) advances and rolls back independently. A network with no flag\n * (or an unknown/malformed value) resolves to {@link Off}.\n */\nexport enum SnapsAssetsMigrationStage {\n  /**\n   * Status quo — the Snap uses its own AssetsService and the AssetsController\n   * does NOT ingest for the network.\n   */\n  Off = 0,\n  /**\n   * The AssetsController ingests for the network (Account Activity WebSocket +\n   * AccountsAPI) and reads route through it, falling back to the Snap's\n   * AssetsService when the controller has no value.\n   */\n  ReadAssetsControllerWithFallback = 1,\n  /**\n   * Reads come from the AssetsController only (no fallback), but the Snap still\n   * tracks/persists in the background so rollback stays safe.\n   */\n  ReadAssetsControllerWithoutFallback = 2,\n  /**\n   * The Snap stops tracking/persisting; the AssetsController is the only source.\n   */\n  ReadAssetsControllerOnly = 3,\n}\n\n/**\n * CAIP-2 namespaces covered by the Snaps → AssetsController assets migration.\n * Only chains in these namespaces are stage-gated; every other namespace\n * (e.g. `eip155`) keeps its existing, ungated ingestion behavior.\n */\nexport const SNAPS_ASSETS_MIGRATION_NAMESPACES = [\n  'solana',\n  'stellar',\n  'tron',\n] as const;\n\nexport type SnapsAssetsMigrationNamespace =\n  (typeof SNAPS_ASSETS_MIGRATION_NAMESPACES)[number];\n\n/**\n * Per-network remote feature flag keys (LaunchDarkly) that drive the migration.\n * Each flag's resolved value carries the {@link SnapsAssetsMigrationStage} for\n * that network — see {@link parseSnapsAssetsMigrationStage}.\n */\nexport const SNAPS_ASSETS_MIGRATION_FLAG_KEYS: Record<\n  SnapsAssetsMigrationNamespace,\n  string\n> = {\n  solana: 'networkAssetsSnapsMigrationSolana',\n  stellar: 'networkAssetsSnapsMigrationStellar',\n  tron: 'networkAssetsSnapsMigrationTron',\n};\n\n/**\n * Resolve the CAIP-2 namespace of a chain when it belongs to a migration\n * network (Solana, Stellar, Tron).\n *\n * @param chainId - The CAIP-2 chain id.\n * @returns The migration namespace, or `undefined` for any other chain.\n */\nexport function getSnapsAssetsMigrationNamespace(\n  chainId: ChainId,\n): SnapsAssetsMigrationNamespace | undefined {\n  try {\n    const { namespace } = parseCaipChainId(chainId);\n    return (SNAPS_ASSETS_MIGRATION_NAMESPACES as readonly string[]).includes(\n      namespace,\n    )\n      ? (namespace as SnapsAssetsMigrationNamespace)\n      : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Whether a CAIP-2 chain id belongs to a network covered by the assets\n * migration (Solana, Stellar, Tron).\n *\n * @param chainId - The CAIP-2 chain id to check.\n * @returns True when the chain's namespace is a migration namespace.\n */\nexport function isSnapsAssetsMigrationNamespace(chainId: ChainId): boolean {\n  return getSnapsAssetsMigrationNamespace(chainId) !== undefined;\n}\n\n/**\n * Coerce a resolved remote feature flag value into a {@link SnapsAssetsMigrationStage}.\n *\n * `RemoteFeatureFlagController` resolves a threshold-scoped flag to a\n * `{ name, value }` variant, so the migration payload\n * `{ featureVersion, minimumSnapVersion, stage }` (and thus `stage`) lives under\n * `value` — the same nesting the sibling `assetsAccountsApiV6` flag uses. The\n * top-level object is used as a fallback so a plain, unscoped `{ stage }`\n * variation still resolves. Anything missing, malformed, or carrying an unknown\n * `stage` resolves to {@link SnapsAssetsMigrationStage.Off}.\n *\n * @param flagValue - The resolved remote feature flag value for a network.\n * @returns The migration stage.\n */\nexport function parseSnapsAssetsMigrationStage(\n  flagValue: Json | undefined,\n): SnapsAssetsMigrationStage {\n  if (\n    typeof flagValue !== 'object' ||\n    flagValue === null ||\n    Array.isArray(flagValue)\n  ) {\n    return SnapsAssetsMigrationStage.Off;\n  }\n\n  const { value } = flagValue as { value?: unknown };\n  const payload =\n    typeof value === 'object' && value !== null && !Array.isArray(value)\n      ? value\n      : flagValue;\n\n  const { stage } = payload as { stage?: unknown };\n  switch (stage) {\n    case SnapsAssetsMigrationStage.ReadAssetsControllerWithFallback:\n    case SnapsAssetsMigrationStage.ReadAssetsControllerWithoutFallback:\n    case SnapsAssetsMigrationStage.ReadAssetsControllerOnly:\n      return stage;\n    default:\n      return SnapsAssetsMigrationStage.Off;\n  }\n}\n\n/**\n * Whether a network's migration stage is active, i.e. the AssetsController\n * (rather than the Snap) is the source of assets for the network.\n *\n * A stage is active from {@link SnapsAssetsMigrationStage.ReadAssetsControllerWithFallback}\n * onward and inactive at {@link SnapsAssetsMigrationStage.Off}.\n *\n * @param stage - The resolved per-network migration stage.\n * @returns True when the migration is active for the network.\n */\nexport function isMigrationStageActive(\n  stage: SnapsAssetsMigrationStage,\n): boolean {\n  return stage >= SnapsAssetsMigrationStage.ReadAssetsControllerWithFallback;\n}\n\n/**\n * Resolve the Snaps → AssetsController migration stage for each migration\n * network (Solana, Stellar, Tron) from the remote feature flags. The order\n * matches {@link SNAPS_ASSETS_MIGRATION_NAMESPACES}, so the result can be joined\n * into a stable primitive signature for change detection.\n *\n * @param remoteFeatureFlags - The remote feature flags state to resolve stages from.\n * @returns An array of each migration namespace's resolved stage.\n */\nexport function getMigrationStages(\n  remoteFeatureFlags: FeatureFlags,\n): SnapsAssetsMigrationStage[] {\n  return SNAPS_ASSETS_MIGRATION_NAMESPACES.map((namespace) =>\n    parseSnapsAssetsMigrationStage(\n      remoteFeatureFlags[SNAPS_ASSETS_MIGRATION_FLAG_KEYS[namespace]],\n    ),\n  );\n}\n\n/**\n * Whether a supported network should be surfaced as an active chain, gated by\n * the Snaps → AssetsController migration feature flags.\n *\n * Non-migration namespaces (e.g. `eip155`) are always surfaced. Migration\n * networks (Solana, Stellar, Tron) are only surfaced once their per-network\n * stage reaches {@link SnapsAssetsMigrationStage.ReadAssetsControllerWithFallback};\n * they are excluded when the stage is `Off` (also the fail-safe when the flag is\n * missing or the flags are unavailable).\n *\n * @param chainId - The CAIP-2 chain id to check.\n * @param remoteFeatureFlags - The remote feature flags state, or `undefined` when unavailable.\n * @returns `true` when the chain should be surfaced as an active chain.\n */\nexport function shouldSupportChain(\n  chainId: ChainId,\n  remoteFeatureFlags: FeatureFlags | undefined,\n): boolean {\n  const namespace = getSnapsAssetsMigrationNamespace(chainId);\n  // Non-migration namespaces (e.g. `eip155`) are never gated.\n  if (!namespace) {\n    return true;\n  }\n\n  const stage = parseSnapsAssetsMigrationStage(\n    remoteFeatureFlags?.[SNAPS_ASSETS_MIGRATION_FLAG_KEYS[namespace]],\n  );\n  return isMigrationStageActive(stage);\n}\n"]}

package/dist/utils/{snaps-assets-migration.d.ts → snaps-assets-migration.d.cts}

@@ -1,6 +1,6 @@
-import type { FeatureFlags } from '@metamask/remote-feature-flag-controller';
-import type { Json } from '@metamask/utils';
-import type { ChainId } from '../types.js';
+import type { FeatureFlags } from "@metamask/remote-feature-flag-controller";
+import type { Json } from "@metamask/utils";
+import type { ChainId } from "../types.cjs";
 /**
  * Per-network rollout stage for the Snaps → AssetsController assets migration.
  *
@@ -35,7 +35,7 @@ export declare enum SnapsAssetsMigrationStage {
  * Only chains in these namespaces are stage-gated; every other namespace
  * (e.g. `eip155`) keeps its existing, ungated ingestion behavior.
  */
-export declare const SNAPS_ASSETS_MIGRATION_NAMESPACES: readonly ['solana', 'stellar', 'tron'];
+export declare const SNAPS_ASSETS_MIGRATION_NAMESPACES: readonly ["solana", "stellar", "tron"];
 export type SnapsAssetsMigrationNamespace = (typeof SNAPS_ASSETS_MIGRATION_NAMESPACES)[number];
 /**
  * Per-network remote feature flag keys (LaunchDarkly) that drive the migration.
@@ -110,4 +110,4 @@ export declare function getMigrationStages(remoteFeatureFlags: FeatureFlags): Sn
  * @returns `true` when the chain should be surfaced as an active chain.
  */
 export declare function shouldSupportChain(chainId: ChainId, remoteFeatureFlags: FeatureFlags | undefined): boolean;
-//# sourceMappingURL=snaps-assets-migration.d.ts.map
+//# sourceMappingURL=snaps-assets-migration.d.cts.map

package/dist/utils/snaps-assets-migration.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snaps-assets-migration.d.cts","sourceRoot":"","sources":["../../src/utils/snaps-assets-migration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iDAAiD;AAC7E,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAG5C,OAAO,KAAK,EAAE,OAAO,EAAE,qBAAoB;AAE3C;;;;;;GAMG;AACH,oBAAY,yBAAyB;IACnC;;;OAGG;IACH,GAAG,IAAI;IACP;;;;OAIG;IACH,gCAAgC,IAAI;IACpC;;;OAGG;IACH,mCAAmC,IAAI;IACvC;;OAEG;IACH,wBAAwB,IAAI;CAC7B;AAED;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,wCAIpC,CAAC;AAEX,MAAM,MAAM,6BAA6B,GACvC,CAAC,OAAO,iCAAiC,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,EAAE,MAAM,CACnD,6BAA6B,EAC7B,MAAM,CAKP,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,OAAO,GACf,6BAA6B,GAAG,SAAS,CAW3C;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,IAAI,GAAG,SAAS,GAC1B,yBAAyB,CAwB3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAET;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,kBAAkB,EAAE,YAAY,GAC/B,yBAAyB,EAAE,CAM7B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,YAAY,GAAG,SAAS,GAC3C,OAAO,CAWT"}

package/dist/utils/snaps-assets-migration.d.mts

@@ -0,0 +1,113 @@
+import type { FeatureFlags } from "@metamask/remote-feature-flag-controller";
+import type { Json } from "@metamask/utils";
+import type { ChainId } from "../types.mjs";
+/**
+ * Per-network rollout stage for the Snaps → AssetsController assets migration.
+ *
+ * The stage is resolved per CAIP-2 chain id, so each migration network (Solana,
+ * Stellar, Tron) advances and rolls back independently. A network with no flag
+ * (or an unknown/malformed value) resolves to {@link Off}.
+ */
+export declare enum SnapsAssetsMigrationStage {
+    /**
+     * Status quo — the Snap uses its own AssetsService and the AssetsController
+     * does NOT ingest for the network.
+     */
+    Off = 0,
+    /**
+     * The AssetsController ingests for the network (Account Activity WebSocket +
+     * AccountsAPI) and reads route through it, falling back to the Snap's
+     * AssetsService when the controller has no value.
+     */
+    ReadAssetsControllerWithFallback = 1,
+    /**
+     * Reads come from the AssetsController only (no fallback), but the Snap still
+     * tracks/persists in the background so rollback stays safe.
+     */
+    ReadAssetsControllerWithoutFallback = 2,
+    /**
+     * The Snap stops tracking/persisting; the AssetsController is the only source.
+     */
+    ReadAssetsControllerOnly = 3
+}
+/**
+ * CAIP-2 namespaces covered by the Snaps → AssetsController assets migration.
+ * Only chains in these namespaces are stage-gated; every other namespace
+ * (e.g. `eip155`) keeps its existing, ungated ingestion behavior.
+ */
+export declare const SNAPS_ASSETS_MIGRATION_NAMESPACES: readonly ["solana", "stellar", "tron"];
+export type SnapsAssetsMigrationNamespace = (typeof SNAPS_ASSETS_MIGRATION_NAMESPACES)[number];
+/**
+ * Per-network remote feature flag keys (LaunchDarkly) that drive the migration.
+ * Each flag's resolved value carries the {@link SnapsAssetsMigrationStage} for
+ * that network — see {@link parseSnapsAssetsMigrationStage}.
+ */
+export declare const SNAPS_ASSETS_MIGRATION_FLAG_KEYS: Record<SnapsAssetsMigrationNamespace, string>;
+/**
+ * Resolve the CAIP-2 namespace of a chain when it belongs to a migration
+ * network (Solana, Stellar, Tron).
+ *
+ * @param chainId - The CAIP-2 chain id.
+ * @returns The migration namespace, or `undefined` for any other chain.
+ */
+export declare function getSnapsAssetsMigrationNamespace(chainId: ChainId): SnapsAssetsMigrationNamespace | undefined;
+/**
+ * Whether a CAIP-2 chain id belongs to a network covered by the assets
+ * migration (Solana, Stellar, Tron).
+ *
+ * @param chainId - The CAIP-2 chain id to check.
+ * @returns True when the chain's namespace is a migration namespace.
+ */
+export declare function isSnapsAssetsMigrationNamespace(chainId: ChainId): boolean;
+/**
+ * Coerce a resolved remote feature flag value into a {@link SnapsAssetsMigrationStage}.
+ *
+ * `RemoteFeatureFlagController` resolves a threshold-scoped flag to a
+ * `{ name, value }` variant, so the migration payload
+ * `{ featureVersion, minimumSnapVersion, stage }` (and thus `stage`) lives under
+ * `value` — the same nesting the sibling `assetsAccountsApiV6` flag uses. The
+ * top-level object is used as a fallback so a plain, unscoped `{ stage }`
+ * variation still resolves. Anything missing, malformed, or carrying an unknown
+ * `stage` resolves to {@link SnapsAssetsMigrationStage.Off}.
+ *
+ * @param flagValue - The resolved remote feature flag value for a network.
+ * @returns The migration stage.
+ */
+export declare function parseSnapsAssetsMigrationStage(flagValue: Json | undefined): SnapsAssetsMigrationStage;
+/**
+ * Whether a network's migration stage is active, i.e. the AssetsController
+ * (rather than the Snap) is the source of assets for the network.
+ *
+ * A stage is active from {@link SnapsAssetsMigrationStage.ReadAssetsControllerWithFallback}
+ * onward and inactive at {@link SnapsAssetsMigrationStage.Off}.
+ *
+ * @param stage - The resolved per-network migration stage.
+ * @returns True when the migration is active for the network.
+ */
+export declare function isMigrationStageActive(stage: SnapsAssetsMigrationStage): boolean;
+/**
+ * Resolve the Snaps → AssetsController migration stage for each migration
+ * network (Solana, Stellar, Tron) from the remote feature flags. The order
+ * matches {@link SNAPS_ASSETS_MIGRATION_NAMESPACES}, so the result can be joined
+ * into a stable primitive signature for change detection.
+ *
+ * @param remoteFeatureFlags - The remote feature flags state to resolve stages from.
+ * @returns An array of each migration namespace's resolved stage.
+ */
+export declare function getMigrationStages(remoteFeatureFlags: FeatureFlags): SnapsAssetsMigrationStage[];
+/**
+ * Whether a supported network should be surfaced as an active chain, gated by
+ * the Snaps → AssetsController migration feature flags.
+ *
+ * Non-migration namespaces (e.g. `eip155`) are always surfaced. Migration
+ * networks (Solana, Stellar, Tron) are only surfaced once their per-network
+ * stage reaches {@link SnapsAssetsMigrationStage.ReadAssetsControllerWithFallback};
+ * they are excluded when the stage is `Off` (also the fail-safe when the flag is
+ * missing or the flags are unavailable).
+ *
+ * @param chainId - The CAIP-2 chain id to check.
+ * @param remoteFeatureFlags - The remote feature flags state, or `undefined` when unavailable.
+ * @returns `true` when the chain should be surfaced as an active chain.
+ */
+export declare function shouldSupportChain(chainId: ChainId, remoteFeatureFlags: FeatureFlags | undefined): boolean;
+//# sourceMappingURL=snaps-assets-migration.d.mts.map

package/dist/utils/snaps-assets-migration.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snaps-assets-migration.d.mts","sourceRoot":"","sources":["../../src/utils/snaps-assets-migration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iDAAiD;AAC7E,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAG5C,OAAO,KAAK,EAAE,OAAO,EAAE,qBAAoB;AAE3C;;;;;;GAMG;AACH,oBAAY,yBAAyB;IACnC;;;OAGG;IACH,GAAG,IAAI;IACP;;;;OAIG;IACH,gCAAgC,IAAI;IACpC;;;OAGG;IACH,mCAAmC,IAAI;IACvC;;OAEG;IACH,wBAAwB,IAAI;CAC7B;AAED;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,wCAIpC,CAAC;AAEX,MAAM,MAAM,6BAA6B,GACvC,CAAC,OAAO,iCAAiC,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,EAAE,MAAM,CACnD,6BAA6B,EAC7B,MAAM,CAKP,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,OAAO,GACf,6BAA6B,GAAG,SAAS,CAW3C;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,IAAI,GAAG,SAAS,GAC1B,yBAAyB,CAwB3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAET;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,kBAAkB,EAAE,YAAY,GAC/B,yBAAyB,EAAE,CAM7B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,YAAY,GAAG,SAAS,GAC3C,OAAO,CAWT"}

package/dist/utils/{snaps-assets-migration.js → snaps-assets-migration.mjs}

@@ -1,4 +1,4 @@
-import { parseCaipChainId } from '@metamask/utils';
+import { parseCaipChainId } from "@metamask/utils";
 /**
  * Per-network rollout stage for the Snaps → AssetsController assets migration.
  *
@@ -159,4 +159,4 @@ export function shouldSupportChain(chainId, remoteFeatureFlags) {
     const stage = parseSnapsAssetsMigrationStage(remoteFeatureFlags?.[SNAPS_ASSETS_MIGRATION_FLAG_KEYS[namespace]]);
     return isMigrationStageActive(stage);
 }
-//# sourceMappingURL=snaps-assets-migration.js.map
+//# sourceMappingURL=snaps-assets-migration.mjs.map

package/dist/utils/snaps-assets-migration.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"snaps-assets-migration.mjs","sourceRoot":"","sources":["../../src/utils/snaps-assets-migration.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FeatureFlags } from '@metamask/remote-feature-flag-controller';\nimport type { Json } from '@metamask/utils';\nimport { parseCaipChainId } from '@metamask/utils';\n\nimport type { ChainId } from '../types.js';\n\n/**\n * Per-network rollout stage for the Snaps → AssetsController assets migration.\n *\n * The stage is resolved per CAIP-2 chain id, so each migration network (Solana,\n * Stellar, Tron) advances and rolls back independently. A network with no flag\n * (or an unknown/malformed value) resolves to {@link Off}.\n */\nexport enum SnapsAssetsMigrationStage {\n  /**\n   * Status quo — the Snap uses its own AssetsService and the AssetsController\n   * does NOT ingest for the network.\n   */\n  Off = 0,\n  /**\n   * The AssetsController ingests for the network (Account Activity WebSocket +\n   * AccountsAPI) and reads route through it, falling back to the Snap's\n   * AssetsService when the controller has no value.\n   */\n  ReadAssetsControllerWithFallback = 1,\n  /**\n   * Reads come from the AssetsController only (no fallback), but the Snap still\n   * tracks/persists in the background so rollback stays safe.\n   */\n  ReadAssetsControllerWithoutFallback = 2,\n  /**\n   * The Snap stops tracking/persisting; the AssetsController is the only source.\n   */\n  ReadAssetsControllerOnly = 3,\n}\n\n/**\n * CAIP-2 namespaces covered by the Snaps → AssetsController assets migration.\n * Only chains in these namespaces are stage-gated; every other namespace\n * (e.g. `eip155`) keeps its existing, ungated ingestion behavior.\n */\nexport const SNAPS_ASSETS_MIGRATION_NAMESPACES = [\n  'solana',\n  'stellar',\n  'tron',\n] as const;\n\nexport type SnapsAssetsMigrationNamespace =\n  (typeof SNAPS_ASSETS_MIGRATION_NAMESPACES)[number];\n\n/**\n * Per-network remote feature flag keys (LaunchDarkly) that drive the migration.\n * Each flag's resolved value carries the {@link SnapsAssetsMigrationStage} for\n * that network — see {@link parseSnapsAssetsMigrationStage}.\n */\nexport const SNAPS_ASSETS_MIGRATION_FLAG_KEYS: Record<\n  SnapsAssetsMigrationNamespace,\n  string\n> = {\n  solana: 'networkAssetsSnapsMigrationSolana',\n  stellar: 'networkAssetsSnapsMigrationStellar',\n  tron: 'networkAssetsSnapsMigrationTron',\n};\n\n/**\n * Resolve the CAIP-2 namespace of a chain when it belongs to a migration\n * network (Solana, Stellar, Tron).\n *\n * @param chainId - The CAIP-2 chain id.\n * @returns The migration namespace, or `undefined` for any other chain.\n */\nexport function getSnapsAssetsMigrationNamespace(\n  chainId: ChainId,\n): SnapsAssetsMigrationNamespace | undefined {\n  try {\n    const { namespace } = parseCaipChainId(chainId);\n    return (SNAPS_ASSETS_MIGRATION_NAMESPACES as readonly string[]).includes(\n      namespace,\n    )\n      ? (namespace as SnapsAssetsMigrationNamespace)\n      : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Whether a CAIP-2 chain id belongs to a network covered by the assets\n * migration (Solana, Stellar, Tron).\n *\n * @param chainId - The CAIP-2 chain id to check.\n * @returns True when the chain's namespace is a migration namespace.\n */\nexport function isSnapsAssetsMigrationNamespace(chainId: ChainId): boolean {\n  return getSnapsAssetsMigrationNamespace(chainId) !== undefined;\n}\n\n/**\n * Coerce a resolved remote feature flag value into a {@link SnapsAssetsMigrationStage}.\n *\n * `RemoteFeatureFlagController` resolves a threshold-scoped flag to a\n * `{ name, value }` variant, so the migration payload\n * `{ featureVersion, minimumSnapVersion, stage }` (and thus `stage`) lives under\n * `value` — the same nesting the sibling `assetsAccountsApiV6` flag uses. The\n * top-level object is used as a fallback so a plain, unscoped `{ stage }`\n * variation still resolves. Anything missing, malformed, or carrying an unknown\n * `stage` resolves to {@link SnapsAssetsMigrationStage.Off}.\n *\n * @param flagValue - The resolved remote feature flag value for a network.\n * @returns The migration stage.\n */\nexport function parseSnapsAssetsMigrationStage(\n  flagValue: Json | undefined,\n): SnapsAssetsMigrationStage {\n  if (\n    typeof flagValue !== 'object' ||\n    flagValue === null ||\n    Array.isArray(flagValue)\n  ) {\n    return SnapsAssetsMigrationStage.Off;\n  }\n\n  const { value } = flagValue as { value?: unknown };\n  const payload =\n    typeof value === 'object' && value !== null && !Array.isArray(value)\n      ? value\n      : flagValue;\n\n  const { stage } = payload as { stage?: unknown };\n  switch (stage) {\n    case SnapsAssetsMigrationStage.ReadAssetsControllerWithFallback:\n    case SnapsAssetsMigrationStage.ReadAssetsControllerWithoutFallback:\n    case SnapsAssetsMigrationStage.ReadAssetsControllerOnly:\n      return stage;\n    default:\n      return SnapsAssetsMigrationStage.Off;\n  }\n}\n\n/**\n * Whether a network's migration stage is active, i.e. the AssetsController\n * (rather than the Snap) is the source of assets for the network.\n *\n * A stage is active from {@link SnapsAssetsMigrationStage.ReadAssetsControllerWithFallback}\n * onward and inactive at {@link SnapsAssetsMigrationStage.Off}.\n *\n * @param stage - The resolved per-network migration stage.\n * @returns True when the migration is active for the network.\n */\nexport function isMigrationStageActive(\n  stage: SnapsAssetsMigrationStage,\n): boolean {\n  return stage >= SnapsAssetsMigrationStage.ReadAssetsControllerWithFallback;\n}\n\n/**\n * Resolve the Snaps → AssetsController migration stage for each migration\n * network (Solana, Stellar, Tron) from the remote feature flags. The order\n * matches {@link SNAPS_ASSETS_MIGRATION_NAMESPACES}, so the result can be joined\n * into a stable primitive signature for change detection.\n *\n * @param remoteFeatureFlags - The remote feature flags state to resolve stages from.\n * @returns An array of each migration namespace's resolved stage.\n */\nexport function getMigrationStages(\n  remoteFeatureFlags: FeatureFlags,\n): SnapsAssetsMigrationStage[] {\n  return SNAPS_ASSETS_MIGRATION_NAMESPACES.map((namespace) =>\n    parseSnapsAssetsMigrationStage(\n      remoteFeatureFlags[SNAPS_ASSETS_MIGRATION_FLAG_KEYS[namespace]],\n    ),\n  );\n}\n\n/**\n * Whether a supported network should be surfaced as an active chain, gated by\n * the Snaps → AssetsController migration feature flags.\n *\n * Non-migration namespaces (e.g. `eip155`) are always surfaced. Migration\n * networks (Solana, Stellar, Tron) are only surfaced once their per-network\n * stage reaches {@link SnapsAssetsMigrationStage.ReadAssetsControllerWithFallback};\n * they are excluded when the stage is `Off` (also the fail-safe when the flag is\n * missing or the flags are unavailable).\n *\n * @param chainId - The CAIP-2 chain id to check.\n * @param remoteFeatureFlags - The remote feature flags state, or `undefined` when unavailable.\n * @returns `true` when the chain should be surfaced as an active chain.\n */\nexport function shouldSupportChain(\n  chainId: ChainId,\n  remoteFeatureFlags: FeatureFlags | undefined,\n): boolean {\n  const namespace = getSnapsAssetsMigrationNamespace(chainId);\n  // Non-migration namespaces (e.g. `eip155`) are never gated.\n  if (!namespace) {\n    return true;\n  }\n\n  const stage = parseSnapsAssetsMigrationStage(\n    remoteFeatureFlags?.[SNAPS_ASSETS_MIGRATION_FLAG_KEYS[namespace]],\n  );\n  return isMigrationStageActive(stage);\n}\n"]}