@metamask-previews/account-api 0.3.0-9522cc5 → 0.5.0-0e28ac0

package/dist/api/multichain/wallet.cjs

@@ -1,146 +1,7 @@
 "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 _MultichainAccountWallet_id, _MultichainAccountWallet_providers, _MultichainAccountWallet_entropySource, _MultichainAccountWallet_accounts;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MultichainAccountWallet = void 0;
 exports.toMultichainAccountWalletId = toMultichainAccountWalletId;
-const account_1 = require("./account.cjs");
-const group_1 = require("../group.cjs");
 const wallet_1 = require("../wallet.cjs");
-/**
- * A multichain account wallet that holds multiple multichain accounts (one multichain account per
- * group index).
- */
-class MultichainAccountWallet {
-    constructor({ providers, entropySource, }) {
-        _MultichainAccountWallet_id.set(this, void 0);
-        _MultichainAccountWallet_providers.set(this, void 0);
-        _MultichainAccountWallet_entropySource.set(this, void 0);
-        _MultichainAccountWallet_accounts.set(this, void 0);
-        __classPrivateFieldSet(this, _MultichainAccountWallet_id, toMultichainAccountWalletId(entropySource), "f");
-        __classPrivateFieldSet(this, _MultichainAccountWallet_providers, providers, "f");
-        __classPrivateFieldSet(this, _MultichainAccountWallet_entropySource, entropySource, "f");
-        __classPrivateFieldSet(this, _MultichainAccountWallet_accounts, new Map(), "f");
-        // Initial synchronization.
-        this.sync();
-    }
-    /**
-     * Force wallet synchronization.
-     *
-     * This can be used if account providers got new accounts that the wallet
-     * doesn't know about.
-     */
-    sync() {
-        for (const provider of __classPrivateFieldGet(this, _MultichainAccountWallet_providers, "f")) {
-            for (const account of provider.getAccounts()) {
-                const { entropy } = account.options;
-                // Filter for this wallet only.
-                if (entropy.id !== this.entropySource) {
-                    continue;
-                }
-                // This multichain account might exists already.
-                let multichainAccount = __classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").get(entropy.groupIndex);
-                if (!multichainAccount) {
-                    multichainAccount = new account_1.MultichainAccount({
-                        groupIndex: entropy.groupIndex,
-                        wallet: this,
-                        providers: __classPrivateFieldGet(this, _MultichainAccountWallet_providers, "f"),
-                    });
-                    __classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").set(entropy.groupIndex, multichainAccount);
-                }
-            }
-        }
-        // Now force-sync all remaining multichain accounts.
-        for (const [groupIndex, multichainAccount] of __classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").entries()) {
-            multichainAccount.sync();
-            // Clean up old multichain accounts.
-            if (!multichainAccount.hasAccounts()) {
-                __classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").delete(groupIndex);
-            }
-        }
-    }
-    /**
-     * Gets the multichain account wallet ID.
-     *
-     * @returns The multichain account wallet ID.
-     */
-    get id() {
-        return __classPrivateFieldGet(this, _MultichainAccountWallet_id, "f");
-    }
-    /**
-     * Gets the multichain account wallet type, which is always {@link AccountWalletType.Entropy}.
-     *
-     * @returns The multichain account wallet type.
-     */
-    get type() {
-        return wallet_1.AccountWalletType.Entropy;
-    }
-    /**
-     * Gets the multichain account wallet entropy source.
-     *
-     * @returns The multichain account wallet entropy source.
-     */
-    get entropySource() {
-        return __classPrivateFieldGet(this, _MultichainAccountWallet_entropySource, "f");
-    }
-    /**
-     * Gets multichain account for a given ID.
-     * The default group ID will default to the multichain account with index 0.
-     *
-     * @param id - Account group ID.
-     * @returns Account group.
-     */
-    getAccountGroup(id) {
-        // We consider the "default case" to be mapped to index 0.
-        if (id === (0, group_1.toDefaultAccountGroupId)(this.id)) {
-            return __classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").get(0);
-        }
-        // If it is not a valid ID, we cannot extract the group index
-        // from it, so we fail fast.
-        if (!(0, account_1.isMultichainAccountId)(id)) {
-            return undefined;
-        }
-        const groupIndex = (0, account_1.getGroupIndexFromMultichainAccountId)(id);
-        return __classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").get(groupIndex);
-    }
-    /**
-     * Gets all multichain accounts. Similar to {@link MultichainAccountWallet.getMultichainAccounts}.
-     *
-     * @returns The multichain accounts.
-     */
-    getAccountGroups() {
-        return this.getMultichainAccounts();
-    }
-    /**
-     * Gets multichain account for a given index.
-     *
-     * @param groupIndex - Multichain account index.
-     * @returns The multichain account associated with the given index.
-     */
-    getMultichainAccount(groupIndex) {
-        return __classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").get(groupIndex);
-    }
-    /**
-     * Gets all multichain accounts.
-     *
-     * @returns The multichain accounts.
-     */
-    getMultichainAccounts() {
-        return Array.from(__classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").values()); // TODO: Prevent copy here.
-    }
-}
-exports.MultichainAccountWallet = MultichainAccountWallet;
-_MultichainAccountWallet_id = new WeakMap(), _MultichainAccountWallet_providers = new WeakMap(), _MultichainAccountWallet_entropySource = new WeakMap(), _MultichainAccountWallet_accounts = new WeakMap();
 /**
  * Gets the multichain account wallet ID from its entropy source.
  *

package/dist/api/multichain/wallet.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.cjs","sourceRoot":"","sources":["../../../src/api/multichain/wallet.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type EntropySourceId,\n  type KeyringAccount,\n} from '@metamask/keyring-api';\n\nimport {\n  getGroupIndexFromMultichainAccountId,\n  isMultichainAccountId,\n  MultichainAccount,\n} from './account';\nimport type { Bip44Account } from '../bip44';\nimport type { AccountGroupId } from '../group';\nimport { toDefaultAccountGroupId } from '../group';\nimport type { AccountProvider } from '../provider';\nimport type { AccountWallet } from '../wallet';\nimport { AccountWalletType } from '../wallet';\n\n/**\n * Multichain account wallet ID.\n */\nexport type MultichainAccountWalletId =\n  `${AccountWalletType.Entropy}:${EntropySourceId}`;\n\n/**\n * A multichain account wallet that holds multiple multichain accounts (one multichain account per\n * group index).\n */\nexport class MultichainAccountWallet<\n  Account extends Bip44Account<KeyringAccount>,\n> implements AccountWallet<Account>\n{\n  readonly #id: MultichainAccountWalletId;\n\n  readonly #providers: AccountProvider<Account>[];\n\n  readonly #entropySource: EntropySourceId;\n\n  readonly #accounts: Map<number, MultichainAccount<Account>>;\n\n  constructor({\n    providers,\n    entropySource,\n  }: {\n    providers: AccountProvider<Account>[];\n    entropySource: EntropySourceId;\n  }) {\n    this.#id = toMultichainAccountWalletId(entropySource);\n    this.#providers = providers;\n    this.#entropySource = entropySource;\n    this.#accounts = new Map();\n\n    // Initial synchronization.\n    this.sync();\n  }\n\n  /**\n   * Force wallet synchronization.\n   *\n   * This can be used if account providers got new accounts that the wallet\n   * doesn't know about.\n   */\n  sync(): void {\n    for (const provider of this.#providers) {\n      for (const account of provider.getAccounts()) {\n        const { entropy } = account.options;\n\n        // Filter for this wallet only.\n        if (entropy.id !== this.entropySource) {\n          continue;\n        }\n\n        // This multichain account might exists already.\n        let multichainAccount = this.#accounts.get(entropy.groupIndex);\n        if (!multichainAccount) {\n          multichainAccount = new MultichainAccount<Account>({\n            groupIndex: entropy.groupIndex,\n            wallet: this,\n            providers: this.#providers,\n          });\n\n          this.#accounts.set(entropy.groupIndex, multichainAccount);\n        }\n      }\n    }\n\n    // Now force-sync all remaining multichain accounts.\n    for (const [groupIndex, multichainAccount] of this.#accounts.entries()) {\n      multichainAccount.sync();\n\n      // Clean up old multichain accounts.\n      if (!multichainAccount.hasAccounts()) {\n        this.#accounts.delete(groupIndex);\n      }\n    }\n  }\n\n  /**\n   * Gets the multichain account wallet ID.\n   *\n   * @returns The multichain account wallet ID.\n   */\n  get id(): MultichainAccountWalletId {\n    return this.#id;\n  }\n\n  /**\n   * Gets the multichain account wallet type, which is always {@link AccountWalletType.Entropy}.\n   *\n   * @returns The multichain account wallet type.\n   */\n  get type(): AccountWalletType.Entropy {\n    return AccountWalletType.Entropy;\n  }\n\n  /**\n   * Gets the multichain account wallet entropy source.\n   *\n   * @returns The multichain account wallet entropy source.\n   */\n  get entropySource(): EntropySourceId {\n    return this.#entropySource;\n  }\n\n  /**\n   * Gets multichain account for a given ID.\n   * The default group ID will default to the multichain account with index 0.\n   *\n   * @param id - Account group ID.\n   * @returns Account group.\n   */\n  getAccountGroup(id: AccountGroupId): MultichainAccount<Account> | undefined {\n    // We consider the \"default case\" to be mapped to index 0.\n    if (id === toDefaultAccountGroupId(this.id)) {\n      return this.#accounts.get(0);\n    }\n\n    // If it is not a valid ID, we cannot extract the group index\n    // from it, so we fail fast.\n    if (!isMultichainAccountId(id)) {\n      return undefined;\n    }\n\n    const groupIndex = getGroupIndexFromMultichainAccountId(id);\n    return this.#accounts.get(groupIndex);\n  }\n\n  /**\n   * Gets all multichain accounts. Similar to {@link MultichainAccountWallet.getMultichainAccounts}.\n   *\n   * @returns The multichain accounts.\n   */\n  getAccountGroups(): MultichainAccount<Account>[] {\n    return this.getMultichainAccounts();\n  }\n\n  /**\n   * Gets multichain account for a given index.\n   *\n   * @param groupIndex - Multichain account index.\n   * @returns The multichain account associated with the given index.\n   */\n  getMultichainAccount(\n    groupIndex: number,\n  ): MultichainAccount<Account> | undefined {\n    return this.#accounts.get(groupIndex);\n  }\n\n  /**\n   * Gets all multichain accounts.\n   *\n   * @returns The multichain accounts.\n   */\n  getMultichainAccounts(): MultichainAccount<Account>[] {\n    return Array.from(this.#accounts.values()); // TODO: Prevent copy here.\n  }\n}\n\n/**\n * Gets the multichain account wallet ID from its entropy source.\n *\n * @param entropySource - Entropy source ID of that wallet.\n * @returns The multichain account wallet ID.\n */\nexport function toMultichainAccountWalletId(\n  entropySource: EntropySourceId,\n): MultichainAccountWalletId {\n  return `${AccountWalletType.Entropy}:${entropySource}`;\n}\n"]}
+{"version":3,"file":"wallet.cjs","sourceRoot":"","sources":["../../../src/api/multichain/wallet.ts"],"names":[],"mappings":";;AA8DA,kEAIC;AA1DD,0CAA8C;AAgD9C;;;;;GAKG;AACH,SAAgB,2BAA2B,CACzC,aAA8B;IAE9B,OAAO,GAAG,0BAAiB,CAAC,OAAO,IAAI,aAAa,EAAE,CAAC;AACzD,CAAC","sourcesContent":["import {\n  type EntropySourceId,\n  type KeyringAccount,\n} from '@metamask/keyring-api';\n\nimport type { MultichainAccountGroup } from './group';\nimport type { Bip44Account } from '../bip44';\nimport type { AccountWallet } from '../wallet';\nimport { AccountWalletType } from '../wallet';\n\n/**\n * Multichain account wallet ID.\n */\nexport type MultichainAccountWalletId =\n  `${AccountWalletType.Entropy}:${EntropySourceId}`;\n\n/**\n * A multichain account wallet that holds multiple multichain accounts (one multichain account per\n * group index).\n */\nexport type MultichainAccountWallet<\n  Account extends Bip44Account<KeyringAccount>,\n> = AccountWallet<Account> & {\n  /**\n   * Multichain account wallet ID.\n   */\n  get id(): MultichainAccountWalletId;\n\n  /**\n   * Multichain account wallet type, which is always {@link AccountWalletType.Entropy}.\n   */\n  get type(): AccountWalletType.Entropy;\n\n  /**\n   * Multichain account wallet entropy source.\n   */\n  get entropySource(): EntropySourceId;\n\n  /**\n   * Gets multichain account for a given index.\n   *\n   * @param groupIndex - Multichain account index.\n   * @returns The multichain account associated with the given index.\n   */\n  getMultichainAccountGroup(\n    groupIndex: number,\n  ): MultichainAccountGroup<Account> | undefined;\n\n  /**\n   * Gets all multichain accounts.\n   *\n   * @returns The multichain accounts.\n   */\n  getMultichainAccountGroups(): MultichainAccountGroup<Account>[];\n};\n\n/**\n * Gets the multichain account wallet ID from its entropy source.\n *\n * @param entropySource - Entropy source ID of that wallet.\n * @returns The multichain account wallet ID.\n */\nexport function toMultichainAccountWalletId(\n  entropySource: EntropySourceId,\n): MultichainAccountWalletId {\n  return `${AccountWalletType.Entropy}:${entropySource}`;\n}\n"]}

package/dist/api/multichain/wallet.d.cts

@@ -1,8 +1,6 @@
 import { type EntropySourceId, type KeyringAccount } from "@metamask/keyring-api";
-import { MultichainAccount } from "./account.cjs";
+import type { MultichainAccountGroup } from "./group.cjs";
 import type { Bip44Account } from "../bip44.cjs";
-import type { AccountGroupId } from "../group.cjs";
-import type { AccountProvider } from "../provider.cjs";
 import type { AccountWallet } from "../wallet.cjs";
 import { AccountWalletType } from "../wallet.cjs";
 /**
@@ -13,65 +11,33 @@ export type MultichainAccountWalletId = `${AccountWalletType.Entropy}:${EntropyS
  * A multichain account wallet that holds multiple multichain accounts (one multichain account per
  * group index).
  */
-export declare class MultichainAccountWallet<Account extends Bip44Account<KeyringAccount>> implements AccountWallet<Account> {
-    #private;
-    constructor({ providers, entropySource, }: {
-        providers: AccountProvider<Account>[];
-        entropySource: EntropySourceId;
-    });
+export type MultichainAccountWallet<Account extends Bip44Account<KeyringAccount>> = AccountWallet<Account> & {
     /**
-     * Force wallet synchronization.
-     *
-     * This can be used if account providers got new accounts that the wallet
-     * doesn't know about.
-     */
-    sync(): void;
-    /**
-     * Gets the multichain account wallet ID.
-     *
-     * @returns The multichain account wallet ID.
+     * Multichain account wallet ID.
      */
     get id(): MultichainAccountWalletId;
     /**
-     * Gets the multichain account wallet type, which is always {@link AccountWalletType.Entropy}.
-     *
-     * @returns The multichain account wallet type.
+     * Multichain account wallet type, which is always {@link AccountWalletType.Entropy}.
      */
     get type(): AccountWalletType.Entropy;
     /**
-     * Gets the multichain account wallet entropy source.
-     *
-     * @returns The multichain account wallet entropy source.
+     * Multichain account wallet entropy source.
      */
     get entropySource(): EntropySourceId;
-    /**
-     * Gets multichain account for a given ID.
-     * The default group ID will default to the multichain account with index 0.
-     *
-     * @param id - Account group ID.
-     * @returns Account group.
-     */
-    getAccountGroup(id: AccountGroupId): MultichainAccount<Account> | undefined;
-    /**
-     * Gets all multichain accounts. Similar to {@link MultichainAccountWallet.getMultichainAccounts}.
-     *
-     * @returns The multichain accounts.
-     */
-    getAccountGroups(): MultichainAccount<Account>[];
     /**
      * Gets multichain account for a given index.
      *
      * @param groupIndex - Multichain account index.
      * @returns The multichain account associated with the given index.
      */
-    getMultichainAccount(groupIndex: number): MultichainAccount<Account> | undefined;
+    getMultichainAccountGroup(groupIndex: number): MultichainAccountGroup<Account> | undefined;
     /**
      * Gets all multichain accounts.
      *
      * @returns The multichain accounts.
      */
-    getMultichainAccounts(): MultichainAccount<Account>[];
-}
+    getMultichainAccountGroups(): MultichainAccountGroup<Account>[];
+};
 /**
  * Gets the multichain account wallet ID from its entropy source.
  *

package/dist/api/multichain/wallet.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.d.cts","sourceRoot":"","sources":["../../../src/api/multichain/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,8BAA8B;AAE/B,OAAO,EAGL,iBAAiB,EAClB,sBAAkB;AACnB,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAiB;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAiB;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAoB;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAkB;AAC/C,OAAO,EAAE,iBAAiB,EAAE,sBAAkB;AAE9C;;GAEG;AACH,MAAM,MAAM,yBAAyB,GACnC,GAAG,iBAAiB,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC;AAEpD;;;GAGG;AACH,qBAAa,uBAAuB,CAClC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,CAC5C,YAAW,aAAa,CAAC,OAAO,CAAC;;gBAUrB,EACV,SAAS,EACT,aAAa,GACd,EAAE;QACD,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,aAAa,EAAE,eAAe,CAAC;KAChC;IAUD;;;;;OAKG;IACH,IAAI,IAAI,IAAI;IAmCZ;;;;OAIG;IACH,IAAI,EAAE,IAAI,yBAAyB,CAElC;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,iBAAiB,CAAC,OAAO,CAEpC;IAED;;;;OAIG;IACH,IAAI,aAAa,IAAI,eAAe,CAEnC;IAED;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,SAAS;IAgB3E;;;;OAIG;IACH,gBAAgB,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAIhD;;;;;OAKG;IACH,oBAAoB,CAClB,UAAU,EAAE,MAAM,GACjB,iBAAiB,CAAC,OAAO,CAAC,GAAG,SAAS;IAIzC;;;;OAIG;IACH,qBAAqB,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE;CAGtD;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,eAAe,GAC7B,yBAAyB,CAE3B"}
+{"version":3,"file":"wallet.d.cts","sourceRoot":"","sources":["../../../src/api/multichain/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,8BAA8B;AAE/B,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAgB;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAiB;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAkB;AAC/C,OAAO,EAAE,iBAAiB,EAAE,sBAAkB;AAE9C;;GAEG;AACH,MAAM,MAAM,yBAAyB,GACnC,GAAG,iBAAiB,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,uBAAuB,CACjC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,IAC1C,aAAa,CAAC,OAAO,CAAC,GAAG;IAC3B;;OAEG;IACH,IAAI,EAAE,IAAI,yBAAyB,CAAC;IAEpC;;OAEG;IACH,IAAI,IAAI,IAAI,iBAAiB,CAAC,OAAO,CAAC;IAEtC;;OAEG;IACH,IAAI,aAAa,IAAI,eAAe,CAAC;IAErC;;;;;OAKG;IACH,yBAAyB,CACvB,UAAU,EAAE,MAAM,GACjB,sBAAsB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAE/C;;;;OAIG;IACH,0BAA0B,IAAI,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC;CACjE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,eAAe,GAC7B,yBAAyB,CAE3B"}

package/dist/api/multichain/wallet.d.mts

@@ -1,8 +1,6 @@
 import { type EntropySourceId, type KeyringAccount } from "@metamask/keyring-api";
-import { MultichainAccount } from "./account.mjs";
+import type { MultichainAccountGroup } from "./group.mjs";
 import type { Bip44Account } from "../bip44.mjs";
-import type { AccountGroupId } from "../group.mjs";
-import type { AccountProvider } from "../provider.mjs";
 import type { AccountWallet } from "../wallet.mjs";
 import { AccountWalletType } from "../wallet.mjs";
 /**
@@ -13,65 +11,33 @@ export type MultichainAccountWalletId = `${AccountWalletType.Entropy}:${EntropyS
  * A multichain account wallet that holds multiple multichain accounts (one multichain account per
  * group index).
  */
-export declare class MultichainAccountWallet<Account extends Bip44Account<KeyringAccount>> implements AccountWallet<Account> {
-    #private;
-    constructor({ providers, entropySource, }: {
-        providers: AccountProvider<Account>[];
-        entropySource: EntropySourceId;
-    });
+export type MultichainAccountWallet<Account extends Bip44Account<KeyringAccount>> = AccountWallet<Account> & {
     /**
-     * Force wallet synchronization.
-     *
-     * This can be used if account providers got new accounts that the wallet
-     * doesn't know about.
-     */
-    sync(): void;
-    /**
-     * Gets the multichain account wallet ID.
-     *
-     * @returns The multichain account wallet ID.
+     * Multichain account wallet ID.
      */
     get id(): MultichainAccountWalletId;
     /**
-     * Gets the multichain account wallet type, which is always {@link AccountWalletType.Entropy}.
-     *
-     * @returns The multichain account wallet type.
+     * Multichain account wallet type, which is always {@link AccountWalletType.Entropy}.
      */
     get type(): AccountWalletType.Entropy;
     /**
-     * Gets the multichain account wallet entropy source.
-     *
-     * @returns The multichain account wallet entropy source.
+     * Multichain account wallet entropy source.
      */
     get entropySource(): EntropySourceId;
-    /**
-     * Gets multichain account for a given ID.
-     * The default group ID will default to the multichain account with index 0.
-     *
-     * @param id - Account group ID.
-     * @returns Account group.
-     */
-    getAccountGroup(id: AccountGroupId): MultichainAccount<Account> | undefined;
-    /**
-     * Gets all multichain accounts. Similar to {@link MultichainAccountWallet.getMultichainAccounts}.
-     *
-     * @returns The multichain accounts.
-     */
-    getAccountGroups(): MultichainAccount<Account>[];
     /**
      * Gets multichain account for a given index.
      *
      * @param groupIndex - Multichain account index.
      * @returns The multichain account associated with the given index.
      */
-    getMultichainAccount(groupIndex: number): MultichainAccount<Account> | undefined;
+    getMultichainAccountGroup(groupIndex: number): MultichainAccountGroup<Account> | undefined;
     /**
      * Gets all multichain accounts.
      *
      * @returns The multichain accounts.
      */
-    getMultichainAccounts(): MultichainAccount<Account>[];
-}
+    getMultichainAccountGroups(): MultichainAccountGroup<Account>[];
+};
 /**
  * Gets the multichain account wallet ID from its entropy source.
  *

package/dist/api/multichain/wallet.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.d.mts","sourceRoot":"","sources":["../../../src/api/multichain/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,8BAA8B;AAE/B,OAAO,EAGL,iBAAiB,EAClB,sBAAkB;AACnB,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAiB;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAiB;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAoB;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAkB;AAC/C,OAAO,EAAE,iBAAiB,EAAE,sBAAkB;AAE9C;;GAEG;AACH,MAAM,MAAM,yBAAyB,GACnC,GAAG,iBAAiB,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC;AAEpD;;;GAGG;AACH,qBAAa,uBAAuB,CAClC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,CAC5C,YAAW,aAAa,CAAC,OAAO,CAAC;;gBAUrB,EACV,SAAS,EACT,aAAa,GACd,EAAE;QACD,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,aAAa,EAAE,eAAe,CAAC;KAChC;IAUD;;;;;OAKG;IACH,IAAI,IAAI,IAAI;IAmCZ;;;;OAIG;IACH,IAAI,EAAE,IAAI,yBAAyB,CAElC;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,iBAAiB,CAAC,OAAO,CAEpC;IAED;;;;OAIG;IACH,IAAI,aAAa,IAAI,eAAe,CAEnC;IAED;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,SAAS;IAgB3E;;;;OAIG;IACH,gBAAgB,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAIhD;;;;;OAKG;IACH,oBAAoB,CAClB,UAAU,EAAE,MAAM,GACjB,iBAAiB,CAAC,OAAO,CAAC,GAAG,SAAS;IAIzC;;;;OAIG;IACH,qBAAqB,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE;CAGtD;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,eAAe,GAC7B,yBAAyB,CAE3B"}
+{"version":3,"file":"wallet.d.mts","sourceRoot":"","sources":["../../../src/api/multichain/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,8BAA8B;AAE/B,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAgB;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAiB;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAkB;AAC/C,OAAO,EAAE,iBAAiB,EAAE,sBAAkB;AAE9C;;GAEG;AACH,MAAM,MAAM,yBAAyB,GACnC,GAAG,iBAAiB,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,uBAAuB,CACjC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,IAC1C,aAAa,CAAC,OAAO,CAAC,GAAG;IAC3B;;OAEG;IACH,IAAI,EAAE,IAAI,yBAAyB,CAAC;IAEpC;;OAEG;IACH,IAAI,IAAI,IAAI,iBAAiB,CAAC,OAAO,CAAC;IAEtC;;OAEG;IACH,IAAI,aAAa,IAAI,eAAe,CAAC;IAErC;;;;;OAKG;IACH,yBAAyB,CACvB,UAAU,EAAE,MAAM,GACjB,sBAAsB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAE/C;;;;OAIG;IACH,0BAA0B,IAAI,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC;CACjE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,eAAe,GAC7B,yBAAyB,CAE3B"}

package/dist/api/multichain/wallet.mjs

@@ -1,141 +1,4 @@
-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 _MultichainAccountWallet_id, _MultichainAccountWallet_providers, _MultichainAccountWallet_entropySource, _MultichainAccountWallet_accounts;
-import { getGroupIndexFromMultichainAccountId, isMultichainAccountId, MultichainAccount } from "./account.mjs";
-import { toDefaultAccountGroupId } from "../group.mjs";
 import { AccountWalletType } from "../wallet.mjs";
-/**
- * A multichain account wallet that holds multiple multichain accounts (one multichain account per
- * group index).
- */
-export class MultichainAccountWallet {
-    constructor({ providers, entropySource, }) {
-        _MultichainAccountWallet_id.set(this, void 0);
-        _MultichainAccountWallet_providers.set(this, void 0);
-        _MultichainAccountWallet_entropySource.set(this, void 0);
-        _MultichainAccountWallet_accounts.set(this, void 0);
-        __classPrivateFieldSet(this, _MultichainAccountWallet_id, toMultichainAccountWalletId(entropySource), "f");
-        __classPrivateFieldSet(this, _MultichainAccountWallet_providers, providers, "f");
-        __classPrivateFieldSet(this, _MultichainAccountWallet_entropySource, entropySource, "f");
-        __classPrivateFieldSet(this, _MultichainAccountWallet_accounts, new Map(), "f");
-        // Initial synchronization.
-        this.sync();
-    }
-    /**
-     * Force wallet synchronization.
-     *
-     * This can be used if account providers got new accounts that the wallet
-     * doesn't know about.
-     */
-    sync() {
-        for (const provider of __classPrivateFieldGet(this, _MultichainAccountWallet_providers, "f")) {
-            for (const account of provider.getAccounts()) {
-                const { entropy } = account.options;
-                // Filter for this wallet only.
-                if (entropy.id !== this.entropySource) {
-                    continue;
-                }
-                // This multichain account might exists already.
-                let multichainAccount = __classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").get(entropy.groupIndex);
-                if (!multichainAccount) {
-                    multichainAccount = new MultichainAccount({
-                        groupIndex: entropy.groupIndex,
-                        wallet: this,
-                        providers: __classPrivateFieldGet(this, _MultichainAccountWallet_providers, "f"),
-                    });
-                    __classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").set(entropy.groupIndex, multichainAccount);
-                }
-            }
-        }
-        // Now force-sync all remaining multichain accounts.
-        for (const [groupIndex, multichainAccount] of __classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").entries()) {
-            multichainAccount.sync();
-            // Clean up old multichain accounts.
-            if (!multichainAccount.hasAccounts()) {
-                __classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").delete(groupIndex);
-            }
-        }
-    }
-    /**
-     * Gets the multichain account wallet ID.
-     *
-     * @returns The multichain account wallet ID.
-     */
-    get id() {
-        return __classPrivateFieldGet(this, _MultichainAccountWallet_id, "f");
-    }
-    /**
-     * Gets the multichain account wallet type, which is always {@link AccountWalletType.Entropy}.
-     *
-     * @returns The multichain account wallet type.
-     */
-    get type() {
-        return AccountWalletType.Entropy;
-    }
-    /**
-     * Gets the multichain account wallet entropy source.
-     *
-     * @returns The multichain account wallet entropy source.
-     */
-    get entropySource() {
-        return __classPrivateFieldGet(this, _MultichainAccountWallet_entropySource, "f");
-    }
-    /**
-     * Gets multichain account for a given ID.
-     * The default group ID will default to the multichain account with index 0.
-     *
-     * @param id - Account group ID.
-     * @returns Account group.
-     */
-    getAccountGroup(id) {
-        // We consider the "default case" to be mapped to index 0.
-        if (id === toDefaultAccountGroupId(this.id)) {
-            return __classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").get(0);
-        }
-        // If it is not a valid ID, we cannot extract the group index
-        // from it, so we fail fast.
-        if (!isMultichainAccountId(id)) {
-            return undefined;
-        }
-        const groupIndex = getGroupIndexFromMultichainAccountId(id);
-        return __classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").get(groupIndex);
-    }
-    /**
-     * Gets all multichain accounts. Similar to {@link MultichainAccountWallet.getMultichainAccounts}.
-     *
-     * @returns The multichain accounts.
-     */
-    getAccountGroups() {
-        return this.getMultichainAccounts();
-    }
-    /**
-     * Gets multichain account for a given index.
-     *
-     * @param groupIndex - Multichain account index.
-     * @returns The multichain account associated with the given index.
-     */
-    getMultichainAccount(groupIndex) {
-        return __classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").get(groupIndex);
-    }
-    /**
-     * Gets all multichain accounts.
-     *
-     * @returns The multichain accounts.
-     */
-    getMultichainAccounts() {
-        return Array.from(__classPrivateFieldGet(this, _MultichainAccountWallet_accounts, "f").values()); // TODO: Prevent copy here.
-    }
-}
-_MultichainAccountWallet_id = new WeakMap(), _MultichainAccountWallet_providers = new WeakMap(), _MultichainAccountWallet_entropySource = new WeakMap(), _MultichainAccountWallet_accounts = new WeakMap();
 /**
  * Gets the multichain account wallet ID from its entropy source.
  *

package/dist/api/multichain/wallet.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.mjs","sourceRoot":"","sources":["../../../src/api/multichain/wallet.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type EntropySourceId,\n  type KeyringAccount,\n} from '@metamask/keyring-api';\n\nimport {\n  getGroupIndexFromMultichainAccountId,\n  isMultichainAccountId,\n  MultichainAccount,\n} from './account';\nimport type { Bip44Account } from '../bip44';\nimport type { AccountGroupId } from '../group';\nimport { toDefaultAccountGroupId } from '../group';\nimport type { AccountProvider } from '../provider';\nimport type { AccountWallet } from '../wallet';\nimport { AccountWalletType } from '../wallet';\n\n/**\n * Multichain account wallet ID.\n */\nexport type MultichainAccountWalletId =\n  `${AccountWalletType.Entropy}:${EntropySourceId}`;\n\n/**\n * A multichain account wallet that holds multiple multichain accounts (one multichain account per\n * group index).\n */\nexport class MultichainAccountWallet<\n  Account extends Bip44Account<KeyringAccount>,\n> implements AccountWallet<Account>\n{\n  readonly #id: MultichainAccountWalletId;\n\n  readonly #providers: AccountProvider<Account>[];\n\n  readonly #entropySource: EntropySourceId;\n\n  readonly #accounts: Map<number, MultichainAccount<Account>>;\n\n  constructor({\n    providers,\n    entropySource,\n  }: {\n    providers: AccountProvider<Account>[];\n    entropySource: EntropySourceId;\n  }) {\n    this.#id = toMultichainAccountWalletId(entropySource);\n    this.#providers = providers;\n    this.#entropySource = entropySource;\n    this.#accounts = new Map();\n\n    // Initial synchronization.\n    this.sync();\n  }\n\n  /**\n   * Force wallet synchronization.\n   *\n   * This can be used if account providers got new accounts that the wallet\n   * doesn't know about.\n   */\n  sync(): void {\n    for (const provider of this.#providers) {\n      for (const account of provider.getAccounts()) {\n        const { entropy } = account.options;\n\n        // Filter for this wallet only.\n        if (entropy.id !== this.entropySource) {\n          continue;\n        }\n\n        // This multichain account might exists already.\n        let multichainAccount = this.#accounts.get(entropy.groupIndex);\n        if (!multichainAccount) {\n          multichainAccount = new MultichainAccount<Account>({\n            groupIndex: entropy.groupIndex,\n            wallet: this,\n            providers: this.#providers,\n          });\n\n          this.#accounts.set(entropy.groupIndex, multichainAccount);\n        }\n      }\n    }\n\n    // Now force-sync all remaining multichain accounts.\n    for (const [groupIndex, multichainAccount] of this.#accounts.entries()) {\n      multichainAccount.sync();\n\n      // Clean up old multichain accounts.\n      if (!multichainAccount.hasAccounts()) {\n        this.#accounts.delete(groupIndex);\n      }\n    }\n  }\n\n  /**\n   * Gets the multichain account wallet ID.\n   *\n   * @returns The multichain account wallet ID.\n   */\n  get id(): MultichainAccountWalletId {\n    return this.#id;\n  }\n\n  /**\n   * Gets the multichain account wallet type, which is always {@link AccountWalletType.Entropy}.\n   *\n   * @returns The multichain account wallet type.\n   */\n  get type(): AccountWalletType.Entropy {\n    return AccountWalletType.Entropy;\n  }\n\n  /**\n   * Gets the multichain account wallet entropy source.\n   *\n   * @returns The multichain account wallet entropy source.\n   */\n  get entropySource(): EntropySourceId {\n    return this.#entropySource;\n  }\n\n  /**\n   * Gets multichain account for a given ID.\n   * The default group ID will default to the multichain account with index 0.\n   *\n   * @param id - Account group ID.\n   * @returns Account group.\n   */\n  getAccountGroup(id: AccountGroupId): MultichainAccount<Account> | undefined {\n    // We consider the \"default case\" to be mapped to index 0.\n    if (id === toDefaultAccountGroupId(this.id)) {\n      return this.#accounts.get(0);\n    }\n\n    // If it is not a valid ID, we cannot extract the group index\n    // from it, so we fail fast.\n    if (!isMultichainAccountId(id)) {\n      return undefined;\n    }\n\n    const groupIndex = getGroupIndexFromMultichainAccountId(id);\n    return this.#accounts.get(groupIndex);\n  }\n\n  /**\n   * Gets all multichain accounts. Similar to {@link MultichainAccountWallet.getMultichainAccounts}.\n   *\n   * @returns The multichain accounts.\n   */\n  getAccountGroups(): MultichainAccount<Account>[] {\n    return this.getMultichainAccounts();\n  }\n\n  /**\n   * Gets multichain account for a given index.\n   *\n   * @param groupIndex - Multichain account index.\n   * @returns The multichain account associated with the given index.\n   */\n  getMultichainAccount(\n    groupIndex: number,\n  ): MultichainAccount<Account> | undefined {\n    return this.#accounts.get(groupIndex);\n  }\n\n  /**\n   * Gets all multichain accounts.\n   *\n   * @returns The multichain accounts.\n   */\n  getMultichainAccounts(): MultichainAccount<Account>[] {\n    return Array.from(this.#accounts.values()); // TODO: Prevent copy here.\n  }\n}\n\n/**\n * Gets the multichain account wallet ID from its entropy source.\n *\n * @param entropySource - Entropy source ID of that wallet.\n * @returns The multichain account wallet ID.\n */\nexport function toMultichainAccountWalletId(\n  entropySource: EntropySourceId,\n): MultichainAccountWalletId {\n  return `${AccountWalletType.Entropy}:${entropySource}`;\n}\n"]}
+{"version":3,"file":"wallet.mjs","sourceRoot":"","sources":["../../../src/api/multichain/wallet.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,sBAAkB;AAgD9C;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,aAA8B;IAE9B,OAAO,GAAG,iBAAiB,CAAC,OAAO,IAAI,aAAa,EAAE,CAAC;AACzD,CAAC","sourcesContent":["import {\n  type EntropySourceId,\n  type KeyringAccount,\n} from '@metamask/keyring-api';\n\nimport type { MultichainAccountGroup } from './group';\nimport type { Bip44Account } from '../bip44';\nimport type { AccountWallet } from '../wallet';\nimport { AccountWalletType } from '../wallet';\n\n/**\n * Multichain account wallet ID.\n */\nexport type MultichainAccountWalletId =\n  `${AccountWalletType.Entropy}:${EntropySourceId}`;\n\n/**\n * A multichain account wallet that holds multiple multichain accounts (one multichain account per\n * group index).\n */\nexport type MultichainAccountWallet<\n  Account extends Bip44Account<KeyringAccount>,\n> = AccountWallet<Account> & {\n  /**\n   * Multichain account wallet ID.\n   */\n  get id(): MultichainAccountWalletId;\n\n  /**\n   * Multichain account wallet type, which is always {@link AccountWalletType.Entropy}.\n   */\n  get type(): AccountWalletType.Entropy;\n\n  /**\n   * Multichain account wallet entropy source.\n   */\n  get entropySource(): EntropySourceId;\n\n  /**\n   * Gets multichain account for a given index.\n   *\n   * @param groupIndex - Multichain account index.\n   * @returns The multichain account associated with the given index.\n   */\n  getMultichainAccountGroup(\n    groupIndex: number,\n  ): MultichainAccountGroup<Account> | undefined;\n\n  /**\n   * Gets all multichain accounts.\n   *\n   * @returns The multichain accounts.\n   */\n  getMultichainAccountGroups(): MultichainAccountGroup<Account>[];\n};\n\n/**\n * Gets the multichain account wallet ID from its entropy source.\n *\n * @param entropySource - Entropy source ID of that wallet.\n * @returns The multichain account wallet ID.\n */\nexport function toMultichainAccountWalletId(\n  entropySource: EntropySourceId,\n): MultichainAccountWalletId {\n  return `${AccountWalletType.Entropy}:${entropySource}`;\n}\n"]}

package/dist/api/wallet.cjs

@@ -9,17 +9,11 @@ exports.toAccountWalletId = toAccountWalletId;
  */
 var AccountWalletType;
 (function (AccountWalletType) {
-    /**
-     * Wallet grouping accounts based on their entropy source.
-     */
+    /** Wallet grouping accounts based on their entropy source. */
     AccountWalletType["Entropy"] = "entropy";
-    /**
-     * Wallet grouping accounts based on their keyring's type.
-     */
+    /** Wallet grouping accounts based on their keyring's type. */
     AccountWalletType["Keyring"] = "keyring";
-    /**
-     * Wallet grouping accounts associated with an account management Snap.
-     */
+    /** Wallet grouping accounts associated with an account management Snap. */
     AccountWalletType["Snap"] = "snap";
 })(AccountWalletType || (exports.AccountWalletType = AccountWalletType = {}));
 /**

package/dist/api/wallet.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.cjs","sourceRoot":"","sources":["../../src/api/wallet.ts"],"names":[],"mappings":";;;AAqEA,8CAKC;AArED;;;;GAIG;AACH,IAAY,iBAeX;AAfD,WAAY,iBAAiB;IAC3B;;OAEG;IACH,wCAAmB,CAAA;IAEnB;;OAEG;IACH,wCAAmB,CAAA;IAEnB;;OAEG;IACH,kCAAa,CAAA;AACf,CAAC,EAfW,iBAAiB,iCAAjB,iBAAiB,QAe5B;AAqCD;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAC/B,IAAuB,EACvB,EAAU;IAEV,OAAO,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;AACzB,CAAC","sourcesContent":["import type { KeyringAccount } from '@metamask/keyring-api';\n\n// Circular import are allowed when using `import type`.\nimport type { AccountGroup, AccountGroupId } from './group';\n\n/**\n * Wallet type.\n *\n * Each wallet types groups accounts using different criterias.\n */\nexport enum AccountWalletType {\n  /**\n   * Wallet grouping accounts based on their entropy source.\n   */\n  Entropy = 'entropy',\n\n  /**\n   * Wallet grouping accounts based on their keyring's type.\n   */\n  Keyring = 'keyring',\n\n  /**\n   * Wallet grouping accounts associated with an account management Snap.\n   */\n  Snap = 'snap',\n}\n\n/**\n * Account wallet ID.\n */\nexport type AccountWalletId = `${AccountWalletType}:${string}`;\n\n/**\n * Account wallet that can hold multiple account groups.\n */\nexport type AccountWallet<Account extends KeyringAccount> = {\n  /**\n   * Account wallet ID.\n   */\n  get id(): AccountWalletId;\n\n  /**\n   * Account wallet type.\n   */\n  get type(): AccountWalletType;\n\n  /**\n   * Gets account group for a given ID.\n   *\n   * @param id - Account group ID.\n   * @returns Account group.\n   */\n  getAccountGroup(id: AccountGroupId): AccountGroup<Account> | undefined;\n\n  /**\n   * Gets all account groups.\n   *\n   * @returns Account groups.\n   */\n  getAccountGroups(): AccountGroup<Account>[];\n};\n\n/**\n * Convert a unique ID to a wallet ID for a given type.\n *\n * @param type - A wallet type.\n * @param id - A unique ID.\n * @returns A wallet ID.\n */\nexport function toAccountWalletId(\n  type: AccountWalletType,\n  id: string,\n): AccountWalletId {\n  return `${type}:${id}`;\n}\n"]}
+{"version":3,"file":"wallet.cjs","sourceRoot":"","sources":["../../src/api/wallet.ts"],"names":[],"mappings":";;;AAsEA,8CAKC;AAtED;;;;GAIG;AACH,IAAY,iBASX;AATD,WAAY,iBAAiB;IAC3B,8DAA8D;IAC9D,wCAAmB,CAAA;IAEnB,8DAA8D;IAC9D,wCAAmB,CAAA;IAEnB,2EAA2E;IAC3E,kCAAa,CAAA;AACf,CAAC,EATW,iBAAiB,iCAAjB,iBAAiB,QAS5B;AA4CD;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAC/B,IAAgB,EAChB,EAAU;IAEV,OAAO,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;AACzB,CAAC","sourcesContent":["import type { KeyringAccount } from '@metamask/keyring-api';\n\n// Circular import are allowed when using `import type`.\nimport type { AccountGroup, AccountGroupId } from './group';\n\n/**\n * Wallet type.\n *\n * Each wallet types groups accounts using different criterias.\n */\nexport enum AccountWalletType {\n  /** Wallet grouping accounts based on their entropy source. */\n  Entropy = 'entropy',\n\n  /** Wallet grouping accounts based on their keyring's type. */\n  Keyring = 'keyring',\n\n  /** Wallet grouping accounts associated with an account management Snap. */\n  Snap = 'snap',\n}\n\n/**\n * Account wallet ID.\n */\nexport type AccountWalletId = `${AccountWalletType}:${string}`;\n\n/**\n * Account wallet that can hold multiple account groups.\n */\nexport type AccountWallet<Account extends KeyringAccount> = {\n  /**\n   * Account wallet ID.\n   */\n  get id(): AccountWalletId;\n\n  /**\n   * Account wallet type.\n   */\n  get type(): AccountWalletType;\n\n  /**\n   * Gets account group for a given ID.\n   *\n   * @param id - Account group ID.\n   * @returns Account group.\n   */\n  getAccountGroup(id: AccountGroupId): AccountGroup<Account> | undefined;\n\n  /**\n   * Gets all account groups.\n   *\n   * @returns Account groups.\n   */\n  getAccountGroups(): AccountGroup<Account>[];\n};\n\n/**\n * Type utility to compute a constrained {@link AccountWalletId} type given a\n * specifc {@link AccountWalletType}.\n */\nexport type AccountWalletIdOf<WalletType extends AccountWalletType> =\n  `${WalletType}:${string}`;\n\n/**\n * Convert a unique ID to a wallet ID for a given type.\n *\n * @param type - A wallet type.\n * @param id - A unique ID.\n * @returns A wallet ID.\n */\nexport function toAccountWalletId<WalletType extends AccountWalletType>(\n  type: WalletType,\n  id: string,\n): AccountWalletIdOf<WalletType> {\n  return `${type}:${id}`;\n}\n"]}

package/dist/api/wallet.d.cts

@@ -6,17 +6,11 @@ import type { AccountGroup, AccountGroupId } from "./group.cjs";
  * Each wallet types groups accounts using different criterias.
  */
 export declare enum AccountWalletType {
-    /**
-     * Wallet grouping accounts based on their entropy source.
-     */
+    /** Wallet grouping accounts based on their entropy source. */
     Entropy = "entropy",
-    /**
-     * Wallet grouping accounts based on their keyring's type.
-     */
+    /** Wallet grouping accounts based on their keyring's type. */
     Keyring = "keyring",
-    /**
-     * Wallet grouping accounts associated with an account management Snap.
-     */
+    /** Wallet grouping accounts associated with an account management Snap. */
     Snap = "snap"
 }
 /**
@@ -49,6 +43,11 @@ export type AccountWallet<Account extends KeyringAccount> = {
      */
     getAccountGroups(): AccountGroup<Account>[];
 };
+/**
+ * Type utility to compute a constrained {@link AccountWalletId} type given a
+ * specifc {@link AccountWalletType}.
+ */
+export type AccountWalletIdOf<WalletType extends AccountWalletType> = `${WalletType}:${string}`;
 /**
  * Convert a unique ID to a wallet ID for a given type.
  *
@@ -56,5 +55,5 @@ export type AccountWallet<Account extends KeyringAccount> = {
  * @param id - A unique ID.
  * @returns A wallet ID.
  */
-export declare function toAccountWalletId(type: AccountWalletType, id: string): AccountWalletId;
+export declare function toAccountWalletId<WalletType extends AccountWalletType>(type: WalletType, id: string): AccountWalletIdOf<WalletType>;
 //# sourceMappingURL=wallet.d.cts.map

package/dist/api/wallet.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.d.cts","sourceRoot":"","sources":["../../src/api/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA8B;AAG5D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAgB;AAE5D;;;;GAIG;AACH,oBAAY,iBAAiB;IAC3B;;OAEG;IACH,OAAO,YAAY;IAEnB;;OAEG;IACH,OAAO,YAAY;IAEnB;;OAEG;IACH,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,iBAAiB,IAAI,MAAM,EAAE,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,cAAc,IAAI;IAC1D;;OAEG;IACH,IAAI,EAAE,IAAI,eAAe,CAAC;IAE1B;;OAEG;IACH,IAAI,IAAI,IAAI,iBAAiB,CAAC;IAE9B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAEvE;;;;OAIG;IACH,gBAAgB,IAAI,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;CAC7C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,iBAAiB,EACvB,EAAE,EAAE,MAAM,GACT,eAAe,CAEjB"}
+{"version":3,"file":"wallet.d.cts","sourceRoot":"","sources":["../../src/api/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA8B;AAG5D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAgB;AAE5D;;;;GAIG;AACH,oBAAY,iBAAiB;IAC3B,8DAA8D;IAC9D,OAAO,YAAY;IAEnB,8DAA8D;IAC9D,OAAO,YAAY;IAEnB,2EAA2E;IAC3E,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,iBAAiB,IAAI,MAAM,EAAE,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,cAAc,IAAI;IAC1D;;OAEG;IACH,IAAI,EAAE,IAAI,eAAe,CAAC;IAE1B;;OAEG;IACH,IAAI,IAAI,IAAI,iBAAiB,CAAC;IAE9B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAEvE;;;;OAIG;IACH,gBAAgB,IAAI,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;CAC7C,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,UAAU,SAAS,iBAAiB,IAChE,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC;AAE5B;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,SAAS,iBAAiB,EACpE,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,MAAM,GACT,iBAAiB,CAAC,UAAU,CAAC,CAE/B"}