@metamask-previews/multichain-account-service 0.3.0-preview-0910ff0 → 0.3.0-preview-98faf75a

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add multichain account group creation support ([#6222](https://github.com/MetaMask/core/pull/6222))
+  - This also includes the new action `MultichainAccountService:createNextMultichainAccount`.
+- Export `MultichainAccountWallet` and `MultichainAccountGroup` types ([#6220](https://github.com/MetaMask/core/pull/6220))
+
+### Changed
+
+- **BREAKING:** Use `KeyringAccount` instead of `InternalAccount` ([#6227](https://github.com/MetaMask/core/pull/6227))
+- **BREAKING:** Bump peer dependency `@metamask/account-api` from `^0.3.0` to `^0.7.0` ([#6214](https://github.com/MetaMask/core/pull/6214)), ([#6216](https://github.com/MetaMask/core/pull/6216)), ([#6222](https://github.com/MetaMask/core/pull/6222))
+- **BREAKING:** Rename `MultichainAccount` to `MultichainAccountGroup` ([#6216](https://github.com/MetaMask/core/pull/6216)), ([#6219](https://github.com/MetaMask/core/pull/6219))
+  - The naming was confusing and since a `MultichainAccount` is also an `AccountGroup` it makes sense to have the suffix there too.
+- **BREAKING:** Rename `getMultichainAccount*` to `getMultichainAccountGroup*` ([#6216](https://github.com/MetaMask/core/pull/6216)), ([#6219](https://github.com/MetaMask/core/pull/6219))
+  - The naming was confusing and since a `MultichainAccount` is also an `AccountGroup` it makes sense to have the suffix there too.
+
 ## [0.3.0]
 
 ### Added

package/dist/MultichainAccountGroup.cjs

@@ -0,0 +1,192 @@
+"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 _MultichainAccountGroup_id, _MultichainAccountGroup_wallet, _MultichainAccountGroup_index, _MultichainAccountGroup_providers, _MultichainAccountGroup_providerToAccounts, _MultichainAccountGroup_accountToProvider;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultichainAccountGroup = void 0;
+const account_api_1 = require("@metamask/account-api");
+const account_api_2 = require("@metamask/account-api");
+const keyring_utils_1 = require("@metamask/keyring-utils");
+/**
+ * A multichain account group that holds multiple accounts.
+ */
+class MultichainAccountGroup {
+    constructor({ groupIndex, wallet, providers, }) {
+        _MultichainAccountGroup_id.set(this, void 0);
+        _MultichainAccountGroup_wallet.set(this, void 0);
+        _MultichainAccountGroup_index.set(this, void 0);
+        _MultichainAccountGroup_providers.set(this, void 0);
+        _MultichainAccountGroup_providerToAccounts.set(this, void 0);
+        _MultichainAccountGroup_accountToProvider.set(this, void 0);
+        __classPrivateFieldSet(this, _MultichainAccountGroup_id, (0, account_api_2.toMultichainAccountGroupId)(wallet.id, groupIndex), "f");
+        __classPrivateFieldSet(this, _MultichainAccountGroup_index, groupIndex, "f");
+        __classPrivateFieldSet(this, _MultichainAccountGroup_wallet, wallet, "f");
+        __classPrivateFieldSet(this, _MultichainAccountGroup_providers, providers, "f");
+        __classPrivateFieldSet(this, _MultichainAccountGroup_providerToAccounts, new Map(), "f");
+        __classPrivateFieldSet(this, _MultichainAccountGroup_accountToProvider, new Map(), "f");
+        this.sync();
+    }
+    /**
+     * Force multichain account synchronization.
+     *
+     * This can be used if account providers got new accounts that the multichain
+     * account doesn't know about.
+     */
+    sync() {
+        // Clear reverse mapping and re-construct it entirely based on the refreshed
+        // list of accounts from each providers.
+        __classPrivateFieldGet(this, _MultichainAccountGroup_accountToProvider, "f").clear();
+        for (const provider of __classPrivateFieldGet(this, _MultichainAccountGroup_providers, "f")) {
+            // Filter account only for that index.
+            const accounts = [];
+            for (const account of provider.getAccounts()) {
+                if (account.options.entropy.id === this.wallet.entropySource &&
+                    account.options.entropy.groupIndex === this.index) {
+                    // We only use IDs to always fetch the latest version of accounts.
+                    accounts.push(account.id);
+                }
+            }
+            __classPrivateFieldGet(this, _MultichainAccountGroup_providerToAccounts, "f").set(provider, accounts);
+            // Reverse-mapping for fast indexing.
+            for (const id of accounts) {
+                __classPrivateFieldGet(this, _MultichainAccountGroup_accountToProvider, "f").set(id, provider);
+            }
+        }
+    }
+    /**
+     * Gets the multichain account group ID.
+     *
+     * @returns The multichain account group ID.
+     */
+    get id() {
+        return __classPrivateFieldGet(this, _MultichainAccountGroup_id, "f");
+    }
+    /**
+     * Gets the multichain account group type.
+     *
+     * @returns The multichain account type.
+     */
+    get type() {
+        return account_api_1.AccountGroupType.MultichainAccount;
+    }
+    /**
+     * Gets the multichain account's wallet reference (parent).
+     *
+     * @returns The multichain account's wallet.
+     */
+    get wallet() {
+        return __classPrivateFieldGet(this, _MultichainAccountGroup_wallet, "f");
+    }
+    /**
+     * Gets the multichain account group index.
+     *
+     * @returns The multichain account group index.
+     */
+    get index() {
+        return __classPrivateFieldGet(this, _MultichainAccountGroup_index, "f");
+    }
+    /**
+     * Checks if there's any underlying accounts for this multichain accounts.
+     *
+     * @returns True if there's any underlying accounts, false otherwise.
+     */
+    hasAccounts() {
+        // If there's anything in the reverse-map, it means we have some accounts.
+        return __classPrivateFieldGet(this, _MultichainAccountGroup_accountToProvider, "f").size > 0;
+    }
+    /**
+     * Gets the accounts for this multichain account.
+     *
+     * @returns The accounts.
+     */
+    getAccounts() {
+        const allAccounts = [];
+        for (const [provider, accounts] of __classPrivateFieldGet(this, _MultichainAccountGroup_providerToAccounts, "f").entries()) {
+            for (const id of accounts) {
+                const account = provider.getAccount(id);
+                if (account) {
+                    // If for some reason we cannot get this account from the provider, it
+                    // might means it has been deleted or something, so we just filter it
+                    // out.
+                    allAccounts.push(account);
+                }
+            }
+        }
+        return allAccounts;
+    }
+    /**
+     * Gets the account for a given account ID.
+     *
+     * @param id - Account ID.
+     * @returns The account or undefined if not found.
+     */
+    getAccount(id) {
+        const provider = __classPrivateFieldGet(this, _MultichainAccountGroup_accountToProvider, "f").get(id);
+        // If there's nothing in the map, it means we tried to get an account
+        // that does not belong to this multichain account.
+        if (!provider) {
+            return undefined;
+        }
+        return provider.getAccount(id);
+    }
+    /**
+     * Query an account matching the selector.
+     *
+     * @param selector - Query selector.
+     * @returns The account matching the selector or undefined if not matching.
+     * @throws If multiple accounts match the selector.
+     */
+    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.
+    }
+    /**
+     * Query accounts matching the selector.
+     *
+     * @param selector - Query selector.
+     * @returns The accounts matching the selector.
+     */
+    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.
+                    (0, keyring_utils_1.isScopeEqualToAny)(scope, account.scopes));
+                }));
+            }
+            return selected;
+        });
+    }
+}
+exports.MultichainAccountGroup = MultichainAccountGroup;
+_MultichainAccountGroup_id = new WeakMap(), _MultichainAccountGroup_wallet = new WeakMap(), _MultichainAccountGroup_index = new WeakMap(), _MultichainAccountGroup_providers = new WeakMap(), _MultichainAccountGroup_providerToAccounts = new WeakMap(), _MultichainAccountGroup_accountToProvider = new WeakMap();
+//# sourceMappingURL=MultichainAccountGroup.cjs.map

package/dist/MultichainAccountGroup.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainAccountGroup.cjs","sourceRoot":"","sources":["../src/MultichainAccountGroup.ts"],"names":[],"mappings":"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","sourcesContent":["import { AccountGroupType } from '@metamask/account-api';\nimport {\n  toMultichainAccountGroupId,\n  type MultichainAccountGroupId,\n  type MultichainAccountGroup as MultichainAccountGroupDefinition,\n} from '@metamask/account-api';\nimport type { Bip44Account } from '@metamask/account-api';\nimport type { AccountSelector } from '@metamask/account-api';\nimport type { AccountProvider } from '@metamask/account-api';\nimport { type KeyringAccount } from '@metamask/keyring-api';\nimport { isScopeEqualToAny } from '@metamask/keyring-utils';\n\nimport type { MultichainAccountWallet } from './MultichainAccountWallet';\n\n/**\n * A multichain account group that holds multiple accounts.\n */\nexport class MultichainAccountGroup<\n  Account extends Bip44Account<KeyringAccount>,\n> implements MultichainAccountGroupDefinition<Account>\n{\n  readonly #id: MultichainAccountGroupId;\n\n  readonly #wallet: MultichainAccountWallet<Account>;\n\n  readonly #index: number;\n\n  readonly #providers: AccountProvider<Account>[];\n\n  readonly #providerToAccounts: Map<AccountProvider<Account>, Account['id'][]>;\n\n  readonly #accountToProvider: Map<Account['id'], AccountProvider<Account>>;\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 = toMultichainAccountGroupId(wallet.id, groupIndex);\n    this.#index = groupIndex;\n    this.#wallet = wallet;\n    this.#providers = providers;\n    this.#providerToAccounts = new Map();\n    this.#accountToProvider = new Map();\n\n    this.sync();\n  }\n\n  /**\n   * Force multichain account synchronization.\n   *\n   * This can be used if account providers got new accounts that the multichain\n   * account doesn't know about.\n   */\n  sync(): void {\n    // Clear reverse mapping and re-construct it entirely based on the refreshed\n    // list of accounts from each providers.\n    this.#accountToProvider.clear();\n\n    for (const provider of this.#providers) {\n      // Filter account only for that index.\n      const accounts = [];\n      for (const account of provider.getAccounts()) {\n        if (\n          account.options.entropy.id === this.wallet.entropySource &&\n          account.options.entropy.groupIndex === this.index\n        ) {\n          // We only use IDs to always fetch the latest version of accounts.\n          accounts.push(account.id);\n        }\n      }\n      this.#providerToAccounts.set(provider, accounts);\n\n      // Reverse-mapping for fast indexing.\n      for (const id of accounts) {\n        this.#accountToProvider.set(id, provider);\n      }\n    }\n  }\n\n  /**\n   * Gets the multichain account group ID.\n   *\n   * @returns The multichain account group ID.\n   */\n  get id(): MultichainAccountGroupId {\n    return this.#id;\n  }\n\n  /**\n   * Gets the multichain account group type.\n   *\n   * @returns The multichain account type.\n   */\n  get type(): AccountGroupType.MultichainAccount {\n    return AccountGroupType.MultichainAccount;\n  }\n\n  /**\n   * Gets the multichain account's wallet reference (parent).\n   *\n   * @returns The multichain account's wallet.\n   */\n  get wallet(): MultichainAccountWallet<Account> {\n    return this.#wallet;\n  }\n\n  /**\n   * Gets the multichain account group index.\n   *\n   * @returns The multichain account group index.\n   */\n  get index(): number {\n    return this.#index;\n  }\n\n  /**\n   * Checks if there's any underlying accounts for this multichain accounts.\n   *\n   * @returns True if there's any underlying accounts, false otherwise.\n   */\n  hasAccounts(): boolean {\n    // If there's anything in the reverse-map, it means we have some accounts.\n    return this.#accountToProvider.size > 0;\n  }\n\n  /**\n   * Gets the accounts for this multichain account.\n   *\n   * @returns The accounts.\n   */\n  getAccounts(): Account[] {\n    const allAccounts: Account[] = [];\n\n    for (const [provider, accounts] of this.#providerToAccounts.entries()) {\n      for (const id of accounts) {\n        const account = provider.getAccount(id);\n\n        if (account) {\n          // If for some reason we cannot get this account from the provider, it\n          // might means it has been deleted or something, so we just filter it\n          // out.\n          allAccounts.push(account);\n        }\n      }\n    }\n\n    return allAccounts;\n  }\n\n  /**\n   * Gets the account for a given account ID.\n   *\n   * @param id - Account ID.\n   * @returns The account or undefined if not found.\n   */\n  getAccount(id: Account['id']): Account | undefined {\n    const provider = this.#accountToProvider.get(id);\n\n    // If there's nothing in the map, it means we tried to get an account\n    // that does not belong to this multichain account.\n    if (!provider) {\n      return undefined;\n    }\n    return provider.getAccount(id);\n  }\n\n  /**\n   * Query an account matching the selector.\n   *\n   * @param selector - Query selector.\n   * @returns The account matching the selector or undefined if not matching.\n   * @throws If multiple accounts match the selector.\n   */\n  get(selector: AccountSelector<Account>): 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  /**\n   * Query accounts matching the selector.\n   *\n   * @param selector - Query selector.\n   * @returns The accounts matching the selector.\n   */\n  select(selector: AccountSelector<Account>): 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"]}

package/dist/MultichainAccountGroup.d.cts

@@ -0,0 +1,84 @@
+import { AccountGroupType } from "@metamask/account-api";
+import { type MultichainAccountGroupId, type MultichainAccountGroup as MultichainAccountGroupDefinition } from "@metamask/account-api";
+import type { Bip44Account } from "@metamask/account-api";
+import type { AccountSelector } from "@metamask/account-api";
+import type { AccountProvider } from "@metamask/account-api";
+import { type KeyringAccount } from "@metamask/keyring-api";
+import type { MultichainAccountWallet } from "./MultichainAccountWallet.cjs";
+/**
+ * A multichain account group that holds multiple accounts.
+ */
+export declare class MultichainAccountGroup<Account extends Bip44Account<KeyringAccount>> implements MultichainAccountGroupDefinition<Account> {
+    #private;
+    constructor({ groupIndex, wallet, providers, }: {
+        groupIndex: number;
+        wallet: MultichainAccountWallet<Account>;
+        providers: AccountProvider<Account>[];
+    });
+    /**
+     * Force multichain account synchronization.
+     *
+     * This can be used if account providers got new accounts that the multichain
+     * account doesn't know about.
+     */
+    sync(): void;
+    /**
+     * Gets the multichain account group ID.
+     *
+     * @returns The multichain account group ID.
+     */
+    get id(): MultichainAccountGroupId;
+    /**
+     * Gets the multichain account group type.
+     *
+     * @returns The multichain account type.
+     */
+    get type(): AccountGroupType.MultichainAccount;
+    /**
+     * Gets the multichain account's wallet reference (parent).
+     *
+     * @returns The multichain account's wallet.
+     */
+    get wallet(): MultichainAccountWallet<Account>;
+    /**
+     * Gets the multichain account group index.
+     *
+     * @returns The multichain account group index.
+     */
+    get index(): number;
+    /**
+     * Checks if there's any underlying accounts for this multichain accounts.
+     *
+     * @returns True if there's any underlying accounts, false otherwise.
+     */
+    hasAccounts(): boolean;
+    /**
+     * Gets the accounts for this multichain account.
+     *
+     * @returns The accounts.
+     */
+    getAccounts(): Account[];
+    /**
+     * Gets the account for a given account ID.
+     *
+     * @param id - Account ID.
+     * @returns The account or undefined if not found.
+     */
+    getAccount(id: Account['id']): Account | undefined;
+    /**
+     * Query an account matching the selector.
+     *
+     * @param selector - Query selector.
+     * @returns The account matching the selector or undefined if not matching.
+     * @throws If multiple accounts match the selector.
+     */
+    get(selector: AccountSelector<Account>): Account | undefined;
+    /**
+     * Query accounts matching the selector.
+     *
+     * @param selector - Query selector.
+     * @returns The accounts matching the selector.
+     */
+    select(selector: AccountSelector<Account>): Account[];
+}
+//# sourceMappingURL=MultichainAccountGroup.d.cts.map

package/dist/MultichainAccountGroup.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainAccountGroup.d.cts","sourceRoot":"","sources":["../src/MultichainAccountGroup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,8BAA8B;AACzD,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,IAAI,gCAAgC,EAChE,8BAA8B;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,8BAA8B;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,8BAA8B;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,8BAA8B;AAC7D,OAAO,EAAE,KAAK,cAAc,EAAE,8BAA8B;AAG5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,sCAAkC;AAEzE;;GAEG;AACH,qBAAa,sBAAsB,CACjC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,CAC5C,YAAW,gCAAgC,CAAC,OAAO,CAAC;;gBAcxC,EACV,UAAU,EACV,MAAM,EACN,SAAS,GACV,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC;QACzC,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;KACvC;IAWD;;;;;OAKG;IACH,IAAI,IAAI,IAAI;IA0BZ;;;;OAIG;IACH,IAAI,EAAE,IAAI,wBAAwB,CAEjC;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,gBAAgB,CAAC,iBAAiB,CAE7C;IAED;;;;OAIG;IACH,IAAI,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAE7C;IAED;;;;OAIG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAKtB;;;;OAIG;IACH,WAAW,IAAI,OAAO,EAAE;IAmBxB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,SAAS;IAWlD;;;;;;OAMG;IACH,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS;IAgB5D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;CA8BtD"}

package/dist/MultichainAccountGroup.d.mts

@@ -0,0 +1,84 @@
+import { AccountGroupType } from "@metamask/account-api";
+import { type MultichainAccountGroupId, type MultichainAccountGroup as MultichainAccountGroupDefinition } from "@metamask/account-api";
+import type { Bip44Account } from "@metamask/account-api";
+import type { AccountSelector } from "@metamask/account-api";
+import type { AccountProvider } from "@metamask/account-api";
+import { type KeyringAccount } from "@metamask/keyring-api";
+import type { MultichainAccountWallet } from "./MultichainAccountWallet.mjs";
+/**
+ * A multichain account group that holds multiple accounts.
+ */
+export declare class MultichainAccountGroup<Account extends Bip44Account<KeyringAccount>> implements MultichainAccountGroupDefinition<Account> {
+    #private;
+    constructor({ groupIndex, wallet, providers, }: {
+        groupIndex: number;
+        wallet: MultichainAccountWallet<Account>;
+        providers: AccountProvider<Account>[];
+    });
+    /**
+     * Force multichain account synchronization.
+     *
+     * This can be used if account providers got new accounts that the multichain
+     * account doesn't know about.
+     */
+    sync(): void;
+    /**
+     * Gets the multichain account group ID.
+     *
+     * @returns The multichain account group ID.
+     */
+    get id(): MultichainAccountGroupId;
+    /**
+     * Gets the multichain account group type.
+     *
+     * @returns The multichain account type.
+     */
+    get type(): AccountGroupType.MultichainAccount;
+    /**
+     * Gets the multichain account's wallet reference (parent).
+     *
+     * @returns The multichain account's wallet.
+     */
+    get wallet(): MultichainAccountWallet<Account>;
+    /**
+     * Gets the multichain account group index.
+     *
+     * @returns The multichain account group index.
+     */
+    get index(): number;
+    /**
+     * Checks if there's any underlying accounts for this multichain accounts.
+     *
+     * @returns True if there's any underlying accounts, false otherwise.
+     */
+    hasAccounts(): boolean;
+    /**
+     * Gets the accounts for this multichain account.
+     *
+     * @returns The accounts.
+     */
+    getAccounts(): Account[];
+    /**
+     * Gets the account for a given account ID.
+     *
+     * @param id - Account ID.
+     * @returns The account or undefined if not found.
+     */
+    getAccount(id: Account['id']): Account | undefined;
+    /**
+     * Query an account matching the selector.
+     *
+     * @param selector - Query selector.
+     * @returns The account matching the selector or undefined if not matching.
+     * @throws If multiple accounts match the selector.
+     */
+    get(selector: AccountSelector<Account>): Account | undefined;
+    /**
+     * Query accounts matching the selector.
+     *
+     * @param selector - Query selector.
+     * @returns The accounts matching the selector.
+     */
+    select(selector: AccountSelector<Account>): Account[];
+}
+//# sourceMappingURL=MultichainAccountGroup.d.mts.map

package/dist/MultichainAccountGroup.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainAccountGroup.d.mts","sourceRoot":"","sources":["../src/MultichainAccountGroup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,8BAA8B;AACzD,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,IAAI,gCAAgC,EAChE,8BAA8B;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,8BAA8B;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,8BAA8B;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,8BAA8B;AAC7D,OAAO,EAAE,KAAK,cAAc,EAAE,8BAA8B;AAG5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,sCAAkC;AAEzE;;GAEG;AACH,qBAAa,sBAAsB,CACjC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,CAC5C,YAAW,gCAAgC,CAAC,OAAO,CAAC;;gBAcxC,EACV,UAAU,EACV,MAAM,EACN,SAAS,GACV,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC;QACzC,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;KACvC;IAWD;;;;;OAKG;IACH,IAAI,IAAI,IAAI;IA0BZ;;;;OAIG;IACH,IAAI,EAAE,IAAI,wBAAwB,CAEjC;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,gBAAgB,CAAC,iBAAiB,CAE7C;IAED;;;;OAIG;IACH,IAAI,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAE7C;IAED;;;;OAIG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAKtB;;;;OAIG;IACH,WAAW,IAAI,OAAO,EAAE;IAmBxB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,SAAS;IAWlD;;;;;;OAMG;IACH,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS;IAgB5D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;CA8BtD"}

package/dist/MultichainAccountGroup.mjs

@@ -0,0 +1,188 @@
+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 _MultichainAccountGroup_id, _MultichainAccountGroup_wallet, _MultichainAccountGroup_index, _MultichainAccountGroup_providers, _MultichainAccountGroup_providerToAccounts, _MultichainAccountGroup_accountToProvider;
+import { AccountGroupType } from "@metamask/account-api";
+import { toMultichainAccountGroupId } from "@metamask/account-api";
+import { isScopeEqualToAny } from "@metamask/keyring-utils";
+/**
+ * A multichain account group that holds multiple accounts.
+ */
+export class MultichainAccountGroup {
+    constructor({ groupIndex, wallet, providers, }) {
+        _MultichainAccountGroup_id.set(this, void 0);
+        _MultichainAccountGroup_wallet.set(this, void 0);
+        _MultichainAccountGroup_index.set(this, void 0);
+        _MultichainAccountGroup_providers.set(this, void 0);
+        _MultichainAccountGroup_providerToAccounts.set(this, void 0);
+        _MultichainAccountGroup_accountToProvider.set(this, void 0);
+        __classPrivateFieldSet(this, _MultichainAccountGroup_id, toMultichainAccountGroupId(wallet.id, groupIndex), "f");
+        __classPrivateFieldSet(this, _MultichainAccountGroup_index, groupIndex, "f");
+        __classPrivateFieldSet(this, _MultichainAccountGroup_wallet, wallet, "f");
+        __classPrivateFieldSet(this, _MultichainAccountGroup_providers, providers, "f");
+        __classPrivateFieldSet(this, _MultichainAccountGroup_providerToAccounts, new Map(), "f");
+        __classPrivateFieldSet(this, _MultichainAccountGroup_accountToProvider, new Map(), "f");
+        this.sync();
+    }
+    /**
+     * Force multichain account synchronization.
+     *
+     * This can be used if account providers got new accounts that the multichain
+     * account doesn't know about.
+     */
+    sync() {
+        // Clear reverse mapping and re-construct it entirely based on the refreshed
+        // list of accounts from each providers.
+        __classPrivateFieldGet(this, _MultichainAccountGroup_accountToProvider, "f").clear();
+        for (const provider of __classPrivateFieldGet(this, _MultichainAccountGroup_providers, "f")) {
+            // Filter account only for that index.
+            const accounts = [];
+            for (const account of provider.getAccounts()) {
+                if (account.options.entropy.id === this.wallet.entropySource &&
+                    account.options.entropy.groupIndex === this.index) {
+                    // We only use IDs to always fetch the latest version of accounts.
+                    accounts.push(account.id);
+                }
+            }
+            __classPrivateFieldGet(this, _MultichainAccountGroup_providerToAccounts, "f").set(provider, accounts);
+            // Reverse-mapping for fast indexing.
+            for (const id of accounts) {
+                __classPrivateFieldGet(this, _MultichainAccountGroup_accountToProvider, "f").set(id, provider);
+            }
+        }
+    }
+    /**
+     * Gets the multichain account group ID.
+     *
+     * @returns The multichain account group ID.
+     */
+    get id() {
+        return __classPrivateFieldGet(this, _MultichainAccountGroup_id, "f");
+    }
+    /**
+     * Gets the multichain account group type.
+     *
+     * @returns The multichain account type.
+     */
+    get type() {
+        return AccountGroupType.MultichainAccount;
+    }
+    /**
+     * Gets the multichain account's wallet reference (parent).
+     *
+     * @returns The multichain account's wallet.
+     */
+    get wallet() {
+        return __classPrivateFieldGet(this, _MultichainAccountGroup_wallet, "f");
+    }
+    /**
+     * Gets the multichain account group index.
+     *
+     * @returns The multichain account group index.
+     */
+    get index() {
+        return __classPrivateFieldGet(this, _MultichainAccountGroup_index, "f");
+    }
+    /**
+     * Checks if there's any underlying accounts for this multichain accounts.
+     *
+     * @returns True if there's any underlying accounts, false otherwise.
+     */
+    hasAccounts() {
+        // If there's anything in the reverse-map, it means we have some accounts.
+        return __classPrivateFieldGet(this, _MultichainAccountGroup_accountToProvider, "f").size > 0;
+    }
+    /**
+     * Gets the accounts for this multichain account.
+     *
+     * @returns The accounts.
+     */
+    getAccounts() {
+        const allAccounts = [];
+        for (const [provider, accounts] of __classPrivateFieldGet(this, _MultichainAccountGroup_providerToAccounts, "f").entries()) {
+            for (const id of accounts) {
+                const account = provider.getAccount(id);
+                if (account) {
+                    // If for some reason we cannot get this account from the provider, it
+                    // might means it has been deleted or something, so we just filter it
+                    // out.
+                    allAccounts.push(account);
+                }
+            }
+        }
+        return allAccounts;
+    }
+    /**
+     * Gets the account for a given account ID.
+     *
+     * @param id - Account ID.
+     * @returns The account or undefined if not found.
+     */
+    getAccount(id) {
+        const provider = __classPrivateFieldGet(this, _MultichainAccountGroup_accountToProvider, "f").get(id);
+        // If there's nothing in the map, it means we tried to get an account
+        // that does not belong to this multichain account.
+        if (!provider) {
+            return undefined;
+        }
+        return provider.getAccount(id);
+    }
+    /**
+     * Query an account matching the selector.
+     *
+     * @param selector - Query selector.
+     * @returns The account matching the selector or undefined if not matching.
+     * @throws If multiple accounts match the selector.
+     */
+    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.
+    }
+    /**
+     * Query accounts matching the selector.
+     *
+     * @param selector - Query selector.
+     * @returns The accounts matching the selector.
+     */
+    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;
+        });
+    }
+}
+_MultichainAccountGroup_id = new WeakMap(), _MultichainAccountGroup_wallet = new WeakMap(), _MultichainAccountGroup_index = new WeakMap(), _MultichainAccountGroup_providers = new WeakMap(), _MultichainAccountGroup_providerToAccounts = new WeakMap(), _MultichainAccountGroup_accountToProvider = new WeakMap();
+//# sourceMappingURL=MultichainAccountGroup.mjs.map

package/dist/MultichainAccountGroup.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainAccountGroup.mjs","sourceRoot":"","sources":["../src/MultichainAccountGroup.ts"],"names":[],"mappings":"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","sourcesContent":["import { AccountGroupType } from '@metamask/account-api';\nimport {\n  toMultichainAccountGroupId,\n  type MultichainAccountGroupId,\n  type MultichainAccountGroup as MultichainAccountGroupDefinition,\n} from '@metamask/account-api';\nimport type { Bip44Account } from '@metamask/account-api';\nimport type { AccountSelector } from '@metamask/account-api';\nimport type { AccountProvider } from '@metamask/account-api';\nimport { type KeyringAccount } from '@metamask/keyring-api';\nimport { isScopeEqualToAny } from '@metamask/keyring-utils';\n\nimport type { MultichainAccountWallet } from './MultichainAccountWallet';\n\n/**\n * A multichain account group that holds multiple accounts.\n */\nexport class MultichainAccountGroup<\n  Account extends Bip44Account<KeyringAccount>,\n> implements MultichainAccountGroupDefinition<Account>\n{\n  readonly #id: MultichainAccountGroupId;\n\n  readonly #wallet: MultichainAccountWallet<Account>;\n\n  readonly #index: number;\n\n  readonly #providers: AccountProvider<Account>[];\n\n  readonly #providerToAccounts: Map<AccountProvider<Account>, Account['id'][]>;\n\n  readonly #accountToProvider: Map<Account['id'], AccountProvider<Account>>;\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 = toMultichainAccountGroupId(wallet.id, groupIndex);\n    this.#index = groupIndex;\n    this.#wallet = wallet;\n    this.#providers = providers;\n    this.#providerToAccounts = new Map();\n    this.#accountToProvider = new Map();\n\n    this.sync();\n  }\n\n  /**\n   * Force multichain account synchronization.\n   *\n   * This can be used if account providers got new accounts that the multichain\n   * account doesn't know about.\n   */\n  sync(): void {\n    // Clear reverse mapping and re-construct it entirely based on the refreshed\n    // list of accounts from each providers.\n    this.#accountToProvider.clear();\n\n    for (const provider of this.#providers) {\n      // Filter account only for that index.\n      const accounts = [];\n      for (const account of provider.getAccounts()) {\n        if (\n          account.options.entropy.id === this.wallet.entropySource &&\n          account.options.entropy.groupIndex === this.index\n        ) {\n          // We only use IDs to always fetch the latest version of accounts.\n          accounts.push(account.id);\n        }\n      }\n      this.#providerToAccounts.set(provider, accounts);\n\n      // Reverse-mapping for fast indexing.\n      for (const id of accounts) {\n        this.#accountToProvider.set(id, provider);\n      }\n    }\n  }\n\n  /**\n   * Gets the multichain account group ID.\n   *\n   * @returns The multichain account group ID.\n   */\n  get id(): MultichainAccountGroupId {\n    return this.#id;\n  }\n\n  /**\n   * Gets the multichain account group type.\n   *\n   * @returns The multichain account type.\n   */\n  get type(): AccountGroupType.MultichainAccount {\n    return AccountGroupType.MultichainAccount;\n  }\n\n  /**\n   * Gets the multichain account's wallet reference (parent).\n   *\n   * @returns The multichain account's wallet.\n   */\n  get wallet(): MultichainAccountWallet<Account> {\n    return this.#wallet;\n  }\n\n  /**\n   * Gets the multichain account group index.\n   *\n   * @returns The multichain account group index.\n   */\n  get index(): number {\n    return this.#index;\n  }\n\n  /**\n   * Checks if there's any underlying accounts for this multichain accounts.\n   *\n   * @returns True if there's any underlying accounts, false otherwise.\n   */\n  hasAccounts(): boolean {\n    // If there's anything in the reverse-map, it means we have some accounts.\n    return this.#accountToProvider.size > 0;\n  }\n\n  /**\n   * Gets the accounts for this multichain account.\n   *\n   * @returns The accounts.\n   */\n  getAccounts(): Account[] {\n    const allAccounts: Account[] = [];\n\n    for (const [provider, accounts] of this.#providerToAccounts.entries()) {\n      for (const id of accounts) {\n        const account = provider.getAccount(id);\n\n        if (account) {\n          // If for some reason we cannot get this account from the provider, it\n          // might means it has been deleted or something, so we just filter it\n          // out.\n          allAccounts.push(account);\n        }\n      }\n    }\n\n    return allAccounts;\n  }\n\n  /**\n   * Gets the account for a given account ID.\n   *\n   * @param id - Account ID.\n   * @returns The account or undefined if not found.\n   */\n  getAccount(id: Account['id']): Account | undefined {\n    const provider = this.#accountToProvider.get(id);\n\n    // If there's nothing in the map, it means we tried to get an account\n    // that does not belong to this multichain account.\n    if (!provider) {\n      return undefined;\n    }\n    return provider.getAccount(id);\n  }\n\n  /**\n   * Query an account matching the selector.\n   *\n   * @param selector - Query selector.\n   * @returns The account matching the selector or undefined if not matching.\n   * @throws If multiple accounts match the selector.\n   */\n  get(selector: AccountSelector<Account>): 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  /**\n   * Query accounts matching the selector.\n   *\n   * @param selector - Query selector.\n   * @returns The accounts matching the selector.\n   */\n  select(selector: AccountSelector<Account>): 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"]}