@metamask-previews/multichain-account-service 0.0.0-preview-21df933

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- Add `MultichainAccountService` ([#6141](https://github.com/MetaMask/core/pull/6141))
+  - This service manages multichain accounts/wallets.
+
+[Unreleased]: https://github.com/MetaMask/core/

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 MetaMask
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

package/README.md

@@ -0,0 +1,17 @@
+# `@metamask/multichain-account-service`
+
+Multichain account service.
+
+This service provides operations and functionalities around multichain accounts and wallets.
+
+## Installation
+
+`yarn add @metamask/multichain-account-service`
+
+or
+
+`npm install @metamask/multichain-account-service`
+
+## Contributing
+
+This package is part of a monorepo. Instructions for contributing can be found in the [monorepo README](https://github.com/MetaMask/core#readme).

package/dist/MultichainAccountService.cjs

@@ -0,0 +1,120 @@
+"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 _MultichainAccountService_instances, _MultichainAccountService_messenger, _MultichainAccountService_providers, _MultichainAccountService_wallets, _MultichainAccountService_setMultichainAccountWallets, _MultichainAccountService_getWallet;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultichainAccountService = void 0;
+const account_api_1 = require("@metamask/account-api");
+const keyring_controller_1 = require("@metamask/keyring-controller");
+const EvmAccountProvider_1 = require("./providers/EvmAccountProvider.cjs");
+const SolAccountProvider_1 = require("./providers/SolAccountProvider.cjs");
+/**
+ * Select keyrings from keyring controller state.
+ *
+ * @param state - The keyring controller state.
+ * @returns The keyrings.
+ */
+function selectKeyringControllerKeyrings(state) {
+    return state.keyrings;
+}
+/**
+ * Service to expose multichain accounts capabilities.
+ */
+class MultichainAccountService {
+    /**
+     * Constructs a new MultichainAccountService.
+     *
+     * @param options - The options.
+     * @param options.messenger - The messenger suited to this
+     * MultichainAccountService.
+     */
+    constructor({ messenger }) {
+        _MultichainAccountService_instances.add(this);
+        _MultichainAccountService_messenger.set(this, void 0);
+        _MultichainAccountService_providers.set(this, void 0);
+        _MultichainAccountService_wallets.set(this, void 0);
+        __classPrivateFieldSet(this, _MultichainAccountService_messenger, messenger, "f");
+        __classPrivateFieldSet(this, _MultichainAccountService_wallets, new Map(), "f");
+        // TODO: Rely on keyring capabilities once the keyring API is used by all keyrings.
+        __classPrivateFieldSet(this, _MultichainAccountService_providers, [
+            new EvmAccountProvider_1.EvmAccountProvider(__classPrivateFieldGet(this, _MultichainAccountService_messenger, "f")),
+            new SolAccountProvider_1.SolAccountProvider(__classPrivateFieldGet(this, _MultichainAccountService_messenger, "f")),
+        ], "f");
+    }
+    /**
+     * Initialize the service and constructs the internal reprensentation of
+     * multichain accounts and wallets.
+     */
+    init() {
+        // Gather all entropy sources first.
+        const state = __classPrivateFieldGet(this, _MultichainAccountService_messenger, "f").call('KeyringController:getState');
+        __classPrivateFieldGet(this, _MultichainAccountService_instances, "m", _MultichainAccountService_setMultichainAccountWallets).call(this, state.keyrings);
+        __classPrivateFieldGet(this, _MultichainAccountService_messenger, "f").subscribe('KeyringController:stateChange', (keyrings) => {
+            __classPrivateFieldGet(this, _MultichainAccountService_instances, "m", _MultichainAccountService_setMultichainAccountWallets).call(this, keyrings);
+        }, selectKeyringControllerKeyrings);
+    }
+    /**
+     * Gets a reference to the multichain account matching this entropy source and group index.
+     *
+     * @param options - Options.
+     * @param options.entropySource - The entropy source of the multichain account.
+     * @param options.groupIndex - The group index of the multichain account.
+     * @throws If none multichain account match this entropy source and group index.
+     * @returns A reference to the multichain account.
+     */
+    getMultichainAccount({ entropySource, groupIndex, }) {
+        const multichainAccount = __classPrivateFieldGet(this, _MultichainAccountService_instances, "m", _MultichainAccountService_getWallet).call(this, entropySource).getMultichainAccount(groupIndex);
+        if (!multichainAccount) {
+            throw new Error(`No multichain account for index: ${groupIndex}`);
+        }
+        return multichainAccount;
+    }
+    /**
+     * Gets all multichain accounts for a given entropy source.
+     *
+     * @param options - Options.
+     * @param options.entropySource - The entropy source to query.
+     * @throws If no multichain accounts match this entropy source.
+     * @returns A list of all multichain accounts.
+     */
+    getMultichainAccounts({ entropySource, }) {
+        return __classPrivateFieldGet(this, _MultichainAccountService_instances, "m", _MultichainAccountService_getWallet).call(this, entropySource).getMultichainAccounts();
+    }
+}
+exports.MultichainAccountService = MultichainAccountService;
+_MultichainAccountService_messenger = new WeakMap(), _MultichainAccountService_providers = new WeakMap(), _MultichainAccountService_wallets = new WeakMap(), _MultichainAccountService_instances = new WeakSet(), _MultichainAccountService_setMultichainAccountWallets = function _MultichainAccountService_setMultichainAccountWallets(keyrings) {
+    for (const keyring of keyrings) {
+        if (keyring.type === keyring_controller_1.KeyringTypes.hd) {
+            // Only HD keyrings have an entropy source/SRP.
+            const entropySource = keyring.metadata.id;
+            // Do not re-create wallets if they exists. Even if a keyrings got new accounts, this
+            // will be handled by the `*AccountProvider`s which are always in-sync with their
+            // keyrings and controllers (like the `AccountsController`).
+            if (!__classPrivateFieldGet(this, _MultichainAccountService_wallets, "f").has((0, account_api_1.toMultichainAccountWalletId)(entropySource))) {
+                // This will automatically "associate" all multichain accounts for that wallet
+                // (based on the accounts owned by each account providers).
+                const wallet = new account_api_1.MultichainAccountWallet({
+                    entropySource,
+                    providers: __classPrivateFieldGet(this, _MultichainAccountService_providers, "f"),
+                });
+                __classPrivateFieldGet(this, _MultichainAccountService_wallets, "f").set(wallet.id, wallet);
+            }
+        }
+    }
+}, _MultichainAccountService_getWallet = function _MultichainAccountService_getWallet(entropySource) {
+    const wallet = __classPrivateFieldGet(this, _MultichainAccountService_wallets, "f").get((0, account_api_1.toMultichainAccountWalletId)(entropySource));
+    if (!wallet) {
+        throw new Error('Unknown wallet, no wallet matching this entropy source');
+    }
+    return wallet;
+};
+//# sourceMappingURL=MultichainAccountService.cjs.map

package/dist/MultichainAccountService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainAccountService.cjs","sourceRoot":"","sources":["../src/MultichainAccountService.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAIA,uDAI+B;AAM/B,qEAA4D;AAG5D,2EAAoE;AACpE,2EAAoE;AAUpE;;;;;GAKG;AACH,SAAS,+BAA+B,CAAC,KAA6B;IACpE,OAAO,KAAK,CAAC,QAAQ,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAa,wBAAwB;IAUnC;;;;;;OAMG;IACH,YAAY,EAAE,SAAS,EAAmC;;QAhBjD,sDAA8C;QAE9C,sDAA+C;QAE/C,oDAGP;QAUA,uBAAA,IAAI,uCAAc,SAAS,MAAA,CAAC;QAC5B,uBAAA,IAAI,qCAAY,IAAI,GAAG,EAAE,MAAA,CAAC;QAC1B,mFAAmF;QACnF,uBAAA,IAAI,uCAAc;YAChB,IAAI,uCAAkB,CAAC,uBAAA,IAAI,2CAAW,CAAC;YACvC,IAAI,uCAAkB,CAAC,uBAAA,IAAI,2CAAW,CAAC;SACxC,MAAA,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,oCAAoC;QACpC,MAAM,KAAK,GAAG,uBAAA,IAAI,2CAAW,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACjE,uBAAA,IAAI,kGAA6B,MAAjC,IAAI,EAA8B,KAAK,CAAC,QAAQ,CAAC,CAAC;QAElD,uBAAA,IAAI,2CAAW,CAAC,SAAS,CACvB,+BAA+B,EAC/B,CAAC,QAAQ,EAAE,EAAE;YACX,uBAAA,IAAI,kGAA6B,MAAjC,IAAI,EAA8B,QAAQ,CAAC,CAAC;QAC9C,CAAC,EACD,+BAA+B,CAChC,CAAC;IACJ,CAAC;IAuCD;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EACnB,aAAa,EACb,UAAU,GAIX;QACC,MAAM,iBAAiB,GACrB,uBAAA,IAAI,gFAAW,MAAf,IAAI,EAAY,aAAa,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAElE,IAAI,CAAC,iBAAiB,EAAE;YACtB,MAAM,IAAI,KAAK,CAAC,oCAAoC,UAAU,EAAE,CAAC,CAAC;SACnE;QAED,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED;;;;;;;OAOG;IACH,qBAAqB,CAAC,EACpB,aAAa,GAGd;QACC,OAAO,uBAAA,IAAI,gFAAW,MAAf,IAAI,EAAY,aAAa,CAAC,CAAC,qBAAqB,EAAE,CAAC;IAChE,CAAC;CACF;AA3HD,4DA2HC;yUA9E8B,QAAyB;IACpD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;QAC9B,IAAI,OAAO,CAAC,IAAI,KAAM,iCAAY,CAAC,EAAa,EAAE;YAChD,+CAA+C;YAC/C,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAE1C,qFAAqF;YACrF,iFAAiF;YACjF,4DAA4D;YAC5D,IAAI,CAAC,uBAAA,IAAI,yCAAS,CAAC,GAAG,CAAC,IAAA,yCAA2B,EAAC,aAAa,CAAC,CAAC,EAAE;gBAClE,8EAA8E;gBAC9E,2DAA2D;gBAC3D,MAAM,MAAM,GAAG,IAAI,qCAAuB,CAAC;oBACzC,aAAa;oBACb,SAAS,EAAE,uBAAA,IAAI,2CAAW;iBAC3B,CAAC,CAAC;gBAEH,uBAAA,IAAI,yCAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;aACtC;SACF;KACF;AACH,CAAC,qFAGC,aAA8B;IAE9B,MAAM,MAAM,GAAG,uBAAA,IAAI,yCAAS,CAAC,GAAG,CAC9B,IAAA,yCAA2B,EAAC,aAAa,CAAC,CAC3C,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;KAC3E;IAED,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import type {\n  MultichainAccountWalletId,\n  AccountProvider,\n} from '@metamask/account-api';\nimport {\n  MultichainAccountWallet,\n  toMultichainAccountWalletId,\n  type MultichainAccount,\n} from '@metamask/account-api';\nimport type { EntropySourceId } from '@metamask/keyring-api';\nimport type {\n  KeyringControllerState,\n  KeyringObject,\n} from '@metamask/keyring-controller';\nimport { KeyringTypes } from '@metamask/keyring-controller';\nimport type { InternalAccount } from '@metamask/keyring-internal-api';\n\nimport { EvmAccountProvider } from './providers/EvmAccountProvider';\nimport { SolAccountProvider } from './providers/SolAccountProvider';\nimport type { MultichainAccountServiceMessenger } from './types';\n\n/**\n * The options that {@link MultichainAccountService} takes.\n */\ntype MultichainAccountServiceOptions = {\n  messenger: MultichainAccountServiceMessenger;\n};\n\n/**\n * Select keyrings from keyring controller state.\n *\n * @param state - The keyring controller state.\n * @returns The keyrings.\n */\nfunction selectKeyringControllerKeyrings(state: KeyringControllerState) {\n  return state.keyrings;\n}\n\n/**\n * Service to expose multichain accounts capabilities.\n */\nexport class MultichainAccountService {\n  readonly #messenger: MultichainAccountServiceMessenger;\n\n  readonly #providers: AccountProvider<InternalAccount>[];\n\n  readonly #wallets: Map<\n    MultichainAccountWalletId,\n    MultichainAccountWallet<InternalAccount>\n  >;\n\n  /**\n   * Constructs a new MultichainAccountService.\n   *\n   * @param options - The options.\n   * @param options.messenger - The messenger suited to this\n   * MultichainAccountService.\n   */\n  constructor({ messenger }: MultichainAccountServiceOptions) {\n    this.#messenger = messenger;\n    this.#wallets = new Map();\n    // TODO: Rely on keyring capabilities once the keyring API is used by all keyrings.\n    this.#providers = [\n      new EvmAccountProvider(this.#messenger),\n      new SolAccountProvider(this.#messenger),\n    ];\n  }\n\n  /**\n   * Initialize the service and constructs the internal reprensentation of\n   * multichain accounts and wallets.\n   */\n  init(): void {\n    // Gather all entropy sources first.\n    const state = this.#messenger.call('KeyringController:getState');\n    this.#setMultichainAccountWallets(state.keyrings);\n\n    this.#messenger.subscribe(\n      'KeyringController:stateChange',\n      (keyrings) => {\n        this.#setMultichainAccountWallets(keyrings);\n      },\n      selectKeyringControllerKeyrings,\n    );\n  }\n\n  #setMultichainAccountWallets(keyrings: KeyringObject[]) {\n    for (const keyring of keyrings) {\n      if (keyring.type === (KeyringTypes.hd as string)) {\n        // Only HD keyrings have an entropy source/SRP.\n        const entropySource = keyring.metadata.id;\n\n        // Do not re-create wallets if they exists. Even if a keyrings got new accounts, this\n        // will be handled by the `*AccountProvider`s which are always in-sync with their\n        // keyrings and controllers (like the `AccountsController`).\n        if (!this.#wallets.has(toMultichainAccountWalletId(entropySource))) {\n          // This will automatically \"associate\" all multichain accounts for that wallet\n          // (based on the accounts owned by each account providers).\n          const wallet = new MultichainAccountWallet({\n            entropySource,\n            providers: this.#providers,\n          });\n\n          this.#wallets.set(wallet.id, wallet);\n        }\n      }\n    }\n  }\n\n  #getWallet(\n    entropySource: EntropySourceId,\n  ): MultichainAccountWallet<InternalAccount> {\n    const wallet = this.#wallets.get(\n      toMultichainAccountWalletId(entropySource),\n    );\n\n    if (!wallet) {\n      throw new Error('Unknown wallet, no wallet matching this entropy source');\n    }\n\n    return wallet;\n  }\n\n  /**\n   * Gets a reference to the multichain account matching this entropy source and group index.\n   *\n   * @param options - Options.\n   * @param options.entropySource - The entropy source of the multichain account.\n   * @param options.groupIndex - The group index of the multichain account.\n   * @throws If none multichain account match this entropy source and group index.\n   * @returns A reference to the multichain account.\n   */\n  getMultichainAccount({\n    entropySource,\n    groupIndex,\n  }: {\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }): MultichainAccount<InternalAccount> {\n    const multichainAccount =\n      this.#getWallet(entropySource).getMultichainAccount(groupIndex);\n\n    if (!multichainAccount) {\n      throw new Error(`No multichain account for index: ${groupIndex}`);\n    }\n\n    return multichainAccount;\n  }\n\n  /**\n   * Gets all multichain accounts for a given entropy source.\n   *\n   * @param options - Options.\n   * @param options.entropySource - The entropy source to query.\n   * @throws If no multichain accounts match this entropy source.\n   * @returns A list of all multichain accounts.\n   */\n  getMultichainAccounts({\n    entropySource,\n  }: {\n    entropySource: EntropySourceId;\n  }): MultichainAccount<InternalAccount>[] {\n    return this.#getWallet(entropySource).getMultichainAccounts();\n  }\n}\n"]}

package/dist/MultichainAccountService.d.cts

@@ -0,0 +1,55 @@
+import { type MultichainAccount } from "@metamask/account-api";
+import type { EntropySourceId } from "@metamask/keyring-api";
+import type { InternalAccount } from "@metamask/keyring-internal-api";
+import type { MultichainAccountServiceMessenger } from "./types.cjs";
+/**
+ * The options that {@link MultichainAccountService} takes.
+ */
+type MultichainAccountServiceOptions = {
+    messenger: MultichainAccountServiceMessenger;
+};
+/**
+ * Service to expose multichain accounts capabilities.
+ */
+export declare class MultichainAccountService {
+    #private;
+    /**
+     * Constructs a new MultichainAccountService.
+     *
+     * @param options - The options.
+     * @param options.messenger - The messenger suited to this
+     * MultichainAccountService.
+     */
+    constructor({ messenger }: MultichainAccountServiceOptions);
+    /**
+     * Initialize the service and constructs the internal reprensentation of
+     * multichain accounts and wallets.
+     */
+    init(): void;
+    /**
+     * Gets a reference to the multichain account matching this entropy source and group index.
+     *
+     * @param options - Options.
+     * @param options.entropySource - The entropy source of the multichain account.
+     * @param options.groupIndex - The group index of the multichain account.
+     * @throws If none multichain account match this entropy source and group index.
+     * @returns A reference to the multichain account.
+     */
+    getMultichainAccount({ entropySource, groupIndex, }: {
+        entropySource: EntropySourceId;
+        groupIndex: number;
+    }): MultichainAccount<InternalAccount>;
+    /**
+     * Gets all multichain accounts for a given entropy source.
+     *
+     * @param options - Options.
+     * @param options.entropySource - The entropy source to query.
+     * @throws If no multichain accounts match this entropy source.
+     * @returns A list of all multichain accounts.
+     */
+    getMultichainAccounts({ entropySource, }: {
+        entropySource: EntropySourceId;
+    }): MultichainAccount<InternalAccount>[];
+}
+export {};
+//# sourceMappingURL=MultichainAccountService.d.cts.map

package/dist/MultichainAccountService.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainAccountService.d.cts","sourceRoot":"","sources":["../src/MultichainAccountService.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,iBAAiB,EACvB,8BAA8B;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,8BAA8B;AAM7D,OAAO,KAAK,EAAE,eAAe,EAAE,uCAAuC;AAItE,OAAO,KAAK,EAAE,iCAAiC,EAAE,oBAAgB;AAEjE;;GAEG;AACH,KAAK,+BAA+B,GAAG;IACrC,SAAS,EAAE,iCAAiC,CAAC;CAC9C,CAAC;AAYF;;GAEG;AACH,qBAAa,wBAAwB;;IAUnC;;;;;;OAMG;gBACS,EAAE,SAAS,EAAE,EAAE,+BAA+B;IAU1D;;;OAGG;IACH,IAAI,IAAI,IAAI;IAmDZ;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EACnB,aAAa,EACb,UAAU,GACX,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,iBAAiB,CAAC,eAAe,CAAC;IAWtC;;;;;;;OAOG;IACH,qBAAqB,CAAC,EACpB,aAAa,GACd,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;KAChC,GAAG,iBAAiB,CAAC,eAAe,CAAC,EAAE;CAGzC"}

package/dist/MultichainAccountService.d.mts

@@ -0,0 +1,55 @@
+import { type MultichainAccount } from "@metamask/account-api";
+import type { EntropySourceId } from "@metamask/keyring-api";
+import type { InternalAccount } from "@metamask/keyring-internal-api";
+import type { MultichainAccountServiceMessenger } from "./types.mjs";
+/**
+ * The options that {@link MultichainAccountService} takes.
+ */
+type MultichainAccountServiceOptions = {
+    messenger: MultichainAccountServiceMessenger;
+};
+/**
+ * Service to expose multichain accounts capabilities.
+ */
+export declare class MultichainAccountService {
+    #private;
+    /**
+     * Constructs a new MultichainAccountService.
+     *
+     * @param options - The options.
+     * @param options.messenger - The messenger suited to this
+     * MultichainAccountService.
+     */
+    constructor({ messenger }: MultichainAccountServiceOptions);
+    /**
+     * Initialize the service and constructs the internal reprensentation of
+     * multichain accounts and wallets.
+     */
+    init(): void;
+    /**
+     * Gets a reference to the multichain account matching this entropy source and group index.
+     *
+     * @param options - Options.
+     * @param options.entropySource - The entropy source of the multichain account.
+     * @param options.groupIndex - The group index of the multichain account.
+     * @throws If none multichain account match this entropy source and group index.
+     * @returns A reference to the multichain account.
+     */
+    getMultichainAccount({ entropySource, groupIndex, }: {
+        entropySource: EntropySourceId;
+        groupIndex: number;
+    }): MultichainAccount<InternalAccount>;
+    /**
+     * Gets all multichain accounts for a given entropy source.
+     *
+     * @param options - Options.
+     * @param options.entropySource - The entropy source to query.
+     * @throws If no multichain accounts match this entropy source.
+     * @returns A list of all multichain accounts.
+     */
+    getMultichainAccounts({ entropySource, }: {
+        entropySource: EntropySourceId;
+    }): MultichainAccount<InternalAccount>[];
+}
+export {};
+//# sourceMappingURL=MultichainAccountService.d.mts.map

package/dist/MultichainAccountService.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainAccountService.d.mts","sourceRoot":"","sources":["../src/MultichainAccountService.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,iBAAiB,EACvB,8BAA8B;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,8BAA8B;AAM7D,OAAO,KAAK,EAAE,eAAe,EAAE,uCAAuC;AAItE,OAAO,KAAK,EAAE,iCAAiC,EAAE,oBAAgB;AAEjE;;GAEG;AACH,KAAK,+BAA+B,GAAG;IACrC,SAAS,EAAE,iCAAiC,CAAC;CAC9C,CAAC;AAYF;;GAEG;AACH,qBAAa,wBAAwB;;IAUnC;;;;;;OAMG;gBACS,EAAE,SAAS,EAAE,EAAE,+BAA+B;IAU1D;;;OAGG;IACH,IAAI,IAAI,IAAI;IAmDZ;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EACnB,aAAa,EACb,UAAU,GACX,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,iBAAiB,CAAC,eAAe,CAAC;IAWtC;;;;;;;OAOG;IACH,qBAAqB,CAAC,EACpB,aAAa,GACd,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;KAChC,GAAG,iBAAiB,CAAC,eAAe,CAAC,EAAE;CAGzC"}

package/dist/MultichainAccountService.mjs

@@ -0,0 +1,116 @@
+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 _MultichainAccountService_instances, _MultichainAccountService_messenger, _MultichainAccountService_providers, _MultichainAccountService_wallets, _MultichainAccountService_setMultichainAccountWallets, _MultichainAccountService_getWallet;
+import { MultichainAccountWallet, toMultichainAccountWalletId } from "@metamask/account-api";
+import { KeyringTypes } from "@metamask/keyring-controller";
+import { EvmAccountProvider } from "./providers/EvmAccountProvider.mjs";
+import { SolAccountProvider } from "./providers/SolAccountProvider.mjs";
+/**
+ * Select keyrings from keyring controller state.
+ *
+ * @param state - The keyring controller state.
+ * @returns The keyrings.
+ */
+function selectKeyringControllerKeyrings(state) {
+    return state.keyrings;
+}
+/**
+ * Service to expose multichain accounts capabilities.
+ */
+export class MultichainAccountService {
+    /**
+     * Constructs a new MultichainAccountService.
+     *
+     * @param options - The options.
+     * @param options.messenger - The messenger suited to this
+     * MultichainAccountService.
+     */
+    constructor({ messenger }) {
+        _MultichainAccountService_instances.add(this);
+        _MultichainAccountService_messenger.set(this, void 0);
+        _MultichainAccountService_providers.set(this, void 0);
+        _MultichainAccountService_wallets.set(this, void 0);
+        __classPrivateFieldSet(this, _MultichainAccountService_messenger, messenger, "f");
+        __classPrivateFieldSet(this, _MultichainAccountService_wallets, new Map(), "f");
+        // TODO: Rely on keyring capabilities once the keyring API is used by all keyrings.
+        __classPrivateFieldSet(this, _MultichainAccountService_providers, [
+            new EvmAccountProvider(__classPrivateFieldGet(this, _MultichainAccountService_messenger, "f")),
+            new SolAccountProvider(__classPrivateFieldGet(this, _MultichainAccountService_messenger, "f")),
+        ], "f");
+    }
+    /**
+     * Initialize the service and constructs the internal reprensentation of
+     * multichain accounts and wallets.
+     */
+    init() {
+        // Gather all entropy sources first.
+        const state = __classPrivateFieldGet(this, _MultichainAccountService_messenger, "f").call('KeyringController:getState');
+        __classPrivateFieldGet(this, _MultichainAccountService_instances, "m", _MultichainAccountService_setMultichainAccountWallets).call(this, state.keyrings);
+        __classPrivateFieldGet(this, _MultichainAccountService_messenger, "f").subscribe('KeyringController:stateChange', (keyrings) => {
+            __classPrivateFieldGet(this, _MultichainAccountService_instances, "m", _MultichainAccountService_setMultichainAccountWallets).call(this, keyrings);
+        }, selectKeyringControllerKeyrings);
+    }
+    /**
+     * Gets a reference to the multichain account matching this entropy source and group index.
+     *
+     * @param options - Options.
+     * @param options.entropySource - The entropy source of the multichain account.
+     * @param options.groupIndex - The group index of the multichain account.
+     * @throws If none multichain account match this entropy source and group index.
+     * @returns A reference to the multichain account.
+     */
+    getMultichainAccount({ entropySource, groupIndex, }) {
+        const multichainAccount = __classPrivateFieldGet(this, _MultichainAccountService_instances, "m", _MultichainAccountService_getWallet).call(this, entropySource).getMultichainAccount(groupIndex);
+        if (!multichainAccount) {
+            throw new Error(`No multichain account for index: ${groupIndex}`);
+        }
+        return multichainAccount;
+    }
+    /**
+     * Gets all multichain accounts for a given entropy source.
+     *
+     * @param options - Options.
+     * @param options.entropySource - The entropy source to query.
+     * @throws If no multichain accounts match this entropy source.
+     * @returns A list of all multichain accounts.
+     */
+    getMultichainAccounts({ entropySource, }) {
+        return __classPrivateFieldGet(this, _MultichainAccountService_instances, "m", _MultichainAccountService_getWallet).call(this, entropySource).getMultichainAccounts();
+    }
+}
+_MultichainAccountService_messenger = new WeakMap(), _MultichainAccountService_providers = new WeakMap(), _MultichainAccountService_wallets = new WeakMap(), _MultichainAccountService_instances = new WeakSet(), _MultichainAccountService_setMultichainAccountWallets = function _MultichainAccountService_setMultichainAccountWallets(keyrings) {
+    for (const keyring of keyrings) {
+        if (keyring.type === KeyringTypes.hd) {
+            // Only HD keyrings have an entropy source/SRP.
+            const entropySource = keyring.metadata.id;
+            // Do not re-create wallets if they exists. Even if a keyrings got new accounts, this
+            // will be handled by the `*AccountProvider`s which are always in-sync with their
+            // keyrings and controllers (like the `AccountsController`).
+            if (!__classPrivateFieldGet(this, _MultichainAccountService_wallets, "f").has(toMultichainAccountWalletId(entropySource))) {
+                // This will automatically "associate" all multichain accounts for that wallet
+                // (based on the accounts owned by each account providers).
+                const wallet = new MultichainAccountWallet({
+                    entropySource,
+                    providers: __classPrivateFieldGet(this, _MultichainAccountService_providers, "f"),
+                });
+                __classPrivateFieldGet(this, _MultichainAccountService_wallets, "f").set(wallet.id, wallet);
+            }
+        }
+    }
+}, _MultichainAccountService_getWallet = function _MultichainAccountService_getWallet(entropySource) {
+    const wallet = __classPrivateFieldGet(this, _MultichainAccountService_wallets, "f").get(toMultichainAccountWalletId(entropySource));
+    if (!wallet) {
+        throw new Error('Unknown wallet, no wallet matching this entropy source');
+    }
+    return wallet;
+};
+//# sourceMappingURL=MultichainAccountService.mjs.map

package/dist/MultichainAccountService.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainAccountService.mjs","sourceRoot":"","sources":["../src/MultichainAccountService.ts"],"names":[],"mappings":";;;;;;;;;;;;AAIA,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAE5B,8BAA8B;AAM/B,OAAO,EAAE,YAAY,EAAE,qCAAqC;AAG5D,OAAO,EAAE,kBAAkB,EAAE,2CAAuC;AACpE,OAAO,EAAE,kBAAkB,EAAE,2CAAuC;AAUpE;;;;;GAKG;AACH,SAAS,+BAA+B,CAAC,KAA6B;IACpE,OAAO,KAAK,CAAC,QAAQ,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,wBAAwB;IAUnC;;;;;;OAMG;IACH,YAAY,EAAE,SAAS,EAAmC;;QAhBjD,sDAA8C;QAE9C,sDAA+C;QAE/C,oDAGP;QAUA,uBAAA,IAAI,uCAAc,SAAS,MAAA,CAAC;QAC5B,uBAAA,IAAI,qCAAY,IAAI,GAAG,EAAE,MAAA,CAAC;QAC1B,mFAAmF;QACnF,uBAAA,IAAI,uCAAc;YAChB,IAAI,kBAAkB,CAAC,uBAAA,IAAI,2CAAW,CAAC;YACvC,IAAI,kBAAkB,CAAC,uBAAA,IAAI,2CAAW,CAAC;SACxC,MAAA,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,oCAAoC;QACpC,MAAM,KAAK,GAAG,uBAAA,IAAI,2CAAW,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACjE,uBAAA,IAAI,kGAA6B,MAAjC,IAAI,EAA8B,KAAK,CAAC,QAAQ,CAAC,CAAC;QAElD,uBAAA,IAAI,2CAAW,CAAC,SAAS,CACvB,+BAA+B,EAC/B,CAAC,QAAQ,EAAE,EAAE;YACX,uBAAA,IAAI,kGAA6B,MAAjC,IAAI,EAA8B,QAAQ,CAAC,CAAC;QAC9C,CAAC,EACD,+BAA+B,CAChC,CAAC;IACJ,CAAC;IAuCD;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EACnB,aAAa,EACb,UAAU,GAIX;QACC,MAAM,iBAAiB,GACrB,uBAAA,IAAI,gFAAW,MAAf,IAAI,EAAY,aAAa,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAElE,IAAI,CAAC,iBAAiB,EAAE;YACtB,MAAM,IAAI,KAAK,CAAC,oCAAoC,UAAU,EAAE,CAAC,CAAC;SACnE;QAED,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED;;;;;;;OAOG;IACH,qBAAqB,CAAC,EACpB,aAAa,GAGd;QACC,OAAO,uBAAA,IAAI,gFAAW,MAAf,IAAI,EAAY,aAAa,CAAC,CAAC,qBAAqB,EAAE,CAAC;IAChE,CAAC;CACF;yUA9E8B,QAAyB;IACpD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;QAC9B,IAAI,OAAO,CAAC,IAAI,KAAM,YAAY,CAAC,EAAa,EAAE;YAChD,+CAA+C;YAC/C,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAE1C,qFAAqF;YACrF,iFAAiF;YACjF,4DAA4D;YAC5D,IAAI,CAAC,uBAAA,IAAI,yCAAS,CAAC,GAAG,CAAC,2BAA2B,CAAC,aAAa,CAAC,CAAC,EAAE;gBAClE,8EAA8E;gBAC9E,2DAA2D;gBAC3D,MAAM,MAAM,GAAG,IAAI,uBAAuB,CAAC;oBACzC,aAAa;oBACb,SAAS,EAAE,uBAAA,IAAI,2CAAW;iBAC3B,CAAC,CAAC;gBAEH,uBAAA,IAAI,yCAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;aACtC;SACF;KACF;AACH,CAAC,qFAGC,aAA8B;IAE9B,MAAM,MAAM,GAAG,uBAAA,IAAI,yCAAS,CAAC,GAAG,CAC9B,2BAA2B,CAAC,aAAa,CAAC,CAC3C,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;KAC3E;IAED,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import type {\n  MultichainAccountWalletId,\n  AccountProvider,\n} from '@metamask/account-api';\nimport {\n  MultichainAccountWallet,\n  toMultichainAccountWalletId,\n  type MultichainAccount,\n} from '@metamask/account-api';\nimport type { EntropySourceId } from '@metamask/keyring-api';\nimport type {\n  KeyringControllerState,\n  KeyringObject,\n} from '@metamask/keyring-controller';\nimport { KeyringTypes } from '@metamask/keyring-controller';\nimport type { InternalAccount } from '@metamask/keyring-internal-api';\n\nimport { EvmAccountProvider } from './providers/EvmAccountProvider';\nimport { SolAccountProvider } from './providers/SolAccountProvider';\nimport type { MultichainAccountServiceMessenger } from './types';\n\n/**\n * The options that {@link MultichainAccountService} takes.\n */\ntype MultichainAccountServiceOptions = {\n  messenger: MultichainAccountServiceMessenger;\n};\n\n/**\n * Select keyrings from keyring controller state.\n *\n * @param state - The keyring controller state.\n * @returns The keyrings.\n */\nfunction selectKeyringControllerKeyrings(state: KeyringControllerState) {\n  return state.keyrings;\n}\n\n/**\n * Service to expose multichain accounts capabilities.\n */\nexport class MultichainAccountService {\n  readonly #messenger: MultichainAccountServiceMessenger;\n\n  readonly #providers: AccountProvider<InternalAccount>[];\n\n  readonly #wallets: Map<\n    MultichainAccountWalletId,\n    MultichainAccountWallet<InternalAccount>\n  >;\n\n  /**\n   * Constructs a new MultichainAccountService.\n   *\n   * @param options - The options.\n   * @param options.messenger - The messenger suited to this\n   * MultichainAccountService.\n   */\n  constructor({ messenger }: MultichainAccountServiceOptions) {\n    this.#messenger = messenger;\n    this.#wallets = new Map();\n    // TODO: Rely on keyring capabilities once the keyring API is used by all keyrings.\n    this.#providers = [\n      new EvmAccountProvider(this.#messenger),\n      new SolAccountProvider(this.#messenger),\n    ];\n  }\n\n  /**\n   * Initialize the service and constructs the internal reprensentation of\n   * multichain accounts and wallets.\n   */\n  init(): void {\n    // Gather all entropy sources first.\n    const state = this.#messenger.call('KeyringController:getState');\n    this.#setMultichainAccountWallets(state.keyrings);\n\n    this.#messenger.subscribe(\n      'KeyringController:stateChange',\n      (keyrings) => {\n        this.#setMultichainAccountWallets(keyrings);\n      },\n      selectKeyringControllerKeyrings,\n    );\n  }\n\n  #setMultichainAccountWallets(keyrings: KeyringObject[]) {\n    for (const keyring of keyrings) {\n      if (keyring.type === (KeyringTypes.hd as string)) {\n        // Only HD keyrings have an entropy source/SRP.\n        const entropySource = keyring.metadata.id;\n\n        // Do not re-create wallets if they exists. Even if a keyrings got new accounts, this\n        // will be handled by the `*AccountProvider`s which are always in-sync with their\n        // keyrings and controllers (like the `AccountsController`).\n        if (!this.#wallets.has(toMultichainAccountWalletId(entropySource))) {\n          // This will automatically \"associate\" all multichain accounts for that wallet\n          // (based on the accounts owned by each account providers).\n          const wallet = new MultichainAccountWallet({\n            entropySource,\n            providers: this.#providers,\n          });\n\n          this.#wallets.set(wallet.id, wallet);\n        }\n      }\n    }\n  }\n\n  #getWallet(\n    entropySource: EntropySourceId,\n  ): MultichainAccountWallet<InternalAccount> {\n    const wallet = this.#wallets.get(\n      toMultichainAccountWalletId(entropySource),\n    );\n\n    if (!wallet) {\n      throw new Error('Unknown wallet, no wallet matching this entropy source');\n    }\n\n    return wallet;\n  }\n\n  /**\n   * Gets a reference to the multichain account matching this entropy source and group index.\n   *\n   * @param options - Options.\n   * @param options.entropySource - The entropy source of the multichain account.\n   * @param options.groupIndex - The group index of the multichain account.\n   * @throws If none multichain account match this entropy source and group index.\n   * @returns A reference to the multichain account.\n   */\n  getMultichainAccount({\n    entropySource,\n    groupIndex,\n  }: {\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }): MultichainAccount<InternalAccount> {\n    const multichainAccount =\n      this.#getWallet(entropySource).getMultichainAccount(groupIndex);\n\n    if (!multichainAccount) {\n      throw new Error(`No multichain account for index: ${groupIndex}`);\n    }\n\n    return multichainAccount;\n  }\n\n  /**\n   * Gets all multichain accounts for a given entropy source.\n   *\n   * @param options - Options.\n   * @param options.entropySource - The entropy source to query.\n   * @throws If no multichain accounts match this entropy source.\n   * @returns A list of all multichain accounts.\n   */\n  getMultichainAccounts({\n    entropySource,\n  }: {\n    entropySource: EntropySourceId;\n  }): MultichainAccount<InternalAccount>[] {\n    return this.#getWallet(entropySource).getMultichainAccounts();\n  }\n}\n"]}

package/dist/index.cjs

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultichainAccountService = void 0;
+var MultichainAccountService_1 = require("./MultichainAccountService.cjs");
+Object.defineProperty(exports, "MultichainAccountService", { enumerable: true, get: function () { return MultichainAccountService_1.MultichainAccountService; } });
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAKA,2EAAsE;AAA7D,oIAAA,wBAAwB,OAAA","sourcesContent":["export type {\n  MultichainAccountServiceActions,\n  MultichainAccountServiceEvents,\n  MultichainAccountServiceMessenger,\n} from './types';\nexport { MultichainAccountService } from './MultichainAccountService';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,3 @@
+export type { MultichainAccountServiceActions, MultichainAccountServiceEvents, MultichainAccountServiceMessenger, } from "./types.cjs";
+export { MultichainAccountService } from "./MultichainAccountService.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,+BAA+B,EAC/B,8BAA8B,EAC9B,iCAAiC,GAClC,oBAAgB;AACjB,OAAO,EAAE,wBAAwB,EAAE,uCAAmC"}

package/dist/index.d.mts

@@ -0,0 +1,3 @@
+export type { MultichainAccountServiceActions, MultichainAccountServiceEvents, MultichainAccountServiceMessenger, } from "./types.mjs";
+export { MultichainAccountService } from "./MultichainAccountService.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,+BAA+B,EAC/B,8BAA8B,EAC9B,iCAAiC,GAClC,oBAAgB;AACjB,OAAO,EAAE,wBAAwB,EAAE,uCAAmC"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+export { MultichainAccountService } from "./MultichainAccountService.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,wBAAwB,EAAE,uCAAmC","sourcesContent":["export type {\n  MultichainAccountServiceActions,\n  MultichainAccountServiceEvents,\n  MultichainAccountServiceMessenger,\n} from './types';\nexport { MultichainAccountService } from './MultichainAccountService';\n"]}

package/dist/providers/BaseAccountProvider.cjs

@@ -0,0 +1,59 @@
+"use strict";
+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 _BaseAccountProvider_instances, _BaseAccountProvider_getAccounts;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseAccountProvider = exports.isBip44Account = void 0;
+const keyring_api_1 = require("@metamask/keyring-api");
+/**
+ * Checks if an account is BIP-44 compatible.
+ *
+ * @param account - The account to be tested.
+ * @returns True if the account is BIP-44 compatible.
+ */
+function isBip44Account(account) {
+    if (!account.options.entropy ||
+        account.options.entropy.type !== keyring_api_1.KeyringAccountEntropyTypeOption.Mnemonic) {
+        console.warn("! Found an HD account with invalid entropy options: account won't be associated to its wallet.");
+        return false;
+    }
+    return true;
+}
+exports.isBip44Account = isBip44Account;
+class BaseAccountProvider {
+    constructor(messenger) {
+        _BaseAccountProvider_instances.add(this);
+        this.messenger = messenger;
+    }
+    getAccounts() {
+        return __classPrivateFieldGet(this, _BaseAccountProvider_instances, "m", _BaseAccountProvider_getAccounts).call(this);
+    }
+    getAccount(id) {
+        // TODO: Maybe just use a proper find for faster lookup?
+        const [found] = __classPrivateFieldGet(this, _BaseAccountProvider_instances, "m", _BaseAccountProvider_getAccounts).call(this, (account) => account.id === id);
+        if (!found) {
+            throw new Error(`Unable to find account: ${id}`);
+        }
+        return found;
+    }
+}
+exports.BaseAccountProvider = BaseAccountProvider;
+_BaseAccountProvider_instances = new WeakSet(), _BaseAccountProvider_getAccounts = function _BaseAccountProvider_getAccounts(filter = () => true) {
+    const accounts = [];
+    for (const account of this.messenger.call(
+    // NOTE: Even though the name is misleading, this only fetches all internal
+    // accounts, including EVM and non-EVM. We might wanna change this action
+    // name once we fully support multichain accounts.
+    'AccountsController:listMultichainAccounts')) {
+        if (this.isAccountCompatible(account) &&
+            isBip44Account(account) &&
+            filter(account)) {
+            accounts.push(account);
+        }
+    }
+    return accounts;
+};
+//# sourceMappingURL=BaseAccountProvider.cjs.map

package/dist/providers/BaseAccountProvider.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseAccountProvider.cjs","sourceRoot":"","sources":["../../src/providers/BaseAccountProvider.ts"],"names":[],"mappings":";;;;;;;;;AAMA,uDAAwE;AAWxE;;;;;GAKG;AACH,SAAgB,cAAc,CAC5B,OAAgB;IAEhB,IACE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO;QACxB,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,6CAA+B,CAAC,QAAQ,EACzE;QACA,OAAO,CAAC,IAAI,CACV,gGAAgG,CACjG,CAAC;QACF,OAAO,KAAK,CAAC;KACd;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAdD,wCAcC;AAED,MAAsB,mBAAmB;IAKvC,YAAY,SAA4C;;QACtD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAyBD,WAAW;QACT,OAAO,uBAAA,IAAI,wEAAa,MAAjB,IAAI,CAAe,CAAC;IAC7B,CAAC;IAED,UAAU,CAAC,EAAa;QACtB,wDAAwD;QACxD,MAAM,CAAC,KAAK,CAAC,GAAG,uBAAA,IAAI,wEAAa,MAAjB,IAAI,EAAc,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAElE,IAAI,CAAC,KAAK,EAAE;YACV,MAAM,IAAI,KAAK,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;SAClD;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CAGF;AAhDD,kDAgDC;6HAtCG,SAAgD,GAAG,EAAE,CAAC,IAAI;IAE1D,MAAM,QAAQ,GAAoC,EAAE,CAAC;IAErD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI;IACvC,2EAA2E;IAC3E,yEAAyE;IACzE,kDAAkD;IAClD,2CAA2C,CAC5C,EAAE;QACD,IACE,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC;YACjC,cAAc,CAAC,OAAO,CAAC;YACvB,MAAM,CAAC,OAAO,CAAC,EACf;YACA,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;SACxB;KACF;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import type { AccountProvider } from '@metamask/account-api';\nimport type { AccountId } from '@metamask/accounts-controller';\nimport type {\n  KeyringAccount,\n  KeyringAccountEntropyMnemonicOptions,\n} from '@metamask/keyring-api';\nimport { KeyringAccountEntropyTypeOption } from '@metamask/keyring-api';\nimport type { InternalAccount } from '@metamask/keyring-internal-api';\n\nimport type { MultichainAccountServiceMessenger } from '../types';\n\nexport type Bip44Account<Account extends KeyringAccount> = Account & {\n  options: {\n    entropy: KeyringAccountEntropyMnemonicOptions;\n  };\n};\n\n/**\n * Checks if an account is BIP-44 compatible.\n *\n * @param account - The account to be tested.\n * @returns True if the account is BIP-44 compatible.\n */\nexport function isBip44Account<Account extends KeyringAccount>(\n  account: Account,\n): account is Bip44Account<Account> {\n  if (\n    !account.options.entropy ||\n    account.options.entropy.type !== KeyringAccountEntropyTypeOption.Mnemonic\n  ) {\n    console.warn(\n      \"! Found an HD account with invalid entropy options: account won't be associated to its wallet.\",\n    );\n    return false;\n  }\n\n  return true;\n}\n\nexport abstract class BaseAccountProvider\n  implements AccountProvider<InternalAccount>\n{\n  protected readonly messenger: MultichainAccountServiceMessenger;\n\n  constructor(messenger: MultichainAccountServiceMessenger) {\n    this.messenger = messenger;\n  }\n\n  #getAccounts(\n    filter: (account: InternalAccount) => boolean = () => true,\n  ): Bip44Account<InternalAccount>[] {\n    const accounts: Bip44Account<InternalAccount>[] = [];\n\n    for (const account of this.messenger.call(\n      // NOTE: Even though the name is misleading, this only fetches all internal\n      // accounts, including EVM and non-EVM. We might wanna change this action\n      // name once we fully support multichain accounts.\n      'AccountsController:listMultichainAccounts',\n    )) {\n      if (\n        this.isAccountCompatible(account) &&\n        isBip44Account(account) &&\n        filter(account)\n      ) {\n        accounts.push(account);\n      }\n    }\n\n    return accounts;\n  }\n\n  getAccounts(): InternalAccount[] {\n    return this.#getAccounts();\n  }\n\n  getAccount(id: AccountId): InternalAccount {\n    // TODO: Maybe just use a proper find for faster lookup?\n    const [found] = this.#getAccounts((account) => account.id === id);\n\n    if (!found) {\n      throw new Error(`Unable to find account: ${id}`);\n    }\n\n    return found;\n  }\n\n  abstract isAccountCompatible(account: InternalAccount): boolean;\n}\n"]}

package/dist/providers/BaseAccountProvider.d.cts

@@ -0,0 +1,26 @@
+import type { AccountProvider } from "@metamask/account-api";
+import type { AccountId } from "@metamask/accounts-controller";
+import type { KeyringAccount, KeyringAccountEntropyMnemonicOptions } from "@metamask/keyring-api";
+import type { InternalAccount } from "@metamask/keyring-internal-api";
+import type { MultichainAccountServiceMessenger } from "../types.cjs";
+export type Bip44Account<Account extends KeyringAccount> = Account & {
+    options: {
+        entropy: KeyringAccountEntropyMnemonicOptions;
+    };
+};
+/**
+ * Checks if an account is BIP-44 compatible.
+ *
+ * @param account - The account to be tested.
+ * @returns True if the account is BIP-44 compatible.
+ */
+export declare function isBip44Account<Account extends KeyringAccount>(account: Account): account is Bip44Account<Account>;
+export declare abstract class BaseAccountProvider implements AccountProvider<InternalAccount> {
+    #private;
+    protected readonly messenger: MultichainAccountServiceMessenger;
+    constructor(messenger: MultichainAccountServiceMessenger);
+    getAccounts(): InternalAccount[];
+    getAccount(id: AccountId): InternalAccount;
+    abstract isAccountCompatible(account: InternalAccount): boolean;
+}
+//# sourceMappingURL=BaseAccountProvider.d.cts.map

package/dist/providers/BaseAccountProvider.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseAccountProvider.d.cts","sourceRoot":"","sources":["../../src/providers/BaseAccountProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,8BAA8B;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,sCAAsC;AAC/D,OAAO,KAAK,EACV,cAAc,EACd,oCAAoC,EACrC,8BAA8B;AAE/B,OAAO,KAAK,EAAE,eAAe,EAAE,uCAAuC;AAEtE,OAAO,KAAK,EAAE,iCAAiC,EAAE,qBAAiB;AAElE,MAAM,MAAM,YAAY,CAAC,OAAO,SAAS,cAAc,IAAI,OAAO,GAAG;IACnE,OAAO,EAAE;QACP,OAAO,EAAE,oCAAoC,CAAC;KAC/C,CAAC;CACH,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,cAAc,EAC3D,OAAO,EAAE,OAAO,GACf,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAYlC;AAED,8BAAsB,mBACpB,YAAW,eAAe,CAAC,eAAe,CAAC;;IAE3C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,iCAAiC,CAAC;gBAEpD,SAAS,EAAE,iCAAiC;IA2BxD,WAAW,IAAI,eAAe,EAAE;IAIhC,UAAU,CAAC,EAAE,EAAE,SAAS,GAAG,eAAe;IAW1C,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO;CAChE"}

package/dist/providers/BaseAccountProvider.d.mts

@@ -0,0 +1,26 @@
+import type { AccountProvider } from "@metamask/account-api";
+import type { AccountId } from "@metamask/accounts-controller";
+import type { KeyringAccount, KeyringAccountEntropyMnemonicOptions } from "@metamask/keyring-api";
+import type { InternalAccount } from "@metamask/keyring-internal-api";
+import type { MultichainAccountServiceMessenger } from "../types.mjs";
+export type Bip44Account<Account extends KeyringAccount> = Account & {
+    options: {
+        entropy: KeyringAccountEntropyMnemonicOptions;
+    };
+};
+/**
+ * Checks if an account is BIP-44 compatible.
+ *
+ * @param account - The account to be tested.
+ * @returns True if the account is BIP-44 compatible.
+ */
+export declare function isBip44Account<Account extends KeyringAccount>(account: Account): account is Bip44Account<Account>;
+export declare abstract class BaseAccountProvider implements AccountProvider<InternalAccount> {
+    #private;
+    protected readonly messenger: MultichainAccountServiceMessenger;
+    constructor(messenger: MultichainAccountServiceMessenger);
+    getAccounts(): InternalAccount[];
+    getAccount(id: AccountId): InternalAccount;
+    abstract isAccountCompatible(account: InternalAccount): boolean;
+}
+//# sourceMappingURL=BaseAccountProvider.d.mts.map

package/dist/providers/BaseAccountProvider.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseAccountProvider.d.mts","sourceRoot":"","sources":["../../src/providers/BaseAccountProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,8BAA8B;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,sCAAsC;AAC/D,OAAO,KAAK,EACV,cAAc,EACd,oCAAoC,EACrC,8BAA8B;AAE/B,OAAO,KAAK,EAAE,eAAe,EAAE,uCAAuC;AAEtE,OAAO,KAAK,EAAE,iCAAiC,EAAE,qBAAiB;AAElE,MAAM,MAAM,YAAY,CAAC,OAAO,SAAS,cAAc,IAAI,OAAO,GAAG;IACnE,OAAO,EAAE;QACP,OAAO,EAAE,oCAAoC,CAAC;KAC/C,CAAC;CACH,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,cAAc,EAC3D,OAAO,EAAE,OAAO,GACf,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAYlC;AAED,8BAAsB,mBACpB,YAAW,eAAe,CAAC,eAAe,CAAC;;IAE3C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,iCAAiC,CAAC;gBAEpD,SAAS,EAAE,iCAAiC;IA2BxD,WAAW,IAAI,eAAe,EAAE;IAIhC,UAAU,CAAC,EAAE,EAAE,SAAS,GAAG,eAAe;IAW1C,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO;CAChE"}