@metamask/snap-networks-utils 1.0.0 → 2.0.0

package/dist/providers/assets/AssetsProvider.d.cts

@@ -1,4 +1,5 @@
-import type { AccountId, AssetsControllerGetAccountAssetByIDAction, AssetsControllerGetAccountAssetsByIDsAction, AssetsControllerGetAccountAssetsByScopeAction, Caip19AssetId } from "@metamask/assets-controller";
+import type { AccountId, AssetsControllerGetAccountAssetByIDAction, AssetsControllerGetAccountAssetsByIDsAction, AssetsControllerGetAccountAssetsByScopeAction, AssetsControllerGetAssetMetadataAction, AssetsControllerGetAssetsAction, Caip19AssetId } from "@metamask/assets-controller";
+import type { InternalAccount } from "@metamask/keyring-internal-api";
 import type { Messenger } from "@metamask/messenger";
 import { AsyncMessenger } from "@metamask/snaps-sdk";
 import type { CaipChainId } from "@metamask/utils";
@@ -9,7 +10,7 @@ export declare const ASSETS_PROVIDER_NAME: "AssetsProvider";
 /**
  * Actions from other messengers that {@link AssetsProvider} calls.
  */
-export type AssetsProviderAllowedActions = AssetsControllerGetAccountAssetByIDAction | AssetsControllerGetAccountAssetsByIDsAction | AssetsControllerGetAccountAssetsByScopeAction;
+export type AssetsProviderAllowedActions = AssetsControllerGetAccountAssetByIDAction | AssetsControllerGetAccountAssetsByIDsAction | AssetsControllerGetAccountAssetsByScopeAction | AssetsControllerGetAssetMetadataAction | AssetsControllerGetAssetsAction;
 /**
  * Messenger restricted to actions consumed by {@link AssetsProvider}.
  */
@@ -43,5 +44,32 @@ export declare class AssetsProvider {
      * @returns Controller assets keyed by CAIP-19 asset ID.
      */
     getAccountAssetsByScope(scope: CaipChainId, accountId: AccountId): Promise<ReturnType<AssetsControllerGetAccountAssetsByScopeAction['handler']>>;
+    /**
+     * Returns metadata for a CAIP-19 asset from controller state, or `undefined`
+     * if the asset is unknown.
+     *
+     * @param assetId - CAIP-19 asset ID.
+     * @returns Controller asset metadata, or `undefined`.
+     */
+    getAssetMetadata(assetId: Caip19AssetId): Promise<ReturnType<AssetsControllerGetAssetMetadataAction['handler']>>;
+    /**
+     * Fetches combined assets (balance + metadata + price + computed
+     * `fiatValue`) for the given accounts, bypassing client-side caches.
+     *
+     * Unlike the state-only getters above, this maps to the controller's
+     * one-time fetch pipeline: passing `forceUpdate: true` refreshes the data
+     * from the data sources and updates controller state, and the returned
+     * value reflects that fresh fetch rather than current state. Pass
+     * `bypassServerCache: true` (only together with `forceUpdate`) to also
+     * bypass server-side HTTP caches such as the Accounts API's 60-second
+     * cache; use sparingly, e.g. right after a transaction confirms when the
+     * cached snapshot is known stale.
+     *
+     * @param accounts - Internal accounts to fetch assets for.
+     * @param options - Fetch options (`chainIds`, `forceUpdate`,
+     * `bypassServerCache`, `dataTypes`, etc.).
+     * @returns Combined assets keyed by account ID, then CAIP-19 asset ID.
+     */
+    getAssets(accounts: InternalAccount[], options?: Parameters<AssetsControllerGetAssetsAction['handler']>[1]): Promise<ReturnType<AssetsControllerGetAssetsAction['handler']>>;
 }
 //# sourceMappingURL=AssetsProvider.d.cts.map

package/dist/providers/assets/AssetsProvider.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetsProvider.d.cts","sourceRoot":"","sources":["../../../src/providers/assets/AssetsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,yCAAyC,EACzC,2CAA2C,EAC3C,6CAA6C,EAC7C,aAAa,EACd,oCAAoC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AACrD,OAAO,EAAE,cAAc,EAAE,4BAA4B;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB;AAEnD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAG,gBAAyB,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,4BAA4B,GACpC,yCAAyC,GACzC,2CAA2C,GAC3C,6CAA6C,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAClD,SAAS,CAAC,OAAO,oBAAoB,EAAE,4BAA4B,CAAC,CACrE,CAAC;AAEF,qBAAa,cAAc;;gBAGb,EAAE,SAAS,EAAE,EAAE;QAAE,SAAS,EAAE,uBAAuB,CAAA;KAAE;IAIjE;;;;;;OAMG;IACG,mBAAmB,CACvB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,UAAU,CAAC,yCAAyC,CAAC,SAAS,CAAC,CAAC,CAAC;IAQ5E;;;;;;OAMG;IACG,qBAAqB,CACzB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,aAAa,EAAE,GACxB,OAAO,CACR,UAAU,CAAC,2CAA2C,CAAC,SAAS,CAAC,CAAC,CACnE;IAQD;;;;;;OAMG;IACG,uBAAuB,CAC3B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,SAAS,GACnB,OAAO,CACR,UAAU,CAAC,6CAA6C,CAAC,SAAS,CAAC,CAAC,CACrE;CAOF"}
+{"version":3,"file":"AssetsProvider.d.cts","sourceRoot":"","sources":["../../../src/providers/assets/AssetsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,yCAAyC,EACzC,2CAA2C,EAC3C,6CAA6C,EAC7C,sCAAsC,EACtC,+BAA+B,EAC/B,aAAa,EACd,oCAAoC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,uCAAuC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AACrD,OAAO,EAAE,cAAc,EAAE,4BAA4B;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB;AAEnD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAG,gBAAyB,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,4BAA4B,GACpC,yCAAyC,GACzC,2CAA2C,GAC3C,6CAA6C,GAC7C,sCAAsC,GACtC,+BAA+B,CAAC;AAEpC;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAClD,SAAS,CAAC,OAAO,oBAAoB,EAAE,4BAA4B,CAAC,CACrE,CAAC;AAEF,qBAAa,cAAc;;gBAGb,EAAE,SAAS,EAAE,EAAE;QAAE,SAAS,EAAE,uBAAuB,CAAA;KAAE;IAIjE;;;;;;OAMG;IACG,mBAAmB,CACvB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,UAAU,CAAC,yCAAyC,CAAC,SAAS,CAAC,CAAC,CAAC;IAQ5E;;;;;;OAMG;IACG,qBAAqB,CACzB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,aAAa,EAAE,GACxB,OAAO,CACR,UAAU,CAAC,2CAA2C,CAAC,SAAS,CAAC,CAAC,CACnE;IAQD;;;;;;OAMG;IACG,uBAAuB,CAC3B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,SAAS,GACnB,OAAO,CACR,UAAU,CAAC,6CAA6C,CAAC,SAAS,CAAC,CAAC,CACrE;IAQD;;;;;;OAMG;IACG,gBAAgB,CACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,UAAU,CAAC,sCAAsC,CAAC,SAAS,CAAC,CAAC,CAAC;IAIzE;;;;;;;;;;;;;;;;;OAiBG;IACG,SAAS,CACb,QAAQ,EAAE,eAAe,EAAE,EAC3B,OAAO,CAAC,EAAE,UAAU,CAAC,+BAA+B,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAClE,OAAO,CAAC,UAAU,CAAC,+BAA+B,CAAC,SAAS,CAAC,CAAC,CAAC;CAOnE"}

package/dist/providers/assets/AssetsProvider.d.mts

@@ -1,4 +1,5 @@
-import type { AccountId, AssetsControllerGetAccountAssetByIDAction, AssetsControllerGetAccountAssetsByIDsAction, AssetsControllerGetAccountAssetsByScopeAction, Caip19AssetId } from "@metamask/assets-controller";
+import type { AccountId, AssetsControllerGetAccountAssetByIDAction, AssetsControllerGetAccountAssetsByIDsAction, AssetsControllerGetAccountAssetsByScopeAction, AssetsControllerGetAssetMetadataAction, AssetsControllerGetAssetsAction, Caip19AssetId } from "@metamask/assets-controller";
+import type { InternalAccount } from "@metamask/keyring-internal-api";
 import type { Messenger } from "@metamask/messenger";
 import { AsyncMessenger } from "@metamask/snaps-sdk";
 import type { CaipChainId } from "@metamask/utils";
@@ -9,7 +10,7 @@ export declare const ASSETS_PROVIDER_NAME: "AssetsProvider";
 /**
  * Actions from other messengers that {@link AssetsProvider} calls.
  */
-export type AssetsProviderAllowedActions = AssetsControllerGetAccountAssetByIDAction | AssetsControllerGetAccountAssetsByIDsAction | AssetsControllerGetAccountAssetsByScopeAction;
+export type AssetsProviderAllowedActions = AssetsControllerGetAccountAssetByIDAction | AssetsControllerGetAccountAssetsByIDsAction | AssetsControllerGetAccountAssetsByScopeAction | AssetsControllerGetAssetMetadataAction | AssetsControllerGetAssetsAction;
 /**
  * Messenger restricted to actions consumed by {@link AssetsProvider}.
  */
@@ -43,5 +44,32 @@ export declare class AssetsProvider {
      * @returns Controller assets keyed by CAIP-19 asset ID.
      */
     getAccountAssetsByScope(scope: CaipChainId, accountId: AccountId): Promise<ReturnType<AssetsControllerGetAccountAssetsByScopeAction['handler']>>;
+    /**
+     * Returns metadata for a CAIP-19 asset from controller state, or `undefined`
+     * if the asset is unknown.
+     *
+     * @param assetId - CAIP-19 asset ID.
+     * @returns Controller asset metadata, or `undefined`.
+     */
+    getAssetMetadata(assetId: Caip19AssetId): Promise<ReturnType<AssetsControllerGetAssetMetadataAction['handler']>>;
+    /**
+     * Fetches combined assets (balance + metadata + price + computed
+     * `fiatValue`) for the given accounts, bypassing client-side caches.
+     *
+     * Unlike the state-only getters above, this maps to the controller's
+     * one-time fetch pipeline: passing `forceUpdate: true` refreshes the data
+     * from the data sources and updates controller state, and the returned
+     * value reflects that fresh fetch rather than current state. Pass
+     * `bypassServerCache: true` (only together with `forceUpdate`) to also
+     * bypass server-side HTTP caches such as the Accounts API's 60-second
+     * cache; use sparingly, e.g. right after a transaction confirms when the
+     * cached snapshot is known stale.
+     *
+     * @param accounts - Internal accounts to fetch assets for.
+     * @param options - Fetch options (`chainIds`, `forceUpdate`,
+     * `bypassServerCache`, `dataTypes`, etc.).
+     * @returns Combined assets keyed by account ID, then CAIP-19 asset ID.
+     */
+    getAssets(accounts: InternalAccount[], options?: Parameters<AssetsControllerGetAssetsAction['handler']>[1]): Promise<ReturnType<AssetsControllerGetAssetsAction['handler']>>;
 }
 //# sourceMappingURL=AssetsProvider.d.mts.map

package/dist/providers/assets/AssetsProvider.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetsProvider.d.mts","sourceRoot":"","sources":["../../../src/providers/assets/AssetsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,yCAAyC,EACzC,2CAA2C,EAC3C,6CAA6C,EAC7C,aAAa,EACd,oCAAoC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AACrD,OAAO,EAAE,cAAc,EAAE,4BAA4B;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB;AAEnD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAG,gBAAyB,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,4BAA4B,GACpC,yCAAyC,GACzC,2CAA2C,GAC3C,6CAA6C,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAClD,SAAS,CAAC,OAAO,oBAAoB,EAAE,4BAA4B,CAAC,CACrE,CAAC;AAEF,qBAAa,cAAc;;gBAGb,EAAE,SAAS,EAAE,EAAE;QAAE,SAAS,EAAE,uBAAuB,CAAA;KAAE;IAIjE;;;;;;OAMG;IACG,mBAAmB,CACvB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,UAAU,CAAC,yCAAyC,CAAC,SAAS,CAAC,CAAC,CAAC;IAQ5E;;;;;;OAMG;IACG,qBAAqB,CACzB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,aAAa,EAAE,GACxB,OAAO,CACR,UAAU,CAAC,2CAA2C,CAAC,SAAS,CAAC,CAAC,CACnE;IAQD;;;;;;OAMG;IACG,uBAAuB,CAC3B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,SAAS,GACnB,OAAO,CACR,UAAU,CAAC,6CAA6C,CAAC,SAAS,CAAC,CAAC,CACrE;CAOF"}
+{"version":3,"file":"AssetsProvider.d.mts","sourceRoot":"","sources":["../../../src/providers/assets/AssetsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,yCAAyC,EACzC,2CAA2C,EAC3C,6CAA6C,EAC7C,sCAAsC,EACtC,+BAA+B,EAC/B,aAAa,EACd,oCAAoC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,uCAAuC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AACrD,OAAO,EAAE,cAAc,EAAE,4BAA4B;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB;AAEnD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAG,gBAAyB,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,4BAA4B,GACpC,yCAAyC,GACzC,2CAA2C,GAC3C,6CAA6C,GAC7C,sCAAsC,GACtC,+BAA+B,CAAC;AAEpC;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAClD,SAAS,CAAC,OAAO,oBAAoB,EAAE,4BAA4B,CAAC,CACrE,CAAC;AAEF,qBAAa,cAAc;;gBAGb,EAAE,SAAS,EAAE,EAAE;QAAE,SAAS,EAAE,uBAAuB,CAAA;KAAE;IAIjE;;;;;;OAMG;IACG,mBAAmB,CACvB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,UAAU,CAAC,yCAAyC,CAAC,SAAS,CAAC,CAAC,CAAC;IAQ5E;;;;;;OAMG;IACG,qBAAqB,CACzB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,aAAa,EAAE,GACxB,OAAO,CACR,UAAU,CAAC,2CAA2C,CAAC,SAAS,CAAC,CAAC,CACnE;IAQD;;;;;;OAMG;IACG,uBAAuB,CAC3B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,SAAS,GACnB,OAAO,CACR,UAAU,CAAC,6CAA6C,CAAC,SAAS,CAAC,CAAC,CACrE;IAQD;;;;;;OAMG;IACG,gBAAgB,CACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,UAAU,CAAC,sCAAsC,CAAC,SAAS,CAAC,CAAC,CAAC;IAIzE;;;;;;;;;;;;;;;;;OAiBG;IACG,SAAS,CACb,QAAQ,EAAE,eAAe,EAAE,EAC3B,OAAO,CAAC,EAAE,UAAU,CAAC,+BAA+B,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAClE,OAAO,CAAC,UAAU,CAAC,+BAA+B,CAAC,SAAS,CAAC,CAAC,CAAC;CAOnE"}

package/dist/providers/assets/AssetsProvider.mjs

@@ -1,23 +1,11 @@
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _AssetsProvider_messenger;
 /**
  * Namespace for the {@link AssetsProvider} messenger.
  */
 export const ASSETS_PROVIDER_NAME = 'AssetsProvider';
 export class AssetsProvider {
+    #messenger;
     constructor({ messenger }) {
-        _AssetsProvider_messenger.set(this, void 0);
-        __classPrivateFieldSet(this, _AssetsProvider_messenger, messenger, "f");
+        this.#messenger = messenger;
     }
     /**
      * Returns a single account asset by CAIP-19 ID, or `undefined` if missing.
@@ -27,7 +15,7 @@ export class AssetsProvider {
      * @returns Controller asset, or `undefined`.
      */
     async getAccountAssetByID(accountId, assetId) {
-        return __classPrivateFieldGet(this, _AssetsProvider_messenger, "f").call('AssetsController:getAccountAssetByID', accountId, assetId);
+        return this.#messenger.call('AssetsController:getAccountAssetByID', accountId, assetId);
     }
     /**
      * Returns account assets for the given CAIP-19 IDs, keyed by asset ID.
@@ -37,7 +25,7 @@ export class AssetsProvider {
      * @returns Map of asset ID → controller asset.
      */
     async getAccountAssetsByIDs(accountId, assetIds) {
-        return __classPrivateFieldGet(this, _AssetsProvider_messenger, "f").call('AssetsController:getAccountAssetsByIDs', accountId, assetIds);
+        return this.#messenger.call('AssetsController:getAccountAssetsByIDs', accountId, assetIds);
     }
     /**
      * Returns controller-backed assets for an account on a chain.
@@ -47,8 +35,38 @@ export class AssetsProvider {
      * @returns Controller assets keyed by CAIP-19 asset ID.
      */
     async getAccountAssetsByScope(scope, accountId) {
-        return __classPrivateFieldGet(this, _AssetsProvider_messenger, "f").call('AssetsController:getAccountAssetsByScope', accountId, scope);
+        return this.#messenger.call('AssetsController:getAccountAssetsByScope', accountId, scope);
+    }
+    /**
+     * Returns metadata for a CAIP-19 asset from controller state, or `undefined`
+     * if the asset is unknown.
+     *
+     * @param assetId - CAIP-19 asset ID.
+     * @returns Controller asset metadata, or `undefined`.
+     */
+    async getAssetMetadata(assetId) {
+        return this.#messenger.call('AssetsController:getAssetMetadata', assetId);
+    }
+    /**
+     * Fetches combined assets (balance + metadata + price + computed
+     * `fiatValue`) for the given accounts, bypassing client-side caches.
+     *
+     * Unlike the state-only getters above, this maps to the controller's
+     * one-time fetch pipeline: passing `forceUpdate: true` refreshes the data
+     * from the data sources and updates controller state, and the returned
+     * value reflects that fresh fetch rather than current state. Pass
+     * `bypassServerCache: true` (only together with `forceUpdate`) to also
+     * bypass server-side HTTP caches such as the Accounts API's 60-second
+     * cache; use sparingly, e.g. right after a transaction confirms when the
+     * cached snapshot is known stale.
+     *
+     * @param accounts - Internal accounts to fetch assets for.
+     * @param options - Fetch options (`chainIds`, `forceUpdate`,
+     * `bypassServerCache`, `dataTypes`, etc.).
+     * @returns Combined assets keyed by account ID, then CAIP-19 asset ID.
+     */
+    async getAssets(accounts, options) {
+        return this.#messenger.call('AssetsController:getAssets', accounts, options);
     }
 }
-_AssetsProvider_messenger = new WeakMap();
 //# sourceMappingURL=AssetsProvider.mjs.map

package/dist/providers/assets/AssetsProvider.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AssetsProvider.mjs","sourceRoot":"","sources":["../../../src/providers/assets/AssetsProvider.ts"],"names":[],"mappings":";;;;;;;;;;;;AAWA;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAyB,CAAC;AAiB9D,MAAM,OAAO,cAAc;IAGzB,YAAY,EAAE,SAAS,EAA0C;QAFxD,4CAAoC;QAG3C,uBAAA,IAAI,6BAAc,SAAS,MAAA,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB,CACvB,SAAoB,EACpB,OAAsB;QAEtB,OAAO,uBAAA,IAAI,iCAAW,CAAC,IAAI,CACzB,sCAAsC,EACtC,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,qBAAqB,CACzB,SAAoB,EACpB,QAAyB;QAIzB,OAAO,uBAAA,IAAI,iCAAW,CAAC,IAAI,CACzB,wCAAwC,EACxC,SAAS,EACT,QAAQ,CACT,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,uBAAuB,CAC3B,KAAkB,EAClB,SAAoB;QAIpB,OAAO,uBAAA,IAAI,iCAAW,CAAC,IAAI,CACzB,0CAA0C,EAC1C,SAAS,EACT,KAAK,CACN,CAAC;IACJ,CAAC;CACF","sourcesContent":["import type {\n  AccountId,\n  AssetsControllerGetAccountAssetByIDAction,\n  AssetsControllerGetAccountAssetsByIDsAction,\n  AssetsControllerGetAccountAssetsByScopeAction,\n  Caip19AssetId,\n} from '@metamask/assets-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport { AsyncMessenger } from '@metamask/snaps-sdk';\nimport type { CaipChainId } from '@metamask/utils';\n\n/**\n * Namespace for the {@link AssetsProvider} messenger.\n */\nexport const ASSETS_PROVIDER_NAME = 'AssetsProvider' as const;\n\n/**\n * Actions from other messengers that {@link AssetsProvider} calls.\n */\nexport type AssetsProviderAllowedActions =\n  | AssetsControllerGetAccountAssetByIDAction\n  | AssetsControllerGetAccountAssetsByIDsAction\n  | AssetsControllerGetAccountAssetsByScopeAction;\n\n/**\n * Messenger restricted to actions consumed by {@link AssetsProvider}.\n */\nexport type AssetsProviderMessenger = AsyncMessenger<\n  Messenger<typeof ASSETS_PROVIDER_NAME, AssetsProviderAllowedActions>\n>;\n\nexport class AssetsProvider {\n  readonly #messenger: AssetsProviderMessenger;\n\n  constructor({ messenger }: { messenger: AssetsProviderMessenger }) {\n    this.#messenger = messenger;\n  }\n\n  /**\n   * Returns a single account asset by CAIP-19 ID, or `undefined` if missing.\n   *\n   * @param accountId - Keyring account ID.\n   * @param assetId - CAIP-19 asset ID.\n   * @returns Controller asset, or `undefined`.\n   */\n  async getAccountAssetByID(\n    accountId: AccountId,\n    assetId: Caip19AssetId,\n  ): Promise<ReturnType<AssetsControllerGetAccountAssetByIDAction['handler']>> {\n    return this.#messenger.call(\n      'AssetsController:getAccountAssetByID',\n      accountId,\n      assetId,\n    );\n  }\n\n  /**\n   * Returns account assets for the given CAIP-19 IDs, keyed by asset ID.\n   *\n   * @param accountId - Keyring account ID.\n   * @param assetIds - CAIP-19 asset IDs to resolve.\n   * @returns Map of asset ID → controller asset.\n   */\n  async getAccountAssetsByIDs(\n    accountId: AccountId,\n    assetIds: Caip19AssetId[],\n  ): Promise<\n    ReturnType<AssetsControllerGetAccountAssetsByIDsAction['handler']>\n  > {\n    return this.#messenger.call(\n      'AssetsController:getAccountAssetsByIDs',\n      accountId,\n      assetIds,\n    );\n  }\n\n  /**\n   * Returns controller-backed assets for an account on a chain.\n   *\n   * @param scope - CAIP-2 chain ID to filter controller results.\n   * @param accountId - Keyring account ID.\n   * @returns Controller assets keyed by CAIP-19 asset ID.\n   */\n  async getAccountAssetsByScope(\n    scope: CaipChainId,\n    accountId: AccountId,\n  ): Promise<\n    ReturnType<AssetsControllerGetAccountAssetsByScopeAction['handler']>\n  > {\n    return this.#messenger.call(\n      'AssetsController:getAccountAssetsByScope',\n      accountId,\n      scope,\n    );\n  }\n}\n"]}
+{"version":3,"file":"AssetsProvider.mjs","sourceRoot":"","sources":["../../../src/providers/assets/AssetsProvider.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAyB,CAAC;AAmB9D,MAAM,OAAO,cAAc;IAChB,UAAU,CAA0B;IAE7C,YAAY,EAAE,SAAS,EAA0C;QAC/D,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB,CACvB,SAAoB,EACpB,OAAsB;QAEtB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CACzB,sCAAsC,EACtC,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,qBAAqB,CACzB,SAAoB,EACpB,QAAyB;QAIzB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CACzB,wCAAwC,EACxC,SAAS,EACT,QAAQ,CACT,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,uBAAuB,CAC3B,KAAkB,EAClB,SAAoB;QAIpB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CACzB,0CAA0C,EAC1C,SAAS,EACT,KAAK,CACN,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,gBAAgB,CACpB,OAAsB;QAEtB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,mCAAmC,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,SAAS,CACb,QAA2B,EAC3B,OAAmE;QAEnE,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CACzB,4BAA4B,EAC5B,QAAQ,EACR,OAAO,CACR,CAAC;IACJ,CAAC;CACF","sourcesContent":["import type {\n  AccountId,\n  AssetsControllerGetAccountAssetByIDAction,\n  AssetsControllerGetAccountAssetsByIDsAction,\n  AssetsControllerGetAccountAssetsByScopeAction,\n  AssetsControllerGetAssetMetadataAction,\n  AssetsControllerGetAssetsAction,\n  Caip19AssetId,\n} from '@metamask/assets-controller';\nimport type { InternalAccount } from '@metamask/keyring-internal-api';\nimport type { Messenger } from '@metamask/messenger';\nimport { AsyncMessenger } from '@metamask/snaps-sdk';\nimport type { CaipChainId } from '@metamask/utils';\n\n/**\n * Namespace for the {@link AssetsProvider} messenger.\n */\nexport const ASSETS_PROVIDER_NAME = 'AssetsProvider' as const;\n\n/**\n * Actions from other messengers that {@link AssetsProvider} calls.\n */\nexport type AssetsProviderAllowedActions =\n  | AssetsControllerGetAccountAssetByIDAction\n  | AssetsControllerGetAccountAssetsByIDsAction\n  | AssetsControllerGetAccountAssetsByScopeAction\n  | AssetsControllerGetAssetMetadataAction\n  | AssetsControllerGetAssetsAction;\n\n/**\n * Messenger restricted to actions consumed by {@link AssetsProvider}.\n */\nexport type AssetsProviderMessenger = AsyncMessenger<\n  Messenger<typeof ASSETS_PROVIDER_NAME, AssetsProviderAllowedActions>\n>;\n\nexport class AssetsProvider {\n  readonly #messenger: AssetsProviderMessenger;\n\n  constructor({ messenger }: { messenger: AssetsProviderMessenger }) {\n    this.#messenger = messenger;\n  }\n\n  /**\n   * Returns a single account asset by CAIP-19 ID, or `undefined` if missing.\n   *\n   * @param accountId - Keyring account ID.\n   * @param assetId - CAIP-19 asset ID.\n   * @returns Controller asset, or `undefined`.\n   */\n  async getAccountAssetByID(\n    accountId: AccountId,\n    assetId: Caip19AssetId,\n  ): Promise<ReturnType<AssetsControllerGetAccountAssetByIDAction['handler']>> {\n    return this.#messenger.call(\n      'AssetsController:getAccountAssetByID',\n      accountId,\n      assetId,\n    );\n  }\n\n  /**\n   * Returns account assets for the given CAIP-19 IDs, keyed by asset ID.\n   *\n   * @param accountId - Keyring account ID.\n   * @param assetIds - CAIP-19 asset IDs to resolve.\n   * @returns Map of asset ID → controller asset.\n   */\n  async getAccountAssetsByIDs(\n    accountId: AccountId,\n    assetIds: Caip19AssetId[],\n  ): Promise<\n    ReturnType<AssetsControllerGetAccountAssetsByIDsAction['handler']>\n  > {\n    return this.#messenger.call(\n      'AssetsController:getAccountAssetsByIDs',\n      accountId,\n      assetIds,\n    );\n  }\n\n  /**\n   * Returns controller-backed assets for an account on a chain.\n   *\n   * @param scope - CAIP-2 chain ID to filter controller results.\n   * @param accountId - Keyring account ID.\n   * @returns Controller assets keyed by CAIP-19 asset ID.\n   */\n  async getAccountAssetsByScope(\n    scope: CaipChainId,\n    accountId: AccountId,\n  ): Promise<\n    ReturnType<AssetsControllerGetAccountAssetsByScopeAction['handler']>\n  > {\n    return this.#messenger.call(\n      'AssetsController:getAccountAssetsByScope',\n      accountId,\n      scope,\n    );\n  }\n\n  /**\n   * Returns metadata for a CAIP-19 asset from controller state, or `undefined`\n   * if the asset is unknown.\n   *\n   * @param assetId - CAIP-19 asset ID.\n   * @returns Controller asset metadata, or `undefined`.\n   */\n  async getAssetMetadata(\n    assetId: Caip19AssetId,\n  ): Promise<ReturnType<AssetsControllerGetAssetMetadataAction['handler']>> {\n    return this.#messenger.call('AssetsController:getAssetMetadata', assetId);\n  }\n\n  /**\n   * Fetches combined assets (balance + metadata + price + computed\n   * `fiatValue`) for the given accounts, bypassing client-side caches.\n   *\n   * Unlike the state-only getters above, this maps to the controller's\n   * one-time fetch pipeline: passing `forceUpdate: true` refreshes the data\n   * from the data sources and updates controller state, and the returned\n   * value reflects that fresh fetch rather than current state. Pass\n   * `bypassServerCache: true` (only together with `forceUpdate`) to also\n   * bypass server-side HTTP caches such as the Accounts API's 60-second\n   * cache; use sparingly, e.g. right after a transaction confirms when the\n   * cached snapshot is known stale.\n   *\n   * @param accounts - Internal accounts to fetch assets for.\n   * @param options - Fetch options (`chainIds`, `forceUpdate`,\n   * `bypassServerCache`, `dataTypes`, etc.).\n   * @returns Combined assets keyed by account ID, then CAIP-19 asset ID.\n   */\n  async getAssets(\n    accounts: InternalAccount[],\n    options?: Parameters<AssetsControllerGetAssetsAction['handler']>[1],\n  ): Promise<ReturnType<AssetsControllerGetAssetsAction['handler']>> {\n    return this.#messenger.call(\n      'AssetsController:getAssets',\n      accounts,\n      options,\n    );\n  }\n}\n"]}

package/dist/providers/remote-feature-flags/RemoteFeatureFlagsProvider.cjs

@@ -1,16 +1,4 @@
 "use strict";
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _RemoteFeatureFlagsProvider_messenger;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RemoteFeatureFlagsProvider = exports.REMOTE_FEATURE_FLAGS_PROVIDER_NAME = void 0;
 /**
@@ -18,9 +6,9 @@ exports.RemoteFeatureFlagsProvider = exports.REMOTE_FEATURE_FLAGS_PROVIDER_NAME
  */
 exports.REMOTE_FEATURE_FLAGS_PROVIDER_NAME = 'RemoteFeatureFlagsProvider';
 class RemoteFeatureFlagsProvider {
+    #messenger;
     constructor({ messenger, }) {
-        _RemoteFeatureFlagsProvider_messenger.set(this, void 0);
-        __classPrivateFieldSet(this, _RemoteFeatureFlagsProvider_messenger, messenger, "f");
+        this.#messenger = messenger;
     }
     /**
      * Returns a single remote feature flag value, or `undefined` if missing.
@@ -29,7 +17,7 @@ class RemoteFeatureFlagsProvider {
      * @returns Flag value, or `undefined`.
      */
     async getFeatureFlag(flagKey) {
-        const { remoteFeatureFlags } = await __classPrivateFieldGet(this, _RemoteFeatureFlagsProvider_messenger, "f").call('RemoteFeatureFlagController:getState');
+        const { remoteFeatureFlags } = await this.#messenger.call('RemoteFeatureFlagController:getState');
         return remoteFeatureFlags[flagKey];
     }
     /**
@@ -40,7 +28,7 @@ class RemoteFeatureFlagsProvider {
      * @returns Map of flag key → value.
      */
     async getFeatureFlags(flagKeys) {
-        const { remoteFeatureFlags } = await __classPrivateFieldGet(this, _RemoteFeatureFlagsProvider_messenger, "f").call('RemoteFeatureFlagController:getState');
+        const { remoteFeatureFlags } = await this.#messenger.call('RemoteFeatureFlagController:getState');
         return flagKeys.reduce((acc, flagKey) => {
             acc[flagKey] = remoteFeatureFlags[flagKey];
             return acc;
@@ -48,5 +36,4 @@ class RemoteFeatureFlagsProvider {
     }
 }
 exports.RemoteFeatureFlagsProvider = RemoteFeatureFlagsProvider;
-_RemoteFeatureFlagsProvider_messenger = new WeakMap();
 //# sourceMappingURL=RemoteFeatureFlagsProvider.cjs.map

package/dist/providers/remote-feature-flags/RemoteFeatureFlagsProvider.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"RemoteFeatureFlagsProvider.cjs","sourceRoot":"","sources":["../../../src/providers/remote-feature-flags/RemoteFeatureFlagsProvider.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAKA;;GAEG;AACU,QAAA,kCAAkC,GAC7C,4BAAqC,CAAC;AAkBxC,MAAa,0BAA0B;IAGrC,YAAY,EACV,SAAS,GAGV;QANQ,wDAAgD;QAOvD,uBAAA,IAAI,yCAAc,SAAS,MAAA,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,uBAAA,IAAI,6CAAW,CAAC,IAAI,CACvD,sCAAsC,CACvC,CAAC;QAEF,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CACnB,QAAkB;QAElB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,uBAAA,IAAI,6CAAW,CAAC,IAAI,CACvD,sCAAsC,CACvC,CAAC;QAEF,OAAO,QAAQ,CAAC,MAAM,CAAmC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;YACxE,GAAG,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC;CACF;AA5CD,gEA4CC","sourcesContent":["import type { Messenger } from '@metamask/messenger';\nimport type { RemoteFeatureFlagControllerGetStateAction } from '@metamask/remote-feature-flag-controller';\nimport { AsyncMessenger } from '@metamask/snaps-sdk';\nimport type { Json } from '@metamask/utils';\n\n/**\n * Namespace for the {@link RemoteFeatureFlagsProvider} messenger.\n */\nexport const REMOTE_FEATURE_FLAGS_PROVIDER_NAME =\n  'RemoteFeatureFlagsProvider' as const;\n\n/**\n * Actions from other messengers that {@link RemoteFeatureFlagsProvider} calls.\n */\nexport type RemoteFeatureFlagsProviderAllowedActions =\n  RemoteFeatureFlagControllerGetStateAction;\n\n/**\n * Messenger restricted to actions consumed by {@link RemoteFeatureFlagsProvider}.\n */\nexport type RemoteFeatureFlagsProviderMessenger = AsyncMessenger<\n  Messenger<\n    typeof REMOTE_FEATURE_FLAGS_PROVIDER_NAME,\n    RemoteFeatureFlagsProviderAllowedActions\n  >\n>;\n\nexport class RemoteFeatureFlagsProvider {\n  readonly #messenger: RemoteFeatureFlagsProviderMessenger;\n\n  constructor({\n    messenger,\n  }: {\n    messenger: RemoteFeatureFlagsProviderMessenger;\n  }) {\n    this.#messenger = messenger;\n  }\n\n  /**\n   * Returns a single remote feature flag value, or `undefined` if missing.\n   *\n   * @param flagKey - LaunchDarkly / client-config feature flag key.\n   * @returns Flag value, or `undefined`.\n   */\n  async getFeatureFlag(flagKey: string): Promise<Json | undefined> {\n    const { remoteFeatureFlags } = await this.#messenger.call(\n      'RemoteFeatureFlagController:getState',\n    );\n\n    return remoteFeatureFlags[flagKey];\n  }\n\n  /**\n   * Returns remote feature flag values for the given keys, keyed by flag key.\n   * Missing keys are included with value `undefined`.\n   *\n   * @param flagKeys - Feature flag keys to resolve.\n   * @returns Map of flag key → value.\n   */\n  async getFeatureFlags(\n    flagKeys: string[],\n  ): Promise<Record<string, Json | undefined>> {\n    const { remoteFeatureFlags } = await this.#messenger.call(\n      'RemoteFeatureFlagController:getState',\n    );\n\n    return flagKeys.reduce<Record<string, Json | undefined>>((acc, flagKey) => {\n      acc[flagKey] = remoteFeatureFlags[flagKey];\n      return acc;\n    }, {});\n  }\n}\n"]}
+{"version":3,"file":"RemoteFeatureFlagsProvider.cjs","sourceRoot":"","sources":["../../../src/providers/remote-feature-flags/RemoteFeatureFlagsProvider.ts"],"names":[],"mappings":";;;AAKA;;GAEG;AACU,QAAA,kCAAkC,GAC7C,4BAAqC,CAAC;AAkBxC,MAAa,0BAA0B;IAC5B,UAAU,CAAsC;IAEzD,YAAY,EACV,SAAS,GAGV;QACC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACvD,sCAAsC,CACvC,CAAC;QAEF,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CACnB,QAAkB;QAElB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACvD,sCAAsC,CACvC,CAAC;QAEF,OAAO,QAAQ,CAAC,MAAM,CAAmC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;YACxE,GAAG,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC;CACF;AA5CD,gEA4CC","sourcesContent":["import type { Messenger } from '@metamask/messenger';\nimport type { RemoteFeatureFlagControllerGetStateAction } from '@metamask/remote-feature-flag-controller';\nimport { AsyncMessenger } from '@metamask/snaps-sdk';\nimport type { Json } from '@metamask/utils';\n\n/**\n * Namespace for the {@link RemoteFeatureFlagsProvider} messenger.\n */\nexport const REMOTE_FEATURE_FLAGS_PROVIDER_NAME =\n  'RemoteFeatureFlagsProvider' as const;\n\n/**\n * Actions from other messengers that {@link RemoteFeatureFlagsProvider} calls.\n */\nexport type RemoteFeatureFlagsProviderAllowedActions =\n  RemoteFeatureFlagControllerGetStateAction;\n\n/**\n * Messenger restricted to actions consumed by {@link RemoteFeatureFlagsProvider}.\n */\nexport type RemoteFeatureFlagsProviderMessenger = AsyncMessenger<\n  Messenger<\n    typeof REMOTE_FEATURE_FLAGS_PROVIDER_NAME,\n    RemoteFeatureFlagsProviderAllowedActions\n  >\n>;\n\nexport class RemoteFeatureFlagsProvider {\n  readonly #messenger: RemoteFeatureFlagsProviderMessenger;\n\n  constructor({\n    messenger,\n  }: {\n    messenger: RemoteFeatureFlagsProviderMessenger;\n  }) {\n    this.#messenger = messenger;\n  }\n\n  /**\n   * Returns a single remote feature flag value, or `undefined` if missing.\n   *\n   * @param flagKey - LaunchDarkly / client-config feature flag key.\n   * @returns Flag value, or `undefined`.\n   */\n  async getFeatureFlag(flagKey: string): Promise<Json | undefined> {\n    const { remoteFeatureFlags } = await this.#messenger.call(\n      'RemoteFeatureFlagController:getState',\n    );\n\n    return remoteFeatureFlags[flagKey];\n  }\n\n  /**\n   * Returns remote feature flag values for the given keys, keyed by flag key.\n   * Missing keys are included with value `undefined`.\n   *\n   * @param flagKeys - Feature flag keys to resolve.\n   * @returns Map of flag key → value.\n   */\n  async getFeatureFlags(\n    flagKeys: string[],\n  ): Promise<Record<string, Json | undefined>> {\n    const { remoteFeatureFlags } = await this.#messenger.call(\n      'RemoteFeatureFlagController:getState',\n    );\n\n    return flagKeys.reduce<Record<string, Json | undefined>>((acc, flagKey) => {\n      acc[flagKey] = remoteFeatureFlags[flagKey];\n      return acc;\n    }, {});\n  }\n}\n"]}

package/dist/providers/remote-feature-flags/RemoteFeatureFlagsProvider.mjs

@@ -1,23 +1,11 @@
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _RemoteFeatureFlagsProvider_messenger;
 /**
  * Namespace for the {@link RemoteFeatureFlagsProvider} messenger.
  */
 export const REMOTE_FEATURE_FLAGS_PROVIDER_NAME = 'RemoteFeatureFlagsProvider';
 export class RemoteFeatureFlagsProvider {
+    #messenger;
     constructor({ messenger, }) {
-        _RemoteFeatureFlagsProvider_messenger.set(this, void 0);
-        __classPrivateFieldSet(this, _RemoteFeatureFlagsProvider_messenger, messenger, "f");
+        this.#messenger = messenger;
     }
     /**
      * Returns a single remote feature flag value, or `undefined` if missing.
@@ -26,7 +14,7 @@ export class RemoteFeatureFlagsProvider {
      * @returns Flag value, or `undefined`.
      */
     async getFeatureFlag(flagKey) {
-        const { remoteFeatureFlags } = await __classPrivateFieldGet(this, _RemoteFeatureFlagsProvider_messenger, "f").call('RemoteFeatureFlagController:getState');
+        const { remoteFeatureFlags } = await this.#messenger.call('RemoteFeatureFlagController:getState');
         return remoteFeatureFlags[flagKey];
     }
     /**
@@ -37,12 +25,11 @@ export class RemoteFeatureFlagsProvider {
      * @returns Map of flag key → value.
      */
     async getFeatureFlags(flagKeys) {
-        const { remoteFeatureFlags } = await __classPrivateFieldGet(this, _RemoteFeatureFlagsProvider_messenger, "f").call('RemoteFeatureFlagController:getState');
+        const { remoteFeatureFlags } = await this.#messenger.call('RemoteFeatureFlagController:getState');
         return flagKeys.reduce((acc, flagKey) => {
             acc[flagKey] = remoteFeatureFlags[flagKey];
             return acc;
         }, {});
     }
 }
-_RemoteFeatureFlagsProvider_messenger = new WeakMap();
 //# sourceMappingURL=RemoteFeatureFlagsProvider.mjs.map

package/dist/providers/remote-feature-flags/RemoteFeatureFlagsProvider.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"RemoteFeatureFlagsProvider.mjs","sourceRoot":"","sources":["../../../src/providers/remote-feature-flags/RemoteFeatureFlagsProvider.ts"],"names":[],"mappings":";;;;;;;;;;;;AAKA;;GAEG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAC7C,4BAAqC,CAAC;AAkBxC,MAAM,OAAO,0BAA0B;IAGrC,YAAY,EACV,SAAS,GAGV;QANQ,wDAAgD;QAOvD,uBAAA,IAAI,yCAAc,SAAS,MAAA,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,uBAAA,IAAI,6CAAW,CAAC,IAAI,CACvD,sCAAsC,CACvC,CAAC;QAEF,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CACnB,QAAkB;QAElB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,uBAAA,IAAI,6CAAW,CAAC,IAAI,CACvD,sCAAsC,CACvC,CAAC;QAEF,OAAO,QAAQ,CAAC,MAAM,CAAmC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;YACxE,GAAG,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC;CACF","sourcesContent":["import type { Messenger } from '@metamask/messenger';\nimport type { RemoteFeatureFlagControllerGetStateAction } from '@metamask/remote-feature-flag-controller';\nimport { AsyncMessenger } from '@metamask/snaps-sdk';\nimport type { Json } from '@metamask/utils';\n\n/**\n * Namespace for the {@link RemoteFeatureFlagsProvider} messenger.\n */\nexport const REMOTE_FEATURE_FLAGS_PROVIDER_NAME =\n  'RemoteFeatureFlagsProvider' as const;\n\n/**\n * Actions from other messengers that {@link RemoteFeatureFlagsProvider} calls.\n */\nexport type RemoteFeatureFlagsProviderAllowedActions =\n  RemoteFeatureFlagControllerGetStateAction;\n\n/**\n * Messenger restricted to actions consumed by {@link RemoteFeatureFlagsProvider}.\n */\nexport type RemoteFeatureFlagsProviderMessenger = AsyncMessenger<\n  Messenger<\n    typeof REMOTE_FEATURE_FLAGS_PROVIDER_NAME,\n    RemoteFeatureFlagsProviderAllowedActions\n  >\n>;\n\nexport class RemoteFeatureFlagsProvider {\n  readonly #messenger: RemoteFeatureFlagsProviderMessenger;\n\n  constructor({\n    messenger,\n  }: {\n    messenger: RemoteFeatureFlagsProviderMessenger;\n  }) {\n    this.#messenger = messenger;\n  }\n\n  /**\n   * Returns a single remote feature flag value, or `undefined` if missing.\n   *\n   * @param flagKey - LaunchDarkly / client-config feature flag key.\n   * @returns Flag value, or `undefined`.\n   */\n  async getFeatureFlag(flagKey: string): Promise<Json | undefined> {\n    const { remoteFeatureFlags } = await this.#messenger.call(\n      'RemoteFeatureFlagController:getState',\n    );\n\n    return remoteFeatureFlags[flagKey];\n  }\n\n  /**\n   * Returns remote feature flag values for the given keys, keyed by flag key.\n   * Missing keys are included with value `undefined`.\n   *\n   * @param flagKeys - Feature flag keys to resolve.\n   * @returns Map of flag key → value.\n   */\n  async getFeatureFlags(\n    flagKeys: string[],\n  ): Promise<Record<string, Json | undefined>> {\n    const { remoteFeatureFlags } = await this.#messenger.call(\n      'RemoteFeatureFlagController:getState',\n    );\n\n    return flagKeys.reduce<Record<string, Json | undefined>>((acc, flagKey) => {\n      acc[flagKey] = remoteFeatureFlags[flagKey];\n      return acc;\n    }, {});\n  }\n}\n"]}
+{"version":3,"file":"RemoteFeatureFlagsProvider.mjs","sourceRoot":"","sources":["../../../src/providers/remote-feature-flags/RemoteFeatureFlagsProvider.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAC7C,4BAAqC,CAAC;AAkBxC,MAAM,OAAO,0BAA0B;IAC5B,UAAU,CAAsC;IAEzD,YAAY,EACV,SAAS,GAGV;QACC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACvD,sCAAsC,CACvC,CAAC;QAEF,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CACnB,QAAkB;QAElB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACvD,sCAAsC,CACvC,CAAC;QAEF,OAAO,QAAQ,CAAC,MAAM,CAAmC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;YACxE,GAAG,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC;CACF","sourcesContent":["import type { Messenger } from '@metamask/messenger';\nimport type { RemoteFeatureFlagControllerGetStateAction } from '@metamask/remote-feature-flag-controller';\nimport { AsyncMessenger } from '@metamask/snaps-sdk';\nimport type { Json } from '@metamask/utils';\n\n/**\n * Namespace for the {@link RemoteFeatureFlagsProvider} messenger.\n */\nexport const REMOTE_FEATURE_FLAGS_PROVIDER_NAME =\n  'RemoteFeatureFlagsProvider' as const;\n\n/**\n * Actions from other messengers that {@link RemoteFeatureFlagsProvider} calls.\n */\nexport type RemoteFeatureFlagsProviderAllowedActions =\n  RemoteFeatureFlagControllerGetStateAction;\n\n/**\n * Messenger restricted to actions consumed by {@link RemoteFeatureFlagsProvider}.\n */\nexport type RemoteFeatureFlagsProviderMessenger = AsyncMessenger<\n  Messenger<\n    typeof REMOTE_FEATURE_FLAGS_PROVIDER_NAME,\n    RemoteFeatureFlagsProviderAllowedActions\n  >\n>;\n\nexport class RemoteFeatureFlagsProvider {\n  readonly #messenger: RemoteFeatureFlagsProviderMessenger;\n\n  constructor({\n    messenger,\n  }: {\n    messenger: RemoteFeatureFlagsProviderMessenger;\n  }) {\n    this.#messenger = messenger;\n  }\n\n  /**\n   * Returns a single remote feature flag value, or `undefined` if missing.\n   *\n   * @param flagKey - LaunchDarkly / client-config feature flag key.\n   * @returns Flag value, or `undefined`.\n   */\n  async getFeatureFlag(flagKey: string): Promise<Json | undefined> {\n    const { remoteFeatureFlags } = await this.#messenger.call(\n      'RemoteFeatureFlagController:getState',\n    );\n\n    return remoteFeatureFlags[flagKey];\n  }\n\n  /**\n   * Returns remote feature flag values for the given keys, keyed by flag key.\n   * Missing keys are included with value `undefined`.\n   *\n   * @param flagKeys - Feature flag keys to resolve.\n   * @returns Map of flag key → value.\n   */\n  async getFeatureFlags(\n    flagKeys: string[],\n  ): Promise<Record<string, Json | undefined>> {\n    const { remoteFeatureFlags } = await this.#messenger.call(\n      'RemoteFeatureFlagController:getState',\n    );\n\n    return flagKeys.reduce<Record<string, Json | undefined>>((acc, flagKey) => {\n      acc[flagKey] = remoteFeatureFlags[flagKey];\n      return acc;\n    }, {});\n  }\n}\n"]}

package/dist/services/analytics/AnalyticsService.cjs

@@ -0,0 +1,225 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyticsService = exports.SecurityEventType = exports.TransactionEventType = void 0;
+exports.TransactionEventType = {
+    TransactionAdded: 'Transaction Added',
+    TransactionRejected: 'Transaction Rejected',
+    TransactionApproved: 'Transaction Approved',
+    TransactionSubmitted: 'Transaction Submitted',
+    TransactionFinalized: 'Transaction Finalized',
+};
+exports.SecurityEventType = {
+    SecurityAlertDetected: 'Security Alert Detected',
+    SecurityScanCompleted: 'Security Scan Completed',
+};
+/**
+ * Tracks common network Snap analytics events.
+ */
+class AnalyticsService {
+    #getSnapProvider;
+    #logger;
+    #trackError;
+    constructor({ getSnapProvider, logger, trackError, }) {
+        this.#getSnapProvider = getSnapProvider;
+        this.#logger = logger.withPrefix('[AnalyticsService]');
+        this.#trackError = trackError;
+    }
+    /**
+     * Track an event in MetaMask analytics.
+     *
+     * Tracking and error-reporting failures are logged but never interrupt the
+     * user flow.
+     *
+     * @param event - Event name.
+     * @param properties - Event properties.
+     */
+    async trackEvent(event, properties) {
+        try {
+            await this.#getSnapProvider().request({
+                method: 'snap_trackEvent',
+                params: {
+                    event: {
+                        event,
+                        properties,
+                    },
+                },
+            });
+        }
+        catch (error) {
+            try {
+                await this.#trackError(error);
+            }
+            catch (trackingError) {
+                this.#logger.warn('Failed to report analytics error', {
+                    error: trackingError,
+                });
+            }
+            this.#logger.warn('Failed to track event', {
+                error,
+                event,
+                properties,
+            });
+        }
+    }
+    /**
+     * Track a "Transaction Added" event when a transaction confirmation is shown.
+     *
+     * @param properties - Event properties.
+     * @param properties.origin - The origin of the request.
+     * @param properties.accountType - The type of account.
+     * @param properties.chainIdCaip - The CAIP-2 chain ID.
+     * @param properties.transactionType - Optional transaction type.
+     */
+    async trackTransactionAdded(properties) {
+        await this.#trackTransactionEvent(exports.TransactionEventType.TransactionAdded, 'Snap transaction added', properties);
+    }
+    /**
+     * Track a "Transaction Rejected" event when the user rejects a transaction.
+     *
+     * @param properties - Event properties.
+     * @param properties.origin - The origin of the request.
+     * @param properties.accountType - The type of account.
+     * @param properties.chainIdCaip - The CAIP-2 chain ID.
+     * @param properties.transactionType - Optional transaction type.
+     */
+    async trackTransactionRejected(properties) {
+        await this.#trackTransactionEvent(exports.TransactionEventType.TransactionRejected, 'Snap transaction rejected', properties);
+    }
+    /**
+     * Track a "Transaction Approved" event when a transaction is approved.
+     *
+     * @param properties - Event properties.
+     * @param properties.origin - The origin of the request.
+     * @param properties.accountType - The type of account.
+     * @param properties.chainIdCaip - The CAIP-2 chain ID.
+     * @param properties.transactionType - Optional transaction type.
+     */
+    async trackTransactionApproved(properties) {
+        await this.#trackTransactionEvent(exports.TransactionEventType.TransactionApproved, 'Snap transaction approved', properties);
+    }
+    /**
+     * Track a "Transaction Submitted" event when a transaction is broadcast.
+     *
+     * @param properties - Event properties.
+     * @param properties.origin - The origin of the request.
+     * @param properties.accountType - The type of account.
+     * @param properties.chainIdCaip - The CAIP-2 chain ID.
+     * @param properties.transactionType - Optional transaction type.
+     */
+    async trackTransactionSubmitted(properties) {
+        await this.#trackTransactionEvent(exports.TransactionEventType.TransactionSubmitted, 'Snap transaction submitted', properties);
+    }
+    /**
+     * Track a "Transaction Finalized" event when a transaction reaches a final state.
+     *
+     * @param properties - Event properties.
+     * @param properties.origin - The origin of the request.
+     * @param properties.accountType - The type of account.
+     * @param properties.chainIdCaip - The CAIP-2 chain ID.
+     * @param properties.transactionStatus - Optional final transaction status.
+     * @param properties.transactionType - Optional transaction type.
+     */
+    async trackTransactionFinalized({ origin, accountType, chainIdCaip, transactionStatus, transactionType, }) {
+        await this.trackEvent(exports.TransactionEventType.TransactionFinalized, {
+            message: 'Snap transaction finalized',
+            origin,
+            account_type: accountType,
+            chain_id_caip: chainIdCaip,
+            ...(transactionStatus === undefined
+                ? {}
+                : { transaction_status: transactionStatus }),
+            ...(transactionType === undefined
+                ? {}
+                : { transaction_type: transactionType }),
+        });
+    }
+    /**
+     * Track a "Security Alert Detected" event when a malicious or warning
+     * transaction is detected.
+     *
+     * @param properties - Event properties.
+     * @param properties.origin - The origin of the request.
+     * @param properties.accountType - The type of account.
+     * @param properties.chainIdCaip - The CAIP-2 chain ID.
+     * @param properties.securityAlertResponse - The type of security alert.
+     * @param properties.securityAlertReason - The reason for the security alert.
+     * @param properties.securityAlertDescription - Human-readable description of the alert.
+     */
+    async trackSecurityAlertDetected({ origin, accountType, chainIdCaip, securityAlertResponse, securityAlertReason, securityAlertDescription, }) {
+        await this.trackEvent(exports.SecurityEventType.SecurityAlertDetected, {
+            message: 'Snap security alert detected',
+            origin,
+            account_type: accountType,
+            chain_id_caip: chainIdCaip,
+            security_alert_response: securityAlertResponse,
+            security_alert_reason: securityAlertReason,
+            security_alert_description: securityAlertDescription,
+        });
+    }
+    /**
+     * Track a "Security Scan Completed" event when a transaction security scan
+     * finishes.
+     *
+     * @param properties - Event properties.
+     * @param properties.origin - The origin of the request.
+     * @param properties.accountType - The type of account.
+     * @param properties.chainIdCaip - The CAIP-2 chain ID.
+     * @param properties.scanStatus - The status of the scan.
+     * @param properties.hasSecurityAlerts - Whether security alerts were detected.
+     */
+    async trackSecurityScanCompleted({ origin, accountType, chainIdCaip, scanStatus, hasSecurityAlerts, }) {
+        await this.trackEvent(exports.SecurityEventType.SecurityScanCompleted, {
+            message: 'Snap security scan completed',
+            origin,
+            account_type: accountType,
+            chain_id_caip: chainIdCaip,
+            scan_status: scanStatus,
+            has_security_alerts: hasSecurityAlerts,
+        });
+    }
+    /**
+     * Track a "WebSocket Connection Closed Not Cleanly" event when a Snap
+     * WebSocket disconnects without a clean close.
+     *
+     * @param properties - Event properties.
+     * @param properties.origin - The origin of the connection.
+     * @param properties.code - The WebSocket close code.
+     * @param properties.reason - The close reason, if any.
+     */
+    async trackWebSocketConnectionClosedNotCleanly({ origin, code, reason, }) {
+        await this.trackEvent('WebSocket Connection Closed Not Cleanly', {
+            message: 'Snap WebSocket connection closed not cleanly',
+            origin,
+            code,
+            reason,
+        });
+    }
+    /**
+     * Track a transaction lifecycle event.
+     *
+     * Centralizes the shared payload so the common properties only have to change
+     * in one place. `transaction_type` is added only when the emitting Snap could
+     * classify the transaction.
+     *
+     * @param event - Event name.
+     * @param message - Human-readable event message.
+     * @param properties - Event properties.
+     * @param properties.origin - The origin of the request.
+     * @param properties.accountType - The type of account.
+     * @param properties.chainIdCaip - The CAIP-2 chain ID.
+     * @param properties.transactionType - Optional transaction type.
+     */
+    async #trackTransactionEvent(event, message, { origin, accountType, chainIdCaip, transactionType, }) {
+        await this.trackEvent(event, {
+            message,
+            origin,
+            account_type: accountType,
+            chain_id_caip: chainIdCaip,
+            ...(transactionType === undefined
+                ? {}
+                : { transaction_type: transactionType }),
+        });
+    }
+}
+exports.AnalyticsService = AnalyticsService;
+//# sourceMappingURL=AnalyticsService.cjs.map

package/dist/services/analytics/AnalyticsService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsService.cjs","sourceRoot":"","sources":["../../../src/services/analytics/AnalyticsService.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TransactionType } from '@metamask/keyring-api';\nimport type { Json } from '@metamask/snaps-sdk';\n\nimport type { TrackErrorFn } from '../../utils/errors';\nimport type { Logger } from '../../utils/logger/Logger';\n\nexport const TransactionEventType = {\n  TransactionAdded: 'Transaction Added',\n  TransactionRejected: 'Transaction Rejected',\n  TransactionApproved: 'Transaction Approved',\n  TransactionSubmitted: 'Transaction Submitted',\n  TransactionFinalized: 'Transaction Finalized',\n} as const;\n\nexport type TransactionEventType =\n  (typeof TransactionEventType)[keyof typeof TransactionEventType];\n\nexport const SecurityEventType = {\n  SecurityAlertDetected: 'Security Alert Detected',\n  SecurityScanCompleted: 'Security Scan Completed',\n} as const;\n\nexport type SecurityEventType =\n  (typeof SecurityEventType)[keyof typeof SecurityEventType];\n\nexport type SnapTrackEventRequest = {\n  method: 'snap_trackEvent';\n  params: {\n    event: {\n      event: string;\n      properties: Record<string, Json>;\n    };\n  };\n};\n\nexport type TrackEventCapableProvider = {\n  request: (args: SnapTrackEventRequest) => Promise<unknown>;\n};\n\nexport type AnalyticsServiceOptions<\n  TProvider extends TrackEventCapableProvider = TrackEventCapableProvider,\n> = {\n  getSnapProvider: () => TProvider;\n  logger: Logger;\n  trackError: TrackErrorFn;\n};\n\n/**\n * Fields shared by every event tied to an account on a chain.\n */\nexport type AccountEventProperties = {\n  origin: string;\n  accountType: string;\n  chainIdCaip: string;\n};\n\n/**\n * Properties of a transaction lifecycle event.\n *\n * `transactionType` is the optional classification of the transaction.\n *\n * Security events intentionally do not extend this type: they are not tied to a\n * transaction classification, so advertising `transactionType` there would let\n * callers pass a value that is silently discarded.\n */\nexport type TransactionEventProperties = AccountEventProperties & {\n  transactionType?: `${TransactionType}`;\n};\n\nexport type TransactionFinalizedEventProperties = TransactionEventProperties & {\n  transactionStatus?: string;\n};\n\nexport type SecurityAlertDetectedEventProperties = AccountEventProperties & {\n  securityAlertResponse: string;\n  securityAlertReason: string | null;\n  securityAlertDescription: string;\n};\n\nexport type SecurityScanCompletedEventProperties = AccountEventProperties & {\n  scanStatus: string;\n  hasSecurityAlerts: boolean;\n};\n\nexport type WebSocketConnectionClosedEventProperties = {\n  origin: string;\n  code: number;\n  reason: string | null;\n};\n\n/**\n * Tracks common network Snap analytics events.\n */\nexport class AnalyticsService<\n  TProvider extends TrackEventCapableProvider = TrackEventCapableProvider,\n> {\n  readonly #getSnapProvider: () => TProvider;\n\n  readonly #logger: Logger;\n\n  readonly #trackError: TrackErrorFn;\n\n  constructor({\n    getSnapProvider,\n    logger,\n    trackError,\n  }: AnalyticsServiceOptions<TProvider>) {\n    this.#getSnapProvider = getSnapProvider;\n    this.#logger = logger.withPrefix('[AnalyticsService]');\n    this.#trackError = trackError;\n  }\n\n  /**\n   * Track an event in MetaMask analytics.\n   *\n   * Tracking and error-reporting failures are logged but never interrupt the\n   * user flow.\n   *\n   * @param event - Event name.\n   * @param properties - Event properties.\n   */\n  async trackEvent(\n    event: string,\n    properties: Record<string, Json>,\n  ): Promise<void> {\n    try {\n      await this.#getSnapProvider().request({\n        method: 'snap_trackEvent',\n        params: {\n          event: {\n            event,\n            properties,\n          },\n        },\n      });\n    } catch (error) {\n      try {\n        await this.#trackError(error);\n      } catch (trackingError) {\n        this.#logger.warn('Failed to report analytics error', {\n          error: trackingError,\n        });\n      }\n\n      this.#logger.warn('Failed to track event', {\n        error,\n        event,\n        properties,\n      });\n    }\n  }\n\n  /**\n   * Track a \"Transaction Added\" event when a transaction confirmation is shown.\n   *\n   * @param properties - Event properties.\n   * @param properties.origin - The origin of the request.\n   * @param properties.accountType - The type of account.\n   * @param properties.chainIdCaip - The CAIP-2 chain ID.\n   * @param properties.transactionType - Optional transaction type.\n   */\n  async trackTransactionAdded(\n    properties: TransactionEventProperties,\n  ): Promise<void> {\n    await this.#trackTransactionEvent(\n      TransactionEventType.TransactionAdded,\n      'Snap transaction added',\n      properties,\n    );\n  }\n\n  /**\n   * Track a \"Transaction Rejected\" event when the user rejects a transaction.\n   *\n   * @param properties - Event properties.\n   * @param properties.origin - The origin of the request.\n   * @param properties.accountType - The type of account.\n   * @param properties.chainIdCaip - The CAIP-2 chain ID.\n   * @param properties.transactionType - Optional transaction type.\n   */\n  async trackTransactionRejected(\n    properties: TransactionEventProperties,\n  ): Promise<void> {\n    await this.#trackTransactionEvent(\n      TransactionEventType.TransactionRejected,\n      'Snap transaction rejected',\n      properties,\n    );\n  }\n\n  /**\n   * Track a \"Transaction Approved\" event when a transaction is approved.\n   *\n   * @param properties - Event properties.\n   * @param properties.origin - The origin of the request.\n   * @param properties.accountType - The type of account.\n   * @param properties.chainIdCaip - The CAIP-2 chain ID.\n   * @param properties.transactionType - Optional transaction type.\n   */\n  async trackTransactionApproved(\n    properties: TransactionEventProperties,\n  ): Promise<void> {\n    await this.#trackTransactionEvent(\n      TransactionEventType.TransactionApproved,\n      'Snap transaction approved',\n      properties,\n    );\n  }\n\n  /**\n   * Track a \"Transaction Submitted\" event when a transaction is broadcast.\n   *\n   * @param properties - Event properties.\n   * @param properties.origin - The origin of the request.\n   * @param properties.accountType - The type of account.\n   * @param properties.chainIdCaip - The CAIP-2 chain ID.\n   * @param properties.transactionType - Optional transaction type.\n   */\n  async trackTransactionSubmitted(\n    properties: TransactionEventProperties,\n  ): Promise<void> {\n    await this.#trackTransactionEvent(\n      TransactionEventType.TransactionSubmitted,\n      'Snap transaction submitted',\n      properties,\n    );\n  }\n\n  /**\n   * Track a \"Transaction Finalized\" event when a transaction reaches a final state.\n   *\n   * @param properties - Event properties.\n   * @param properties.origin - The origin of the request.\n   * @param properties.accountType - The type of account.\n   * @param properties.chainIdCaip - The CAIP-2 chain ID.\n   * @param properties.transactionStatus - Optional final transaction status.\n   * @param properties.transactionType - Optional transaction type.\n   */\n  async trackTransactionFinalized({\n    origin,\n    accountType,\n    chainIdCaip,\n    transactionStatus,\n    transactionType,\n  }: TransactionFinalizedEventProperties): Promise<void> {\n    await this.trackEvent(TransactionEventType.TransactionFinalized, {\n      message: 'Snap transaction finalized',\n      origin,\n      account_type: accountType,\n      chain_id_caip: chainIdCaip,\n      ...(transactionStatus === undefined\n        ? {}\n        : { transaction_status: transactionStatus }),\n      ...(transactionType === undefined\n        ? {}\n        : { transaction_type: transactionType }),\n    });\n  }\n\n  /**\n   * Track a \"Security Alert Detected\" event when a malicious or warning\n   * transaction is detected.\n   *\n   * @param properties - Event properties.\n   * @param properties.origin - The origin of the request.\n   * @param properties.accountType - The type of account.\n   * @param properties.chainIdCaip - The CAIP-2 chain ID.\n   * @param properties.securityAlertResponse - The type of security alert.\n   * @param properties.securityAlertReason - The reason for the security alert.\n   * @param properties.securityAlertDescription - Human-readable description of the alert.\n   */\n  async trackSecurityAlertDetected({\n    origin,\n    accountType,\n    chainIdCaip,\n    securityAlertResponse,\n    securityAlertReason,\n    securityAlertDescription,\n  }: SecurityAlertDetectedEventProperties): Promise<void> {\n    await this.trackEvent(SecurityEventType.SecurityAlertDetected, {\n      message: 'Snap security alert detected',\n      origin,\n      account_type: accountType,\n      chain_id_caip: chainIdCaip,\n      security_alert_response: securityAlertResponse,\n      security_alert_reason: securityAlertReason,\n      security_alert_description: securityAlertDescription,\n    });\n  }\n\n  /**\n   * Track a \"Security Scan Completed\" event when a transaction security scan\n   * finishes.\n   *\n   * @param properties - Event properties.\n   * @param properties.origin - The origin of the request.\n   * @param properties.accountType - The type of account.\n   * @param properties.chainIdCaip - The CAIP-2 chain ID.\n   * @param properties.scanStatus - The status of the scan.\n   * @param properties.hasSecurityAlerts - Whether security alerts were detected.\n   */\n  async trackSecurityScanCompleted({\n    origin,\n    accountType,\n    chainIdCaip,\n    scanStatus,\n    hasSecurityAlerts,\n  }: SecurityScanCompletedEventProperties): Promise<void> {\n    await this.trackEvent(SecurityEventType.SecurityScanCompleted, {\n      message: 'Snap security scan completed',\n      origin,\n      account_type: accountType,\n      chain_id_caip: chainIdCaip,\n      scan_status: scanStatus,\n      has_security_alerts: hasSecurityAlerts,\n    });\n  }\n\n  /**\n   * Track a \"WebSocket Connection Closed Not Cleanly\" event when a Snap\n   * WebSocket disconnects without a clean close.\n   *\n   * @param properties - Event properties.\n   * @param properties.origin - The origin of the connection.\n   * @param properties.code - The WebSocket close code.\n   * @param properties.reason - The close reason, if any.\n   */\n  async trackWebSocketConnectionClosedNotCleanly({\n    origin,\n    code,\n    reason,\n  }: WebSocketConnectionClosedEventProperties): Promise<void> {\n    await this.trackEvent('WebSocket Connection Closed Not Cleanly', {\n      message: 'Snap WebSocket connection closed not cleanly',\n      origin,\n      code,\n      reason,\n    });\n  }\n\n  /**\n   * Track a transaction lifecycle event.\n   *\n   * Centralizes the shared payload so the common properties only have to change\n   * in one place. `transaction_type` is added only when the emitting Snap could\n   * classify the transaction.\n   *\n   * @param event - Event name.\n   * @param message - Human-readable event message.\n   * @param properties - Event properties.\n   * @param properties.origin - The origin of the request.\n   * @param properties.accountType - The type of account.\n   * @param properties.chainIdCaip - The CAIP-2 chain ID.\n   * @param properties.transactionType - Optional transaction type.\n   */\n  async #trackTransactionEvent(\n    event: TransactionEventType,\n    message: string,\n    {\n      origin,\n      accountType,\n      chainIdCaip,\n      transactionType,\n    }: TransactionEventProperties,\n  ): Promise<void> {\n    await this.trackEvent(event, {\n      message,\n      origin,\n      account_type: accountType,\n      chain_id_caip: chainIdCaip,\n      ...(transactionType === undefined\n        ? {}\n        : { transaction_type: transactionType }),\n    });\n  }\n}\n"]}