@metamask-previews/snap-account-service 2.1.2-preview-4f4c98e → 2.1.2-preview-eb263b0ee

package/CHANGELOG.md

@@ -36,7 +36,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
-- **BREAKING:** Bump minimum Node.js version to 22 ([#9168](https://github.com/MetaMask/core/pull/9168))
 - Bump `@metamask/account-tree-controller` from `^7.5.4` to `^7.5.5` ([#9470](https://github.com/MetaMask/core/pull/9470))
 - Bump `@metamask/account-api` from `^1.0.4` to `^1.1.1` ([#9676](https://github.com/MetaMask/core/pull/9676))
 - Bump `@metamask/keyring-api` from `^23.5.0` to `^23.7.0` ([#9676](https://github.com/MetaMask/core/pull/9676))

package/dist/SnapAccountService-method-action-types.cjs

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=SnapAccountService-method-action-types.cjs.map

package/dist/SnapAccountService-method-action-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapAccountService-method-action-types.cjs","sourceRoot":"","sources":["../src/SnapAccountService-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { SnapAccountService } from './SnapAccountService.js';\n\n/**\n * Returns the IDs of all currently tracked account-management Snaps —\n * Snaps that are installed, enabled, not blocked, and have the\n * `endowment:keyring` permission.\n *\n * @returns The IDs of tracked account-management Snaps.\n */\nexport type SnapAccountServiceGetSnapsAction = {\n  type: `SnapAccountService:getSnaps`;\n  handler: SnapAccountService['getSnaps'];\n};\n\n/**\n * Ensures everything is ready to use Snap accounts for the given Snap.\n * 1. Validates that `snapId` is a tracked account-management Snap.\n * 2. Asserts that the legacy -> v2 migration has been triggered (expected to\n * happen at `KeyringController:unlock` time).\n * 3. Atomically creates the v2 keyring for this Snap if it doesn't exist\n * yet.\n * 4. Waits for the Snap platform to be fully started.\n *\n * Safe to call concurrently — each step is idempotent or mutex-protected.\n *\n * @param snapId - ID of the Snap to ensure readiness for.\n * @throws If `snapId` is not a tracked account-management Snap.\n * @throws If the migration has not been triggered yet (wallet not unlocked).\n */\nexport type SnapAccountServiceEnsureReadyAction = {\n  type: `SnapAccountService:ensureReady`;\n  handler: SnapAccountService['ensureReady'];\n};\n\n/**\n * Migrate the legacy Snap keyring to the new (per-snap) Snap keyring v2.\n * Expected to be triggered at `KeyringController:unlock` time.\n * Safe to call concurrently — the migration runs only once; all callers\n * await the same promise.\n *\n * @returns A promise that resolves when the migration is complete.\n */\nexport type SnapAccountServiceEnsureMigratedAction = {\n  type: `SnapAccountService:ensureMigrated`;\n  handler: SnapAccountService['ensureMigrated'];\n};\n\n/**\n * Returns the keyring capabilities declared by the given Snap. These are\n * populated by the bridge keyring from the Snap's manifest, and describe\n * which keyring features the Snap supports (scopes, BIP-44 options, etc.).\n *\n * Consumers use this to decide whether to drive the Snap through the v1 or\n * v2 keyring path. Reading capabilities does not mutate state, so the\n * lock-free keyring access is used.\n *\n * @param snapId - ID of the Snap.\n * @returns The Snap's keyring capabilities.\n */\nexport type SnapAccountServiceGetCapabilitiesAction = {\n  type: `SnapAccountService:getCapabilities`;\n  handler: SnapAccountService['getCapabilities'];\n};\n\n/**\n * Returns the CAIP-19 asset type/ID list supported by an account.\n *\n * @param snapId - ID of the Snap.\n * @param id - ID of the account.\n * @returns A promise resolving to the list of supported CAIP-19 asset type/IDs.\n */\nexport type SnapAccountServiceGetAccountAssetsAction = {\n  type: `SnapAccountService:getAccountAssets`;\n  handler: SnapAccountService['getAccountAssets'];\n};\n\n/**\n * Returns the balances for an account for the requested asset types.\n *\n * @param snapId - ID of the Snap.\n * @param id - ID of the account.\n * @param assets - List of CAIP-19 fungible asset types to fetch balances for.\n * @returns A promise resolving to a map of asset type to balance.\n */\nexport type SnapAccountServiceGetAccountBalancesAction = {\n  type: `SnapAccountService:getAccountBalances`;\n  handler: SnapAccountService['getAccountBalances'];\n};\n\n/**\n * Returns a page of transactions for an account.\n *\n * @param snapId - ID of the Snap.\n * @param id - ID of the account.\n * @param pagination - Pagination options.\n * @returns A promise resolving to a page of transactions.\n */\nexport type SnapAccountServiceGetAccountTransactionsAction = {\n  type: `SnapAccountService:getAccountTransactions`;\n  handler: SnapAccountService['getAccountTransactions'];\n};\n\n/**\n * Resolves the account address to use for routing a signing request.\n *\n * @param snapId - ID of the Snap.\n * @param scope - CAIP-2 chain ID of the signing request.\n * @param request - The signing JSON-RPC request.\n * @returns A promise resolving to the resolved address, or `null` if the\n * Snap cannot determine an address for this request.\n */\nexport type SnapAccountServiceResolveAccountAddressAction = {\n  type: `SnapAccountService:resolveAccountAddress`;\n  handler: SnapAccountService['resolveAccountAddress'];\n};\n\n/**\n * Notifies a Snap of the currently selected accounts.\n *\n * For v1 Snaps the call goes through the keyring (signing interface); for\n * v2 Snaps it is routed via the RPC client because the keyring only covers\n * keyring-only operations (signing, account lifecycle).\n *\n * @param snapId - ID of the Snap.\n * @param accounts - IDs of the accounts to mark as selected.\n */\nexport type SnapAccountServiceSetSelectedAccountsAction = {\n  type: `SnapAccountService:setSelectedAccounts`;\n  handler: SnapAccountService['setSelectedAccounts'];\n};\n\n/**\n * Handle a message from a Snap.\n *\n * @param snapId - ID of the Snap.\n * @param message - Message sent by the Snap.\n * @returns The execution result.\n */\nexport type SnapAccountServiceHandleKeyringSnapMessageAction = {\n  type: `SnapAccountService:handleKeyringSnapMessage`;\n  handler: SnapAccountService['handleKeyringSnapMessage'];\n};\n\n/**\n * Union of all SnapAccountService action types.\n */\nexport type SnapAccountServiceMethodActions =\n  | SnapAccountServiceGetSnapsAction\n  | SnapAccountServiceEnsureReadyAction\n  | SnapAccountServiceEnsureMigratedAction\n  | SnapAccountServiceGetCapabilitiesAction\n  | SnapAccountServiceGetAccountAssetsAction\n  | SnapAccountServiceGetAccountBalancesAction\n  | SnapAccountServiceGetAccountTransactionsAction\n  | SnapAccountServiceResolveAccountAddressAction\n  | SnapAccountServiceSetSelectedAccountsAction\n  | SnapAccountServiceHandleKeyringSnapMessageAction;\n"]}

package/dist/{SnapAccountService-method-action-types.d.ts → SnapAccountService-method-action-types.d.cts}

@@ -2,7 +2,7 @@
  * This file is auto generated.
  * Do not edit manually.
  */
-import type { SnapAccountService } from './SnapAccountService.js';
+import type { SnapAccountService } from "./SnapAccountService.cjs";
 /**
  * Returns the IDs of all currently tracked account-management Snaps —
  * Snaps that are installed, enabled, not blocked, and have the
@@ -138,4 +138,4 @@ export type SnapAccountServiceHandleKeyringSnapMessageAction = {
  * Union of all SnapAccountService action types.
  */
 export type SnapAccountServiceMethodActions = SnapAccountServiceGetSnapsAction | SnapAccountServiceEnsureReadyAction | SnapAccountServiceEnsureMigratedAction | SnapAccountServiceGetCapabilitiesAction | SnapAccountServiceGetAccountAssetsAction | SnapAccountServiceGetAccountBalancesAction | SnapAccountServiceGetAccountTransactionsAction | SnapAccountServiceResolveAccountAddressAction | SnapAccountServiceSetSelectedAccountsAction | SnapAccountServiceHandleKeyringSnapMessageAction;
-//# sourceMappingURL=SnapAccountService-method-action-types.d.ts.map
+//# sourceMappingURL=SnapAccountService-method-action-types.d.cts.map

package/dist/SnapAccountService-method-action-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapAccountService-method-action-types.d.cts","sourceRoot":"","sources":["../src/SnapAccountService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iCAAgC;AAElE;;;;;;GAMG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C,IAAI,EAAE,6BAA6B,CAAC;IACpC,OAAO,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;CACzC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,gCAAgC,CAAC;IACvC,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,sCAAsC,GAAG;IACnD,IAAI,EAAE,mCAAmC,CAAC;IAC1C,OAAO,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;CAC/C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,uCAAuC,GAAG;IACpD,IAAI,EAAE,oCAAoC,CAAC;IAC3C,OAAO,EAAE,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;CAChD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,qCAAqC,CAAC;IAC5C,OAAO,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,0CAA0C,GAAG;IACvD,IAAI,EAAE,uCAAuC,CAAC;IAC9C,OAAO,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;CACnD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,8CAA8C,GAAG;IAC3D,IAAI,EAAE,2CAA2C,CAAC;IAClD,OAAO,EAAE,kBAAkB,CAAC,wBAAwB,CAAC,CAAC;CACvD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,6CAA6C,GAAG;IAC1D,IAAI,EAAE,0CAA0C,CAAC;IACjD,OAAO,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;CACtD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,gDAAgD,GAAG;IAC7D,IAAI,EAAE,6CAA6C,CAAC;IACpD,OAAO,EAAE,kBAAkB,CAAC,0BAA0B,CAAC,CAAC;CACzD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACvC,gCAAgC,GAChC,mCAAmC,GACnC,sCAAsC,GACtC,uCAAuC,GACvC,wCAAwC,GACxC,0CAA0C,GAC1C,8CAA8C,GAC9C,6CAA6C,GAC7C,2CAA2C,GAC3C,gDAAgD,CAAC"}

package/dist/SnapAccountService-method-action-types.d.mts

@@ -0,0 +1,141 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+import type { SnapAccountService } from "./SnapAccountService.mjs";
+/**
+ * Returns the IDs of all currently tracked account-management Snaps —
+ * Snaps that are installed, enabled, not blocked, and have the
+ * `endowment:keyring` permission.
+ *
+ * @returns The IDs of tracked account-management Snaps.
+ */
+export type SnapAccountServiceGetSnapsAction = {
+    type: `SnapAccountService:getSnaps`;
+    handler: SnapAccountService['getSnaps'];
+};
+/**
+ * Ensures everything is ready to use Snap accounts for the given Snap.
+ * 1. Validates that `snapId` is a tracked account-management Snap.
+ * 2. Asserts that the legacy -> v2 migration has been triggered (expected to
+ * happen at `KeyringController:unlock` time).
+ * 3. Atomically creates the v2 keyring for this Snap if it doesn't exist
+ * yet.
+ * 4. Waits for the Snap platform to be fully started.
+ *
+ * Safe to call concurrently — each step is idempotent or mutex-protected.
+ *
+ * @param snapId - ID of the Snap to ensure readiness for.
+ * @throws If `snapId` is not a tracked account-management Snap.
+ * @throws If the migration has not been triggered yet (wallet not unlocked).
+ */
+export type SnapAccountServiceEnsureReadyAction = {
+    type: `SnapAccountService:ensureReady`;
+    handler: SnapAccountService['ensureReady'];
+};
+/**
+ * Migrate the legacy Snap keyring to the new (per-snap) Snap keyring v2.
+ * Expected to be triggered at `KeyringController:unlock` time.
+ * Safe to call concurrently — the migration runs only once; all callers
+ * await the same promise.
+ *
+ * @returns A promise that resolves when the migration is complete.
+ */
+export type SnapAccountServiceEnsureMigratedAction = {
+    type: `SnapAccountService:ensureMigrated`;
+    handler: SnapAccountService['ensureMigrated'];
+};
+/**
+ * Returns the keyring capabilities declared by the given Snap. These are
+ * populated by the bridge keyring from the Snap's manifest, and describe
+ * which keyring features the Snap supports (scopes, BIP-44 options, etc.).
+ *
+ * Consumers use this to decide whether to drive the Snap through the v1 or
+ * v2 keyring path. Reading capabilities does not mutate state, so the
+ * lock-free keyring access is used.
+ *
+ * @param snapId - ID of the Snap.
+ * @returns The Snap's keyring capabilities.
+ */
+export type SnapAccountServiceGetCapabilitiesAction = {
+    type: `SnapAccountService:getCapabilities`;
+    handler: SnapAccountService['getCapabilities'];
+};
+/**
+ * Returns the CAIP-19 asset type/ID list supported by an account.
+ *
+ * @param snapId - ID of the Snap.
+ * @param id - ID of the account.
+ * @returns A promise resolving to the list of supported CAIP-19 asset type/IDs.
+ */
+export type SnapAccountServiceGetAccountAssetsAction = {
+    type: `SnapAccountService:getAccountAssets`;
+    handler: SnapAccountService['getAccountAssets'];
+};
+/**
+ * Returns the balances for an account for the requested asset types.
+ *
+ * @param snapId - ID of the Snap.
+ * @param id - ID of the account.
+ * @param assets - List of CAIP-19 fungible asset types to fetch balances for.
+ * @returns A promise resolving to a map of asset type to balance.
+ */
+export type SnapAccountServiceGetAccountBalancesAction = {
+    type: `SnapAccountService:getAccountBalances`;
+    handler: SnapAccountService['getAccountBalances'];
+};
+/**
+ * Returns a page of transactions for an account.
+ *
+ * @param snapId - ID of the Snap.
+ * @param id - ID of the account.
+ * @param pagination - Pagination options.
+ * @returns A promise resolving to a page of transactions.
+ */
+export type SnapAccountServiceGetAccountTransactionsAction = {
+    type: `SnapAccountService:getAccountTransactions`;
+    handler: SnapAccountService['getAccountTransactions'];
+};
+/**
+ * Resolves the account address to use for routing a signing request.
+ *
+ * @param snapId - ID of the Snap.
+ * @param scope - CAIP-2 chain ID of the signing request.
+ * @param request - The signing JSON-RPC request.
+ * @returns A promise resolving to the resolved address, or `null` if the
+ * Snap cannot determine an address for this request.
+ */
+export type SnapAccountServiceResolveAccountAddressAction = {
+    type: `SnapAccountService:resolveAccountAddress`;
+    handler: SnapAccountService['resolveAccountAddress'];
+};
+/**
+ * Notifies a Snap of the currently selected accounts.
+ *
+ * For v1 Snaps the call goes through the keyring (signing interface); for
+ * v2 Snaps it is routed via the RPC client because the keyring only covers
+ * keyring-only operations (signing, account lifecycle).
+ *
+ * @param snapId - ID of the Snap.
+ * @param accounts - IDs of the accounts to mark as selected.
+ */
+export type SnapAccountServiceSetSelectedAccountsAction = {
+    type: `SnapAccountService:setSelectedAccounts`;
+    handler: SnapAccountService['setSelectedAccounts'];
+};
+/**
+ * Handle a message from a Snap.
+ *
+ * @param snapId - ID of the Snap.
+ * @param message - Message sent by the Snap.
+ * @returns The execution result.
+ */
+export type SnapAccountServiceHandleKeyringSnapMessageAction = {
+    type: `SnapAccountService:handleKeyringSnapMessage`;
+    handler: SnapAccountService['handleKeyringSnapMessage'];
+};
+/**
+ * Union of all SnapAccountService action types.
+ */
+export type SnapAccountServiceMethodActions = SnapAccountServiceGetSnapsAction | SnapAccountServiceEnsureReadyAction | SnapAccountServiceEnsureMigratedAction | SnapAccountServiceGetCapabilitiesAction | SnapAccountServiceGetAccountAssetsAction | SnapAccountServiceGetAccountBalancesAction | SnapAccountServiceGetAccountTransactionsAction | SnapAccountServiceResolveAccountAddressAction | SnapAccountServiceSetSelectedAccountsAction | SnapAccountServiceHandleKeyringSnapMessageAction;
+//# sourceMappingURL=SnapAccountService-method-action-types.d.mts.map

package/dist/SnapAccountService-method-action-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapAccountService-method-action-types.d.mts","sourceRoot":"","sources":["../src/SnapAccountService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iCAAgC;AAElE;;;;;;GAMG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C,IAAI,EAAE,6BAA6B,CAAC;IACpC,OAAO,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;CACzC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,gCAAgC,CAAC;IACvC,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,sCAAsC,GAAG;IACnD,IAAI,EAAE,mCAAmC,CAAC;IAC1C,OAAO,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;CAC/C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,uCAAuC,GAAG;IACpD,IAAI,EAAE,oCAAoC,CAAC;IAC3C,OAAO,EAAE,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;CAChD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,qCAAqC,CAAC;IAC5C,OAAO,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,0CAA0C,GAAG;IACvD,IAAI,EAAE,uCAAuC,CAAC;IAC9C,OAAO,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;CACnD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,8CAA8C,GAAG;IAC3D,IAAI,EAAE,2CAA2C,CAAC;IAClD,OAAO,EAAE,kBAAkB,CAAC,wBAAwB,CAAC,CAAC;CACvD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,6CAA6C,GAAG;IAC1D,IAAI,EAAE,0CAA0C,CAAC;IACjD,OAAO,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;CACtD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,gDAAgD,GAAG;IAC7D,IAAI,EAAE,6CAA6C,CAAC;IACpD,OAAO,EAAE,kBAAkB,CAAC,0BAA0B,CAAC,CAAC;CACzD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACvC,gCAAgC,GAChC,mCAAmC,GACnC,sCAAsC,GACtC,uCAAuC,GACvC,wCAAwC,GACxC,0CAA0C,GAC1C,8CAA8C,GAC9C,6CAA6C,GAC7C,2CAA2C,GAC3C,gDAAgD,CAAC"}

package/dist/{SnapAccountService-method-action-types.js → SnapAccountService-method-action-types.mjs}

@@ -3,4 +3,4 @@
  * Do not edit manually.
  */
 export {};
-//# sourceMappingURL=SnapAccountService-method-action-types.js.map
+//# sourceMappingURL=SnapAccountService-method-action-types.mjs.map

package/dist/SnapAccountService-method-action-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapAccountService-method-action-types.mjs","sourceRoot":"","sources":["../src/SnapAccountService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { SnapAccountService } from './SnapAccountService.js';\n\n/**\n * Returns the IDs of all currently tracked account-management Snaps —\n * Snaps that are installed, enabled, not blocked, and have the\n * `endowment:keyring` permission.\n *\n * @returns The IDs of tracked account-management Snaps.\n */\nexport type SnapAccountServiceGetSnapsAction = {\n  type: `SnapAccountService:getSnaps`;\n  handler: SnapAccountService['getSnaps'];\n};\n\n/**\n * Ensures everything is ready to use Snap accounts for the given Snap.\n * 1. Validates that `snapId` is a tracked account-management Snap.\n * 2. Asserts that the legacy -> v2 migration has been triggered (expected to\n * happen at `KeyringController:unlock` time).\n * 3. Atomically creates the v2 keyring for this Snap if it doesn't exist\n * yet.\n * 4. Waits for the Snap platform to be fully started.\n *\n * Safe to call concurrently — each step is idempotent or mutex-protected.\n *\n * @param snapId - ID of the Snap to ensure readiness for.\n * @throws If `snapId` is not a tracked account-management Snap.\n * @throws If the migration has not been triggered yet (wallet not unlocked).\n */\nexport type SnapAccountServiceEnsureReadyAction = {\n  type: `SnapAccountService:ensureReady`;\n  handler: SnapAccountService['ensureReady'];\n};\n\n/**\n * Migrate the legacy Snap keyring to the new (per-snap) Snap keyring v2.\n * Expected to be triggered at `KeyringController:unlock` time.\n * Safe to call concurrently — the migration runs only once; all callers\n * await the same promise.\n *\n * @returns A promise that resolves when the migration is complete.\n */\nexport type SnapAccountServiceEnsureMigratedAction = {\n  type: `SnapAccountService:ensureMigrated`;\n  handler: SnapAccountService['ensureMigrated'];\n};\n\n/**\n * Returns the keyring capabilities declared by the given Snap. These are\n * populated by the bridge keyring from the Snap's manifest, and describe\n * which keyring features the Snap supports (scopes, BIP-44 options, etc.).\n *\n * Consumers use this to decide whether to drive the Snap through the v1 or\n * v2 keyring path. Reading capabilities does not mutate state, so the\n * lock-free keyring access is used.\n *\n * @param snapId - ID of the Snap.\n * @returns The Snap's keyring capabilities.\n */\nexport type SnapAccountServiceGetCapabilitiesAction = {\n  type: `SnapAccountService:getCapabilities`;\n  handler: SnapAccountService['getCapabilities'];\n};\n\n/**\n * Returns the CAIP-19 asset type/ID list supported by an account.\n *\n * @param snapId - ID of the Snap.\n * @param id - ID of the account.\n * @returns A promise resolving to the list of supported CAIP-19 asset type/IDs.\n */\nexport type SnapAccountServiceGetAccountAssetsAction = {\n  type: `SnapAccountService:getAccountAssets`;\n  handler: SnapAccountService['getAccountAssets'];\n};\n\n/**\n * Returns the balances for an account for the requested asset types.\n *\n * @param snapId - ID of the Snap.\n * @param id - ID of the account.\n * @param assets - List of CAIP-19 fungible asset types to fetch balances for.\n * @returns A promise resolving to a map of asset type to balance.\n */\nexport type SnapAccountServiceGetAccountBalancesAction = {\n  type: `SnapAccountService:getAccountBalances`;\n  handler: SnapAccountService['getAccountBalances'];\n};\n\n/**\n * Returns a page of transactions for an account.\n *\n * @param snapId - ID of the Snap.\n * @param id - ID of the account.\n * @param pagination - Pagination options.\n * @returns A promise resolving to a page of transactions.\n */\nexport type SnapAccountServiceGetAccountTransactionsAction = {\n  type: `SnapAccountService:getAccountTransactions`;\n  handler: SnapAccountService['getAccountTransactions'];\n};\n\n/**\n * Resolves the account address to use for routing a signing request.\n *\n * @param snapId - ID of the Snap.\n * @param scope - CAIP-2 chain ID of the signing request.\n * @param request - The signing JSON-RPC request.\n * @returns A promise resolving to the resolved address, or `null` if the\n * Snap cannot determine an address for this request.\n */\nexport type SnapAccountServiceResolveAccountAddressAction = {\n  type: `SnapAccountService:resolveAccountAddress`;\n  handler: SnapAccountService['resolveAccountAddress'];\n};\n\n/**\n * Notifies a Snap of the currently selected accounts.\n *\n * For v1 Snaps the call goes through the keyring (signing interface); for\n * v2 Snaps it is routed via the RPC client because the keyring only covers\n * keyring-only operations (signing, account lifecycle).\n *\n * @param snapId - ID of the Snap.\n * @param accounts - IDs of the accounts to mark as selected.\n */\nexport type SnapAccountServiceSetSelectedAccountsAction = {\n  type: `SnapAccountService:setSelectedAccounts`;\n  handler: SnapAccountService['setSelectedAccounts'];\n};\n\n/**\n * Handle a message from a Snap.\n *\n * @param snapId - ID of the Snap.\n * @param message - Message sent by the Snap.\n * @returns The execution result.\n */\nexport type SnapAccountServiceHandleKeyringSnapMessageAction = {\n  type: `SnapAccountService:handleKeyringSnapMessage`;\n  handler: SnapAccountService['handleKeyringSnapMessage'];\n};\n\n/**\n * Union of all SnapAccountService action types.\n */\nexport type SnapAccountServiceMethodActions =\n  | SnapAccountServiceGetSnapsAction\n  | SnapAccountServiceEnsureReadyAction\n  | SnapAccountServiceEnsureMigratedAction\n  | SnapAccountServiceGetCapabilitiesAction\n  | SnapAccountServiceGetAccountAssetsAction\n  | SnapAccountServiceGetAccountBalancesAction\n  | SnapAccountServiceGetAccountTransactionsAction\n  | SnapAccountServiceResolveAccountAddressAction\n  | SnapAccountServiceSetSelectedAccountsAction\n  | SnapAccountServiceHandleKeyringSnapMessageAction;\n"]}