@metamask-previews/keyring-snap-client 9.0.2-e5bc458 → 9.1.0-5951828

package/CHANGELOG.md

@@ -7,10 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add `resolveAccountAddress` to v2 `KeyringClient` ([#585](https://github.com/MetaMask/accounts/pull/585))
+
+## [9.1.0]
+
+### Added
+
+- Implements `KeyringSnapRpc` (v2) in `KeyringClient` (v2) ([#582](https://github.com/MetaMask/accounts/pull/582))
+  - Exposes all core v2 keyring methods plus optional snap-specific ones: `setSelectedAccounts`, `getAccountTransactions`, `getAccountAssets`, and `getAccountBalances`.
+
 ### Changed
 
 - Bump `@metamask/keyring-utils` from `^3.2.0` to `^3.3.1` ([#544](https://github.com/MetaMask/accounts/pull/544), [#546](https://github.com/MetaMask/accounts/pull/546))
-- Bump `@metamask/keyring-api` from `^23.1.0` to `^23.2.0` ([#562](https://github.com/MetaMask/accounts/pull/562))
+- Bump `@metamask/keyring-api` from `^23.1.0` to `^23.4.0` ([#562](https://github.com/MetaMask/accounts/pull/562), [#569](https://github.com/MetaMask/accounts/pull/569), [#583](https://github.com/MetaMask/accounts/pull/583))
 
 ## [9.0.2]
 
@@ -188,7 +199,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - This new version fixes a bug with CJS re-exports.
 - Initial release ([#24](https://github.com/MetaMask/accounts/pull/24))
 
-[Unreleased]: https://github.com/MetaMask/accounts/compare/@metamask/keyring-snap-client@9.0.2...HEAD
+[Unreleased]: https://github.com/MetaMask/accounts/compare/@metamask/keyring-snap-client@9.1.0...HEAD
+[9.1.0]: https://github.com/MetaMask/accounts/compare/@metamask/keyring-snap-client@9.0.2...@metamask/keyring-snap-client@9.1.0
 [9.0.2]: https://github.com/MetaMask/accounts/compare/@metamask/keyring-snap-client@9.0.1...@metamask/keyring-snap-client@9.0.2
 [9.0.1]: https://github.com/MetaMask/accounts/compare/@metamask/keyring-snap-client@9.0.0...@metamask/keyring-snap-client@9.0.1
 [9.0.0]: https://github.com/MetaMask/accounts/compare/@metamask/keyring-snap-client@8.2.1...@metamask/keyring-snap-client@9.0.0

package/dist/v2/KeyringClient.cjs

@@ -38,6 +38,11 @@ class KeyringClient {
             ...request,
         });
     }
+    /**
+     * Returns all accounts.
+     *
+     * @returns A promise that resolves to the list of accounts.
+     */
     async getAccounts() {
         return (0, keyring_utils_1.strictMask)(await this.send({
             jsonrpc: '2.0',
@@ -45,6 +50,12 @@ class KeyringClient {
             method: v2_1.KeyringRpcMethod.GetAccounts,
         }), v2_1.GetAccountsResponseStruct);
     }
+    /**
+     * Returns the account with the specified ID.
+     *
+     * @param id - ID of the account to retrieve.
+     * @returns A promise that resolves to the account with the given ID.
+     */
     async getAccount(id) {
         return (0, keyring_utils_1.strictMask)(await this.send({
             jsonrpc: '2.0',
@@ -53,6 +64,12 @@ class KeyringClient {
             params: { id },
         }), v2_1.GetAccountResponseStruct);
     }
+    /**
+     * Creates one or more new accounts according to the provided options.
+     *
+     * @param params - Options describing how to create the account(s).
+     * @returns A promise that resolves to the list of created accounts.
+     */
     async createAccounts(params) {
         return (0, keyring_utils_1.strictMask)(await this.send({
             jsonrpc: '2.0',
@@ -61,6 +78,13 @@ class KeyringClient {
             params,
         }), v2_1.CreateAccountsResponseStruct);
     }
+    /**
+     * Exports the private key or secret material for the specified account.
+     *
+     * @param id - ID of the account to export.
+     * @param options - Optional export options.
+     * @returns A promise that resolves to the exported account data.
+     */
     async exportAccount(id, options) {
         return (0, keyring_utils_1.strictMask)(await this.send({
             jsonrpc: '2.0',
@@ -69,6 +93,12 @@ class KeyringClient {
             params: { id, ...(options && { options }) },
         }), v2_1.ExportAccountResponseStruct);
     }
+    /**
+     * Deletes the account with the specified ID.
+     *
+     * @param id - ID of the account to delete.
+     * @returns A promise that resolves when the account has been deleted.
+     */
     async deleteAccount(id) {
         (0, superstruct_1.assert)(await this.send({
             jsonrpc: '2.0',
@@ -77,6 +107,12 @@ class KeyringClient {
             params: { id },
         }), v2_1.DeleteAccountResponseStruct);
     }
+    /**
+     * Submits a request to the keyring.
+     *
+     * @param request - The `KeyringRequest` object to submit.
+     * @returns A promise that resolves to the response for the request.
+     */
     async submitRequest(request) {
         return (0, keyring_utils_1.strictMask)(await this.send({
             jsonrpc: '2.0',
@@ -85,6 +121,80 @@ class KeyringClient {
             params: request,
         }), v2_1.SubmitRequestResponseStruct);
     }
+    /**
+     * Notifies the Snap of the currently selected accounts.
+     *
+     * @param accounts - List of selected account IDs.
+     * @returns A promise that resolves when the notification has been sent.
+     */
+    async setSelectedAccounts(accounts) {
+        (0, superstruct_1.assert)(await __classPrivateFieldGet(this, _KeyringClient_sender, "f").send({
+            jsonrpc: '2.0',
+            id: (0, uuid_1.v4)(),
+            method: v2_1.KeyringSnapRpcMethod.SetSelectedAccounts,
+            params: { accounts },
+        }), v2_1.SetSelectedAccountsResponseStruct);
+    }
+    /**
+     * Gets transactions for an account with pagination.
+     *
+     * @param id - ID of the account.
+     * @param pagination - Pagination options.
+     * @returns A promise that resolves to a page of transactions.
+     */
+    async getAccountTransactions(id, pagination) {
+        return (0, keyring_utils_1.strictMask)(await __classPrivateFieldGet(this, _KeyringClient_sender, "f").send({
+            jsonrpc: '2.0',
+            id: (0, uuid_1.v4)(),
+            method: v2_1.KeyringSnapRpcMethod.GetAccountTransactions,
+            params: { id, pagination },
+        }), v2_1.GetAccountTransactionsResponseStruct);
+    }
+    /**
+     * Gets the asset types supported by an account.
+     *
+     * @param id - ID of the account.
+     * @returns A promise that resolves to the list of CAIP asset type IDs.
+     */
+    async getAccountAssets(id) {
+        return (0, keyring_utils_1.strictMask)(await __classPrivateFieldGet(this, _KeyringClient_sender, "f").send({
+            jsonrpc: '2.0',
+            id: (0, uuid_1.v4)(),
+            method: v2_1.KeyringSnapRpcMethod.GetAccountAssets,
+            params: { id },
+        }), v2_1.GetAccountAssetsResponseStruct);
+    }
+    /**
+     * Gets balances for an account for the requested asset types.
+     *
+     * @param id - ID of the account.
+     * @param assets - List of CAIP asset types to fetch balances for.
+     * @returns A promise that resolves to a map of asset type to balance.
+     */
+    async getAccountBalances(id, assets) {
+        return (0, keyring_utils_1.strictMask)(await __classPrivateFieldGet(this, _KeyringClient_sender, "f").send({
+            jsonrpc: '2.0',
+            id: (0, uuid_1.v4)(),
+            method: v2_1.KeyringSnapRpcMethod.GetAccountBalances,
+            params: { id, assets },
+        }), v2_1.GetAccountBalancesResponseStruct);
+    }
+    /**
+     * Resolves the account address to use for routing a signing request.
+     *
+     * @param scope - CAIP-2 chain ID of the signing request.
+     * @param request - The signing JSON-RPC request.
+     * @returns A promise that resolves to the resolved address, or `null` if
+     * the Snap cannot determine an address for this request.
+     */
+    async resolveAccountAddress(scope, request) {
+        return (0, keyring_utils_1.strictMask)(await __classPrivateFieldGet(this, _KeyringClient_sender, "f").send({
+            jsonrpc: '2.0',
+            id: (0, uuid_1.v4)(),
+            method: v2_1.KeyringSnapRpcMethod.ResolveAccountAddress,
+            params: { scope, request },
+        }), v2_1.ResolveAccountAddressResponseStruct);
+    }
 }
 exports.KeyringClient = KeyringClient;
 _KeyringClient_sender = new WeakMap();

package/dist/v2/KeyringClient.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"KeyringClient.cjs","sourceRoot":"","sources":["../../src/v2/KeyringClient.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,iDAQkC;AASlC,2DAAqD;AACrD,uDAA+C;AAE/C,+BAAkC;AAIlC,MAAa,aAAa;IAGxB;;;;OAIG;IACH,YAAY,MAAc;QAPjB,wCAAgB;QAQvB,uBAAA,IAAI,yBAAW,MAAM,MAAA,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACO,KAAK,CAAC,IAAI,CAClB,OAAyC;QAEzC,OAAO,uBAAA,IAAI,6BAAQ,CAAC,IAAI,CAAC;YACvB,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAA,0BAAU,EACf,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,IAAA,SAAI,GAAE;YACV,MAAM,EAAE,qBAAgB,CAAC,WAAW;SACrC,CAAC,EACF,8BAAyB,CAC1B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,OAAO,IAAA,0BAAU,EACf,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,IAAA,SAAI,GAAE;YACV,MAAM,EAAE,qBAAgB,CAAC,UAAU;YACnC,MAAM,EAAE,EAAE,EAAE,EAAE;SACf,CAAC,EACF,6BAAwB,CACzB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,MAA4B;QAE5B,OAAO,IAAA,0BAAU,EACf,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,IAAA,SAAI,GAAE;YACV,MAAM,EAAE,qBAAgB,CAAC,cAAc;YACvC,MAAM;SACP,CAAC,EACF,iCAA4B,CAC7B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,EAAa,EACb,OAA8B;QAE9B,OAAO,IAAA,0BAAU,EACf,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,IAAA,SAAI,GAAE;YACV,MAAM,EAAE,qBAAgB,CAAC,aAAa;YACtC,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE;SAC5C,CAAC,EACF,gCAA2B,CAC5B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,EAAa;QAC/B,IAAA,oBAAM,EACJ,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,IAAA,SAAI,GAAE;YACV,MAAM,EAAE,qBAAgB,CAAC,aAAa;YACtC,MAAM,EAAE,EAAE,EAAE,EAAE;SACf,CAAC,EACF,gCAA2B,CAC5B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAuB;QACzC,OAAO,IAAA,0BAAU,EACf,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,IAAA,SAAI,GAAE;YACV,MAAM,EAAE,qBAAgB,CAAC,aAAa;YACtC,MAAM,EAAE,OAAO;SAChB,CAAC,EACF,gCAA2B,CAC5B,CAAC;IACJ,CAAC;CACF;AArGD,sCAqGC","sourcesContent":["import type { KeyringAccount, KeyringRequest } from '@metamask/keyring-api';\nimport {\n  CreateAccountsResponseStruct,\n  DeleteAccountResponseStruct,\n  GetAccountResponseStruct,\n  GetAccountsResponseStruct,\n  SubmitRequestResponseStruct,\n  KeyringRpcMethod,\n  ExportAccountResponseStruct,\n} from '@metamask/keyring-api/v2';\nimport type {\n  CreateAccountOptions,\n  ExportAccountOptions,\n  ExportedAccount,\n  KeyringRpc,\n  KeyringRpcRequest,\n} from '@metamask/keyring-api/v2';\nimport type { AccountId } from '@metamask/keyring-utils';\nimport { strictMask } from '@metamask/keyring-utils';\nimport { assert } from '@metamask/superstruct';\nimport type { Json } from '@metamask/utils';\nimport { v4 as uuid } from 'uuid';\n\nimport type { Sender } from '../KeyringClient';\n\nexport class KeyringClient implements KeyringRpc {\n  readonly #sender: Sender;\n\n  /**\n   * Create a new instance of `KeyringClient`.\n   *\n   * @param sender - The `Sender` instance to use to send requests to the snap.\n   */\n  constructor(sender: Sender) {\n    this.#sender = sender;\n  }\n\n  /**\n   * Send a request to the Snap and return the response.\n   *\n   * @param request - A partial JSON-RPC request (method and params).\n   * @returns A promise that resolves to the response to the request.\n   */\n  protected async send<RequestMethod extends KeyringRpcMethod>(\n    request: KeyringRpcRequest<RequestMethod>,\n  ): Promise<Json> {\n    return this.#sender.send({\n      ...request,\n    });\n  }\n\n  async getAccounts(): Promise<KeyringAccount[]> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.GetAccounts,\n      }),\n      GetAccountsResponseStruct,\n    );\n  }\n\n  async getAccount(id: string): Promise<KeyringAccount> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.GetAccount,\n        params: { id },\n      }),\n      GetAccountResponseStruct,\n    );\n  }\n\n  async createAccounts(\n    params: CreateAccountOptions,\n  ): Promise<KeyringAccount[]> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.CreateAccounts,\n        params,\n      }),\n      CreateAccountsResponseStruct,\n    );\n  }\n\n  async exportAccount(\n    id: AccountId,\n    options?: ExportAccountOptions,\n  ): Promise<ExportedAccount> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.ExportAccount,\n        params: { id, ...(options && { options }) },\n      }),\n      ExportAccountResponseStruct,\n    );\n  }\n\n  async deleteAccount(id: AccountId): Promise<void> {\n    assert(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.DeleteAccount,\n        params: { id },\n      }),\n      DeleteAccountResponseStruct,\n    );\n  }\n\n  async submitRequest(request: KeyringRequest): Promise<Json> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.SubmitRequest,\n        params: request,\n      }),\n      SubmitRequestResponseStruct,\n    );\n  }\n}\n"]}
+{"version":3,"file":"KeyringClient.cjs","sourceRoot":"","sources":["../../src/v2/KeyringClient.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CaipChainId,\n  KeyringAccount,\n  KeyringRequest,\n  ResolvedAccountAddress,\n} from '@metamask/keyring-api';\nimport type {\n  Balance,\n  CaipAssetType,\n  CaipAssetTypeOrId,\n  Pagination,\n  TransactionsPage,\n} from '@metamask/keyring-api';\nimport {\n  CreateAccountsResponseStruct,\n  DeleteAccountResponseStruct,\n  GetAccountResponseStruct,\n  GetAccountsResponseStruct,\n  SubmitRequestResponseStruct,\n  KeyringRpcMethod,\n  ExportAccountResponseStruct,\n  KeyringSnapRpcMethod,\n  SetSelectedAccountsResponseStruct,\n  GetAccountTransactionsResponseStruct,\n  GetAccountAssetsResponseStruct,\n  GetAccountBalancesResponseStruct,\n  ResolveAccountAddressResponseStruct,\n} from '@metamask/keyring-api/v2';\nimport type {\n  CreateAccountOptions,\n  ExportAccountOptions,\n  ExportedAccount,\n  KeyringSnapRpc,\n  KeyringRpcRequest,\n} from '@metamask/keyring-api/v2';\nimport type { JsonRpcRequest } from '@metamask/keyring-utils';\nimport type { AccountId } from '@metamask/keyring-utils';\nimport { strictMask } from '@metamask/keyring-utils';\nimport { assert } from '@metamask/superstruct';\nimport type { Json } from '@metamask/utils';\nimport { v4 as uuid } from 'uuid';\n\nimport type { Sender } from '../KeyringClient';\n\nexport class KeyringClient implements KeyringSnapRpc {\n  readonly #sender: Sender;\n\n  /**\n   * Create a new instance of `KeyringClient`.\n   *\n   * @param sender - The `Sender` instance to use to send requests to the snap.\n   */\n  constructor(sender: Sender) {\n    this.#sender = sender;\n  }\n\n  /**\n   * Send a request to the Snap and return the response.\n   *\n   * @param request - A partial JSON-RPC request (method and params).\n   * @returns A promise that resolves to the response to the request.\n   */\n  protected async send<RequestMethod extends KeyringRpcMethod>(\n    request: KeyringRpcRequest<RequestMethod>,\n  ): Promise<Json> {\n    return this.#sender.send({\n      ...request,\n    });\n  }\n\n  /**\n   * Returns all accounts.\n   *\n   * @returns A promise that resolves to the list of accounts.\n   */\n  async getAccounts(): Promise<KeyringAccount[]> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.GetAccounts,\n      }),\n      GetAccountsResponseStruct,\n    );\n  }\n\n  /**\n   * Returns the account with the specified ID.\n   *\n   * @param id - ID of the account to retrieve.\n   * @returns A promise that resolves to the account with the given ID.\n   */\n  async getAccount(id: string): Promise<KeyringAccount> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.GetAccount,\n        params: { id },\n      }),\n      GetAccountResponseStruct,\n    );\n  }\n\n  /**\n   * Creates one or more new accounts according to the provided options.\n   *\n   * @param params - Options describing how to create the account(s).\n   * @returns A promise that resolves to the list of created accounts.\n   */\n  async createAccounts(\n    params: CreateAccountOptions,\n  ): Promise<KeyringAccount[]> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.CreateAccounts,\n        params,\n      }),\n      CreateAccountsResponseStruct,\n    );\n  }\n\n  /**\n   * Exports the private key or secret material for the specified account.\n   *\n   * @param id - ID of the account to export.\n   * @param options - Optional export options.\n   * @returns A promise that resolves to the exported account data.\n   */\n  async exportAccount(\n    id: AccountId,\n    options?: ExportAccountOptions,\n  ): Promise<ExportedAccount> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.ExportAccount,\n        params: { id, ...(options && { options }) },\n      }),\n      ExportAccountResponseStruct,\n    );\n  }\n\n  /**\n   * Deletes the account with the specified ID.\n   *\n   * @param id - ID of the account to delete.\n   * @returns A promise that resolves when the account has been deleted.\n   */\n  async deleteAccount(id: AccountId): Promise<void> {\n    assert(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.DeleteAccount,\n        params: { id },\n      }),\n      DeleteAccountResponseStruct,\n    );\n  }\n\n  /**\n   * Submits a request to the keyring.\n   *\n   * @param request - The `KeyringRequest` object to submit.\n   * @returns A promise that resolves to the response for the request.\n   */\n  async submitRequest(request: KeyringRequest): Promise<Json> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.SubmitRequest,\n        params: request,\n      }),\n      SubmitRequestResponseStruct,\n    );\n  }\n\n  /**\n   * Notifies the Snap of the currently selected accounts.\n   *\n   * @param accounts - List of selected account IDs.\n   * @returns A promise that resolves when the notification has been sent.\n   */\n  async setSelectedAccounts(accounts: AccountId[]): Promise<void> {\n    assert(\n      await this.#sender.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringSnapRpcMethod.SetSelectedAccounts,\n        params: { accounts },\n      }),\n      SetSelectedAccountsResponseStruct,\n    );\n  }\n\n  /**\n   * Gets transactions for an account with pagination.\n   *\n   * @param id - ID of the account.\n   * @param pagination - Pagination options.\n   * @returns A promise that resolves to a page of transactions.\n   */\n  async getAccountTransactions(\n    id: AccountId,\n    pagination: Pagination,\n  ): Promise<TransactionsPage> {\n    return strictMask(\n      await this.#sender.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringSnapRpcMethod.GetAccountTransactions,\n        params: { id, pagination },\n      }),\n      GetAccountTransactionsResponseStruct,\n    );\n  }\n\n  /**\n   * Gets the asset types supported by an account.\n   *\n   * @param id - ID of the account.\n   * @returns A promise that resolves to the list of CAIP asset type IDs.\n   */\n  async getAccountAssets(id: AccountId): Promise<CaipAssetTypeOrId[]> {\n    return strictMask(\n      await this.#sender.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringSnapRpcMethod.GetAccountAssets,\n        params: { id },\n      }),\n      GetAccountAssetsResponseStruct,\n    );\n  }\n\n  /**\n   * Gets balances for an account for the requested asset types.\n   *\n   * @param id - ID of the account.\n   * @param assets - List of CAIP asset types to fetch balances for.\n   * @returns A promise that resolves to a map of asset type to balance.\n   */\n  async getAccountBalances(\n    id: AccountId,\n    assets: CaipAssetType[],\n  ): Promise<Record<CaipAssetType, Balance>> {\n    return strictMask(\n      await this.#sender.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringSnapRpcMethod.GetAccountBalances,\n        params: { id, assets },\n      }),\n      GetAccountBalancesResponseStruct,\n    );\n  }\n\n  /**\n   * Resolves the account address to use for routing a signing request.\n   *\n   * @param scope - CAIP-2 chain ID of the signing request.\n   * @param request - The signing JSON-RPC request.\n   * @returns A promise that resolves to the resolved address, or `null` if\n   * the Snap cannot determine an address for this request.\n   */\n  async resolveAccountAddress(\n    scope: CaipChainId,\n    request: JsonRpcRequest,\n  ): Promise<ResolvedAccountAddress | null> {\n    return strictMask(\n      await this.#sender.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringSnapRpcMethod.ResolveAccountAddress,\n        params: { scope, request },\n      }),\n      ResolveAccountAddressResponseStruct,\n    );\n  }\n}\n"]}

package/dist/v2/KeyringClient.d.cts

@@ -1,10 +1,12 @@
-import type { KeyringAccount, KeyringRequest } from "@metamask/keyring-api";
+import type { CaipChainId, KeyringAccount, KeyringRequest, ResolvedAccountAddress } from "@metamask/keyring-api";
+import type { Balance, CaipAssetType, CaipAssetTypeOrId, Pagination, TransactionsPage } from "@metamask/keyring-api";
 import { KeyringRpcMethod } from "@metamask/keyring-api/v2";
-import type { CreateAccountOptions, ExportAccountOptions, ExportedAccount, KeyringRpc, KeyringRpcRequest } from "@metamask/keyring-api/v2";
+import type { CreateAccountOptions, ExportAccountOptions, ExportedAccount, KeyringSnapRpc, KeyringRpcRequest } from "@metamask/keyring-api/v2";
+import type { JsonRpcRequest } from "@metamask/keyring-utils";
 import type { AccountId } from "@metamask/keyring-utils";
 import type { Json } from "@metamask/utils";
 import type { Sender } from "../KeyringClient.cjs";
-export declare class KeyringClient implements KeyringRpc {
+export declare class KeyringClient implements KeyringSnapRpc {
     #private;
     /**
      * Create a new instance of `KeyringClient`.
@@ -19,11 +21,86 @@ export declare class KeyringClient implements KeyringRpc {
      * @returns A promise that resolves to the response to the request.
      */
     protected send<RequestMethod extends KeyringRpcMethod>(request: KeyringRpcRequest<RequestMethod>): Promise<Json>;
+    /**
+     * Returns all accounts.
+     *
+     * @returns A promise that resolves to the list of accounts.
+     */
     getAccounts(): Promise<KeyringAccount[]>;
+    /**
+     * Returns the account with the specified ID.
+     *
+     * @param id - ID of the account to retrieve.
+     * @returns A promise that resolves to the account with the given ID.
+     */
     getAccount(id: string): Promise<KeyringAccount>;
+    /**
+     * Creates one or more new accounts according to the provided options.
+     *
+     * @param params - Options describing how to create the account(s).
+     * @returns A promise that resolves to the list of created accounts.
+     */
     createAccounts(params: CreateAccountOptions): Promise<KeyringAccount[]>;
+    /**
+     * Exports the private key or secret material for the specified account.
+     *
+     * @param id - ID of the account to export.
+     * @param options - Optional export options.
+     * @returns A promise that resolves to the exported account data.
+     */
     exportAccount(id: AccountId, options?: ExportAccountOptions): Promise<ExportedAccount>;
+    /**
+     * Deletes the account with the specified ID.
+     *
+     * @param id - ID of the account to delete.
+     * @returns A promise that resolves when the account has been deleted.
+     */
     deleteAccount(id: AccountId): Promise<void>;
+    /**
+     * Submits a request to the keyring.
+     *
+     * @param request - The `KeyringRequest` object to submit.
+     * @returns A promise that resolves to the response for the request.
+     */
     submitRequest(request: KeyringRequest): Promise<Json>;
+    /**
+     * Notifies the Snap of the currently selected accounts.
+     *
+     * @param accounts - List of selected account IDs.
+     * @returns A promise that resolves when the notification has been sent.
+     */
+    setSelectedAccounts(accounts: AccountId[]): Promise<void>;
+    /**
+     * Gets transactions for an account with pagination.
+     *
+     * @param id - ID of the account.
+     * @param pagination - Pagination options.
+     * @returns A promise that resolves to a page of transactions.
+     */
+    getAccountTransactions(id: AccountId, pagination: Pagination): Promise<TransactionsPage>;
+    /**
+     * Gets the asset types supported by an account.
+     *
+     * @param id - ID of the account.
+     * @returns A promise that resolves to the list of CAIP asset type IDs.
+     */
+    getAccountAssets(id: AccountId): Promise<CaipAssetTypeOrId[]>;
+    /**
+     * Gets balances for an account for the requested asset types.
+     *
+     * @param id - ID of the account.
+     * @param assets - List of CAIP asset types to fetch balances for.
+     * @returns A promise that resolves to a map of asset type to balance.
+     */
+    getAccountBalances(id: AccountId, assets: CaipAssetType[]): Promise<Record<CaipAssetType, Balance>>;
+    /**
+     * Resolves the account address to use for routing a signing request.
+     *
+     * @param scope - CAIP-2 chain ID of the signing request.
+     * @param request - The signing JSON-RPC request.
+     * @returns A promise that resolves to the resolved address, or `null` if
+     * the Snap cannot determine an address for this request.
+     */
+    resolveAccountAddress(scope: CaipChainId, request: JsonRpcRequest): Promise<ResolvedAccountAddress | null>;
 }
 //# sourceMappingURL=KeyringClient.d.cts.map

package/dist/v2/KeyringClient.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"KeyringClient.d.cts","sourceRoot":"","sources":["../../src/v2/KeyringClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,8BAA8B;AAC5E,OAAO,EAML,gBAAgB,EAEjB,iCAAiC;AAClC,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,iBAAiB,EAClB,iCAAiC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,gCAAgC;AAGzD,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,6BAAyB;AAE/C,qBAAa,aAAc,YAAW,UAAU;;IAG9C;;;;OAIG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;;OAKG;cACa,IAAI,CAAC,aAAa,SAAS,gBAAgB,EACzD,OAAO,EAAE,iBAAiB,CAAC,aAAa,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC;IAMV,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAWxC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAY/C,cAAc,CAClB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,cAAc,EAAE,CAAC;IAYtB,aAAa,CACjB,EAAE,EAAE,SAAS,EACb,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAYrB,aAAa,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3C,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAW5D"}
+{"version":3,"file":"KeyringClient.d.cts","sourceRoot":"","sources":["../../src/v2/KeyringClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,sBAAsB,EACvB,8BAA8B;AAC/B,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EACjB,8BAA8B;AAC/B,OAAO,EAML,gBAAgB,EAQjB,iCAAiC;AAClC,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,iBAAiB,EAClB,iCAAiC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,gCAAgC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,gCAAgC;AAGzD,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,6BAAyB;AAE/C,qBAAa,aAAc,YAAW,cAAc;;IAGlD;;;;OAIG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;;OAKG;cACa,IAAI,CAAC,aAAa,SAAS,gBAAgB,EACzD,OAAO,EAAE,iBAAiB,CAAC,aAAa,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC;IAMhB;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAW9C;;;;;OAKG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAYrD;;;;;OAKG;IACG,cAAc,CAClB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,cAAc,EAAE,CAAC;IAY5B;;;;;;OAMG;IACG,aAAa,CACjB,EAAE,EAAE,SAAS,EACb,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAY3B;;;;;OAKG;IACG,aAAa,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjD;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3D;;;;;OAKG;IACG,mBAAmB,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/D;;;;;;OAMG;IACG,sBAAsB,CAC1B,EAAE,EAAE,SAAS,EACb,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,gBAAgB,CAAC;IAY5B;;;;;OAKG;IACG,gBAAgB,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAYnE;;;;;;OAMG;IACG,kBAAkB,CACtB,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,aAAa,EAAE,GACtB,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAY1C;;;;;;;OAOG;IACG,qBAAqB,CACzB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;CAW1C"}

package/dist/v2/KeyringClient.d.mts

@@ -1,10 +1,12 @@
-import type { KeyringAccount, KeyringRequest } from "@metamask/keyring-api";
+import type { CaipChainId, KeyringAccount, KeyringRequest, ResolvedAccountAddress } from "@metamask/keyring-api";
+import type { Balance, CaipAssetType, CaipAssetTypeOrId, Pagination, TransactionsPage } from "@metamask/keyring-api";
 import { KeyringRpcMethod } from "@metamask/keyring-api/v2";
-import type { CreateAccountOptions, ExportAccountOptions, ExportedAccount, KeyringRpc, KeyringRpcRequest } from "@metamask/keyring-api/v2";
+import type { CreateAccountOptions, ExportAccountOptions, ExportedAccount, KeyringSnapRpc, KeyringRpcRequest } from "@metamask/keyring-api/v2";
+import type { JsonRpcRequest } from "@metamask/keyring-utils";
 import type { AccountId } from "@metamask/keyring-utils";
 import type { Json } from "@metamask/utils";
 import type { Sender } from "../KeyringClient.mjs";
-export declare class KeyringClient implements KeyringRpc {
+export declare class KeyringClient implements KeyringSnapRpc {
     #private;
     /**
      * Create a new instance of `KeyringClient`.
@@ -19,11 +21,86 @@ export declare class KeyringClient implements KeyringRpc {
      * @returns A promise that resolves to the response to the request.
      */
     protected send<RequestMethod extends KeyringRpcMethod>(request: KeyringRpcRequest<RequestMethod>): Promise<Json>;
+    /**
+     * Returns all accounts.
+     *
+     * @returns A promise that resolves to the list of accounts.
+     */
     getAccounts(): Promise<KeyringAccount[]>;
+    /**
+     * Returns the account with the specified ID.
+     *
+     * @param id - ID of the account to retrieve.
+     * @returns A promise that resolves to the account with the given ID.
+     */
     getAccount(id: string): Promise<KeyringAccount>;
+    /**
+     * Creates one or more new accounts according to the provided options.
+     *
+     * @param params - Options describing how to create the account(s).
+     * @returns A promise that resolves to the list of created accounts.
+     */
     createAccounts(params: CreateAccountOptions): Promise<KeyringAccount[]>;
+    /**
+     * Exports the private key or secret material for the specified account.
+     *
+     * @param id - ID of the account to export.
+     * @param options - Optional export options.
+     * @returns A promise that resolves to the exported account data.
+     */
     exportAccount(id: AccountId, options?: ExportAccountOptions): Promise<ExportedAccount>;
+    /**
+     * Deletes the account with the specified ID.
+     *
+     * @param id - ID of the account to delete.
+     * @returns A promise that resolves when the account has been deleted.
+     */
     deleteAccount(id: AccountId): Promise<void>;
+    /**
+     * Submits a request to the keyring.
+     *
+     * @param request - The `KeyringRequest` object to submit.
+     * @returns A promise that resolves to the response for the request.
+     */
     submitRequest(request: KeyringRequest): Promise<Json>;
+    /**
+     * Notifies the Snap of the currently selected accounts.
+     *
+     * @param accounts - List of selected account IDs.
+     * @returns A promise that resolves when the notification has been sent.
+     */
+    setSelectedAccounts(accounts: AccountId[]): Promise<void>;
+    /**
+     * Gets transactions for an account with pagination.
+     *
+     * @param id - ID of the account.
+     * @param pagination - Pagination options.
+     * @returns A promise that resolves to a page of transactions.
+     */
+    getAccountTransactions(id: AccountId, pagination: Pagination): Promise<TransactionsPage>;
+    /**
+     * Gets the asset types supported by an account.
+     *
+     * @param id - ID of the account.
+     * @returns A promise that resolves to the list of CAIP asset type IDs.
+     */
+    getAccountAssets(id: AccountId): Promise<CaipAssetTypeOrId[]>;
+    /**
+     * Gets balances for an account for the requested asset types.
+     *
+     * @param id - ID of the account.
+     * @param assets - List of CAIP asset types to fetch balances for.
+     * @returns A promise that resolves to a map of asset type to balance.
+     */
+    getAccountBalances(id: AccountId, assets: CaipAssetType[]): Promise<Record<CaipAssetType, Balance>>;
+    /**
+     * Resolves the account address to use for routing a signing request.
+     *
+     * @param scope - CAIP-2 chain ID of the signing request.
+     * @param request - The signing JSON-RPC request.
+     * @returns A promise that resolves to the resolved address, or `null` if
+     * the Snap cannot determine an address for this request.
+     */
+    resolveAccountAddress(scope: CaipChainId, request: JsonRpcRequest): Promise<ResolvedAccountAddress | null>;
 }
 //# sourceMappingURL=KeyringClient.d.mts.map

package/dist/v2/KeyringClient.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"KeyringClient.d.mts","sourceRoot":"","sources":["../../src/v2/KeyringClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,8BAA8B;AAC5E,OAAO,EAML,gBAAgB,EAEjB,iCAAiC;AAClC,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,iBAAiB,EAClB,iCAAiC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,gCAAgC;AAGzD,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,6BAAyB;AAE/C,qBAAa,aAAc,YAAW,UAAU;;IAG9C;;;;OAIG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;;OAKG;cACa,IAAI,CAAC,aAAa,SAAS,gBAAgB,EACzD,OAAO,EAAE,iBAAiB,CAAC,aAAa,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC;IAMV,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAWxC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAY/C,cAAc,CAClB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,cAAc,EAAE,CAAC;IAYtB,aAAa,CACjB,EAAE,EAAE,SAAS,EACb,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAYrB,aAAa,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3C,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAW5D"}
+{"version":3,"file":"KeyringClient.d.mts","sourceRoot":"","sources":["../../src/v2/KeyringClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,sBAAsB,EACvB,8BAA8B;AAC/B,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EACjB,8BAA8B;AAC/B,OAAO,EAML,gBAAgB,EAQjB,iCAAiC;AAClC,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,iBAAiB,EAClB,iCAAiC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,gCAAgC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,gCAAgC;AAGzD,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,6BAAyB;AAE/C,qBAAa,aAAc,YAAW,cAAc;;IAGlD;;;;OAIG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;;OAKG;cACa,IAAI,CAAC,aAAa,SAAS,gBAAgB,EACzD,OAAO,EAAE,iBAAiB,CAAC,aAAa,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC;IAMhB;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAW9C;;;;;OAKG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAYrD;;;;;OAKG;IACG,cAAc,CAClB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,cAAc,EAAE,CAAC;IAY5B;;;;;;OAMG;IACG,aAAa,CACjB,EAAE,EAAE,SAAS,EACb,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAY3B;;;;;OAKG;IACG,aAAa,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjD;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3D;;;;;OAKG;IACG,mBAAmB,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/D;;;;;;OAMG;IACG,sBAAsB,CAC1B,EAAE,EAAE,SAAS,EACb,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,gBAAgB,CAAC;IAY5B;;;;;OAKG;IACG,gBAAgB,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAYnE;;;;;;OAMG;IACG,kBAAkB,CACtB,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,aAAa,EAAE,GACtB,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAY1C;;;;;;;OAOG;IACG,qBAAqB,CACzB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;CAW1C"}

package/dist/v2/KeyringClient.mjs

@@ -10,7 +10,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _KeyringClient_sender;
-import { CreateAccountsResponseStruct, DeleteAccountResponseStruct, GetAccountResponseStruct, GetAccountsResponseStruct, SubmitRequestResponseStruct, KeyringRpcMethod, ExportAccountResponseStruct } from "@metamask/keyring-api/v2";
+import { CreateAccountsResponseStruct, DeleteAccountResponseStruct, GetAccountResponseStruct, GetAccountsResponseStruct, SubmitRequestResponseStruct, KeyringRpcMethod, ExportAccountResponseStruct, KeyringSnapRpcMethod, SetSelectedAccountsResponseStruct, GetAccountTransactionsResponseStruct, GetAccountAssetsResponseStruct, GetAccountBalancesResponseStruct, ResolveAccountAddressResponseStruct } from "@metamask/keyring-api/v2";
 import { strictMask } from "@metamask/keyring-utils";
 import { assert } from "@metamask/superstruct";
 import { v4 as uuid } from "uuid";
@@ -35,6 +35,11 @@ export class KeyringClient {
             ...request,
         });
     }
+    /**
+     * Returns all accounts.
+     *
+     * @returns A promise that resolves to the list of accounts.
+     */
     async getAccounts() {
         return strictMask(await this.send({
             jsonrpc: '2.0',
@@ -42,6 +47,12 @@ export class KeyringClient {
             method: KeyringRpcMethod.GetAccounts,
         }), GetAccountsResponseStruct);
     }
+    /**
+     * Returns the account with the specified ID.
+     *
+     * @param id - ID of the account to retrieve.
+     * @returns A promise that resolves to the account with the given ID.
+     */
     async getAccount(id) {
         return strictMask(await this.send({
             jsonrpc: '2.0',
@@ -50,6 +61,12 @@ export class KeyringClient {
             params: { id },
         }), GetAccountResponseStruct);
     }
+    /**
+     * Creates one or more new accounts according to the provided options.
+     *
+     * @param params - Options describing how to create the account(s).
+     * @returns A promise that resolves to the list of created accounts.
+     */
     async createAccounts(params) {
         return strictMask(await this.send({
             jsonrpc: '2.0',
@@ -58,6 +75,13 @@ export class KeyringClient {
             params,
         }), CreateAccountsResponseStruct);
     }
+    /**
+     * Exports the private key or secret material for the specified account.
+     *
+     * @param id - ID of the account to export.
+     * @param options - Optional export options.
+     * @returns A promise that resolves to the exported account data.
+     */
     async exportAccount(id, options) {
         return strictMask(await this.send({
             jsonrpc: '2.0',
@@ -66,6 +90,12 @@ export class KeyringClient {
             params: { id, ...(options && { options }) },
         }), ExportAccountResponseStruct);
     }
+    /**
+     * Deletes the account with the specified ID.
+     *
+     * @param id - ID of the account to delete.
+     * @returns A promise that resolves when the account has been deleted.
+     */
     async deleteAccount(id) {
         assert(await this.send({
             jsonrpc: '2.0',
@@ -74,6 +104,12 @@ export class KeyringClient {
             params: { id },
         }), DeleteAccountResponseStruct);
     }
+    /**
+     * Submits a request to the keyring.
+     *
+     * @param request - The `KeyringRequest` object to submit.
+     * @returns A promise that resolves to the response for the request.
+     */
     async submitRequest(request) {
         return strictMask(await this.send({
             jsonrpc: '2.0',
@@ -82,6 +118,80 @@ export class KeyringClient {
             params: request,
         }), SubmitRequestResponseStruct);
     }
+    /**
+     * Notifies the Snap of the currently selected accounts.
+     *
+     * @param accounts - List of selected account IDs.
+     * @returns A promise that resolves when the notification has been sent.
+     */
+    async setSelectedAccounts(accounts) {
+        assert(await __classPrivateFieldGet(this, _KeyringClient_sender, "f").send({
+            jsonrpc: '2.0',
+            id: uuid(),
+            method: KeyringSnapRpcMethod.SetSelectedAccounts,
+            params: { accounts },
+        }), SetSelectedAccountsResponseStruct);
+    }
+    /**
+     * Gets transactions for an account with pagination.
+     *
+     * @param id - ID of the account.
+     * @param pagination - Pagination options.
+     * @returns A promise that resolves to a page of transactions.
+     */
+    async getAccountTransactions(id, pagination) {
+        return strictMask(await __classPrivateFieldGet(this, _KeyringClient_sender, "f").send({
+            jsonrpc: '2.0',
+            id: uuid(),
+            method: KeyringSnapRpcMethod.GetAccountTransactions,
+            params: { id, pagination },
+        }), GetAccountTransactionsResponseStruct);
+    }
+    /**
+     * Gets the asset types supported by an account.
+     *
+     * @param id - ID of the account.
+     * @returns A promise that resolves to the list of CAIP asset type IDs.
+     */
+    async getAccountAssets(id) {
+        return strictMask(await __classPrivateFieldGet(this, _KeyringClient_sender, "f").send({
+            jsonrpc: '2.0',
+            id: uuid(),
+            method: KeyringSnapRpcMethod.GetAccountAssets,
+            params: { id },
+        }), GetAccountAssetsResponseStruct);
+    }
+    /**
+     * Gets balances for an account for the requested asset types.
+     *
+     * @param id - ID of the account.
+     * @param assets - List of CAIP asset types to fetch balances for.
+     * @returns A promise that resolves to a map of asset type to balance.
+     */
+    async getAccountBalances(id, assets) {
+        return strictMask(await __classPrivateFieldGet(this, _KeyringClient_sender, "f").send({
+            jsonrpc: '2.0',
+            id: uuid(),
+            method: KeyringSnapRpcMethod.GetAccountBalances,
+            params: { id, assets },
+        }), GetAccountBalancesResponseStruct);
+    }
+    /**
+     * Resolves the account address to use for routing a signing request.
+     *
+     * @param scope - CAIP-2 chain ID of the signing request.
+     * @param request - The signing JSON-RPC request.
+     * @returns A promise that resolves to the resolved address, or `null` if
+     * the Snap cannot determine an address for this request.
+     */
+    async resolveAccountAddress(scope, request) {
+        return strictMask(await __classPrivateFieldGet(this, _KeyringClient_sender, "f").send({
+            jsonrpc: '2.0',
+            id: uuid(),
+            method: KeyringSnapRpcMethod.ResolveAccountAddress,
+            params: { scope, request },
+        }), ResolveAccountAddressResponseStruct);
+    }
 }
 _KeyringClient_sender = new WeakMap();
 //# sourceMappingURL=KeyringClient.mjs.map

package/dist/v2/KeyringClient.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"KeyringClient.mjs","sourceRoot":"","sources":["../../src/v2/KeyringClient.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,gBAAgB,EAChB,2BAA2B,EAC5B,iCAAiC;AASlC,OAAO,EAAE,UAAU,EAAE,gCAAgC;AACrD,OAAO,EAAE,MAAM,EAAE,8BAA8B;AAE/C,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,aAAa;AAIlC,MAAM,OAAO,aAAa;IAGxB;;;;OAIG;IACH,YAAY,MAAc;QAPjB,wCAAgB;QAQvB,uBAAA,IAAI,yBAAW,MAAM,MAAA,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACO,KAAK,CAAC,IAAI,CAClB,OAAyC;QAEzC,OAAO,uBAAA,IAAI,6BAAQ,CAAC,IAAI,CAAC;YACvB,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,UAAU,CACf,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,IAAI,EAAE;YACV,MAAM,EAAE,gBAAgB,CAAC,WAAW;SACrC,CAAC,EACF,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,OAAO,UAAU,CACf,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,IAAI,EAAE;YACV,MAAM,EAAE,gBAAgB,CAAC,UAAU;YACnC,MAAM,EAAE,EAAE,EAAE,EAAE;SACf,CAAC,EACF,wBAAwB,CACzB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,MAA4B;QAE5B,OAAO,UAAU,CACf,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,IAAI,EAAE;YACV,MAAM,EAAE,gBAAgB,CAAC,cAAc;YACvC,MAAM;SACP,CAAC,EACF,4BAA4B,CAC7B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,EAAa,EACb,OAA8B;QAE9B,OAAO,UAAU,CACf,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,IAAI,EAAE;YACV,MAAM,EAAE,gBAAgB,CAAC,aAAa;YACtC,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE;SAC5C,CAAC,EACF,2BAA2B,CAC5B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,EAAa;QAC/B,MAAM,CACJ,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,IAAI,EAAE;YACV,MAAM,EAAE,gBAAgB,CAAC,aAAa;YACtC,MAAM,EAAE,EAAE,EAAE,EAAE;SACf,CAAC,EACF,2BAA2B,CAC5B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAuB;QACzC,OAAO,UAAU,CACf,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,IAAI,EAAE;YACV,MAAM,EAAE,gBAAgB,CAAC,aAAa;YACtC,MAAM,EAAE,OAAO;SAChB,CAAC,EACF,2BAA2B,CAC5B,CAAC;IACJ,CAAC;CACF","sourcesContent":["import type { KeyringAccount, KeyringRequest } from '@metamask/keyring-api';\nimport {\n  CreateAccountsResponseStruct,\n  DeleteAccountResponseStruct,\n  GetAccountResponseStruct,\n  GetAccountsResponseStruct,\n  SubmitRequestResponseStruct,\n  KeyringRpcMethod,\n  ExportAccountResponseStruct,\n} from '@metamask/keyring-api/v2';\nimport type {\n  CreateAccountOptions,\n  ExportAccountOptions,\n  ExportedAccount,\n  KeyringRpc,\n  KeyringRpcRequest,\n} from '@metamask/keyring-api/v2';\nimport type { AccountId } from '@metamask/keyring-utils';\nimport { strictMask } from '@metamask/keyring-utils';\nimport { assert } from '@metamask/superstruct';\nimport type { Json } from '@metamask/utils';\nimport { v4 as uuid } from 'uuid';\n\nimport type { Sender } from '../KeyringClient';\n\nexport class KeyringClient implements KeyringRpc {\n  readonly #sender: Sender;\n\n  /**\n   * Create a new instance of `KeyringClient`.\n   *\n   * @param sender - The `Sender` instance to use to send requests to the snap.\n   */\n  constructor(sender: Sender) {\n    this.#sender = sender;\n  }\n\n  /**\n   * Send a request to the Snap and return the response.\n   *\n   * @param request - A partial JSON-RPC request (method and params).\n   * @returns A promise that resolves to the response to the request.\n   */\n  protected async send<RequestMethod extends KeyringRpcMethod>(\n    request: KeyringRpcRequest<RequestMethod>,\n  ): Promise<Json> {\n    return this.#sender.send({\n      ...request,\n    });\n  }\n\n  async getAccounts(): Promise<KeyringAccount[]> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.GetAccounts,\n      }),\n      GetAccountsResponseStruct,\n    );\n  }\n\n  async getAccount(id: string): Promise<KeyringAccount> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.GetAccount,\n        params: { id },\n      }),\n      GetAccountResponseStruct,\n    );\n  }\n\n  async createAccounts(\n    params: CreateAccountOptions,\n  ): Promise<KeyringAccount[]> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.CreateAccounts,\n        params,\n      }),\n      CreateAccountsResponseStruct,\n    );\n  }\n\n  async exportAccount(\n    id: AccountId,\n    options?: ExportAccountOptions,\n  ): Promise<ExportedAccount> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.ExportAccount,\n        params: { id, ...(options && { options }) },\n      }),\n      ExportAccountResponseStruct,\n    );\n  }\n\n  async deleteAccount(id: AccountId): Promise<void> {\n    assert(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.DeleteAccount,\n        params: { id },\n      }),\n      DeleteAccountResponseStruct,\n    );\n  }\n\n  async submitRequest(request: KeyringRequest): Promise<Json> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.SubmitRequest,\n        params: request,\n      }),\n      SubmitRequestResponseStruct,\n    );\n  }\n}\n"]}
+{"version":3,"file":"KeyringClient.mjs","sourceRoot":"","sources":["../../src/v2/KeyringClient.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CaipChainId,\n  KeyringAccount,\n  KeyringRequest,\n  ResolvedAccountAddress,\n} from '@metamask/keyring-api';\nimport type {\n  Balance,\n  CaipAssetType,\n  CaipAssetTypeOrId,\n  Pagination,\n  TransactionsPage,\n} from '@metamask/keyring-api';\nimport {\n  CreateAccountsResponseStruct,\n  DeleteAccountResponseStruct,\n  GetAccountResponseStruct,\n  GetAccountsResponseStruct,\n  SubmitRequestResponseStruct,\n  KeyringRpcMethod,\n  ExportAccountResponseStruct,\n  KeyringSnapRpcMethod,\n  SetSelectedAccountsResponseStruct,\n  GetAccountTransactionsResponseStruct,\n  GetAccountAssetsResponseStruct,\n  GetAccountBalancesResponseStruct,\n  ResolveAccountAddressResponseStruct,\n} from '@metamask/keyring-api/v2';\nimport type {\n  CreateAccountOptions,\n  ExportAccountOptions,\n  ExportedAccount,\n  KeyringSnapRpc,\n  KeyringRpcRequest,\n} from '@metamask/keyring-api/v2';\nimport type { JsonRpcRequest } from '@metamask/keyring-utils';\nimport type { AccountId } from '@metamask/keyring-utils';\nimport { strictMask } from '@metamask/keyring-utils';\nimport { assert } from '@metamask/superstruct';\nimport type { Json } from '@metamask/utils';\nimport { v4 as uuid } from 'uuid';\n\nimport type { Sender } from '../KeyringClient';\n\nexport class KeyringClient implements KeyringSnapRpc {\n  readonly #sender: Sender;\n\n  /**\n   * Create a new instance of `KeyringClient`.\n   *\n   * @param sender - The `Sender` instance to use to send requests to the snap.\n   */\n  constructor(sender: Sender) {\n    this.#sender = sender;\n  }\n\n  /**\n   * Send a request to the Snap and return the response.\n   *\n   * @param request - A partial JSON-RPC request (method and params).\n   * @returns A promise that resolves to the response to the request.\n   */\n  protected async send<RequestMethod extends KeyringRpcMethod>(\n    request: KeyringRpcRequest<RequestMethod>,\n  ): Promise<Json> {\n    return this.#sender.send({\n      ...request,\n    });\n  }\n\n  /**\n   * Returns all accounts.\n   *\n   * @returns A promise that resolves to the list of accounts.\n   */\n  async getAccounts(): Promise<KeyringAccount[]> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.GetAccounts,\n      }),\n      GetAccountsResponseStruct,\n    );\n  }\n\n  /**\n   * Returns the account with the specified ID.\n   *\n   * @param id - ID of the account to retrieve.\n   * @returns A promise that resolves to the account with the given ID.\n   */\n  async getAccount(id: string): Promise<KeyringAccount> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.GetAccount,\n        params: { id },\n      }),\n      GetAccountResponseStruct,\n    );\n  }\n\n  /**\n   * Creates one or more new accounts according to the provided options.\n   *\n   * @param params - Options describing how to create the account(s).\n   * @returns A promise that resolves to the list of created accounts.\n   */\n  async createAccounts(\n    params: CreateAccountOptions,\n  ): Promise<KeyringAccount[]> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.CreateAccounts,\n        params,\n      }),\n      CreateAccountsResponseStruct,\n    );\n  }\n\n  /**\n   * Exports the private key or secret material for the specified account.\n   *\n   * @param id - ID of the account to export.\n   * @param options - Optional export options.\n   * @returns A promise that resolves to the exported account data.\n   */\n  async exportAccount(\n    id: AccountId,\n    options?: ExportAccountOptions,\n  ): Promise<ExportedAccount> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.ExportAccount,\n        params: { id, ...(options && { options }) },\n      }),\n      ExportAccountResponseStruct,\n    );\n  }\n\n  /**\n   * Deletes the account with the specified ID.\n   *\n   * @param id - ID of the account to delete.\n   * @returns A promise that resolves when the account has been deleted.\n   */\n  async deleteAccount(id: AccountId): Promise<void> {\n    assert(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.DeleteAccount,\n        params: { id },\n      }),\n      DeleteAccountResponseStruct,\n    );\n  }\n\n  /**\n   * Submits a request to the keyring.\n   *\n   * @param request - The `KeyringRequest` object to submit.\n   * @returns A promise that resolves to the response for the request.\n   */\n  async submitRequest(request: KeyringRequest): Promise<Json> {\n    return strictMask(\n      await this.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringRpcMethod.SubmitRequest,\n        params: request,\n      }),\n      SubmitRequestResponseStruct,\n    );\n  }\n\n  /**\n   * Notifies the Snap of the currently selected accounts.\n   *\n   * @param accounts - List of selected account IDs.\n   * @returns A promise that resolves when the notification has been sent.\n   */\n  async setSelectedAccounts(accounts: AccountId[]): Promise<void> {\n    assert(\n      await this.#sender.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringSnapRpcMethod.SetSelectedAccounts,\n        params: { accounts },\n      }),\n      SetSelectedAccountsResponseStruct,\n    );\n  }\n\n  /**\n   * Gets transactions for an account with pagination.\n   *\n   * @param id - ID of the account.\n   * @param pagination - Pagination options.\n   * @returns A promise that resolves to a page of transactions.\n   */\n  async getAccountTransactions(\n    id: AccountId,\n    pagination: Pagination,\n  ): Promise<TransactionsPage> {\n    return strictMask(\n      await this.#sender.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringSnapRpcMethod.GetAccountTransactions,\n        params: { id, pagination },\n      }),\n      GetAccountTransactionsResponseStruct,\n    );\n  }\n\n  /**\n   * Gets the asset types supported by an account.\n   *\n   * @param id - ID of the account.\n   * @returns A promise that resolves to the list of CAIP asset type IDs.\n   */\n  async getAccountAssets(id: AccountId): Promise<CaipAssetTypeOrId[]> {\n    return strictMask(\n      await this.#sender.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringSnapRpcMethod.GetAccountAssets,\n        params: { id },\n      }),\n      GetAccountAssetsResponseStruct,\n    );\n  }\n\n  /**\n   * Gets balances for an account for the requested asset types.\n   *\n   * @param id - ID of the account.\n   * @param assets - List of CAIP asset types to fetch balances for.\n   * @returns A promise that resolves to a map of asset type to balance.\n   */\n  async getAccountBalances(\n    id: AccountId,\n    assets: CaipAssetType[],\n  ): Promise<Record<CaipAssetType, Balance>> {\n    return strictMask(\n      await this.#sender.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringSnapRpcMethod.GetAccountBalances,\n        params: { id, assets },\n      }),\n      GetAccountBalancesResponseStruct,\n    );\n  }\n\n  /**\n   * Resolves the account address to use for routing a signing request.\n   *\n   * @param scope - CAIP-2 chain ID of the signing request.\n   * @param request - The signing JSON-RPC request.\n   * @returns A promise that resolves to the resolved address, or `null` if\n   * the Snap cannot determine an address for this request.\n   */\n  async resolveAccountAddress(\n    scope: CaipChainId,\n    request: JsonRpcRequest,\n  ): Promise<ResolvedAccountAddress | null> {\n    return strictMask(\n      await this.#sender.send({\n        jsonrpc: '2.0',\n        id: uuid(),\n        method: KeyringSnapRpcMethod.ResolveAccountAddress,\n        params: { scope, request },\n      }),\n      ResolveAccountAddressResponseStruct,\n    );\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/keyring-snap-client",
-  "version": "9.0.2-e5bc458",
+  "version": "9.1.0-5951828",
   "description": "MetaMask Keyring Snap clients",
   "keywords": [
     "keyring",
@@ -66,9 +66,9 @@
     "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch"
   },
   "dependencies": {
-    "@metamask/keyring-api": "23.2.0",
+    "@metamask/keyring-api": "23.4.0",
     "@metamask/keyring-utils": "3.3.1",
-    "@metamask/superstruct": "^3.1.0",
+    "@metamask/superstruct": "^3.3.0",
     "@types/uuid": "^9.0.8",
     "uuid": "^9.0.1",
     "webextension-polyfill": "^0.12.0"