@metamask-previews/multichain-account-controller 0.0.0-preview-7b670bb5

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# 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]
+
+[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,15 @@
+# `@metamask/multichain-account-controller`
+
+example
+
+## Installation
+
+`yarn add @metamask/multichain-account-controller`
+
+or
+
+`npm install @metamask/multichain-account-controller`
+
+## 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/MultichainAccountController.cjs

@@ -0,0 +1,88 @@
+"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 _MultichainAccountController_instances, _MultichainAccountController_messenger, _MultichainAccountController_providers, _MultichainAccountController_wallets, _MultichainAccountController_getWallet;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultichainAccountController = void 0;
+const keyring_api_1 = require("@metamask/keyring-api");
+const keyring_controller_1 = require("@metamask/keyring-controller");
+const keyring_snap_client_1 = require("@metamask/keyring-snap-client");
+const multichain_account_api_1 = require("@metamask/multichain-account-api");
+const snaps_utils_1 = require("@metamask/snaps-utils");
+const EvmAccountProvider_1 = require("./providers/EvmAccountProvider.cjs");
+const SolAccountProvider_1 = require("./providers/SolAccountProvider.cjs");
+/**
+ * Stateless controller to expose multichain accounts capabilities.
+ */
+class MultichainAccountController {
+    /**
+     * Constructs a new MultichainAccountController.
+     *
+     * @param options - The options.
+     * @param options.messenger - The messenger suited to this
+     * MultichainAccountController.
+     */
+    constructor({ messenger }) {
+        _MultichainAccountController_instances.add(this);
+        _MultichainAccountController_messenger.set(this, void 0);
+        _MultichainAccountController_providers.set(this, void 0);
+        _MultichainAccountController_wallets.set(this, void 0);
+        __classPrivateFieldSet(this, _MultichainAccountController_messenger, messenger, "f");
+        __classPrivateFieldSet(this, _MultichainAccountController_wallets, new Map(), "f");
+        // TODO: Rely on keyring capabilities once the keyring API is used by all keyrings.
+        __classPrivateFieldSet(this, _MultichainAccountController_providers, [
+            new EvmAccountProvider_1.EvmAccountProvider(__classPrivateFieldGet(this, _MultichainAccountController_messenger, "f")),
+            new SolAccountProvider_1.SolAccountProvider(__classPrivateFieldGet(this, _MultichainAccountController_messenger, "f")),
+        ], "f");
+        // Gather all entropy sources first.
+        const entropySources = new Set();
+        for (const provider of __classPrivateFieldGet(this, _MultichainAccountController_providers, "f")) {
+            for (const entropySource of provider.getEntropySources()) {
+                entropySources.add(entropySource);
+            }
+        }
+        for (const entropySource of entropySources) {
+            // This will automatically create all multichain accounts for that wallet (based
+            // on the accounts owned by each account providers).
+            const wallet = new multichain_account_api_1.MultichainAccountWalletAdapter({
+                entropySource,
+                providers: __classPrivateFieldGet(this, _MultichainAccountController_providers, "f"),
+            });
+            __classPrivateFieldGet(this, _MultichainAccountController_wallets, "f").set(wallet.id, wallet);
+        }
+    }
+    getMultichainAccount({ entropySource, groupIndex, }) {
+        const multichainAccount = __classPrivateFieldGet(this, _MultichainAccountController_instances, "m", _MultichainAccountController_getWallet).call(this, entropySource).accounts[groupIndex];
+        if (!multichainAccount) {
+            throw new Error(`No multichain account for index: ${groupIndex}`);
+        }
+        return multichainAccount;
+    }
+    getMultichainAccounts({ entropySource, }) {
+        return __classPrivateFieldGet(this, _MultichainAccountController_instances, "m", _MultichainAccountController_getWallet).call(this, entropySource).accounts;
+    }
+    async createNextMultichainAccount({ entropySource, }) {
+        return await __classPrivateFieldGet(this, _MultichainAccountController_instances, "m", _MultichainAccountController_getWallet).call(this, entropySource).createNextMultichainAccount();
+    }
+    async discoverAndCreateMultichainAccounts({ entropySource, }) {
+        return await __classPrivateFieldGet(this, _MultichainAccountController_instances, "m", _MultichainAccountController_getWallet).call(this, entropySource).discoverAndCreateMultichainAccounts();
+    }
+}
+exports.MultichainAccountController = MultichainAccountController;
+_MultichainAccountController_messenger = new WeakMap(), _MultichainAccountController_providers = new WeakMap(), _MultichainAccountController_wallets = new WeakMap(), _MultichainAccountController_instances = new WeakSet(), _MultichainAccountController_getWallet = function _MultichainAccountController_getWallet(entropySource) {
+    const wallet = __classPrivateFieldGet(this, _MultichainAccountController_wallets, "f").get((0, multichain_account_api_1.toMultichainAccountWalletId)(entropySource));
+    if (!wallet) {
+        throw new Error('Unknown wallet, not wallet matching this entropy source');
+    }
+    return wallet;
+};
+//# sourceMappingURL=MultichainAccountController.cjs.map

package/dist/MultichainAccountController.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainAccountController.cjs","sourceRoot":"","sources":["../src/MultichainAccountController.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAMA,uDAAuE;AAMvE,qEAA4D;AAK5D,uEAA8D;AAK9D,6EAM0C;AAG1C,uDAAoD;AAGpD,2EAAoE;AACpE,2EAAoE;AAiDpE;;GAEG;AACH,MAAa,2BAA2B;IAOtC;;;;;;OAMG;IACH,YAAY,EAAE,SAAS,EAAsC;;QAbpD,yDAAiD;QAEjD,yDAA8B;QAE9B,uDAAkE;QAUzE,uBAAA,IAAI,0CAAc,SAAS,MAAA,CAAC;QAC5B,uBAAA,IAAI,wCAAY,IAAI,GAAG,EAAE,MAAA,CAAC;QAC1B,mFAAmF;QACnF,uBAAA,IAAI,0CAAc;YAChB,IAAI,uCAAkB,CAAC,uBAAA,IAAI,8CAAW,CAAC;YACvC,IAAI,uCAAkB,CAAC,uBAAA,IAAI,8CAAW,CAAC;SACxC,MAAA,CAAC;QAEF,oCAAoC;QACpC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAmB,CAAC;QAClD,KAAK,MAAM,QAAQ,IAAI,uBAAA,IAAI,8CAAW,EAAE;YACtC,KAAK,MAAM,aAAa,IAAI,QAAQ,CAAC,iBAAiB,EAAE,EAAE;gBACxD,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;aACnC;SACF;QAED,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE;YAC1C,gFAAgF;YAChF,oDAAoD;YACpD,MAAM,MAAM,GAAG,IAAI,uDAA8B,CAAC;gBAChD,aAAa;gBACb,SAAS,EAAE,uBAAA,IAAI,8CAAW;aAC3B,CAAC,CAAC;YAEH,uBAAA,IAAI,4CAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;SACtC;IACH,CAAC;IAgBD,oBAAoB,CAAC,EACnB,aAAa,EACb,UAAU,GAIX;QACC,MAAM,iBAAiB,GACrB,uBAAA,IAAI,sFAAW,MAAf,IAAI,EAAY,aAAa,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAEtD,IAAI,CAAC,iBAAiB,EAAE;YACtB,MAAM,IAAI,KAAK,CAAC,oCAAoC,UAAU,EAAE,CAAC,CAAC;SACnE;QAED,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,qBAAqB,CAAC,EACpB,aAAa,GAGd;QACC,OAAO,uBAAA,IAAI,sFAAW,MAAf,IAAI,EAAY,aAAa,CAAC,CAAC,QAAQ,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,2BAA2B,CAAC,EAChC,aAAa,GAGd;QACC,OAAO,MAAM,uBAAA,IAAI,sFAAW,MAAf,IAAI,EAAY,aAAa,CAAC,CAAC,2BAA2B,EAAE,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,mCAAmC,CAAC,EACxC,aAAa,GAGd;QACC,OAAO,MAAM,uBAAA,IAAI,sFAAW,MAAf,IAAI,EACf,aAAa,CACd,CAAC,mCAAmC,EAAE,CAAC;IAC1C,CAAC;CACF;AAnGD,kEAmGC;uTAxDY,aAA8B;IACvC,MAAM,MAAM,GAAG,uBAAA,IAAI,4CAAS,CAAC,GAAG,CAC9B,IAAA,oDAA2B,EAAC,aAAa,CAAC,CAC3C,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,IAAI,KAAK,CACb,yDAAyD,CAC1D,CAAC;KACH;IAED,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import type {\n  AccountsControllerGetAccountAction,\n  AccountsControllerGetAccountByAddressAction,\n  AccountsControllerListMultichainAccountsAction,\n} from '@metamask/accounts-controller';\nimport type { RestrictedMessenger } from '@metamask/base-controller';\nimport { SolScope, type EntropySourceId } from '@metamask/keyring-api';\nimport type {\n  KeyringControllerWithKeyringAction,\n  KeyringMetadata,\n  KeyringSelector,\n} from '@metamask/keyring-controller';\nimport { KeyringTypes } from '@metamask/keyring-controller';\nimport type {\n  EthKeyring,\n  InternalAccount,\n} from '@metamask/keyring-internal-api';\nimport { KeyringClient } from '@metamask/keyring-snap-client';\nimport type {\n  AccountProvider,\n  MultichainAccountWalletId,\n} from '@metamask/multichain-account-api';\nimport {\n  MultichainAccountAdapter,\n  MultichainAccountWalletAdapter,\n  toMultichainAccountWalletId,\n  type MultichainAccount,\n  type MultichainAccountWallet,\n} from '@metamask/multichain-account-api';\nimport type { HandleSnapRequest as SnapControllerHandleSnapRequestAction } from '@metamask/snaps-controllers';\nimport type { SnapId } from '@metamask/snaps-sdk';\nimport { HandlerType } from '@metamask/snaps-utils';\nimport type { Json, JsonRpcRequest } from '@metamask/utils';\n\nimport { EvmAccountProvider } from './providers/EvmAccountProvider';\nimport { SolAccountProvider } from './providers/SolAccountProvider';\n\n/**\n * All actions that {@link MultichainAccountController} registers so that other\n * modules can call them.\n */\nexport type MultichainAccountControllerActions = never;\n/**\n * All events that {@link MultichainAccountController} publishes so that other modules\n * can subscribe to them.\n */\nexport type MultichainAccountControllerEvents = never;\n\n/**\n * All actions registered by other modules that {@link MultichainAccountController}\n * calls.\n */\nexport type AllowedActions =\n  | AccountsControllerListMultichainAccountsAction\n  | AccountsControllerGetAccountAction\n  | AccountsControllerGetAccountByAddressAction\n  | SnapControllerHandleSnapRequestAction\n  | KeyringControllerWithKeyringAction;\n\n/**\n * All events published by other modules that {@link MultichainAccountController}\n * subscribes to.\n */\nexport type AllowedEvents = never;\n\n/**\n * The messenger restricted to actions and events that\n * {@link MultichainAccountController} needs to access.\n */\nexport type MultichainAccountControllerMessenger = RestrictedMessenger<\n  'MultichainAccountController',\n  MultichainAccountControllerActions | AllowedActions,\n  MultichainAccountControllerEvents | AllowedEvents,\n  AllowedActions['type'],\n  AllowedEvents['type']\n>;\n\n/**\n * The options that {@link MultichainAccountController} takes.\n */\ntype MultichainAccountControllerOptions = {\n  messenger: MultichainAccountControllerMessenger;\n};\n\n/**\n * Stateless controller to expose multichain accounts capabilities.\n */\nexport class MultichainAccountController {\n  readonly #messenger: MultichainAccountControllerMessenger;\n\n  readonly #providers: AccountProvider[];\n\n  readonly #wallets: Map<MultichainAccountWalletId, MultichainAccountWallet>;\n\n  /**\n   * Constructs a new MultichainAccountController.\n   *\n   * @param options - The options.\n   * @param options.messenger - The messenger suited to this\n   * MultichainAccountController.\n   */\n  constructor({ messenger }: MultichainAccountControllerOptions) {\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    // Gather all entropy sources first.\n    const entropySources = new Set<EntropySourceId>();\n    for (const provider of this.#providers) {\n      for (const entropySource of provider.getEntropySources()) {\n        entropySources.add(entropySource);\n      }\n    }\n\n    for (const entropySource of entropySources) {\n      // This will automatically create all multichain accounts for that wallet (based\n      // on the accounts owned by each account providers).\n      const wallet = new MultichainAccountWalletAdapter({\n        entropySource,\n        providers: this.#providers,\n      });\n\n      this.#wallets.set(wallet.id, wallet);\n    }\n  }\n\n  #getWallet(entropySource: EntropySourceId): MultichainAccountWallet {\n    const wallet = this.#wallets.get(\n      toMultichainAccountWalletId(entropySource),\n    );\n\n    if (!wallet) {\n      throw new Error(\n        'Unknown wallet, not wallet matching this entropy source',\n      );\n    }\n\n    return wallet;\n  }\n\n  getMultichainAccount({\n    entropySource,\n    groupIndex,\n  }: {\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }): MultichainAccount {\n    const multichainAccount =\n      this.#getWallet(entropySource).accounts[groupIndex];\n\n    if (!multichainAccount) {\n      throw new Error(`No multichain account for index: ${groupIndex}`);\n    }\n\n    return multichainAccount;\n  }\n\n  getMultichainAccounts({\n    entropySource,\n  }: {\n    entropySource: EntropySourceId;\n  }): MultichainAccount[] {\n    return this.#getWallet(entropySource).accounts;\n  }\n\n  async createNextMultichainAccount({\n    entropySource,\n  }: {\n    entropySource: EntropySourceId;\n  }): Promise<MultichainAccount> {\n    return await this.#getWallet(entropySource).createNextMultichainAccount();\n  }\n\n  async discoverAndCreateMultichainAccounts({\n    entropySource,\n  }: {\n    entropySource: EntropySourceId;\n  }): Promise<MultichainAccount[]> {\n    return await this.#getWallet(\n      entropySource,\n    ).discoverAndCreateMultichainAccounts();\n  }\n}\n"]}

package/dist/MultichainAccountController.d.cts

@@ -0,0 +1,66 @@
+import type { AccountsControllerGetAccountAction, AccountsControllerGetAccountByAddressAction, AccountsControllerListMultichainAccountsAction } from "@metamask/accounts-controller";
+import type { RestrictedMessenger } from "@metamask/base-controller";
+import { type EntropySourceId } from "@metamask/keyring-api";
+import type { KeyringControllerWithKeyringAction } from "@metamask/keyring-controller";
+import { type MultichainAccount } from "@metamask/multichain-account-api";
+import type { HandleSnapRequest as SnapControllerHandleSnapRequestAction } from "@metamask/snaps-controllers";
+/**
+ * All actions that {@link MultichainAccountController} registers so that other
+ * modules can call them.
+ */
+export type MultichainAccountControllerActions = never;
+/**
+ * All events that {@link MultichainAccountController} publishes so that other modules
+ * can subscribe to them.
+ */
+export type MultichainAccountControllerEvents = never;
+/**
+ * All actions registered by other modules that {@link MultichainAccountController}
+ * calls.
+ */
+export type AllowedActions = AccountsControllerListMultichainAccountsAction | AccountsControllerGetAccountAction | AccountsControllerGetAccountByAddressAction | SnapControllerHandleSnapRequestAction | KeyringControllerWithKeyringAction;
+/**
+ * All events published by other modules that {@link MultichainAccountController}
+ * subscribes to.
+ */
+export type AllowedEvents = never;
+/**
+ * The messenger restricted to actions and events that
+ * {@link MultichainAccountController} needs to access.
+ */
+export type MultichainAccountControllerMessenger = RestrictedMessenger<'MultichainAccountController', MultichainAccountControllerActions | AllowedActions, MultichainAccountControllerEvents | AllowedEvents, AllowedActions['type'], AllowedEvents['type']>;
+/**
+ * The options that {@link MultichainAccountController} takes.
+ */
+type MultichainAccountControllerOptions = {
+    messenger: MultichainAccountControllerMessenger;
+};
+/**
+ * Stateless controller to expose multichain accounts capabilities.
+ */
+export declare class MultichainAccountController {
+    #private;
+    /**
+     * Constructs a new MultichainAccountController.
+     *
+     * @param options - The options.
+     * @param options.messenger - The messenger suited to this
+     * MultichainAccountController.
+     */
+    constructor({ messenger }: MultichainAccountControllerOptions);
+    getMultichainAccount({ entropySource, groupIndex, }: {
+        entropySource: EntropySourceId;
+        groupIndex: number;
+    }): MultichainAccount;
+    getMultichainAccounts({ entropySource, }: {
+        entropySource: EntropySourceId;
+    }): MultichainAccount[];
+    createNextMultichainAccount({ entropySource, }: {
+        entropySource: EntropySourceId;
+    }): Promise<MultichainAccount>;
+    discoverAndCreateMultichainAccounts({ entropySource, }: {
+        entropySource: EntropySourceId;
+    }): Promise<MultichainAccount[]>;
+}
+export {};
+//# sourceMappingURL=MultichainAccountController.d.cts.map

package/dist/MultichainAccountController.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainAccountController.d.cts","sourceRoot":"","sources":["../src/MultichainAccountController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kCAAkC,EAClC,2CAA2C,EAC3C,8CAA8C,EAC/C,sCAAsC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,kCAAkC;AACrE,OAAO,EAAY,KAAK,eAAe,EAAE,8BAA8B;AACvE,OAAO,KAAK,EACV,kCAAkC,EAGnC,qCAAqC;AAWtC,OAAO,EAIL,KAAK,iBAAiB,EAEvB,yCAAyC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,IAAI,qCAAqC,EAAE,oCAAoC;AAQ9G;;;GAGG;AACH,MAAM,MAAM,kCAAkC,GAAG,KAAK,CAAC;AACvD;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,8CAA8C,GAC9C,kCAAkC,GAClC,2CAA2C,GAC3C,qCAAqC,GACrC,kCAAkC,CAAC;AAEvC;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC;AAElC;;;GAGG;AACH,MAAM,MAAM,oCAAoC,GAAG,mBAAmB,CACpE,6BAA6B,EAC7B,kCAAkC,GAAG,cAAc,EACnD,iCAAiC,GAAG,aAAa,EACjD,cAAc,CAAC,MAAM,CAAC,EACtB,aAAa,CAAC,MAAM,CAAC,CACtB,CAAC;AAEF;;GAEG;AACH,KAAK,kCAAkC,GAAG;IACxC,SAAS,EAAE,oCAAoC,CAAC;CACjD,CAAC;AAEF;;GAEG;AACH,qBAAa,2BAA2B;;IAOtC;;;;;;OAMG;gBACS,EAAE,SAAS,EAAE,EAAE,kCAAkC;IA2C7D,oBAAoB,CAAC,EACnB,aAAa,EACb,UAAU,GACX,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,iBAAiB;IAWrB,qBAAqB,CAAC,EACpB,aAAa,GACd,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;KAChC,GAAG,iBAAiB,EAAE;IAIjB,2BAA2B,CAAC,EAChC,aAAa,GACd,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;KAChC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIxB,mCAAmC,CAAC,EACxC,aAAa,GACd,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;KAChC,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAKjC"}

package/dist/MultichainAccountController.d.mts

@@ -0,0 +1,66 @@
+import type { AccountsControllerGetAccountAction, AccountsControllerGetAccountByAddressAction, AccountsControllerListMultichainAccountsAction } from "@metamask/accounts-controller";
+import type { RestrictedMessenger } from "@metamask/base-controller";
+import { type EntropySourceId } from "@metamask/keyring-api";
+import type { KeyringControllerWithKeyringAction } from "@metamask/keyring-controller";
+import { type MultichainAccount } from "@metamask/multichain-account-api";
+import type { HandleSnapRequest as SnapControllerHandleSnapRequestAction } from "@metamask/snaps-controllers";
+/**
+ * All actions that {@link MultichainAccountController} registers so that other
+ * modules can call them.
+ */
+export type MultichainAccountControllerActions = never;
+/**
+ * All events that {@link MultichainAccountController} publishes so that other modules
+ * can subscribe to them.
+ */
+export type MultichainAccountControllerEvents = never;
+/**
+ * All actions registered by other modules that {@link MultichainAccountController}
+ * calls.
+ */
+export type AllowedActions = AccountsControllerListMultichainAccountsAction | AccountsControllerGetAccountAction | AccountsControllerGetAccountByAddressAction | SnapControllerHandleSnapRequestAction | KeyringControllerWithKeyringAction;
+/**
+ * All events published by other modules that {@link MultichainAccountController}
+ * subscribes to.
+ */
+export type AllowedEvents = never;
+/**
+ * The messenger restricted to actions and events that
+ * {@link MultichainAccountController} needs to access.
+ */
+export type MultichainAccountControllerMessenger = RestrictedMessenger<'MultichainAccountController', MultichainAccountControllerActions | AllowedActions, MultichainAccountControllerEvents | AllowedEvents, AllowedActions['type'], AllowedEvents['type']>;
+/**
+ * The options that {@link MultichainAccountController} takes.
+ */
+type MultichainAccountControllerOptions = {
+    messenger: MultichainAccountControllerMessenger;
+};
+/**
+ * Stateless controller to expose multichain accounts capabilities.
+ */
+export declare class MultichainAccountController {
+    #private;
+    /**
+     * Constructs a new MultichainAccountController.
+     *
+     * @param options - The options.
+     * @param options.messenger - The messenger suited to this
+     * MultichainAccountController.
+     */
+    constructor({ messenger }: MultichainAccountControllerOptions);
+    getMultichainAccount({ entropySource, groupIndex, }: {
+        entropySource: EntropySourceId;
+        groupIndex: number;
+    }): MultichainAccount;
+    getMultichainAccounts({ entropySource, }: {
+        entropySource: EntropySourceId;
+    }): MultichainAccount[];
+    createNextMultichainAccount({ entropySource, }: {
+        entropySource: EntropySourceId;
+    }): Promise<MultichainAccount>;
+    discoverAndCreateMultichainAccounts({ entropySource, }: {
+        entropySource: EntropySourceId;
+    }): Promise<MultichainAccount[]>;
+}
+export {};
+//# sourceMappingURL=MultichainAccountController.d.mts.map

package/dist/MultichainAccountController.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainAccountController.d.mts","sourceRoot":"","sources":["../src/MultichainAccountController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kCAAkC,EAClC,2CAA2C,EAC3C,8CAA8C,EAC/C,sCAAsC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,kCAAkC;AACrE,OAAO,EAAY,KAAK,eAAe,EAAE,8BAA8B;AACvE,OAAO,KAAK,EACV,kCAAkC,EAGnC,qCAAqC;AAWtC,OAAO,EAIL,KAAK,iBAAiB,EAEvB,yCAAyC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,IAAI,qCAAqC,EAAE,oCAAoC;AAQ9G;;;GAGG;AACH,MAAM,MAAM,kCAAkC,GAAG,KAAK,CAAC;AACvD;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,8CAA8C,GAC9C,kCAAkC,GAClC,2CAA2C,GAC3C,qCAAqC,GACrC,kCAAkC,CAAC;AAEvC;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC;AAElC;;;GAGG;AACH,MAAM,MAAM,oCAAoC,GAAG,mBAAmB,CACpE,6BAA6B,EAC7B,kCAAkC,GAAG,cAAc,EACnD,iCAAiC,GAAG,aAAa,EACjD,cAAc,CAAC,MAAM,CAAC,EACtB,aAAa,CAAC,MAAM,CAAC,CACtB,CAAC;AAEF;;GAEG;AACH,KAAK,kCAAkC,GAAG;IACxC,SAAS,EAAE,oCAAoC,CAAC;CACjD,CAAC;AAEF;;GAEG;AACH,qBAAa,2BAA2B;;IAOtC;;;;;;OAMG;gBACS,EAAE,SAAS,EAAE,EAAE,kCAAkC;IA2C7D,oBAAoB,CAAC,EACnB,aAAa,EACb,UAAU,GACX,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,iBAAiB;IAWrB,qBAAqB,CAAC,EACpB,aAAa,GACd,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;KAChC,GAAG,iBAAiB,EAAE;IAIjB,2BAA2B,CAAC,EAChC,aAAa,GACd,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;KAChC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIxB,mCAAmC,CAAC,EACxC,aAAa,GACd,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;KAChC,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAKjC"}

package/dist/MultichainAccountController.mjs

@@ -0,0 +1,84 @@
+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 _MultichainAccountController_instances, _MultichainAccountController_messenger, _MultichainAccountController_providers, _MultichainAccountController_wallets, _MultichainAccountController_getWallet;
+import { SolScope } from "@metamask/keyring-api";
+import { KeyringTypes } from "@metamask/keyring-controller";
+import { KeyringClient } from "@metamask/keyring-snap-client";
+import { MultichainAccountAdapter, MultichainAccountWalletAdapter, toMultichainAccountWalletId } from "@metamask/multichain-account-api";
+import { HandlerType } from "@metamask/snaps-utils";
+import { EvmAccountProvider } from "./providers/EvmAccountProvider.mjs";
+import { SolAccountProvider } from "./providers/SolAccountProvider.mjs";
+/**
+ * Stateless controller to expose multichain accounts capabilities.
+ */
+export class MultichainAccountController {
+    /**
+     * Constructs a new MultichainAccountController.
+     *
+     * @param options - The options.
+     * @param options.messenger - The messenger suited to this
+     * MultichainAccountController.
+     */
+    constructor({ messenger }) {
+        _MultichainAccountController_instances.add(this);
+        _MultichainAccountController_messenger.set(this, void 0);
+        _MultichainAccountController_providers.set(this, void 0);
+        _MultichainAccountController_wallets.set(this, void 0);
+        __classPrivateFieldSet(this, _MultichainAccountController_messenger, messenger, "f");
+        __classPrivateFieldSet(this, _MultichainAccountController_wallets, new Map(), "f");
+        // TODO: Rely on keyring capabilities once the keyring API is used by all keyrings.
+        __classPrivateFieldSet(this, _MultichainAccountController_providers, [
+            new EvmAccountProvider(__classPrivateFieldGet(this, _MultichainAccountController_messenger, "f")),
+            new SolAccountProvider(__classPrivateFieldGet(this, _MultichainAccountController_messenger, "f")),
+        ], "f");
+        // Gather all entropy sources first.
+        const entropySources = new Set();
+        for (const provider of __classPrivateFieldGet(this, _MultichainAccountController_providers, "f")) {
+            for (const entropySource of provider.getEntropySources()) {
+                entropySources.add(entropySource);
+            }
+        }
+        for (const entropySource of entropySources) {
+            // This will automatically create all multichain accounts for that wallet (based
+            // on the accounts owned by each account providers).
+            const wallet = new MultichainAccountWalletAdapter({
+                entropySource,
+                providers: __classPrivateFieldGet(this, _MultichainAccountController_providers, "f"),
+            });
+            __classPrivateFieldGet(this, _MultichainAccountController_wallets, "f").set(wallet.id, wallet);
+        }
+    }
+    getMultichainAccount({ entropySource, groupIndex, }) {
+        const multichainAccount = __classPrivateFieldGet(this, _MultichainAccountController_instances, "m", _MultichainAccountController_getWallet).call(this, entropySource).accounts[groupIndex];
+        if (!multichainAccount) {
+            throw new Error(`No multichain account for index: ${groupIndex}`);
+        }
+        return multichainAccount;
+    }
+    getMultichainAccounts({ entropySource, }) {
+        return __classPrivateFieldGet(this, _MultichainAccountController_instances, "m", _MultichainAccountController_getWallet).call(this, entropySource).accounts;
+    }
+    async createNextMultichainAccount({ entropySource, }) {
+        return await __classPrivateFieldGet(this, _MultichainAccountController_instances, "m", _MultichainAccountController_getWallet).call(this, entropySource).createNextMultichainAccount();
+    }
+    async discoverAndCreateMultichainAccounts({ entropySource, }) {
+        return await __classPrivateFieldGet(this, _MultichainAccountController_instances, "m", _MultichainAccountController_getWallet).call(this, entropySource).discoverAndCreateMultichainAccounts();
+    }
+}
+_MultichainAccountController_messenger = new WeakMap(), _MultichainAccountController_providers = new WeakMap(), _MultichainAccountController_wallets = new WeakMap(), _MultichainAccountController_instances = new WeakSet(), _MultichainAccountController_getWallet = function _MultichainAccountController_getWallet(entropySource) {
+    const wallet = __classPrivateFieldGet(this, _MultichainAccountController_wallets, "f").get(toMultichainAccountWalletId(entropySource));
+    if (!wallet) {
+        throw new Error('Unknown wallet, not wallet matching this entropy source');
+    }
+    return wallet;
+};
+//# sourceMappingURL=MultichainAccountController.mjs.map

package/dist/MultichainAccountController.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainAccountController.mjs","sourceRoot":"","sources":["../src/MultichainAccountController.ts"],"names":[],"mappings":";;;;;;;;;;;;AAMA,OAAO,EAAE,QAAQ,EAAwB,8BAA8B;AAMvE,OAAO,EAAE,YAAY,EAAE,qCAAqC;AAK5D,OAAO,EAAE,aAAa,EAAE,sCAAsC;AAK9D,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,2BAA2B,EAG5B,yCAAyC;AAG1C,OAAO,EAAE,WAAW,EAAE,8BAA8B;AAGpD,OAAO,EAAE,kBAAkB,EAAE,2CAAuC;AACpE,OAAO,EAAE,kBAAkB,EAAE,2CAAuC;AAiDpE;;GAEG;AACH,MAAM,OAAO,2BAA2B;IAOtC;;;;;;OAMG;IACH,YAAY,EAAE,SAAS,EAAsC;;QAbpD,yDAAiD;QAEjD,yDAA8B;QAE9B,uDAAkE;QAUzE,uBAAA,IAAI,0CAAc,SAAS,MAAA,CAAC;QAC5B,uBAAA,IAAI,wCAAY,IAAI,GAAG,EAAE,MAAA,CAAC;QAC1B,mFAAmF;QACnF,uBAAA,IAAI,0CAAc;YAChB,IAAI,kBAAkB,CAAC,uBAAA,IAAI,8CAAW,CAAC;YACvC,IAAI,kBAAkB,CAAC,uBAAA,IAAI,8CAAW,CAAC;SACxC,MAAA,CAAC;QAEF,oCAAoC;QACpC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAmB,CAAC;QAClD,KAAK,MAAM,QAAQ,IAAI,uBAAA,IAAI,8CAAW,EAAE;YACtC,KAAK,MAAM,aAAa,IAAI,QAAQ,CAAC,iBAAiB,EAAE,EAAE;gBACxD,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;aACnC;SACF;QAED,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE;YAC1C,gFAAgF;YAChF,oDAAoD;YACpD,MAAM,MAAM,GAAG,IAAI,8BAA8B,CAAC;gBAChD,aAAa;gBACb,SAAS,EAAE,uBAAA,IAAI,8CAAW;aAC3B,CAAC,CAAC;YAEH,uBAAA,IAAI,4CAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;SACtC;IACH,CAAC;IAgBD,oBAAoB,CAAC,EACnB,aAAa,EACb,UAAU,GAIX;QACC,MAAM,iBAAiB,GACrB,uBAAA,IAAI,sFAAW,MAAf,IAAI,EAAY,aAAa,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAEtD,IAAI,CAAC,iBAAiB,EAAE;YACtB,MAAM,IAAI,KAAK,CAAC,oCAAoC,UAAU,EAAE,CAAC,CAAC;SACnE;QAED,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,qBAAqB,CAAC,EACpB,aAAa,GAGd;QACC,OAAO,uBAAA,IAAI,sFAAW,MAAf,IAAI,EAAY,aAAa,CAAC,CAAC,QAAQ,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,2BAA2B,CAAC,EAChC,aAAa,GAGd;QACC,OAAO,MAAM,uBAAA,IAAI,sFAAW,MAAf,IAAI,EAAY,aAAa,CAAC,CAAC,2BAA2B,EAAE,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,mCAAmC,CAAC,EACxC,aAAa,GAGd;QACC,OAAO,MAAM,uBAAA,IAAI,sFAAW,MAAf,IAAI,EACf,aAAa,CACd,CAAC,mCAAmC,EAAE,CAAC;IAC1C,CAAC;CACF;uTAxDY,aAA8B;IACvC,MAAM,MAAM,GAAG,uBAAA,IAAI,4CAAS,CAAC,GAAG,CAC9B,2BAA2B,CAAC,aAAa,CAAC,CAC3C,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,IAAI,KAAK,CACb,yDAAyD,CAC1D,CAAC;KACH;IAED,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import type {\n  AccountsControllerGetAccountAction,\n  AccountsControllerGetAccountByAddressAction,\n  AccountsControllerListMultichainAccountsAction,\n} from '@metamask/accounts-controller';\nimport type { RestrictedMessenger } from '@metamask/base-controller';\nimport { SolScope, type EntropySourceId } from '@metamask/keyring-api';\nimport type {\n  KeyringControllerWithKeyringAction,\n  KeyringMetadata,\n  KeyringSelector,\n} from '@metamask/keyring-controller';\nimport { KeyringTypes } from '@metamask/keyring-controller';\nimport type {\n  EthKeyring,\n  InternalAccount,\n} from '@metamask/keyring-internal-api';\nimport { KeyringClient } from '@metamask/keyring-snap-client';\nimport type {\n  AccountProvider,\n  MultichainAccountWalletId,\n} from '@metamask/multichain-account-api';\nimport {\n  MultichainAccountAdapter,\n  MultichainAccountWalletAdapter,\n  toMultichainAccountWalletId,\n  type MultichainAccount,\n  type MultichainAccountWallet,\n} from '@metamask/multichain-account-api';\nimport type { HandleSnapRequest as SnapControllerHandleSnapRequestAction } from '@metamask/snaps-controllers';\nimport type { SnapId } from '@metamask/snaps-sdk';\nimport { HandlerType } from '@metamask/snaps-utils';\nimport type { Json, JsonRpcRequest } from '@metamask/utils';\n\nimport { EvmAccountProvider } from './providers/EvmAccountProvider';\nimport { SolAccountProvider } from './providers/SolAccountProvider';\n\n/**\n * All actions that {@link MultichainAccountController} registers so that other\n * modules can call them.\n */\nexport type MultichainAccountControllerActions = never;\n/**\n * All events that {@link MultichainAccountController} publishes so that other modules\n * can subscribe to them.\n */\nexport type MultichainAccountControllerEvents = never;\n\n/**\n * All actions registered by other modules that {@link MultichainAccountController}\n * calls.\n */\nexport type AllowedActions =\n  | AccountsControllerListMultichainAccountsAction\n  | AccountsControllerGetAccountAction\n  | AccountsControllerGetAccountByAddressAction\n  | SnapControllerHandleSnapRequestAction\n  | KeyringControllerWithKeyringAction;\n\n/**\n * All events published by other modules that {@link MultichainAccountController}\n * subscribes to.\n */\nexport type AllowedEvents = never;\n\n/**\n * The messenger restricted to actions and events that\n * {@link MultichainAccountController} needs to access.\n */\nexport type MultichainAccountControllerMessenger = RestrictedMessenger<\n  'MultichainAccountController',\n  MultichainAccountControllerActions | AllowedActions,\n  MultichainAccountControllerEvents | AllowedEvents,\n  AllowedActions['type'],\n  AllowedEvents['type']\n>;\n\n/**\n * The options that {@link MultichainAccountController} takes.\n */\ntype MultichainAccountControllerOptions = {\n  messenger: MultichainAccountControllerMessenger;\n};\n\n/**\n * Stateless controller to expose multichain accounts capabilities.\n */\nexport class MultichainAccountController {\n  readonly #messenger: MultichainAccountControllerMessenger;\n\n  readonly #providers: AccountProvider[];\n\n  readonly #wallets: Map<MultichainAccountWalletId, MultichainAccountWallet>;\n\n  /**\n   * Constructs a new MultichainAccountController.\n   *\n   * @param options - The options.\n   * @param options.messenger - The messenger suited to this\n   * MultichainAccountController.\n   */\n  constructor({ messenger }: MultichainAccountControllerOptions) {\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    // Gather all entropy sources first.\n    const entropySources = new Set<EntropySourceId>();\n    for (const provider of this.#providers) {\n      for (const entropySource of provider.getEntropySources()) {\n        entropySources.add(entropySource);\n      }\n    }\n\n    for (const entropySource of entropySources) {\n      // This will automatically create all multichain accounts for that wallet (based\n      // on the accounts owned by each account providers).\n      const wallet = new MultichainAccountWalletAdapter({\n        entropySource,\n        providers: this.#providers,\n      });\n\n      this.#wallets.set(wallet.id, wallet);\n    }\n  }\n\n  #getWallet(entropySource: EntropySourceId): MultichainAccountWallet {\n    const wallet = this.#wallets.get(\n      toMultichainAccountWalletId(entropySource),\n    );\n\n    if (!wallet) {\n      throw new Error(\n        'Unknown wallet, not wallet matching this entropy source',\n      );\n    }\n\n    return wallet;\n  }\n\n  getMultichainAccount({\n    entropySource,\n    groupIndex,\n  }: {\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }): MultichainAccount {\n    const multichainAccount =\n      this.#getWallet(entropySource).accounts[groupIndex];\n\n    if (!multichainAccount) {\n      throw new Error(`No multichain account for index: ${groupIndex}`);\n    }\n\n    return multichainAccount;\n  }\n\n  getMultichainAccounts({\n    entropySource,\n  }: {\n    entropySource: EntropySourceId;\n  }): MultichainAccount[] {\n    return this.#getWallet(entropySource).accounts;\n  }\n\n  async createNextMultichainAccount({\n    entropySource,\n  }: {\n    entropySource: EntropySourceId;\n  }): Promise<MultichainAccount> {\n    return await this.#getWallet(entropySource).createNextMultichainAccount();\n  }\n\n  async discoverAndCreateMultichainAccounts({\n    entropySource,\n  }: {\n    entropySource: EntropySourceId;\n  }): Promise<MultichainAccount[]> {\n    return await this.#getWallet(\n      entropySource,\n    ).discoverAndCreateMultichainAccounts();\n  }\n}\n"]}

package/dist/index.cjs

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Example function that returns a greeting for the given name.
+ *
+ * @param name - The name to greet.
+ * @returns The greeting.
+ */
+function greeter(name) {
+    return `Hello, ${name}!`;
+}
+exports.default = greeter;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAAA;;;;;GAKG;AACH,SAAwB,OAAO,CAAC,IAAY;IAC1C,OAAO,UAAU,IAAI,GAAG,CAAC;AAC3B,CAAC;AAFD,0BAEC","sourcesContent":["/**\n * Example function that returns a greeting for the given name.\n *\n * @param name - The name to greet.\n * @returns The greeting.\n */\nexport default function greeter(name: string): string {\n  return `Hello, ${name}!`;\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,8 @@
+/**
+ * Example function that returns a greeting for the given name.
+ *
+ * @param name - The name to greet.
+ * @returns The greeting.
+ */
+export default function greeter(name: string): string;
+//# 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;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/index.d.mts

@@ -0,0 +1,8 @@
+/**
+ * Example function that returns a greeting for the given name.
+ *
+ * @param name - The name to greet.
+ * @returns The greeting.
+ */
+export default function greeter(name: string): string;
+//# 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;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/index.mjs

@@ -0,0 +1,10 @@
+/**
+ * Example function that returns a greeting for the given name.
+ *
+ * @param name - The name to greet.
+ * @returns The greeting.
+ */
+export default function greeter(name) {
+    return `Hello, ${name}!`;
+}
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,IAAY;IAC1C,OAAO,UAAU,IAAI,GAAG,CAAC;AAC3B,CAAC","sourcesContent":["/**\n * Example function that returns a greeting for the given name.\n *\n * @param name - The name to greet.\n * @returns The greeting.\n */\nexport default function greeter(name: string): string {\n  return `Hello, ${name}!`;\n}\n"]}

package/dist/providers/EvmAccountProvider.cjs

@@ -0,0 +1,99 @@
+"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 _EvmAccountProvider_instances, _EvmAccountProvider_messenger, _EvmAccountProvider_withKeyring, _EvmAccountProvider_getAccounts;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvmAccountProvider = void 0;
+const keyring_api_1 = require("@metamask/keyring-api");
+const keyring_controller_1 = require("@metamask/keyring-controller");
+// Max index used by discovery (until we move the proper discovery here).
+const MAX_GROUP_INDEX = 1;
+// eslint-disable-next-line jsdoc/require-jsdoc
+function assertInternalAccountExists(account) {
+    if (!account) {
+        throw new Error('Internal account does not exist');
+    }
+}
+class EvmAccountProvider {
+    constructor(messenger) {
+        _EvmAccountProvider_instances.add(this);
+        _EvmAccountProvider_messenger.set(this, void 0);
+        __classPrivateFieldSet(this, _EvmAccountProvider_messenger, messenger, "f");
+    }
+    async createAccounts({ entropySource, groupIndex, }) {
+        const addresses = await __classPrivateFieldGet(this, _EvmAccountProvider_instances, "m", _EvmAccountProvider_withKeyring).call(this, { id: entropySource }, async ({ keyring }) => {
+            const accounts = await keyring.getAccounts();
+            if (groupIndex <= accounts.length) {
+                // Nothing new to create, we just re-use the existing accounts here,
+                return [accounts[groupIndex]];
+            }
+            // Create new accounts (and returns their addresses).
+            return await keyring.addAccounts(groupIndex);
+        });
+        // Only use the account associated for that index.
+        const address = addresses[groupIndex];
+        const account = __classPrivateFieldGet(this, _EvmAccountProvider_messenger, "f").call('AccountsController:getAccountByAddress', address);
+        // We MUST have the associated internal account.
+        assertInternalAccountExists(account);
+        return [account];
+    }
+    async discoverAndCreateAccounts({ entropySource, groupIndex, }) {
+        // TODO: Move account discovery here (for EVM).
+        if (groupIndex < MAX_GROUP_INDEX) {
+            return await this.createAccounts({ entropySource, groupIndex });
+        }
+        return [];
+    }
+    getAccounts({ entropySource, groupIndex, }) {
+        return __classPrivateFieldGet(this, _EvmAccountProvider_instances, "m", _EvmAccountProvider_getAccounts).call(this).filter((account) => {
+            return (account.options.entropySource === entropySource &&
+                account.options.index === groupIndex);
+        });
+    }
+    getEntropySources() {
+        const entropySources = new Set();
+        for (const account of __classPrivateFieldGet(this, _EvmAccountProvider_instances, "m", _EvmAccountProvider_getAccounts).call(this)) {
+            entropySources.add(account.options.entropySource);
+        }
+        return Array.from(entropySources);
+    }
+}
+exports.EvmAccountProvider = EvmAccountProvider;
+_EvmAccountProvider_messenger = new WeakMap(), _EvmAccountProvider_instances = new WeakSet(), _EvmAccountProvider_withKeyring = async function _EvmAccountProvider_withKeyring(selector, operation) {
+    const result = await __classPrivateFieldGet(this, _EvmAccountProvider_messenger, "f").call('KeyringController:withKeyring', selector, ({ keyring, metadata }) => operation({
+        keyring: keyring,
+        metadata,
+    }));
+    return result;
+}, _EvmAccountProvider_getAccounts = function _EvmAccountProvider_getAccounts() {
+    return __classPrivateFieldGet(this, _EvmAccountProvider_messenger, "f")
+        .call('AccountsController:listMultichainAccounts')
+        .filter((account) => {
+        // We only check for EOA accounts for multichain accounts.
+        if (account.type !== keyring_api_1.EthAccountType.Eoa ||
+            account.metadata.keyring.type !== keyring_controller_1.KeyringTypes.hd) {
+            return false;
+        }
+        // TODO: Maybe use superstruct to validate the structure of HD account since they are not strongly-typed for now?
+        if (!account.options.entropySource) {
+            console.warn("! Found an HD account with no entropy source: account won't be associated to its wallet.");
+            return false;
+        }
+        // TODO: We need to add this index for native accounts too!
+        if (account.options.index === undefined) {
+            console.warn("! Found an HD account with no index: account won't be associated to its wallet.");
+            return false;
+        }
+        return true;
+    }); // Safe, we did check for options fields during filtering.
+};
+//# sourceMappingURL=EvmAccountProvider.cjs.map

package/dist/providers/EvmAccountProvider.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvmAccountProvider.cjs","sourceRoot":"","sources":["../../src/providers/EvmAccountProvider.ts"],"names":[],"mappings":"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","sourcesContent":["import { EthAccountType, type EntropySourceId } from '@metamask/keyring-api';\nimport {\n  KeyringTypes,\n  type KeyringMetadata,\n  type KeyringSelector,\n} from '@metamask/keyring-controller';\nimport type {\n  EthKeyring,\n  InternalAccount,\n} from '@metamask/keyring-internal-api';\nimport type { AccountProvider } from '@metamask/multichain-account-api';\nimport type { MultichainAccountControllerMessenger } from 'src/MultichainAccountController';\n\n// Max index used by discovery (until we move the proper discovery here).\nconst MAX_GROUP_INDEX = 1;\n\ntype EoaInternalAccount = InternalAccount & {\n  options: {\n    index: number;\n    entropySource: EntropySourceId;\n  };\n};\n\n// eslint-disable-next-line jsdoc/require-jsdoc\nfunction assertInternalAccountExists(\n  account: InternalAccount | undefined,\n): asserts account is InternalAccount {\n  if (!account) {\n    throw new Error('Internal account does not exist');\n  }\n}\n\nexport class EvmAccountProvider implements AccountProvider {\n  readonly #messenger: MultichainAccountControllerMessenger;\n\n  constructor(messenger: MultichainAccountControllerMessenger) {\n    this.#messenger = messenger;\n  }\n\n  async #withKeyring<\n    SelectedKeyring extends EthKeyring = EthKeyring,\n    CallbackResult = void,\n  >(\n    selector: KeyringSelector,\n    operation: ({\n      keyring,\n      metadata,\n    }: {\n      keyring: SelectedKeyring;\n      metadata: KeyringMetadata;\n    }) => Promise<CallbackResult>,\n  ): Promise<CallbackResult> {\n    const result = await this.#messenger.call(\n      'KeyringController:withKeyring',\n      selector,\n      ({ keyring, metadata }) =>\n        operation({\n          keyring: keyring as SelectedKeyring,\n          metadata,\n        }),\n    );\n\n    return result as CallbackResult;\n  }\n\n  async createAccounts({\n    entropySource,\n    groupIndex,\n  }: {\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }) {\n    const addresses = await this.#withKeyring(\n      { id: entropySource },\n      async ({ keyring }) => {\n        const accounts = await keyring.getAccounts();\n        if (groupIndex <= accounts.length) {\n          // Nothing new to create, we just re-use the existing accounts here,\n          return [accounts[groupIndex]];\n        }\n\n        // Create new accounts (and returns their addresses).\n        return await keyring.addAccounts(groupIndex);\n      },\n    );\n\n    // Only use the account associated for that index.\n    const address = addresses[groupIndex];\n    const account = this.#messenger.call(\n      'AccountsController:getAccountByAddress',\n      address,\n    );\n\n    // We MUST have the associated internal account.\n    assertInternalAccountExists(account);\n\n    return [account];\n  }\n\n  async discoverAndCreateAccounts({\n    entropySource,\n    groupIndex,\n  }: {\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }) {\n    // TODO: Move account discovery here (for EVM).\n\n    if (groupIndex < MAX_GROUP_INDEX) {\n      return await this.createAccounts({ entropySource, groupIndex });\n    }\n    return [];\n  }\n\n  #getAccounts(): EoaInternalAccount[] {\n    return this.#messenger\n      .call('AccountsController:listMultichainAccounts')\n      .filter((account) => {\n        // We only check for EOA accounts for multichain accounts.\n        if (\n          account.type !== EthAccountType.Eoa ||\n          account.metadata.keyring.type !== (KeyringTypes.hd as string)\n        ) {\n          return false;\n        }\n\n        // TODO: Maybe use superstruct to validate the structure of HD account since they are not strongly-typed for now?\n        if (!account.options.entropySource) {\n          console.warn(\n            \"! Found an HD account with no entropy source: account won't be associated to its wallet.\",\n          );\n          return false;\n        }\n\n        // TODO: We need to add this index for native accounts too!\n        if (account.options.index === undefined) {\n          console.warn(\n            \"! Found an HD account with no index: account won't be associated to its wallet.\",\n          );\n          return false;\n        }\n\n        return true;\n      }) as EoaInternalAccount[]; // Safe, we did check for options fields during filtering.\n  }\n\n  getAccounts({\n    entropySource,\n    groupIndex,\n  }: {\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }): InternalAccount[] {\n    return this.#getAccounts().filter((account) => {\n      return (\n        account.options.entropySource === entropySource &&\n        account.options.index === groupIndex\n      );\n    });\n  }\n\n  getEntropySources(): EntropySourceId[] {\n    const entropySources = new Set<EntropySourceId>();\n\n    for (const account of this.#getAccounts()) {\n      entropySources.add(account.options.entropySource);\n    }\n\n    return Array.from(entropySources);\n  }\n}\n"]}