@metamask-previews/assets-controller 11.0.0-preview-44376e0 → 11.0.0-preview-4343321

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

@@ -1,113 +0,0 @@
-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.
- *
- * 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.cts.map

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

@@ -1 +0,0 @@
-{"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,qBAAiB;AAExC;;;;;;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

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

@@ -1 +0,0 @@
-{"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,qBAAiB;AAExC;;;;;;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.mjs

@@ -1,162 +0,0 @@
-import { parseCaipChainId } from "@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}.
- */
-export 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 || (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.
- */
-export const 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}.
- */
-export const 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.
- */
-export function getSnapsAssetsMigrationNamespace(chainId) {
-    try {
-        const { namespace } = parseCaipChainId(chainId);
-        return SNAPS_ASSETS_MIGRATION_NAMESPACES.includes(namespace)
-            ? namespace
-            : undefined;
-    }
-    catch {
-        return 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 function isSnapsAssetsMigrationNamespace(chainId) {
-    return getSnapsAssetsMigrationNamespace(chainId) !== undefined;
-}
-/**
- * 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 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;
-    }
-}
-/**
- * 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 function isMigrationStageActive(stage) {
-    return stage >= SnapsAssetsMigrationStage.ReadAssetsControllerWithFallback;
-}
-/**
- * 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 function getMigrationStages(remoteFeatureFlags) {
-    return SNAPS_ASSETS_MIGRATION_NAMESPACES.map((namespace) => parseSnapsAssetsMigrationStage(remoteFeatureFlags[SNAPS_ASSETS_MIGRATION_FLAG_KEYS[namespace]]));
-}
-/**
- * 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 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?.[SNAPS_ASSETS_MIGRATION_FLAG_KEYS[namespace]]);
-    return isMigrationStageActive(stage);
-}
-//# sourceMappingURL=snaps-assets-migration.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"snaps-assets-migration.mjs","sourceRoot":"","sources":["../../src/utils/snaps-assets-migration.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,wBAAwB;AAInD;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,yBAqBX;AArBD,WAAY,yBAAyB;IACnC;;;OAGG;IACH,uEAAO,CAAA;IACP;;;;OAIG;IACH,iIAAoC,CAAA;IACpC;;;OAGG;IACH,uIAAuC,CAAA;IACvC;;OAEG;IACH,iHAA4B,CAAA;AAC9B,CAAC,EArBW,yBAAyB,KAAzB,yBAAyB,QAqBpC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,QAAQ;IACR,SAAS;IACT,MAAM;CACE,CAAC;AAKX;;;;GAIG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAGzC;IACF,MAAM,EAAE,mCAAmC;IAC3C,OAAO,EAAE,oCAAoC;IAC7C,IAAI,EAAE,iCAAiC;CACxC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAC9C,OAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,EAAE,SAAS,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAChD,OAAQ,iCAAuD,CAAC,QAAQ,CACtE,SAAS,CACV;YACC,CAAC,CAAE,SAA2C;YAC9C,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,+BAA+B,CAAC,OAAgB;IAC9D,OAAO,gCAAgC,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,8BAA8B,CAC5C,SAA2B;IAE3B,IACE,OAAO,SAAS,KAAK,QAAQ;QAC7B,SAAS,KAAK,IAAI;QAClB,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EACxB,CAAC;QACD,OAAO,yBAAyB,CAAC,GAAG,CAAC;IACvC,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,SAAgC,CAAC;IACnD,MAAM,OAAO,GACX,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAClE,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,EAAE,KAAK,EAAE,GAAG,OAA8B,CAAC;IACjD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,yBAAyB,CAAC,gCAAgC,CAAC;QAChE,KAAK,yBAAyB,CAAC,mCAAmC,CAAC;QACnE,KAAK,yBAAyB,CAAC,wBAAwB;YACrD,OAAO,KAAK,CAAC;QACf;YACE,OAAO,yBAAyB,CAAC,GAAG,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAgC;IAEhC,OAAO,KAAK,IAAI,yBAAyB,CAAC,gCAAgC,CAAC;AAC7E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,kBAAgC;IAEhC,OAAO,iCAAiC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CACzD,8BAA8B,CAC5B,kBAAkB,CAAC,gCAAgC,CAAC,SAAS,CAAC,CAAC,CAChE,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAgB,EAChB,kBAA4C;IAE5C,MAAM,SAAS,GAAG,gCAAgC,CAAC,OAAO,CAAC,CAAC;IAC5D,4DAA4D;IAC5D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,8BAA8B,CAC1C,kBAAkB,EAAE,CAAC,gCAAgC,CAAC,SAAS,CAAC,CAAC,CAClE,CAAC;IACF,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC","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';\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"]}