@metamask-previews/account-api 0.0.0-586437b

package/dist/api/multichain/adapters.mjs

@@ -0,0 +1,235 @@
+/* eslint-disable @typescript-eslint/no-redundant-type-constituents */
+// This rule seems to be triggering a false positive. Possibly eslint is not
+// inferring the `InternalAccount` type correctly which causes issue with the
+// union `| undefined`.
+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 _MultichainAccountAdapter_id, _MultichainAccountAdapter_wallet, _MultichainAccountAdapter_index, _MultichainAccountAdapter_providers, _MultichainAccountAdapter_providersByAccountId, _MultichainAccountAdapter_accounts, _MultichainAccountWalletAdapter_instances, _MultichainAccountWalletAdapter_id, _MultichainAccountWalletAdapter_providers, _MultichainAccountWalletAdapter_entropySource, _MultichainAccountWalletAdapter_accounts, _MultichainAccountWalletAdapter_createMultichainAccount;
+import { isScopeEqualToAny } from "@metamask/keyring-utils";
+import { getGroupIndexFromAccountGroupId, toDefaultAccountGroupId, toMultichainAccountId, toMultichainAccountWalletId } from "../index.mjs";
+export class MultichainAccountAdapter {
+    constructor({ groupIndex, wallet, providers, }) {
+        _MultichainAccountAdapter_id.set(this, void 0);
+        _MultichainAccountAdapter_wallet.set(this, void 0);
+        _MultichainAccountAdapter_index.set(this, void 0);
+        _MultichainAccountAdapter_providers.set(this, void 0);
+        _MultichainAccountAdapter_providersByAccountId.set(this, void 0);
+        _MultichainAccountAdapter_accounts.set(this, void 0);
+        __classPrivateFieldSet(this, _MultichainAccountAdapter_id, toMultichainAccountId(wallet.id, groupIndex), "f");
+        __classPrivateFieldSet(this, _MultichainAccountAdapter_index, groupIndex, "f");
+        __classPrivateFieldSet(this, _MultichainAccountAdapter_wallet, wallet, "f");
+        __classPrivateFieldSet(this, _MultichainAccountAdapter_providers, providers, "f");
+        __classPrivateFieldSet(this, _MultichainAccountAdapter_accounts, new Map(), "f");
+        __classPrivateFieldSet(this, _MultichainAccountAdapter_providersByAccountId, new Map(), "f");
+        for (const provider of __classPrivateFieldGet(this, _MultichainAccountAdapter_providers, "f")) {
+            const accounts = provider.getAccounts({
+                entropySource: __classPrivateFieldGet(this, _MultichainAccountAdapter_wallet, "f").entropySource,
+                groupIndex: __classPrivateFieldGet(this, _MultichainAccountAdapter_index, "f"),
+            });
+            __classPrivateFieldGet(this, _MultichainAccountAdapter_accounts, "f").set(provider, accounts);
+            for (const id of accounts) {
+                __classPrivateFieldGet(this, _MultichainAccountAdapter_providersByAccountId, "f").set(id, provider);
+            }
+        }
+    }
+    get id() {
+        return __classPrivateFieldGet(this, _MultichainAccountAdapter_id, "f");
+    }
+    get wallet() {
+        return __classPrivateFieldGet(this, _MultichainAccountAdapter_wallet, "f");
+    }
+    get index() {
+        return __classPrivateFieldGet(this, _MultichainAccountAdapter_index, "f");
+    }
+    hasAccounts() {
+        // Use this map, cause if there's no accounts, then this map will also
+        // be empty.
+        return __classPrivateFieldGet(this, _MultichainAccountAdapter_providersByAccountId, "f").size > 0;
+    }
+    getAccounts() {
+        let allAccounts = [];
+        for (const [provider, accounts] of __classPrivateFieldGet(this, _MultichainAccountAdapter_accounts, "f").entries()) {
+            allAccounts = allAccounts.concat(accounts.map((id) => provider.getAccount(id)));
+        }
+        return allAccounts;
+    }
+    getAccount(id) {
+        const provider = __classPrivateFieldGet(this, _MultichainAccountAdapter_providersByAccountId, "f").get(id);
+        return provider?.getAccount(id);
+    }
+    get(selector) {
+        const accounts = this.select(selector);
+        if (accounts.length > 1) {
+            throw new Error(`Too many account candidates, expected 1, got: ${accounts.length}`);
+        }
+        if (accounts.length === 0) {
+            return undefined;
+        }
+        return accounts[0]; // This is safe, see checks above.
+    }
+    select(selector) {
+        return this.getAccounts().filter((account) => {
+            let selected = true;
+            if (selector.id) {
+                selected && (selected = account.id === selector.id);
+            }
+            if (selector.address) {
+                selected && (selected = account.address === selector.address);
+            }
+            if (selector.type) {
+                selected && (selected = account.type === selector.type);
+            }
+            if (selector.methods !== undefined) {
+                selected && (selected = selector.methods.some((method) => account.methods.includes(method)));
+            }
+            if (selector.scopes !== undefined) {
+                selected && (selected = selector.scopes.some((scope) => {
+                    return (
+                    // This will cover specific EVM EOA scopes as well.
+                    isScopeEqualToAny(scope, account.scopes));
+                }));
+            }
+            return selected;
+        });
+    }
+}
+_MultichainAccountAdapter_id = new WeakMap(), _MultichainAccountAdapter_wallet = new WeakMap(), _MultichainAccountAdapter_index = new WeakMap(), _MultichainAccountAdapter_providers = new WeakMap(), _MultichainAccountAdapter_providersByAccountId = new WeakMap(), _MultichainAccountAdapter_accounts = new WeakMap();
+export class MultichainAccountWalletAdapter {
+    constructor({ providers, entropySource, }) {
+        _MultichainAccountWalletAdapter_instances.add(this);
+        _MultichainAccountWalletAdapter_id.set(this, void 0);
+        _MultichainAccountWalletAdapter_providers.set(this, void 0);
+        _MultichainAccountWalletAdapter_entropySource.set(this, void 0);
+        _MultichainAccountWalletAdapter_accounts.set(this, void 0);
+        __classPrivateFieldSet(this, _MultichainAccountWalletAdapter_id, toMultichainAccountWalletId(entropySource), "f");
+        __classPrivateFieldSet(this, _MultichainAccountWalletAdapter_providers, providers, "f");
+        __classPrivateFieldSet(this, _MultichainAccountWalletAdapter_entropySource, entropySource, "f");
+        __classPrivateFieldSet(this, _MultichainAccountWalletAdapter_accounts, new Map(), "f");
+        let groupIndex = 0;
+        let hasAccounts = false;
+        do {
+            const multichainAccount = new MultichainAccountAdapter({
+                groupIndex,
+                wallet: this,
+                providers: __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_providers, "f"),
+            });
+            // We only add multichain account that has underlying accounts.
+            hasAccounts = multichainAccount.hasAccounts();
+            if (hasAccounts) {
+                __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_accounts, "f").set(groupIndex, multichainAccount);
+            }
+            groupIndex += 1;
+        } while (hasAccounts);
+    }
+    get id() {
+        return __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_id, "f");
+    }
+    get entropySource() {
+        return __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_entropySource, "f");
+    }
+    getAccountGroup(groupId) {
+        // We consider the "default case" to be mapped to index 0.
+        if (groupId === toDefaultAccountGroupId(this.id)) {
+            return __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_accounts, "f").get(0);
+        }
+        const groupIndex = getGroupIndexFromAccountGroupId(groupId);
+        if (groupIndex === undefined) {
+            return undefined;
+        }
+        return __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_accounts, "f").get(groupIndex);
+    }
+    getAccountGroups() {
+        return this.getMultichainAccounts();
+    }
+    getMultichainAccount(groupIndex) {
+        return __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_accounts, "f").get(groupIndex);
+    }
+    getMultichainAccounts() {
+        return Array.from(__classPrivateFieldGet(this, _MultichainAccountWalletAdapter_accounts, "f").values()); // TODO: Prevent copy here.
+    }
+    getNextGroupIndex() {
+        // Assuming we cannot have indexes gaps.
+        return __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_accounts, "f").size; // No +1 here, group indexes starts at 0.
+    }
+    async createMultichainAccount(groupIndex) {
+        const nextGroupIndex = this.getNextGroupIndex();
+        if (groupIndex > nextGroupIndex) {
+            throw new Error(`You cannot use an group index that is higher than the next available one: expect <${nextGroupIndex}, got ${groupIndex}`);
+        }
+        for (const provider of __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_providers, "f")) {
+            await provider.createAccounts({
+                entropySource: __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_entropySource, "f"),
+                groupIndex,
+            });
+        }
+        // Re-create and "refresh" the multichain account (we assume all account creations are
+        // idempotent, so we should get the same accounts and potentially some new accounts (if
+        // some account providers decide to return more of them this time).
+        return __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_instances, "m", _MultichainAccountWalletAdapter_createMultichainAccount).call(this, groupIndex);
+    }
+    async createNextMultichainAccount() {
+        return this.createMultichainAccount(this.getNextGroupIndex());
+    }
+    async discoverAndCreateMultichainAccounts() {
+        const multichainAccounts = [];
+        let discovered;
+        let groupIndex = 0;
+        do {
+            // Keep track if any accounts got discovered for that new index.
+            discovered = false;
+            const missingProviders = [];
+            for (const provider of __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_providers, "f")) {
+                const discoveredAccounts = await provider.discoverAndCreateAccounts({
+                    entropySource: __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_entropySource, "f"),
+                    groupIndex,
+                });
+                if (discoveredAccounts.length) {
+                    // This provider has discovered and created accounts, meaning there might
+                    // be something to discover on the next index.
+                    discovered = true;
+                }
+                else {
+                    // This provider did not discover or create any accounts. We mark it as
+                    // "missing", so we can create accounts on this index if other providers
+                    // did discover something.
+                    missingProviders.push(provider);
+                }
+            }
+            if (discovered) {
+                // We only create missing accounts if one of the provider has discovered
+                // and created accounts.
+                for (const provider of missingProviders) {
+                    await provider.createAccounts({
+                        entropySource: __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_entropySource, "f"),
+                        groupIndex,
+                    });
+                }
+                // We've got all the accounts now, we can create our multichain account.
+                multichainAccounts.push(__classPrivateFieldGet(this, _MultichainAccountWalletAdapter_instances, "m", _MultichainAccountWalletAdapter_createMultichainAccount).call(this, groupIndex));
+                // We have accounts, we need to check the next index.
+                groupIndex += 1;
+            }
+        } while (discovered);
+        return multichainAccounts;
+    }
+}
+_MultichainAccountWalletAdapter_id = new WeakMap(), _MultichainAccountWalletAdapter_providers = new WeakMap(), _MultichainAccountWalletAdapter_entropySource = new WeakMap(), _MultichainAccountWalletAdapter_accounts = new WeakMap(), _MultichainAccountWalletAdapter_instances = new WeakSet(), _MultichainAccountWalletAdapter_createMultichainAccount = function _MultichainAccountWalletAdapter_createMultichainAccount(groupIndex) {
+    const multichainAccount = new MultichainAccountAdapter({
+        wallet: this,
+        providers: __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_providers, "f"),
+        groupIndex,
+    });
+    // Register the account to our internal map.
+    __classPrivateFieldGet(this, _MultichainAccountWalletAdapter_accounts, "f").set(groupIndex, multichainAccount);
+    return multichainAccount;
+};
+//# sourceMappingURL=adapters.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.mjs","sourceRoot":"","sources":["../../../src/api/multichain/adapters.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/no-redundant-type-constituents */\n// This rule seems to be triggering a false positive. Possibly eslint is not\n// inferring the `InternalAccount` type correctly which causes issue with the\n// union `| undefined`.\n\nimport type { EntropySourceId, KeyringAccount } from '@metamask/keyring-api';\nimport type { AccountId } from '@metamask/keyring-utils';\nimport { isScopeEqualToAny } from '@metamask/keyring-utils';\n\nimport type {\n  AccountGroupId,\n  AccountProvider,\n  MultichainAccount,\n  MultichainAccountId,\n  MultichainAccountSelector,\n  MultichainAccountWallet,\n  MultichainAccountWalletId,\n} from '..';\nimport {\n  getGroupIndexFromAccountGroupId,\n  toDefaultAccountGroupId,\n  toMultichainAccountId,\n  toMultichainAccountWalletId,\n} from '..';\n\nexport class MultichainAccountAdapter<Account extends KeyringAccount>\n  implements MultichainAccount<Account>\n{\n  readonly #id: MultichainAccountId;\n\n  readonly #wallet: MultichainAccountWallet<Account>;\n\n  readonly #index: number;\n\n  readonly #providers: AccountProvider<Account>[];\n\n  readonly #providersByAccountId: Map<AccountId, AccountProvider<Account>>;\n\n  readonly #accounts: Map<AccountProvider<Account>, AccountId[]>;\n\n  constructor({\n    groupIndex,\n    wallet,\n    providers,\n  }: {\n    groupIndex: number;\n    wallet: MultichainAccountWallet<Account>;\n    providers: AccountProvider<Account>[];\n  }) {\n    this.#id = toMultichainAccountId(wallet.id, groupIndex);\n    this.#index = groupIndex;\n    this.#wallet = wallet;\n    this.#providers = providers;\n    this.#accounts = new Map();\n    this.#providersByAccountId = new Map();\n\n    for (const provider of this.#providers) {\n      const accounts = provider.getAccounts({\n        entropySource: this.#wallet.entropySource,\n        groupIndex: this.#index,\n      });\n\n      this.#accounts.set(provider, accounts);\n      for (const id of accounts) {\n        this.#providersByAccountId.set(id, provider);\n      }\n    }\n  }\n\n  get id(): MultichainAccountId {\n    return this.#id;\n  }\n\n  get wallet(): MultichainAccountWallet<Account> {\n    return this.#wallet;\n  }\n\n  get index(): number {\n    return this.#index;\n  }\n\n  hasAccounts(): boolean {\n    // Use this map, cause if there's no accounts, then this map will also\n    // be empty.\n    return this.#providersByAccountId.size > 0;\n  }\n\n  getAccounts(): Account[] {\n    let allAccounts: Account[] = [];\n\n    for (const [provider, accounts] of this.#accounts.entries()) {\n      allAccounts = allAccounts.concat(\n        accounts.map((id) => provider.getAccount(id)),\n      );\n    }\n\n    return allAccounts;\n  }\n\n  getAccount(id: AccountId): Account | undefined {\n    const provider = this.#providersByAccountId.get(id);\n\n    return provider?.getAccount(id);\n  }\n\n  get(selector: MultichainAccountSelector): Account | undefined {\n    const accounts = this.select(selector);\n\n    if (accounts.length > 1) {\n      throw new Error(\n        `Too many account candidates, expected 1, got: ${accounts.length}`,\n      );\n    }\n\n    if (accounts.length === 0) {\n      return undefined;\n    }\n\n    return accounts[0]; // This is safe, see checks above.\n  }\n\n  select(selector: MultichainAccountSelector): Account[] {\n    return this.getAccounts().filter((account) => {\n      let selected = true;\n\n      if (selector.id) {\n        selected &&= account.id === selector.id;\n      }\n      if (selector.address) {\n        selected &&= account.address === selector.address;\n      }\n      if (selector.type) {\n        selected &&= account.type === selector.type;\n      }\n      if (selector.methods !== undefined) {\n        selected &&= selector.methods.some((method) =>\n          account.methods.includes(method),\n        );\n      }\n      if (selector.scopes !== undefined) {\n        selected &&= selector.scopes.some((scope) => {\n          return (\n            // This will cover specific EVM EOA scopes as well.\n            isScopeEqualToAny(scope, account.scopes)\n          );\n        });\n      }\n\n      return selected;\n    });\n  }\n}\n\nexport class MultichainAccountWalletAdapter<Account extends KeyringAccount>\n  implements MultichainAccountWallet<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    let groupIndex = 0;\n    let hasAccounts = false;\n\n    do {\n      const multichainAccount = new MultichainAccountAdapter({\n        groupIndex,\n        wallet: this,\n        providers: this.#providers,\n      });\n\n      // We only add multichain account that has underlying accounts.\n      hasAccounts = multichainAccount.hasAccounts();\n      if (hasAccounts) {\n        this.#accounts.set(groupIndex, multichainAccount);\n      }\n\n      groupIndex += 1;\n    } while (hasAccounts);\n  }\n\n  get id(): MultichainAccountWalletId {\n    return this.#id;\n  }\n\n  get entropySource(): EntropySourceId {\n    return this.#entropySource;\n  }\n\n  getAccountGroup(\n    groupId: AccountGroupId,\n  ): MultichainAccount<Account> | undefined {\n    // We consider the \"default case\" to be mapped to index 0.\n    if (groupId === toDefaultAccountGroupId(this.id)) {\n      return this.#accounts.get(0);\n    }\n\n    const groupIndex = getGroupIndexFromAccountGroupId(groupId);\n    if (groupIndex === undefined) {\n      return undefined;\n    }\n    return this.#accounts.get(groupIndex);\n  }\n\n  getAccountGroups(): MultichainAccount<Account>[] {\n    return this.getMultichainAccounts();\n  }\n\n  getMultichainAccount(\n    groupIndex: number,\n  ): MultichainAccount<Account> | undefined {\n    return this.#accounts.get(groupIndex);\n  }\n\n  getMultichainAccounts(): MultichainAccount<Account>[] {\n    return Array.from(this.#accounts.values()); // TODO: Prevent copy here.\n  }\n\n  #createMultichainAccount(groupIndex: number): MultichainAccount<Account> {\n    const multichainAccount = new MultichainAccountAdapter({\n      wallet: this,\n      providers: this.#providers,\n      groupIndex,\n    });\n\n    // Register the account to our internal map.\n    this.#accounts.set(groupIndex, multichainAccount);\n\n    return multichainAccount;\n  }\n\n  getNextGroupIndex(): number {\n    // Assuming we cannot have indexes gaps.\n    return this.#accounts.size; // No +1 here, group indexes starts at 0.\n  }\n\n  async createMultichainAccount(\n    groupIndex: number,\n  ): Promise<MultichainAccount<Account>> {\n    const nextGroupIndex = this.getNextGroupIndex();\n    if (groupIndex > nextGroupIndex) {\n      throw new Error(\n        `You cannot use an group index that is higher than the next available one: expect <${nextGroupIndex}, got ${groupIndex}`,\n      );\n    }\n\n    for (const provider of this.#providers) {\n      await provider.createAccounts({\n        entropySource: this.#entropySource,\n        groupIndex,\n      });\n    }\n\n    // Re-create and \"refresh\" the multichain account (we assume all account creations are\n    // idempotent, so we should get the same accounts and potentially some new accounts (if\n    // some account providers decide to return more of them this time).\n    return this.#createMultichainAccount(groupIndex);\n  }\n\n  async createNextMultichainAccount(): Promise<MultichainAccount<Account>> {\n    return this.createMultichainAccount(this.getNextGroupIndex());\n  }\n\n  async discoverAndCreateMultichainAccounts(): Promise<\n    MultichainAccount<Account>[]\n  > {\n    const multichainAccounts: MultichainAccount<Account>[] = [];\n\n    let discovered: boolean;\n    let groupIndex = 0;\n\n    do {\n      // Keep track if any accounts got discovered for that new index.\n      discovered = false;\n\n      const missingProviders = [];\n      for (const provider of this.#providers) {\n        const discoveredAccounts = await provider.discoverAndCreateAccounts({\n          entropySource: this.#entropySource,\n          groupIndex,\n        });\n\n        if (discoveredAccounts.length) {\n          // This provider has discovered and created accounts, meaning there might\n          // be something to discover on the next index.\n          discovered = true;\n        } else {\n          // This provider did not discover or create any accounts. We mark it as\n          // \"missing\", so we can create accounts on this index if other providers\n          // did discover something.\n          missingProviders.push(provider);\n        }\n      }\n\n      if (discovered) {\n        // We only create missing accounts if one of the provider has discovered\n        // and created accounts.\n        for (const provider of missingProviders) {\n          await provider.createAccounts({\n            entropySource: this.#entropySource,\n            groupIndex,\n          });\n        }\n\n        // We've got all the accounts now, we can create our multichain account.\n        multichainAccounts.push(this.#createMultichainAccount(groupIndex));\n\n        // We have accounts, we need to check the next index.\n        groupIndex += 1;\n      }\n    } while (discovered);\n\n    return multichainAccounts;\n  }\n}\n"]}

package/dist/api/multichain/id.cjs

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toMultichainAccountWalletId = toMultichainAccountWalletId;
+exports.toMultichainAccountId = toMultichainAccountId;
+exports.getGroupIndexFromAccountGroupId = getGroupIndexFromAccountGroupId;
+const wallet_1 = require("../wallet.cjs");
+const GROUP_INDEX_REGEX = new RegExp(`^${wallet_1.AccountWalletCategory.Entropy}:.*:(?<groupIndex>\\d+)$`, 'u');
+/**
+ * Gets the multichain account wallet ID from its entropy source.
+ *
+ * @param entropySource - Entropy source ID of that wallet.
+ * @returns The multichain account wallet ID.
+ */
+function toMultichainAccountWalletId(entropySource) {
+    return `${wallet_1.AccountWalletCategory.Entropy}:${entropySource}`;
+}
+/**
+ * Gets the multichain account ID from its multichain account wallet ID and its index.
+ *
+ * @param walletId - Multichain account wallet ID.
+ * @param groupIndex - Index of that multichain account.
+ * @returns The multichain account ID.
+ */
+function toMultichainAccountId(walletId, groupIndex) {
+    return `${walletId}:${groupIndex}`;
+}
+/**
+ * Gets the multichain account index from an account group ID.
+ *
+ * @param groupId - Account group ID.
+ * @returns The multichain account index if extractable, undefined otherwise.
+ */
+function getGroupIndexFromAccountGroupId(groupId) {
+    const matched = groupId.match(GROUP_INDEX_REGEX);
+    if (matched) {
+        if (matched.groups?.groupIndex !== undefined) {
+            return Number(matched.groups.groupIndex);
+        }
+    }
+    // Unable to extract group index.
+    return undefined;
+}
+//# sourceMappingURL=id.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id.cjs","sourceRoot":"","sources":["../../../src/api/multichain/id.ts"],"names":[],"mappings":";;AAqBA,kEAIC;AASD,sDAKC;AAQD,0EAYC;AAxDD,0CAAkD;AAOlD,MAAM,iBAAiB,GAAG,IAAI,MAAM,CAClC,IAAI,8BAAqB,CAAC,OAAO,0BAA0B,EAC3D,GAAG,CACJ,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,2BAA2B,CACzC,aAA8B;IAE9B,OAAO,GAAG,8BAAqB,CAAC,OAAO,IAAI,aAAa,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,qBAAqB,CACnC,QAAmC,EACnC,UAAkB;IAElB,OAAO,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,+BAA+B,CAC7C,OAAuB;IAEvB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACjD,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,OAAO,CAAC,MAAM,EAAE,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import type { EntropySourceId } from '@metamask/keyring-api';\n\nimport type { AccountGroupId } from '../group';\nimport { AccountWalletCategory } from '../wallet';\n\nexport type MultichainAccountWalletId =\n  `${AccountWalletCategory.Entropy}:${string}`;\n\nexport type MultichainAccountId = `${MultichainAccountWalletId}:${number}`; // Use number for the account group index.\n\nconst GROUP_INDEX_REGEX = new RegExp(\n  `^${AccountWalletCategory.Entropy}:.*:(?<groupIndex>\\\\d+)$`,\n  'u',\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 `${AccountWalletCategory.Entropy}:${entropySource}`;\n}\n\n/**\n * Gets the multichain account ID from its multichain account wallet ID and its index.\n *\n * @param walletId - Multichain account wallet ID.\n * @param groupIndex - Index of that multichain account.\n * @returns The multichain account ID.\n */\nexport function toMultichainAccountId(\n  walletId: MultichainAccountWalletId,\n  groupIndex: number,\n): MultichainAccountId {\n  return `${walletId}:${groupIndex}`;\n}\n\n/**\n * Gets the multichain account index from an account group ID.\n *\n * @param groupId - Account group ID.\n * @returns The multichain account index if extractable, undefined otherwise.\n */\nexport function getGroupIndexFromAccountGroupId(\n  groupId: AccountGroupId,\n): number | undefined {\n  const matched = groupId.match(GROUP_INDEX_REGEX);\n  if (matched) {\n    if (matched.groups?.groupIndex !== undefined) {\n      return Number(matched.groups.groupIndex);\n    }\n  }\n\n  // Unable to extract group index.\n  return undefined;\n}\n"]}

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

@@ -0,0 +1,28 @@
+import type { EntropySourceId } from "@metamask/keyring-api";
+import type { AccountGroupId } from "../group.cjs";
+import { AccountWalletCategory } from "../wallet.cjs";
+export type MultichainAccountWalletId = `${AccountWalletCategory.Entropy}:${string}`;
+export type MultichainAccountId = `${MultichainAccountWalletId}:${number}`;
+/**
+ * Gets the multichain account wallet ID from its entropy source.
+ *
+ * @param entropySource - Entropy source ID of that wallet.
+ * @returns The multichain account wallet ID.
+ */
+export declare function toMultichainAccountWalletId(entropySource: EntropySourceId): MultichainAccountWalletId;
+/**
+ * Gets the multichain account ID from its multichain account wallet ID and its index.
+ *
+ * @param walletId - Multichain account wallet ID.
+ * @param groupIndex - Index of that multichain account.
+ * @returns The multichain account ID.
+ */
+export declare function toMultichainAccountId(walletId: MultichainAccountWalletId, groupIndex: number): MultichainAccountId;
+/**
+ * Gets the multichain account index from an account group ID.
+ *
+ * @param groupId - Account group ID.
+ * @returns The multichain account index if extractable, undefined otherwise.
+ */
+export declare function getGroupIndexFromAccountGroupId(groupId: AccountGroupId): number | undefined;
+//# sourceMappingURL=id.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.cts","sourceRoot":"","sources":["../../../src/api/multichain/id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,8BAA8B;AAE7D,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAiB;AAC/C,OAAO,EAAE,qBAAqB,EAAE,sBAAkB;AAElD,MAAM,MAAM,yBAAyB,GACnC,GAAG,qBAAqB,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC;AAE/C,MAAM,MAAM,mBAAmB,GAAG,GAAG,yBAAyB,IAAI,MAAM,EAAE,CAAC;AAO3E;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,eAAe,GAC7B,yBAAyB,CAE3B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,yBAAyB,EACnC,UAAU,EAAE,MAAM,GACjB,mBAAmB,CAErB;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,cAAc,GACtB,MAAM,GAAG,SAAS,CAUpB"}

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

@@ -0,0 +1,28 @@
+import type { EntropySourceId } from "@metamask/keyring-api";
+import type { AccountGroupId } from "../group.mjs";
+import { AccountWalletCategory } from "../wallet.mjs";
+export type MultichainAccountWalletId = `${AccountWalletCategory.Entropy}:${string}`;
+export type MultichainAccountId = `${MultichainAccountWalletId}:${number}`;
+/**
+ * Gets the multichain account wallet ID from its entropy source.
+ *
+ * @param entropySource - Entropy source ID of that wallet.
+ * @returns The multichain account wallet ID.
+ */
+export declare function toMultichainAccountWalletId(entropySource: EntropySourceId): MultichainAccountWalletId;
+/**
+ * Gets the multichain account ID from its multichain account wallet ID and its index.
+ *
+ * @param walletId - Multichain account wallet ID.
+ * @param groupIndex - Index of that multichain account.
+ * @returns The multichain account ID.
+ */
+export declare function toMultichainAccountId(walletId: MultichainAccountWalletId, groupIndex: number): MultichainAccountId;
+/**
+ * Gets the multichain account index from an account group ID.
+ *
+ * @param groupId - Account group ID.
+ * @returns The multichain account index if extractable, undefined otherwise.
+ */
+export declare function getGroupIndexFromAccountGroupId(groupId: AccountGroupId): number | undefined;
+//# sourceMappingURL=id.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.mts","sourceRoot":"","sources":["../../../src/api/multichain/id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,8BAA8B;AAE7D,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAiB;AAC/C,OAAO,EAAE,qBAAqB,EAAE,sBAAkB;AAElD,MAAM,MAAM,yBAAyB,GACnC,GAAG,qBAAqB,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC;AAE/C,MAAM,MAAM,mBAAmB,GAAG,GAAG,yBAAyB,IAAI,MAAM,EAAE,CAAC;AAO3E;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,eAAe,GAC7B,yBAAyB,CAE3B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,yBAAyB,EACnC,UAAU,EAAE,MAAM,GACjB,mBAAmB,CAErB;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,cAAc,GACtB,MAAM,GAAG,SAAS,CAUpB"}

package/dist/api/multichain/id.mjs

@@ -0,0 +1,38 @@
+import { AccountWalletCategory } from "../wallet.mjs";
+const GROUP_INDEX_REGEX = new RegExp(`^${AccountWalletCategory.Entropy}:.*:(?<groupIndex>\\d+)$`, 'u');
+/**
+ * Gets the multichain account wallet ID from its entropy source.
+ *
+ * @param entropySource - Entropy source ID of that wallet.
+ * @returns The multichain account wallet ID.
+ */
+export function toMultichainAccountWalletId(entropySource) {
+    return `${AccountWalletCategory.Entropy}:${entropySource}`;
+}
+/**
+ * Gets the multichain account ID from its multichain account wallet ID and its index.
+ *
+ * @param walletId - Multichain account wallet ID.
+ * @param groupIndex - Index of that multichain account.
+ * @returns The multichain account ID.
+ */
+export function toMultichainAccountId(walletId, groupIndex) {
+    return `${walletId}:${groupIndex}`;
+}
+/**
+ * Gets the multichain account index from an account group ID.
+ *
+ * @param groupId - Account group ID.
+ * @returns The multichain account index if extractable, undefined otherwise.
+ */
+export function getGroupIndexFromAccountGroupId(groupId) {
+    const matched = groupId.match(GROUP_INDEX_REGEX);
+    if (matched) {
+        if (matched.groups?.groupIndex !== undefined) {
+            return Number(matched.groups.groupIndex);
+        }
+    }
+    // Unable to extract group index.
+    return undefined;
+}
+//# sourceMappingURL=id.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id.mjs","sourceRoot":"","sources":["../../../src/api/multichain/id.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,sBAAkB;AAOlD,MAAM,iBAAiB,GAAG,IAAI,MAAM,CAClC,IAAI,qBAAqB,CAAC,OAAO,0BAA0B,EAC3D,GAAG,CACJ,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,aAA8B;IAE9B,OAAO,GAAG,qBAAqB,CAAC,OAAO,IAAI,aAAa,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAmC,EACnC,UAAkB;IAElB,OAAO,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,OAAuB;IAEvB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACjD,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,OAAO,CAAC,MAAM,EAAE,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import type { EntropySourceId } from '@metamask/keyring-api';\n\nimport type { AccountGroupId } from '../group';\nimport { AccountWalletCategory } from '../wallet';\n\nexport type MultichainAccountWalletId =\n  `${AccountWalletCategory.Entropy}:${string}`;\n\nexport type MultichainAccountId = `${MultichainAccountWalletId}:${number}`; // Use number for the account group index.\n\nconst GROUP_INDEX_REGEX = new RegExp(\n  `^${AccountWalletCategory.Entropy}:.*:(?<groupIndex>\\\\d+)$`,\n  'u',\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 `${AccountWalletCategory.Entropy}:${entropySource}`;\n}\n\n/**\n * Gets the multichain account ID from its multichain account wallet ID and its index.\n *\n * @param walletId - Multichain account wallet ID.\n * @param groupIndex - Index of that multichain account.\n * @returns The multichain account ID.\n */\nexport function toMultichainAccountId(\n  walletId: MultichainAccountWalletId,\n  groupIndex: number,\n): MultichainAccountId {\n  return `${walletId}:${groupIndex}`;\n}\n\n/**\n * Gets the multichain account index from an account group ID.\n *\n * @param groupId - Account group ID.\n * @returns The multichain account index if extractable, undefined otherwise.\n */\nexport function getGroupIndexFromAccountGroupId(\n  groupId: AccountGroupId,\n): number | undefined {\n  const matched = groupId.match(GROUP_INDEX_REGEX);\n  if (matched) {\n    if (matched.groups?.groupIndex !== undefined) {\n      return Number(matched.groups.groupIndex);\n    }\n  }\n\n  // Unable to extract group index.\n  return undefined;\n}\n"]}

package/dist/api/multichain/index.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./id.cjs"), exports);
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/api/multichain/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAqB","sourcesContent":["export * from './id';\nexport type * from './types';\nexport type * from './providers';\nexport type * from './adapters';\n"]}

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

@@ -0,0 +1,5 @@
+export * from "./id.cjs";
+export type * from "./types.cjs";
+export type * from "./providers.cjs";
+export type * from "./adapters.cjs";
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/api/multichain/index.ts"],"names":[],"mappings":"AAAA,yBAAqB;AACrB,iCAA6B;AAC7B,qCAAiC;AACjC,oCAAgC"}

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

@@ -0,0 +1,5 @@
+export * from "./id.mjs";
+export type * from "./types.mjs";
+export type * from "./providers.mjs";
+export type * from "./adapters.mjs";
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/api/multichain/index.ts"],"names":[],"mappings":"AAAA,yBAAqB;AACrB,iCAA6B;AAC7B,qCAAiC;AACjC,oCAAgC"}

package/dist/api/multichain/index.mjs

@@ -0,0 +1,2 @@
+export * from "./id.mjs";
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/api/multichain/index.ts"],"names":[],"mappings":"AAAA,yBAAqB","sourcesContent":["export * from './id';\nexport type * from './types';\nexport type * from './providers';\nexport type * from './adapters';\n"]}

package/dist/api/multichain/providers.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=providers.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"providers.cjs","sourceRoot":"","sources":["../../../src/api/multichain/providers.ts"],"names":[],"mappings":"","sourcesContent":["import type { EntropySourceId, KeyringAccount } from '@metamask/keyring-api';\nimport type { AccountId } from '@metamask/keyring-utils';\n\nexport type AccountProvider<Account extends KeyringAccount> = {\n  getAccount: (id: AccountId) => Account; // Assuming getting an account from the provider can never fail.\n\n  getAccounts: (opts: {\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }) => AccountId[];\n\n  createAccounts: (opts: {\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }) => Promise<AccountId[]>;\n\n  discoverAndCreateAccounts: (opts: {\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }) => Promise<AccountId[]>;\n};\n"]}

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

@@ -0,0 +1,18 @@
+import type { EntropySourceId, KeyringAccount } from "@metamask/keyring-api";
+import type { AccountId } from "@metamask/keyring-utils";
+export type AccountProvider<Account extends KeyringAccount> = {
+    getAccount: (id: AccountId) => Account;
+    getAccounts: (opts: {
+        entropySource: EntropySourceId;
+        groupIndex: number;
+    }) => AccountId[];
+    createAccounts: (opts: {
+        entropySource: EntropySourceId;
+        groupIndex: number;
+    }) => Promise<AccountId[]>;
+    discoverAndCreateAccounts: (opts: {
+        entropySource: EntropySourceId;
+        groupIndex: number;
+    }) => Promise<AccountId[]>;
+};
+//# sourceMappingURL=providers.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.cts","sourceRoot":"","sources":["../../../src/api/multichain/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,8BAA8B;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,gCAAgC;AAEzD,MAAM,MAAM,eAAe,CAAC,OAAO,SAAS,cAAc,IAAI;IAC5D,UAAU,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC;IAEvC,WAAW,EAAE,CAAC,IAAI,EAAE;QAClB,aAAa,EAAE,eAAe,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,KAAK,SAAS,EAAE,CAAC;IAElB,cAAc,EAAE,CAAC,IAAI,EAAE;QACrB,aAAa,EAAE,eAAe,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAE3B,yBAAyB,EAAE,CAAC,IAAI,EAAE;QAChC,aAAa,EAAE,eAAe,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CAC5B,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { EntropySourceId, KeyringAccount } from "@metamask/keyring-api";
+import type { AccountId } from "@metamask/keyring-utils";
+export type AccountProvider<Account extends KeyringAccount> = {
+    getAccount: (id: AccountId) => Account;
+    getAccounts: (opts: {
+        entropySource: EntropySourceId;
+        groupIndex: number;
+    }) => AccountId[];
+    createAccounts: (opts: {
+        entropySource: EntropySourceId;
+        groupIndex: number;
+    }) => Promise<AccountId[]>;
+    discoverAndCreateAccounts: (opts: {
+        entropySource: EntropySourceId;
+        groupIndex: number;
+    }) => Promise<AccountId[]>;
+};
+//# sourceMappingURL=providers.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.mts","sourceRoot":"","sources":["../../../src/api/multichain/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,8BAA8B;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,gCAAgC;AAEzD,MAAM,MAAM,eAAe,CAAC,OAAO,SAAS,cAAc,IAAI;IAC5D,UAAU,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC;IAEvC,WAAW,EAAE,CAAC,IAAI,EAAE;QAClB,aAAa,EAAE,eAAe,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,KAAK,SAAS,EAAE,CAAC;IAElB,cAAc,EAAE,CAAC,IAAI,EAAE;QACrB,aAAa,EAAE,eAAe,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAE3B,yBAAyB,EAAE,CAAC,IAAI,EAAE;QAChC,aAAa,EAAE,eAAe,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CAC5B,CAAC"}

package/dist/api/multichain/providers.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=providers.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"providers.mjs","sourceRoot":"","sources":["../../../src/api/multichain/providers.ts"],"names":[],"mappings":"","sourcesContent":["import type { EntropySourceId, KeyringAccount } from '@metamask/keyring-api';\nimport type { AccountId } from '@metamask/keyring-utils';\n\nexport type AccountProvider<Account extends KeyringAccount> = {\n  getAccount: (id: AccountId) => Account; // Assuming getting an account from the provider can never fail.\n\n  getAccounts: (opts: {\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }) => AccountId[];\n\n  createAccounts: (opts: {\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }) => Promise<AccountId[]>;\n\n  discoverAndCreateAccounts: (opts: {\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }) => Promise<AccountId[]>;\n};\n"]}

package/dist/api/multichain/types.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../../../src/api/multichain/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { EntropySourceId, KeyringAccount } from '@metamask/keyring-api';\nimport type { AccountId } from '@metamask/keyring-utils';\nimport type { CaipChainId } from '@metamask/utils';\n\nimport type { MultichainAccountId, MultichainAccountWalletId } from './id';\nimport type { AccountGroup } from '../group';\nimport type { AccountWallet } from '../wallet';\n\nexport type AccountType = string;\n\nexport type AccountMethod = string;\n\nexport type MultichainAccountSelector = {\n  id?: AccountId;\n  address?: string;\n  type?: AccountType;\n  methods?: AccountMethod[];\n  scopes?: CaipChainId[];\n};\n\nexport type MultichainAccount<Account extends KeyringAccount> =\n  AccountGroup<Account> & {\n    get id(): MultichainAccountId;\n\n    get wallet(): MultichainAccountWallet<Account>;\n\n    get index(): number;\n\n    /**\n     * Gets the \"blockchain\" accounts for this multichain account.\n     *\n     * @param id - Account ID.\n     * @returns The \"blockchain\" accounts.\n     */\n    getAccounts(): Account[];\n\n    /**\n     * Gets the \"blockchain\" account for a given account ID.\n     *\n     * @param id - Account ID.\n     * @returns The \"blockchain\" account or undefined if not found.\n     */\n    getAccount(id: AccountId): Account | undefined;\n\n    /**\n     * Query a \"blockchain\" account matching the selector.\n     *\n     * @param selector - Query selector.\n     * @returns The \"blockchain\" account matching the selector or undefined if not matching.\n     * @throws If multiple accounts match the selector.\n     */\n    get(selector: MultichainAccountSelector): Account | undefined;\n\n    /**\n     * Query \"blockchain\" accounts matching the selector.\n     *\n     * @param selector - Query selector.\n     * @returns The \"blockchain\" accounts matching the selector.\n     */\n    select(selector: MultichainAccountSelector): Account[];\n  };\n\nexport type MultichainAccountWallet<Account extends KeyringAccount> =\n  AccountWallet<Account> & {\n    get id(): MultichainAccountWalletId;\n\n    get entropySource(): EntropySourceId;\n\n    /**\n     * Gets multichain account for a given index.\n     *\n     * @returns Multichain accounts.\n     */\n    getMultichainAccount(\n      groupIndex: number,\n    ): MultichainAccount<Account> | undefined;\n\n    /**\n     * Gets multichain accounts.\n     *\n     * @returns Multichain accounts.\n     */\n    getMultichainAccounts(): MultichainAccount<Account>[];\n\n    /**\n     * Gets the next available account index (named group index internally).\n     *\n     * @returns Next available group index.\n     */\n    getNextGroupIndex(): number;\n\n    /**\n     * Creates a new multichain account on a given group index.\n     *\n     * NOTE: This method is idempotent.\n     *\n     * @param groupIndex - Next available group index.\n     * @returns New (or existing) multichain account for the given group index.\n     */\n    createMultichainAccount(\n      groupIndex: number,\n    ): Promise<MultichainAccount<Account>>;\n\n    /**\n     * Creates a new multichain account for the next available group index.\n     *\n     * @returns Next multichain account.\n     */\n    createNextMultichainAccount(): Promise<MultichainAccount<Account>>;\n\n    /**\n     * Discovers and automatically create multichain accounts for that wallet.\n     *\n     * @returns List of all multichain accounts that got discovered or automatically created.\n     */\n    discoverAndCreateMultichainAccounts(): Promise<\n      MultichainAccount<Account>[]\n    >;\n  };\n"]}