@metamask-previews/assets-controller 14.0.2-preview-4f4c98e → 14.0.2-preview-eb263b0ee

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"]}

package/dist/utils/trace.cjs

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withTrace = exports.emitTrace = void 0;
+const DEFAULT_TAGS = {
+    controller: 'AssetsController',
+};
+/**
+ * Build request tags / startTime for MetaMask's Sentry adapter.
+ * Numeric `data` fields become tags (measurements); `duration_ms` backdates start.
+ *
+ * @param data - Span data attributes.
+ * @param tags - Caller tags.
+ * @param startTime - Optional explicit start override.
+ * @returns tags and optional startTime for the TraceRequest.
+ */
+function buildTraceTiming(data, tags, startTime) {
+    const numericFromData = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (typeof value === 'number') {
+            numericFromData[key] = value;
+        }
+    }
+    const requestTags = {
+        ...tags,
+        ...numericFromData,
+    };
+    if (startTime !== undefined) {
+        return { tags: requestTags, startTime };
+    }
+    const durationMs = typeof data.duration_ms === 'number' ? data.duration_ms : undefined;
+    if (durationMs === undefined) {
+        return { tags: requestTags };
+    }
+    return {
+        tags: requestTags,
+        startTime: performance.timeOrigin + performance.now() - durationMs,
+    };
+}
+/**
+ * Fire-and-forget Sentry span. Swallows errors so telemetry never breaks callers.
+ * Pass `parentContext` to nest as a subspan. Omit `trace` to skip emission.
+ *
+ * @param params - Span configuration.
+ * @param params.name - Trace / span name visible in Sentry.
+ * @param params.trace - Optional client trace callback; omit to no-op.
+ * @param params.data - Key-value pairs attached as span data.
+ * @param params.tags - Key-value pairs used for Sentry filtering.
+ * @param params.parentContext - Optional parent span context for nesting.
+ * @param params.startTime - Optional explicit start; else derived from `duration_ms`.
+ */
+function emitTrace({ name, trace, data, tags = DEFAULT_TAGS, parentContext, startTime: startTimeOverride, }) {
+    if (!trace) {
+        return;
+    }
+    const { tags: requestTags, startTime } = buildTraceTiming(data, tags, startTimeOverride);
+    trace({
+        name,
+        data,
+        tags: requestTags,
+        parentContext,
+        ...(startTime === undefined ? {} : { startTime }),
+    }, () => undefined)?.catch(() => {
+        // Telemetry failure must not break.
+    });
+}
+exports.emitTrace = emitTrace;
+/**
+ * Run work inside a parent Sentry span and pass its context for nested
+ * {@link emitTrace} subspans.
+ *
+ * When `trace` is omitted, runs `fn(undefined)` with no span.
+ * Telemetry failures are swallowed; errors from `fn` still propagate.
+ *
+ * @param params - Parent span config and work callback.
+ * @param params.name - Parent span name.
+ * @param params.trace - Optional client trace callback; omit to skip wrapping.
+ * @param params.data - Key-value pairs attached as span data.
+ * @param params.fn - Work to run; receives the parent span context.
+ * @param params.tags - Key-value pairs used for Sentry filtering.
+ * @param params.startTime - Optional explicit start; else derived from `duration_ms`.
+ * @returns The result of `fn`.
+ */
+async function withTrace({ name, trace, data, fn, tags = DEFAULT_TAGS, startTime: startTimeOverride, }) {
+    if (!trace) {
+        return fn(undefined);
+    }
+    const { tags: requestTags, startTime } = buildTraceTiming(data, tags, startTimeOverride);
+    let workResult;
+    try {
+        await trace({
+            name,
+            data,
+            tags: requestTags,
+            ...(startTime === undefined ? {} : { startTime }),
+        }, async (parentContext) => {
+            try {
+                const value = await fn(parentContext);
+                workResult = { ok: true, value };
+                return value;
+            }
+            catch (error) {
+                workResult = { ok: false, error };
+                throw error;
+            }
+        });
+    }
+    catch {
+        // Telemetry failure must not break — unless the work itself failed.
+    }
+    if (workResult === undefined) {
+        // `trace` failed before invoking `fn` (or never called it).
+        return fn(undefined);
+    }
+    if (workResult.ok) {
+        return workResult.value;
+    }
+    throw workResult.error;
+}
+exports.withTrace = withTrace;
+//# sourceMappingURL=trace.cjs.map

package/dist/utils/trace.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.cjs","sourceRoot":"","sources":["../../src/utils/trace.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TraceCallback, TraceContext } from '@metamask/controller-utils';\n\nconst DEFAULT_TAGS: Record<string, number | string | boolean> = {\n  controller: 'AssetsController',\n};\n\nexport type TraceSpanData = Record<string, number | string | boolean>;\n\nexport type EmitTraceParams = {\n  name: string;\n  /** When omitted / undefined, this is a no-op (bake call-site gating here). */\n  trace?: TraceCallback;\n  data: TraceSpanData;\n  tags?: TraceSpanData;\n  parentContext?: TraceContext;\n  /** Override span start; otherwise derived from `data.duration_ms` when present. */\n  startTime?: number;\n};\n\nexport type WithTraceParams<Result> = {\n  name: string;\n  /** When omitted / undefined, `fn` runs with no parent context. */\n  trace?: TraceCallback;\n  data: TraceSpanData;\n  fn: (parentContext?: TraceContext) => Promise<Result>;\n  tags?: TraceSpanData;\n  startTime?: number;\n};\n\n/**\n * Build request tags / startTime for MetaMask's Sentry adapter.\n * Numeric `data` fields become tags (measurements); `duration_ms` backdates start.\n *\n * @param data - Span data attributes.\n * @param tags - Caller tags.\n * @param startTime - Optional explicit start override.\n * @returns tags and optional startTime for the TraceRequest.\n */\nfunction buildTraceTiming(\n  data: TraceSpanData,\n  tags: TraceSpanData,\n  startTime?: number,\n): { tags: TraceSpanData; startTime?: number } {\n  const numericFromData: Record<string, number> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (typeof value === 'number') {\n      numericFromData[key] = value;\n    }\n  }\n  const requestTags = {\n    ...tags,\n    ...numericFromData,\n  };\n\n  if (startTime !== undefined) {\n    return { tags: requestTags, startTime };\n  }\n\n  const durationMs =\n    typeof data.duration_ms === 'number' ? data.duration_ms : undefined;\n  if (durationMs === undefined) {\n    return { tags: requestTags };\n  }\n\n  return {\n    tags: requestTags,\n    startTime: performance.timeOrigin + performance.now() - durationMs,\n  };\n}\n\n/**\n * Fire-and-forget Sentry span. Swallows errors so telemetry never breaks callers.\n * Pass `parentContext` to nest as a subspan. Omit `trace` to skip emission.\n *\n * @param params - Span configuration.\n * @param params.name - Trace / span name visible in Sentry.\n * @param params.trace - Optional client trace callback; omit to no-op.\n * @param params.data - Key-value pairs attached as span data.\n * @param params.tags - Key-value pairs used for Sentry filtering.\n * @param params.parentContext - Optional parent span context for nesting.\n * @param params.startTime - Optional explicit start; else derived from `duration_ms`.\n */\nexport function emitTrace({\n  name,\n  trace,\n  data,\n  tags = DEFAULT_TAGS,\n  parentContext,\n  startTime: startTimeOverride,\n}: EmitTraceParams): void {\n  if (!trace) {\n    return;\n  }\n\n  const { tags: requestTags, startTime } = buildTraceTiming(\n    data,\n    tags,\n    startTimeOverride,\n  );\n\n  trace(\n    {\n      name,\n      data,\n      tags: requestTags,\n      parentContext,\n      ...(startTime === undefined ? {} : { startTime }),\n    },\n    () => undefined,\n  )?.catch(() => {\n    // Telemetry failure must not break.\n  });\n}\n\n/**\n * Run work inside a parent Sentry span and pass its context for nested\n * {@link emitTrace} subspans.\n *\n * When `trace` is omitted, runs `fn(undefined)` with no span.\n * Telemetry failures are swallowed; errors from `fn` still propagate.\n *\n * @param params - Parent span config and work callback.\n * @param params.name - Parent span name.\n * @param params.trace - Optional client trace callback; omit to skip wrapping.\n * @param params.data - Key-value pairs attached as span data.\n * @param params.fn - Work to run; receives the parent span context.\n * @param params.tags - Key-value pairs used for Sentry filtering.\n * @param params.startTime - Optional explicit start; else derived from `duration_ms`.\n * @returns The result of `fn`.\n */\nexport async function withTrace<Result>({\n  name,\n  trace,\n  data,\n  fn,\n  tags = DEFAULT_TAGS,\n  startTime: startTimeOverride,\n}: WithTraceParams<Result>): Promise<Result> {\n  if (!trace) {\n    return fn(undefined);\n  }\n\n  const { tags: requestTags, startTime } = buildTraceTiming(\n    data,\n    tags,\n    startTimeOverride,\n  );\n\n  let workResult:\n    | { ok: true; value: Result }\n    | { ok: false; error: unknown }\n    | undefined;\n\n  try {\n    await trace(\n      {\n        name,\n        data,\n        tags: requestTags,\n        ...(startTime === undefined ? {} : { startTime }),\n      },\n      async (parentContext) => {\n        try {\n          const value = await fn(parentContext);\n          workResult = { ok: true, value };\n          return value;\n        } catch (error) {\n          workResult = { ok: false, error };\n          throw error;\n        }\n      },\n    );\n  } catch {\n    // Telemetry failure must not break — unless the work itself failed.\n  }\n\n  if (workResult === undefined) {\n    // `trace` failed before invoking `fn` (or never called it).\n    return fn(undefined);\n  }\n  if (workResult.ok) {\n    return workResult.value;\n  }\n  throw workResult.error;\n}\n"]}

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

@@ -1,4 +1,4 @@
-import type { TraceCallback, TraceContext } from '@metamask/controller-utils';
+import type { TraceCallback, TraceContext } from "@metamask/controller-utils";
 export type TraceSpanData = Record<string, number | string | boolean>;
 export type EmitTraceParams = {
     name: string;
@@ -49,4 +49,4 @@ export declare function emitTrace({ name, trace, data, tags, parentContext, star
  * @returns The result of `fn`.
  */
 export declare function withTrace<Result>({ name, trace, data, fn, tags, startTime: startTimeOverride, }: WithTraceParams<Result>): Promise<Result>;
-//# sourceMappingURL=trace.d.ts.map
+//# sourceMappingURL=trace.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.cts","sourceRoot":"","sources":["../../src/utils/trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,mCAAmC;AAM9E,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAEtE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,MAAM,IAAI;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AA2CF;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,IAAmB,EACnB,aAAa,EACb,SAAS,EAAE,iBAAiB,GAC7B,EAAE,eAAe,GAAG,IAAI,CAuBxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,EACtC,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,EAAE,EACF,IAAmB,EACnB,SAAS,EAAE,iBAAiB,GAC7B,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CA+C3C"}

package/dist/utils/trace.d.mts

@@ -0,0 +1,52 @@
+import type { TraceCallback, TraceContext } from "@metamask/controller-utils";
+export type TraceSpanData = Record<string, number | string | boolean>;
+export type EmitTraceParams = {
+    name: string;
+    /** When omitted / undefined, this is a no-op (bake call-site gating here). */
+    trace?: TraceCallback;
+    data: TraceSpanData;
+    tags?: TraceSpanData;
+    parentContext?: TraceContext;
+    /** Override span start; otherwise derived from `data.duration_ms` when present. */
+    startTime?: number;
+};
+export type WithTraceParams<Result> = {
+    name: string;
+    /** When omitted / undefined, `fn` runs with no parent context. */
+    trace?: TraceCallback;
+    data: TraceSpanData;
+    fn: (parentContext?: TraceContext) => Promise<Result>;
+    tags?: TraceSpanData;
+    startTime?: number;
+};
+/**
+ * Fire-and-forget Sentry span. Swallows errors so telemetry never breaks callers.
+ * Pass `parentContext` to nest as a subspan. Omit `trace` to skip emission.
+ *
+ * @param params - Span configuration.
+ * @param params.name - Trace / span name visible in Sentry.
+ * @param params.trace - Optional client trace callback; omit to no-op.
+ * @param params.data - Key-value pairs attached as span data.
+ * @param params.tags - Key-value pairs used for Sentry filtering.
+ * @param params.parentContext - Optional parent span context for nesting.
+ * @param params.startTime - Optional explicit start; else derived from `duration_ms`.
+ */
+export declare function emitTrace({ name, trace, data, tags, parentContext, startTime: startTimeOverride, }: EmitTraceParams): void;
+/**
+ * Run work inside a parent Sentry span and pass its context for nested
+ * {@link emitTrace} subspans.
+ *
+ * When `trace` is omitted, runs `fn(undefined)` with no span.
+ * Telemetry failures are swallowed; errors from `fn` still propagate.
+ *
+ * @param params - Parent span config and work callback.
+ * @param params.name - Parent span name.
+ * @param params.trace - Optional client trace callback; omit to skip wrapping.
+ * @param params.data - Key-value pairs attached as span data.
+ * @param params.fn - Work to run; receives the parent span context.
+ * @param params.tags - Key-value pairs used for Sentry filtering.
+ * @param params.startTime - Optional explicit start; else derived from `duration_ms`.
+ * @returns The result of `fn`.
+ */
+export declare function withTrace<Result>({ name, trace, data, fn, tags, startTime: startTimeOverride, }: WithTraceParams<Result>): Promise<Result>;
+//# sourceMappingURL=trace.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.mts","sourceRoot":"","sources":["../../src/utils/trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,mCAAmC;AAM9E,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAEtE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,MAAM,IAAI;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AA2CF;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,IAAmB,EACnB,aAAa,EACb,SAAS,EAAE,iBAAiB,GAC7B,EAAE,eAAe,GAAG,IAAI,CAuBxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,EACtC,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,EAAE,EACF,IAAmB,EACnB,SAAS,EAAE,iBAAiB,GAC7B,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CA+C3C"}

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

@@ -112,4 +112,4 @@ export async function withTrace({ name, trace, data, fn, tags = DEFAULT_TAGS, st
     }
     throw workResult.error;
 }
-//# sourceMappingURL=trace.js.map
+//# sourceMappingURL=trace.mjs.map

package/dist/utils/trace.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.mjs","sourceRoot":"","sources":["../../src/utils/trace.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TraceCallback, TraceContext } from '@metamask/controller-utils';\n\nconst DEFAULT_TAGS: Record<string, number | string | boolean> = {\n  controller: 'AssetsController',\n};\n\nexport type TraceSpanData = Record<string, number | string | boolean>;\n\nexport type EmitTraceParams = {\n  name: string;\n  /** When omitted / undefined, this is a no-op (bake call-site gating here). */\n  trace?: TraceCallback;\n  data: TraceSpanData;\n  tags?: TraceSpanData;\n  parentContext?: TraceContext;\n  /** Override span start; otherwise derived from `data.duration_ms` when present. */\n  startTime?: number;\n};\n\nexport type WithTraceParams<Result> = {\n  name: string;\n  /** When omitted / undefined, `fn` runs with no parent context. */\n  trace?: TraceCallback;\n  data: TraceSpanData;\n  fn: (parentContext?: TraceContext) => Promise<Result>;\n  tags?: TraceSpanData;\n  startTime?: number;\n};\n\n/**\n * Build request tags / startTime for MetaMask's Sentry adapter.\n * Numeric `data` fields become tags (measurements); `duration_ms` backdates start.\n *\n * @param data - Span data attributes.\n * @param tags - Caller tags.\n * @param startTime - Optional explicit start override.\n * @returns tags and optional startTime for the TraceRequest.\n */\nfunction buildTraceTiming(\n  data: TraceSpanData,\n  tags: TraceSpanData,\n  startTime?: number,\n): { tags: TraceSpanData; startTime?: number } {\n  const numericFromData: Record<string, number> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (typeof value === 'number') {\n      numericFromData[key] = value;\n    }\n  }\n  const requestTags = {\n    ...tags,\n    ...numericFromData,\n  };\n\n  if (startTime !== undefined) {\n    return { tags: requestTags, startTime };\n  }\n\n  const durationMs =\n    typeof data.duration_ms === 'number' ? data.duration_ms : undefined;\n  if (durationMs === undefined) {\n    return { tags: requestTags };\n  }\n\n  return {\n    tags: requestTags,\n    startTime: performance.timeOrigin + performance.now() - durationMs,\n  };\n}\n\n/**\n * Fire-and-forget Sentry span. Swallows errors so telemetry never breaks callers.\n * Pass `parentContext` to nest as a subspan. Omit `trace` to skip emission.\n *\n * @param params - Span configuration.\n * @param params.name - Trace / span name visible in Sentry.\n * @param params.trace - Optional client trace callback; omit to no-op.\n * @param params.data - Key-value pairs attached as span data.\n * @param params.tags - Key-value pairs used for Sentry filtering.\n * @param params.parentContext - Optional parent span context for nesting.\n * @param params.startTime - Optional explicit start; else derived from `duration_ms`.\n */\nexport function emitTrace({\n  name,\n  trace,\n  data,\n  tags = DEFAULT_TAGS,\n  parentContext,\n  startTime: startTimeOverride,\n}: EmitTraceParams): void {\n  if (!trace) {\n    return;\n  }\n\n  const { tags: requestTags, startTime } = buildTraceTiming(\n    data,\n    tags,\n    startTimeOverride,\n  );\n\n  trace(\n    {\n      name,\n      data,\n      tags: requestTags,\n      parentContext,\n      ...(startTime === undefined ? {} : { startTime }),\n    },\n    () => undefined,\n  )?.catch(() => {\n    // Telemetry failure must not break.\n  });\n}\n\n/**\n * Run work inside a parent Sentry span and pass its context for nested\n * {@link emitTrace} subspans.\n *\n * When `trace` is omitted, runs `fn(undefined)` with no span.\n * Telemetry failures are swallowed; errors from `fn` still propagate.\n *\n * @param params - Parent span config and work callback.\n * @param params.name - Parent span name.\n * @param params.trace - Optional client trace callback; omit to skip wrapping.\n * @param params.data - Key-value pairs attached as span data.\n * @param params.fn - Work to run; receives the parent span context.\n * @param params.tags - Key-value pairs used for Sentry filtering.\n * @param params.startTime - Optional explicit start; else derived from `duration_ms`.\n * @returns The result of `fn`.\n */\nexport async function withTrace<Result>({\n  name,\n  trace,\n  data,\n  fn,\n  tags = DEFAULT_TAGS,\n  startTime: startTimeOverride,\n}: WithTraceParams<Result>): Promise<Result> {\n  if (!trace) {\n    return fn(undefined);\n  }\n\n  const { tags: requestTags, startTime } = buildTraceTiming(\n    data,\n    tags,\n    startTimeOverride,\n  );\n\n  let workResult:\n    | { ok: true; value: Result }\n    | { ok: false; error: unknown }\n    | undefined;\n\n  try {\n    await trace(\n      {\n        name,\n        data,\n        tags: requestTags,\n        ...(startTime === undefined ? {} : { startTime }),\n      },\n      async (parentContext) => {\n        try {\n          const value = await fn(parentContext);\n          workResult = { ok: true, value };\n          return value;\n        } catch (error) {\n          workResult = { ok: false, error };\n          throw error;\n        }\n      },\n    );\n  } catch {\n    // Telemetry failure must not break — unless the work itself failed.\n  }\n\n  if (workResult === undefined) {\n    // `trace` failed before invoking `fn` (or never called it).\n    return fn(undefined);\n  }\n  if (workResult.ok) {\n    return workResult.value;\n  }\n  throw workResult.error;\n}\n"]}