@metamask-previews/multichain-account-service 4.1.0-preview-a9886279 → 5.0.0-preview-6a568504

package/dist/MultichainAccountWallet.cjs

@@ -18,7 +18,7 @@ const utils_1 = require("@metamask/utils");
 const async_mutex_1 = require("async-mutex");
 const logger_1 = require("./logger.cjs");
 const MultichainAccountGroup_1 = require("./MultichainAccountGroup.cjs");
-const providers_1 = require("./providers/index.cjs");
+const EvmAccountProvider_1 = require("./providers/EvmAccountProvider.cjs");
 const utils_2 = require("./utils.cjs");
 /**
  * A multichain account wallet that holds multiple multichain accounts (one multichain account per
@@ -34,7 +34,6 @@ class MultichainAccountWallet {
         _MultichainAccountWallet_accountGroups.set(this, void 0);
         _MultichainAccountWallet_messenger.set(this, void 0);
         _MultichainAccountWallet_log.set(this, void 0);
-        // eslint-disable-next-line @typescript-eslint/prefer-readonly
         _MultichainAccountWallet_initialized.set(this, false);
         _MultichainAccountWallet_status.set(this, void 0);
         __classPrivateFieldSet(this, _MultichainAccountWallet_id, (0, account_api_1.toMultichainAccountWalletId)(entropySource), "f");
@@ -45,58 +44,32 @@ class MultichainAccountWallet {
         __classPrivateFieldSet(this, _MultichainAccountWallet_log, (0, logger_1.createModuleLogger)(logger_1.projectLogger, `[${__classPrivateFieldGet(this, _MultichainAccountWallet_id, "f")}]`), "f");
         // Initial synchronization (don't emit events during initialization).
         __classPrivateFieldSet(this, _MultichainAccountWallet_status, 'uninitialized', "f");
-        this.sync();
-        __classPrivateFieldSet(this, _MultichainAccountWallet_initialized, true, "f");
-        __classPrivateFieldSet(this, _MultichainAccountWallet_status, 'ready', "f");
     }
     /**
-     * Force wallet synchronization.
+     * Initialize the wallet and construct the internal representation of multichain account groups.
      *
-     * This can be used if account providers got new accounts that the wallet
-     * doesn't know about.
+     * @param walletState - The wallet state.
      */
-    sync() {
-        __classPrivateFieldGet(this, _MultichainAccountWallet_log, "f").call(this, 'Synchronizing with account providers...');
-        for (const provider of __classPrivateFieldGet(this, _MultichainAccountWallet_providers, "f")) {
-            for (const account of provider.getAccounts()) {
-                const { entropy } = account.options;
-                // Filter for this wallet only.
-                if (entropy.id !== this.entropySource) {
-                    continue;
-                }
-                // This multichain account might exists already.
-                let multichainAccount = __classPrivateFieldGet(this, _MultichainAccountWallet_accountGroups, "f").get(entropy.groupIndex);
-                if (!multichainAccount) {
-                    multichainAccount = new MultichainAccountGroup_1.MultichainAccountGroup({
-                        groupIndex: entropy.groupIndex,
-                        wallet: this,
-                        providers: __classPrivateFieldGet(this, _MultichainAccountWallet_providers, "f"),
-                        messenger: __classPrivateFieldGet(this, _MultichainAccountWallet_messenger, "f"),
-                    });
-                    // This existing multichain account group might differ from the
-                    // `createMultichainAccountGroup` behavior. When creating a new
-                    // group, we expect the providers to all succeed. But here, we're
-                    // just fetching the account lists from them, so this group might
-                    // not be "aligned" yet (e.g having a missing Solana account).
-                    //
-                    // Since "aligning" is an async operation, it would have to be run
-                    // after the first-sync.
-                    // TODO: Implement align mechanism to create "missing" accounts.
-                    __classPrivateFieldGet(this, _MultichainAccountWallet_log, "f").call(this, `Found a new group: [${multichainAccount.id}]`);
-                    __classPrivateFieldGet(this, _MultichainAccountWallet_accountGroups, "f").set(entropy.groupIndex, multichainAccount);
-                }
-            }
+    init(walletState) {
+        __classPrivateFieldGet(this, _MultichainAccountWallet_log, "f").call(this, 'Initializing wallet state...');
+        for (const [groupIndexString, groupState] of Object.entries(walletState)) {
+            // Have to convert to number because the state keys become strings when we construct the state object in the service
+            const groupIndex = Number(groupIndexString);
+            const group = new MultichainAccountGroup_1.MultichainAccountGroup({
+                groupIndex,
+                wallet: this,
+                providers: __classPrivateFieldGet(this, _MultichainAccountWallet_providers, "f"),
+                messenger: __classPrivateFieldGet(this, _MultichainAccountWallet_messenger, "f"),
+            });
+            __classPrivateFieldGet(this, _MultichainAccountWallet_log, "f").call(this, `Creating new group for index ${groupIndex}...`);
+            group.init(groupState);
+            __classPrivateFieldGet(this, _MultichainAccountWallet_accountGroups, "f").set(groupIndex, group);
         }
-        // Now force-sync all remaining multichain accounts.
-        for (const [groupIndex, multichainAccount,] of __classPrivateFieldGet(this, _MultichainAccountWallet_accountGroups, "f").entries()) {
-            multichainAccount.sync();
-            // Clean up old multichain accounts.
-            if (!multichainAccount.hasAccounts()) {
-                __classPrivateFieldGet(this, _MultichainAccountWallet_log, "f").call(this, `Deleting group: [${multichainAccount.id}]`);
-                __classPrivateFieldGet(this, _MultichainAccountWallet_accountGroups, "f").delete(groupIndex);
-            }
+        if (!__classPrivateFieldGet(this, _MultichainAccountWallet_initialized, "f")) {
+            __classPrivateFieldSet(this, _MultichainAccountWallet_initialized, true, "f");
+            __classPrivateFieldSet(this, _MultichainAccountWallet_status, 'ready', "f");
         }
-        __classPrivateFieldGet(this, _MultichainAccountWallet_log, "f").call(this, 'Synchronized');
+        __classPrivateFieldGet(this, _MultichainAccountWallet_log, "f").call(this, 'Finished initializing wallet state...');
     }
     /**
      * Gets the multichain account wallet ID.
@@ -210,9 +183,6 @@ class MultichainAccountWallet {
             }
             let group = this.getMultichainAccountGroup(groupIndex);
             if (group) {
-                // If the group already exists, we just `sync` it and returns the same
-                // reference.
-                group.sync();
                 __classPrivateFieldGet(this, _MultichainAccountWallet_log, "f").call(this, `Trying to re-create existing group: [${group.id}] (idempotent)`);
                 return group;
             }
@@ -220,23 +190,31 @@ class MultichainAccountWallet {
             // Extract the EVM provider from the list of providers.
             // We always await EVM account creation first.
             const [evmProvider, ...otherProviders] = __classPrivateFieldGet(this, _MultichainAccountWallet_providers, "f");
-            (0, utils_1.assert)(evmProvider instanceof providers_1.EvmAccountProvider, 'EVM account provider must be first');
-            try {
-                await evmProvider.createAccounts({
-                    entropySource: __classPrivateFieldGet(this, _MultichainAccountWallet_entropySource, "f"),
-                    groupIndex,
-                });
-            }
-            catch (error) {
-                const errorMessage = `Unable to create multichain account group for index: ${groupIndex} with provider "${evmProvider.getName()}". Error: ${error.message}`;
+            (0, utils_1.assert)(evmProvider instanceof EvmAccountProvider_1.EvmAccountProvider, 'EVM account provider must be first');
+            const evmAccounts = await evmProvider
+                .createAccounts({
+                entropySource: __classPrivateFieldGet(this, _MultichainAccountWallet_entropySource, "f"),
+                groupIndex,
+            })
+                .then((accounts) => accounts.map((account) => account.id))
+                .catch((error) => {
+                const errorMessage = `Unable to create some accounts for group index: ${groupIndex} with provider "${evmProvider.getName()}". Error: ${error.message}`;
+                console.warn(errorMessage);
                 __classPrivateFieldGet(this, _MultichainAccountWallet_log, "f").call(this, `${logger_1.ERROR_PREFIX} ${errorMessage}:`, error);
                 const sentryError = (0, utils_2.createSentryError)(`Unable to create account with provider "${evmProvider.getName()}"`, error, {
                     groupIndex,
                     provider: evmProvider.getName(),
                 });
                 __classPrivateFieldGet(this, _MultichainAccountWallet_messenger, "f").captureException?.(sentryError);
-                throw new Error(errorMessage);
-            }
+                throw error;
+            });
+            group = new MultichainAccountGroup_1.MultichainAccountGroup({
+                wallet: this,
+                providers: __classPrivateFieldGet(this, _MultichainAccountWallet_providers, "f"),
+                groupIndex,
+                messenger: __classPrivateFieldGet(this, _MultichainAccountWallet_messenger, "f"),
+            });
+            group.init({ [evmProvider.getName()]: evmAccounts });
             // We then create accounts with other providers (some being throttled if configured).
             // Depending on the options, we either await all providers or run them in background.
             if (options?.waitForAllProvidersToFinishCreatingAccounts) {
@@ -244,6 +222,7 @@ class MultichainAccountWallet {
                     groupIndex,
                     providers: otherProviders,
                     awaitAll: true,
+                    group,
                 });
             }
             else {
@@ -252,43 +231,11 @@ class MultichainAccountWallet {
                     groupIndex,
                     providers: otherProviders,
                     awaitAll: false,
+                    group,
                 });
             }
-            // --------------------------------------------------------------------------------
-            // READ THIS CAREFULLY:
-            //
-            // Since we're not "fully supporting multichain" for now, we still rely on single
-            // :accountCreated events to sync multichain account groups and wallets. Which means
-            // that even if of the provider fails, some accounts will still be created on some
-            // other providers and will become "available" on the `AccountsController`, like:
-            //
-            // 1. Creating a multichain account group for index 1
-            // 2. EvmAccountProvider.createAccounts returns the EVM account for index 1
-            //   * AccountsController WILL fire :accountCreated for this account
-            //   * This account WILL BE "available" on the AccountsController state
-            // 3. SolAccountProvider.createAccounts fails to create a Solana account for index 1
-            //   * AccountsController WON't fire :accountCreated for this account
-            //   * This account WON'T be "available" on the Account
-            // 4. MultichainAccountService will receive a :accountCreated for the EVM account from
-            // step 2 and will create a new multichain account group for index 1, but it won't
-            // receive any event for the Solana account of this group. Thus, this group won't be
-            // "aligned" (missing "blockchain account" on this group).
-            //
-            // --------------------------------------------------------------------------------
-            // Because of the :accountAdded automatic sync, we might already have created the
-            // group, so we first try to get it.
-            group = this.getMultichainAccountGroup(groupIndex);
-            if (!group) {
-                // If for some reason it's still not created, we're creating it explicitly now:
-                group = new MultichainAccountGroup_1.MultichainAccountGroup({
-                    wallet: this,
-                    providers: __classPrivateFieldGet(this, _MultichainAccountWallet_providers, "f"),
-                    groupIndex,
-                    messenger: __classPrivateFieldGet(this, _MultichainAccountWallet_messenger, "f"),
-                });
-            }
-            // Register the account to our internal map.
-            __classPrivateFieldGet(this, _MultichainAccountWallet_accountGroups, "f").set(groupIndex, group); // `group` cannot be undefined here.
+            // Register the account(s) to our internal map.
+            __classPrivateFieldGet(this, _MultichainAccountWallet_accountGroups, "f").set(groupIndex, group);
             __classPrivateFieldGet(this, _MultichainAccountWallet_log, "f").call(this, `New group created: [${group.id}]`);
             if (__classPrivateFieldGet(this, _MultichainAccountWallet_initialized, "f")) {
                 __classPrivateFieldGet(this, _MultichainAccountWallet_messenger, "f").publish('MultichainAccountService:multichainAccountGroupCreated', group);
@@ -344,6 +291,12 @@ class MultichainAccountWallet {
             // Start with the next available group index (so we can resume the discovery
             // from there).
             let maxGroupIndex = this.getNextGroupIndex();
+            const discoveredGroupsState = {};
+            const addDiscoveryResultToState = (result, providerName, groupIndex) => {
+                const accountIds = result.map((account) => account.id);
+                discoveredGroupsState[groupIndex] ?? (discoveredGroupsState[groupIndex] = {});
+                discoveredGroupsState[groupIndex][providerName] = accountIds;
+            };
             // One serialized loop per provider; all run concurrently
             const runProviderDiscovery = async (context) => {
                 const providerName = context.provider.getName();
@@ -377,6 +330,7 @@ class MultichainAccountWallet {
                     }
                     (0, logger_1.projectLogger)(message('**succeeded**', targetGroupIndex));
                     context.accounts = context.accounts.concat(accounts);
+                    addDiscoveryResultToState(accounts, providerName, targetGroupIndex);
                     const nextGroupIndex = targetGroupIndex + 1;
                     context.groupIndex = nextGroupIndex;
                     if (nextGroupIndex > maxGroupIndex) {
@@ -392,9 +346,18 @@ class MultichainAccountWallet {
             }));
             // Start discovery for each providers.
             await Promise.all(providerContexts.map(runProviderDiscovery));
-            // Sync the wallet after discovery to ensure that the newly added accounts are added into their groups.
-            // We can potentially remove this if we know that this race condition is not an issue in practice.
-            this.sync();
+            // Create discovered groups
+            for (const [groupIndexString, groupState] of Object.entries(discoveredGroupsState)) {
+                const groupIndex = Number(groupIndexString);
+                const group = new MultichainAccountGroup_1.MultichainAccountGroup({
+                    wallet: this,
+                    providers: __classPrivateFieldGet(this, _MultichainAccountWallet_providers, "f"),
+                    groupIndex,
+                    messenger: __classPrivateFieldGet(this, _MultichainAccountWallet_messenger, "f"),
+                });
+                group.init(groupState);
+                __classPrivateFieldGet(this, _MultichainAccountWallet_accountGroups, "f").set(groupIndex, group);
+            }
             // Align missing accounts from group. This is required to create missing account from non-discovered
             // indexes for some providers.
             await __classPrivateFieldGet(this, _MultichainAccountWallet_instances, "m", _MultichainAccountWallet_alignAccounts).call(this);
@@ -436,10 +399,11 @@ async function _MultichainAccountWallet_withLock(status, operation) {
  * @param options.groupIndex - The group index to create accounts for.
  * @param options.providers - The non‑EVM account providers.
  * @param options.awaitAll - Whether to wait for all providers to finish.
+ * @param options.group - The group object pertaining to the group index to create accounts for.
  * @throws If awaitAll is true and any provider fails to create accounts.
  * @returns A promise that resolves when done (if awaitAll is true) or immediately (if false).
  */
-async function _MultichainAccountWallet_createNonEvmAccounts({ groupIndex, providers, awaitAll, }) {
+async function _MultichainAccountWallet_createNonEvmAccounts({ groupIndex, providers, awaitAll, group, }) {
     if (awaitAll) {
         const tasks = providers.map((provider) => provider
             .createAccounts({
@@ -455,33 +419,54 @@ async function _MultichainAccountWallet_createNonEvmAccounts({ groupIndex, provi
             throw error;
         }));
         const results = await Promise.allSettled(tasks);
-        if (results.some((r) => r.status === 'rejected')) {
-            const errorMessage = (0, utils_2.toRejectedErrorMessage)(`Unable to create multichain account group for index: ${groupIndex}`, results);
-            __classPrivateFieldGet(this, _MultichainAccountWallet_log, "f").call(this, `${logger_1.WARNING_PREFIX} ${errorMessage}`);
-            console.warn(errorMessage);
-            throw new Error(errorMessage);
+        const providerFailures = results.reduce((acc, result, idx) => {
+            let newAcc = acc;
+            if (result.status === 'rejected') {
+                newAcc += `\n- ${providers[idx].getName()}: ${result.reason.message}`;
+            }
+            return newAcc;
+        }, '');
+        if (providerFailures.length) {
+            // We warn there's failures on some providers and thus misalignment, but we still create the group
+            const message = `Unable to create some accounts for group index: ${groupIndex}. Providers threw the following errors:${providerFailures}`;
+            console.warn(message);
+            __classPrivateFieldGet(this, _MultichainAccountWallet_log, "f").call(this, `${logger_1.WARNING_PREFIX} ${message}`);
         }
-        return;
+        // No need to fetch the accounts list from the AccountsController since we already have the account IDs to be used in the controller
+        const groupState = results.reduce((state, result, idx) => {
+            if (result.status === 'fulfilled') {
+                state[providers[idx].getName()] = result.value.map((account) => account.id);
+            }
+            return state;
+        }, {});
+        group.update(groupState);
     }
-    // Background mode: start tasks and log errors.
-    // Optional throttling is handled internally by each provider based on its config.
-    providers.forEach((provider) => {
-        // eslint-disable-next-line no-void
-        void provider
-            .createAccounts({
-            entropySource: __classPrivateFieldGet(this, _MultichainAccountWallet_entropySource, "f"),
-            groupIndex,
-        })
-            .catch((error) => {
-            const errorMessage = `Unable to create multichain account group for index: ${groupIndex} (background mode with provider "${provider.getName()}")`;
-            __classPrivateFieldGet(this, _MultichainAccountWallet_log, "f").call(this, `${logger_1.WARNING_PREFIX} ${errorMessage}:`, error);
-            const sentryError = (0, utils_2.createSentryError)(`Unable to create account with provider "${provider.getName()}"`, error, {
+    else {
+        // Create account with other providers in the background
+        providers.forEach((provider) => {
+            provider
+                .createAccounts({
+                entropySource: __classPrivateFieldGet(this, _MultichainAccountWallet_entropySource, "f"),
                 groupIndex,
-                provider: provider.getName(),
+            })
+                .then((accounts) => {
+                const accountIds = accounts.map((account) => account.id);
+                group.update({ [provider.getName()]: accountIds });
+                return group;
+            })
+                .catch((error) => {
+                // Log errors from background providers but don't fail the operation
+                const errorMessage = `Unable to create some accounts for group index: ${groupIndex} with provider "${provider.getName()}". Error: ${error.message}`;
+                console.warn(errorMessage);
+                __classPrivateFieldGet(this, _MultichainAccountWallet_log, "f").call(this, `${logger_1.WARNING_PREFIX} ${errorMessage}:`, error);
+                const sentryError = (0, utils_2.createSentryError)(`Unable to create account with provider "${provider.getName()}"`, error, {
+                    groupIndex,
+                    provider: provider.getName(),
+                });
+                __classPrivateFieldGet(this, _MultichainAccountWallet_messenger, "f").captureException?.(sentryError);
             });
-            __classPrivateFieldGet(this, _MultichainAccountWallet_messenger, "f").captureException?.(sentryError);
         });
-    });
+    }
 }, _MultichainAccountWallet_alignAccounts = 
 /**
  * Align all multichain account groups.

package/dist/MultichainAccountWallet.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"MultichainAccountWallet.cjs","sourceRoot":"","sources":["../src/MultichainAccountWallet.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AccountGroupId,\n  Bip44Account,\n  MultichainAccountWalletId,\n  MultichainAccountWallet as MultichainAccountWalletDefinition,\n  MultichainAccountWalletStatus,\n} from '@metamask/account-api';\nimport {\n  AccountWalletType,\n  getGroupIndexFromMultichainAccountGroupId,\n  isMultichainAccountGroupId,\n  toDefaultAccountGroupId,\n  toMultichainAccountWalletId,\n} from '@metamask/account-api';\nimport type { EntropySourceId, KeyringAccount } from '@metamask/keyring-api';\nimport { assert } from '@metamask/utils';\nimport { Mutex } from 'async-mutex';\n\nimport type { Logger } from './logger';\nimport {\n  createModuleLogger,\n  ERROR_PREFIX,\n  projectLogger as log,\n  WARNING_PREFIX,\n} from './logger';\nimport { MultichainAccountGroup } from './MultichainAccountGroup';\nimport { EvmAccountProvider } from './providers';\nimport type { Bip44AccountProvider } from './providers';\nimport type { MultichainAccountServiceMessenger } from './types';\nimport { createSentryError, toRejectedErrorMessage } from './utils';\n\n/**\n * The context for a provider discovery.\n */\ntype AccountProviderDiscoveryContext<\n  Account extends Bip44Account<KeyringAccount>,\n> = {\n  provider: Bip44AccountProvider<Account>;\n  stopped: boolean;\n  groupIndex: number;\n  accounts: Account[];\n};\n\n/**\n * A multichain account wallet that holds multiple multichain accounts (one multichain account per\n * group index).\n */\nexport class MultichainAccountWallet<\n  Account extends Bip44Account<KeyringAccount>,\n> implements MultichainAccountWalletDefinition<Account>\n{\n  readonly #lock = new Mutex();\n\n  readonly #id: MultichainAccountWalletId;\n\n  readonly #providers: Bip44AccountProvider<Account>[];\n\n  readonly #entropySource: EntropySourceId;\n\n  readonly #accountGroups: Map<number, MultichainAccountGroup<Account>>;\n\n  readonly #messenger: MultichainAccountServiceMessenger;\n\n  readonly #log: Logger;\n\n  // eslint-disable-next-line @typescript-eslint/prefer-readonly\n  #initialized = false;\n\n  #status: MultichainAccountWalletStatus;\n\n  constructor({\n    providers,\n    entropySource,\n    messenger,\n  }: {\n    providers: Bip44AccountProvider<Account>[];\n    entropySource: EntropySourceId;\n    messenger: MultichainAccountServiceMessenger;\n  }) {\n    this.#id = toMultichainAccountWalletId(entropySource);\n    this.#providers = providers;\n    this.#entropySource = entropySource;\n    this.#messenger = messenger;\n    this.#accountGroups = new Map();\n\n    this.#log = createModuleLogger(log, `[${this.#id}]`);\n\n    // Initial synchronization (don't emit events during initialization).\n    this.#status = 'uninitialized';\n    this.sync();\n    this.#initialized = true;\n    this.#status = 'ready';\n  }\n\n  /**\n   * Force wallet synchronization.\n   *\n   * This can be used if account providers got new accounts that the wallet\n   * doesn't know about.\n   */\n  sync(): void {\n    this.#log('Synchronizing with account providers...');\n    for (const provider of this.#providers) {\n      for (const account of provider.getAccounts()) {\n        const { entropy } = account.options;\n\n        // Filter for this wallet only.\n        if (entropy.id !== this.entropySource) {\n          continue;\n        }\n\n        // This multichain account might exists already.\n        let multichainAccount = this.#accountGroups.get(entropy.groupIndex);\n        if (!multichainAccount) {\n          multichainAccount = new MultichainAccountGroup<Account>({\n            groupIndex: entropy.groupIndex,\n            wallet: this,\n            providers: this.#providers,\n            messenger: this.#messenger,\n          });\n\n          // This existing multichain account group might differ from the\n          // `createMultichainAccountGroup` behavior. When creating a new\n          // group, we expect the providers to all succeed. But here, we're\n          // just fetching the account lists from them, so this group might\n          // not be \"aligned\" yet (e.g having a missing Solana account).\n          //\n          // Since \"aligning\" is an async operation, it would have to be run\n          // after the first-sync.\n          // TODO: Implement align mechanism to create \"missing\" accounts.\n\n          this.#log(`Found a new group: [${multichainAccount.id}]`);\n          this.#accountGroups.set(entropy.groupIndex, multichainAccount);\n        }\n      }\n    }\n\n    // Now force-sync all remaining multichain accounts.\n    for (const [\n      groupIndex,\n      multichainAccount,\n    ] of this.#accountGroups.entries()) {\n      multichainAccount.sync();\n\n      // Clean up old multichain accounts.\n      if (!multichainAccount.hasAccounts()) {\n        this.#log(`Deleting group: [${multichainAccount.id}]`);\n        this.#accountGroups.delete(groupIndex);\n      }\n    }\n\n    this.#log('Synchronized');\n  }\n\n  /**\n   * Gets the multichain account wallet ID.\n   *\n   * @returns The multichain account wallet ID.\n   */\n  get id(): MultichainAccountWalletId {\n    return this.#id;\n  }\n\n  /**\n   * Gets the multichain account wallet type, which is always {@link AccountWalletType.Entropy}.\n   *\n   * @returns The multichain account wallet type.\n   */\n  get type(): AccountWalletType.Entropy {\n    return AccountWalletType.Entropy;\n  }\n\n  /**\n   * Gets the multichain account wallet entropy source.\n   *\n   * @returns The multichain account wallet entropy source.\n   */\n  get entropySource(): EntropySourceId {\n    return this.#entropySource;\n  }\n\n  /**\n   * Gets the multichain account wallet current status.\n   *\n   * @returns The multichain account wallet current status.\n   */\n  get status(): MultichainAccountWalletStatus {\n    return this.#status;\n  }\n\n  /**\n   * Set the wallet status and run the associated operation callback.\n   *\n   * @param status - Wallet status associated with this operation.\n   * @param operation - Operation to run.\n   * @returns The operation's result.\n   * @throws {Error} If the wallet is already running a mutable operation.\n   */\n  async #withLock<Return>(\n    status: MultichainAccountWalletStatus,\n    operation: () => Promise<Return>,\n  ) {\n    const release = await this.#lock.acquire();\n    try {\n      this.#log(`Locking wallet with status \"${status}\"...`);\n      this.#status = status;\n      this.#messenger.publish(\n        'MultichainAccountService:walletStatusChange',\n        this.id,\n        this.#status,\n      );\n      return await operation();\n    } finally {\n      this.#status = 'ready';\n      this.#messenger.publish(\n        'MultichainAccountService:walletStatusChange',\n        this.id,\n        this.#status,\n      );\n      release();\n      this.#log(`Releasing wallet lock (was \"${status}\")`);\n    }\n  }\n\n  /**\n   * Create accounts with non‑EVM providers. Optional throttling is managed by each provider internally.\n   * When awaitAll is true, waits for all providers and throws if any failed.\n   * When false, starts work in background and logs errors without throwing.\n   *\n   * @param options - Method options.\n   * @param options.groupIndex - The group index to create accounts for.\n   * @param options.providers - The non‑EVM account providers.\n   * @param options.awaitAll - Whether to wait for all providers to finish.\n   * @throws If awaitAll is true and any provider fails to create accounts.\n   * @returns A promise that resolves when done (if awaitAll is true) or immediately (if false).\n   */\n  async #createNonEvmAccounts({\n    groupIndex,\n    providers,\n    awaitAll,\n  }: {\n    groupIndex: number;\n    providers: Bip44AccountProvider<Account>[];\n    awaitAll: boolean;\n  }): Promise<void> {\n    if (awaitAll) {\n      const tasks = providers.map((provider) =>\n        provider\n          .createAccounts({\n            entropySource: this.#entropySource,\n            groupIndex,\n          })\n          .catch((error) => {\n            const sentryError = createSentryError(\n              `Unable to create account with provider \"${provider.getName()}\"`,\n              error,\n              {\n                groupIndex,\n                provider: provider.getName(),\n              },\n            );\n            this.#messenger.captureException?.(sentryError);\n            throw error;\n          }),\n      );\n\n      const results = await Promise.allSettled(tasks);\n      if (results.some((r) => r.status === 'rejected')) {\n        const errorMessage = toRejectedErrorMessage(\n          `Unable to create multichain account group for index: ${groupIndex}`,\n          results,\n        );\n\n        this.#log(`${WARNING_PREFIX} ${errorMessage}`);\n        console.warn(errorMessage);\n        throw new Error(errorMessage);\n      }\n      return;\n    }\n\n    // Background mode: start tasks and log errors.\n    // Optional throttling is handled internally by each provider based on its config.\n    providers.forEach((provider) => {\n      // eslint-disable-next-line no-void\n      void provider\n        .createAccounts({\n          entropySource: this.#entropySource,\n          groupIndex,\n        })\n        .catch((error) => {\n          const errorMessage = `Unable to create multichain account group for index: ${groupIndex} (background mode with provider \"${provider.getName()}\")`;\n          this.#log(`${WARNING_PREFIX} ${errorMessage}:`, error);\n          const sentryError = createSentryError(\n            `Unable to create account with provider \"${provider.getName()}\"`,\n            error,\n            {\n              groupIndex,\n              provider: provider.getName(),\n            },\n          );\n          this.#messenger.captureException?.(sentryError);\n        });\n    });\n  }\n\n  /**\n   * Gets multichain account for a given ID.\n   * The default group ID will default to the multichain account with index 0.\n   *\n   * @param id - Account group ID.\n   * @returns Account group.\n   */\n  getAccountGroup(\n    id: AccountGroupId,\n  ): MultichainAccountGroup<Account> | undefined {\n    // We consider the \"default case\" to be mapped to index 0.\n    if (id === toDefaultAccountGroupId(this.id)) {\n      return this.#accountGroups.get(0);\n    }\n\n    // If it is not a valid ID, we cannot extract the group index\n    // from it, so we fail fast.\n    if (!isMultichainAccountGroupId(id)) {\n      return undefined;\n    }\n\n    const groupIndex = getGroupIndexFromMultichainAccountGroupId(id);\n    return this.#accountGroups.get(groupIndex);\n  }\n\n  /**\n   * Gets all multichain accounts. Similar to {@link MultichainAccountWallet.getMultichainAccountGroups}.\n   *\n   * @returns The multichain accounts.\n   */\n  getAccountGroups(): MultichainAccountGroup<Account>[] {\n    return this.getMultichainAccountGroups();\n  }\n\n  /**\n   * Gets multichain account group for a given index.\n   *\n   * @param groupIndex - Multichain account index.\n   * @returns The multichain account associated with the given index.\n   */\n  getMultichainAccountGroup(\n    groupIndex: number,\n  ): MultichainAccountGroup<Account> | undefined {\n    return this.#accountGroups.get(groupIndex);\n  }\n\n  /**\n   * Gets all multichain account groups.\n   *\n   * @returns The multichain accounts.\n   */\n  getMultichainAccountGroups(): MultichainAccountGroup<Account>[] {\n    return Array.from(this.#accountGroups.values()); // TODO: Prevent copy here.\n  }\n\n  /**\n   * Gets next group index for this wallet.\n   *\n   * @returns The next group index of this wallet.\n   */\n  getNextGroupIndex(): number {\n    // We do not check for gaps.\n    return (\n      Math.max(\n        -1, // So it will default to 0 if no groups.\n        ...this.#accountGroups.keys(),\n      ) + 1\n    );\n  }\n\n  /**\n   * Creates a multichain account group for a given group index.\n   *\n   * NOTE: This operation WILL lock the wallet's mutex.\n   *\n   * @param groupIndex - The group index to use.\n   * @param options - Options to configure the account creation.\n   * @param options.waitForAllProvidersToFinishCreatingAccounts - Whether to wait for all\n   * account providers to finish creating their accounts before returning. If `false`, only\n   * the EVM provider will be awaited, while all other providers will create their accounts\n   * in the background. Defaults to `false`.\n   * @throws If any of the account providers fails to create their accounts and\n   * the `waitForAllProvidersToFinishCreatingAccounts` option is set to `true`. If `false`,\n   * errors from non-EVM providers will be logged but ignored, and only errors from the\n   * EVM provider will be thrown.\n   * @returns The multichain account group for this group index.\n   */\n  async createMultichainAccountGroup(\n    groupIndex: number,\n    options: {\n      waitForAllProvidersToFinishCreatingAccounts?: boolean;\n    } = { waitForAllProvidersToFinishCreatingAccounts: false },\n  ): Promise<MultichainAccountGroup<Account>> {\n    return await this.#withLock('in-progress:create-accounts', async () => {\n      const nextGroupIndex = this.getNextGroupIndex();\n      if (groupIndex > nextGroupIndex) {\n        throw new Error(\n          `You cannot use a group index that is higher than the next available one: expected <=${nextGroupIndex}, got ${groupIndex}`,\n        );\n      }\n\n      let group = this.getMultichainAccountGroup(groupIndex);\n      if (group) {\n        // If the group already exists, we just `sync` it and returns the same\n        // reference.\n        group.sync();\n\n        this.#log(\n          `Trying to re-create existing group: [${group.id}] (idempotent)`,\n        );\n        return group;\n      }\n\n      this.#log(`Creating new group for index ${groupIndex}...`);\n\n      // Extract the EVM provider from the list of providers.\n      // We always await EVM account creation first.\n      const [evmProvider, ...otherProviders] = this.#providers;\n      assert(\n        evmProvider instanceof EvmAccountProvider,\n        'EVM account provider must be first',\n      );\n\n      try {\n        await evmProvider.createAccounts({\n          entropySource: this.#entropySource,\n          groupIndex,\n        });\n      } catch (error) {\n        const errorMessage = `Unable to create multichain account group for index: ${groupIndex} with provider \"${evmProvider.getName()}\". Error: ${(error as Error).message}`;\n        this.#log(`${ERROR_PREFIX} ${errorMessage}:`, error);\n        const sentryError = createSentryError(\n          `Unable to create account with provider \"${evmProvider.getName()}\"`,\n          error as Error,\n          {\n            groupIndex,\n            provider: evmProvider.getName(),\n          },\n        );\n        this.#messenger.captureException?.(sentryError);\n        throw new Error(errorMessage);\n      }\n\n      // We then create accounts with other providers (some being throttled if configured).\n      // Depending on the options, we either await all providers or run them in background.\n      if (options?.waitForAllProvidersToFinishCreatingAccounts) {\n        await this.#createNonEvmAccounts({\n          groupIndex,\n          providers: otherProviders,\n          awaitAll: true,\n        });\n      } else {\n        // eslint-disable-next-line no-void\n        void this.#createNonEvmAccounts({\n          groupIndex,\n          providers: otherProviders,\n          awaitAll: false,\n        });\n      }\n\n      // --------------------------------------------------------------------------------\n      // READ THIS CAREFULLY:\n      //\n      // Since we're not \"fully supporting multichain\" for now, we still rely on single\n      // :accountCreated events to sync multichain account groups and wallets. Which means\n      // that even if of the provider fails, some accounts will still be created on some\n      // other providers and will become \"available\" on the `AccountsController`, like:\n      //\n      // 1. Creating a multichain account group for index 1\n      // 2. EvmAccountProvider.createAccounts returns the EVM account for index 1\n      //   * AccountsController WILL fire :accountCreated for this account\n      //   * This account WILL BE \"available\" on the AccountsController state\n      // 3. SolAccountProvider.createAccounts fails to create a Solana account for index 1\n      //   * AccountsController WON't fire :accountCreated for this account\n      //   * This account WON'T be \"available\" on the Account\n      // 4. MultichainAccountService will receive a :accountCreated for the EVM account from\n      // step 2 and will create a new multichain account group for index 1, but it won't\n      // receive any event for the Solana account of this group. Thus, this group won't be\n      // \"aligned\" (missing \"blockchain account\" on this group).\n      //\n      // --------------------------------------------------------------------------------\n\n      // Because of the :accountAdded automatic sync, we might already have created the\n      // group, so we first try to get it.\n      group = this.getMultichainAccountGroup(groupIndex);\n      if (!group) {\n        // If for some reason it's still not created, we're creating it explicitly now:\n        group = new MultichainAccountGroup({\n          wallet: this,\n          providers: this.#providers,\n          groupIndex,\n          messenger: this.#messenger,\n        });\n      }\n\n      // Register the account to our internal map.\n      this.#accountGroups.set(groupIndex, group); // `group` cannot be undefined here.\n      this.#log(`New group created: [${group.id}]`);\n\n      if (this.#initialized) {\n        this.#messenger.publish(\n          'MultichainAccountService:multichainAccountGroupCreated',\n          group,\n        );\n      }\n\n      return group;\n    });\n  }\n\n  /**\n   * Creates the next multichain account group.\n   *\n   * @throws If any of the account providers fails to create their accounts.\n   * @returns The multichain account group for the next group index available.\n   */\n  async createNextMultichainAccountGroup(): Promise<\n    MultichainAccountGroup<Account>\n  > {\n    return this.createMultichainAccountGroup(this.getNextGroupIndex(), {\n      waitForAllProvidersToFinishCreatingAccounts: true,\n    });\n  }\n\n  /**\n   * Align all multichain account groups.\n   *\n   * NOTE: This operation WILL NOT lock the wallet's mutex.\n   */\n  async #alignAccounts(): Promise<void> {\n    const groups = this.getMultichainAccountGroups();\n    await Promise.all(groups.map((group) => group.alignAccounts()));\n  }\n\n  /**\n   * Align all accounts from each existing multichain account groups.\n   *\n   * NOTE: This operation WILL lock the wallet's mutex.\n   */\n  async alignAccounts(): Promise<void> {\n    await this.#withLock('in-progress:alignment', async () => {\n      await this.#alignAccounts();\n    });\n  }\n\n  /**\n   * Align a specific multichain account group.\n   *\n   * NOTE: This operation WILL lock the wallet's mutex.\n   *\n   * @param groupIndex - The group index to align.\n   */\n  async alignAccountsOf(groupIndex: number): Promise<void> {\n    await this.#withLock('in-progress:alignment', async () => {\n      const group = this.getMultichainAccountGroup(groupIndex);\n      if (group) {\n        await group.alignAccounts();\n      }\n    });\n  }\n\n  /**\n   * Discover and create accounts for all providers.\n   *\n   * NOTE: This operation WILL lock the wallet's mutex.\n   *\n   * @returns The discovered accounts for each provider.\n   */\n  async discoverAccounts(): Promise<Account[]> {\n    return this.#withLock('in-progress:discovery', async () => {\n      // Start with the next available group index (so we can resume the discovery\n      // from there).\n      let maxGroupIndex = this.getNextGroupIndex();\n\n      // One serialized loop per provider; all run concurrently\n      const runProviderDiscovery = async (\n        context: AccountProviderDiscoveryContext<Account>,\n      ) => {\n        const providerName = context.provider.getName();\n        const message = (stepName: string, groupIndex: number) =>\n          `[${providerName}] Discovery ${stepName} for group index: ${groupIndex}`;\n\n        while (!context.stopped) {\n          // Fast‑forward to current high‑water mark\n          const targetGroupIndex = Math.max(context.groupIndex, maxGroupIndex);\n\n          log(message('started', targetGroupIndex));\n\n          let accounts: Account[] = [];\n          try {\n            accounts = await context.provider.discoverAccounts({\n              entropySource: this.#entropySource,\n              groupIndex: targetGroupIndex,\n            });\n          } catch (error) {\n            context.stopped = true;\n            console.error(error);\n            log(\n              message(\n                `failed (with: \"${(error as Error).message}\")`,\n                targetGroupIndex,\n              ),\n              error,\n            );\n            const sentryError = createSentryError(\n              'Unable to discover accounts',\n              error as Error,\n              {\n                provider: providerName,\n                groupIndex: targetGroupIndex,\n              },\n            );\n            this.#messenger.captureException?.(sentryError);\n            break;\n          }\n\n          if (!accounts.length) {\n            log(\n              message('stopped (no accounts got discovered)', targetGroupIndex),\n            );\n            context.stopped = true;\n            break;\n          }\n\n          log(message('**succeeded**', targetGroupIndex));\n\n          context.accounts = context.accounts.concat(accounts);\n\n          const nextGroupIndex = targetGroupIndex + 1;\n          context.groupIndex = nextGroupIndex;\n\n          if (nextGroupIndex > maxGroupIndex) {\n            maxGroupIndex = nextGroupIndex;\n          }\n        }\n      };\n\n      const providerContexts: AccountProviderDiscoveryContext<Account>[] =\n        this.#providers.map((provider) => ({\n          provider,\n          stopped: false,\n          groupIndex: maxGroupIndex,\n          accounts: [],\n        }));\n\n      // Start discovery for each providers.\n      await Promise.all(providerContexts.map(runProviderDiscovery));\n\n      // Sync the wallet after discovery to ensure that the newly added accounts are added into their groups.\n      // We can potentially remove this if we know that this race condition is not an issue in practice.\n      this.sync();\n\n      // Align missing accounts from group. This is required to create missing account from non-discovered\n      // indexes for some providers.\n      await this.#alignAccounts();\n\n      return providerContexts.flatMap((context) => context.accounts);\n    });\n  }\n}\n"]}
+{"version":3,"file":"MultichainAccountWallet.cjs","sourceRoot":"","sources":["../src/MultichainAccountWallet.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AccountGroupId,\n  Bip44Account,\n  MultichainAccountWalletId,\n  MultichainAccountWallet as MultichainAccountWalletDefinition,\n  MultichainAccountWalletStatus,\n} from '@metamask/account-api';\nimport {\n  AccountWalletType,\n  getGroupIndexFromMultichainAccountGroupId,\n  isMultichainAccountGroupId,\n  toDefaultAccountGroupId,\n  toMultichainAccountWalletId,\n} from '@metamask/account-api';\nimport type { EntropySourceId, KeyringAccount } from '@metamask/keyring-api';\nimport { assert } from '@metamask/utils';\nimport { Mutex } from 'async-mutex';\n\nimport type { Logger } from './logger';\nimport {\n  createModuleLogger,\n  ERROR_PREFIX,\n  projectLogger as log,\n  WARNING_PREFIX,\n} from './logger';\nimport type { GroupState } from './MultichainAccountGroup';\nimport { MultichainAccountGroup } from './MultichainAccountGroup';\nimport type { ServiceState, StateKeys } from './MultichainAccountService';\nimport type { Bip44AccountProvider } from './providers';\nimport { EvmAccountProvider } from './providers/EvmAccountProvider';\nimport type { MultichainAccountServiceMessenger } from './types';\nimport { createSentryError } from './utils';\n\n/**\n * The context for a provider discovery.\n */\ntype AccountProviderDiscoveryContext<\n  Account extends Bip44Account<KeyringAccount>,\n> = {\n  provider: Bip44AccountProvider<Account>;\n  stopped: boolean;\n  groupIndex: number;\n  accounts: Account[];\n};\n\nexport type WalletState = ServiceState[StateKeys['entropySource']];\n\n// type alias to make clear this state is generated by discovery\ntype DiscoveredGroupsState = WalletState;\n\n/**\n * A multichain account wallet that holds multiple multichain accounts (one multichain account per\n * group index).\n */\nexport class MultichainAccountWallet<\n  Account extends Bip44Account<KeyringAccount>,\n> implements MultichainAccountWalletDefinition<Account>\n{\n  readonly #lock = new Mutex();\n\n  readonly #id: MultichainAccountWalletId;\n\n  readonly #providers: Bip44AccountProvider<Account>[];\n\n  readonly #entropySource: EntropySourceId;\n\n  readonly #accountGroups: Map<number, MultichainAccountGroup<Account>>;\n\n  readonly #messenger: MultichainAccountServiceMessenger;\n\n  readonly #log: Logger;\n\n  #initialized = false;\n\n  #status: MultichainAccountWalletStatus;\n\n  constructor({\n    providers,\n    entropySource,\n    messenger,\n  }: {\n    providers: Bip44AccountProvider<Account>[];\n    entropySource: EntropySourceId;\n    messenger: MultichainAccountServiceMessenger;\n  }) {\n    this.#id = toMultichainAccountWalletId(entropySource);\n    this.#providers = providers;\n    this.#entropySource = entropySource;\n    this.#messenger = messenger;\n    this.#accountGroups = new Map();\n\n    this.#log = createModuleLogger(log, `[${this.#id}]`);\n\n    // Initial synchronization (don't emit events during initialization).\n    this.#status = 'uninitialized';\n  }\n\n  /**\n   * Initialize the wallet and construct the internal representation of multichain account groups.\n   *\n   * @param walletState - The wallet state.\n   */\n  init(walletState: WalletState): void {\n    this.#log('Initializing wallet state...');\n    for (const [groupIndexString, groupState] of Object.entries(walletState)) {\n      // Have to convert to number because the state keys become strings when we construct the state object in the service\n      const groupIndex = Number(groupIndexString);\n      const group = new MultichainAccountGroup({\n        groupIndex,\n        wallet: this,\n        providers: this.#providers,\n        messenger: this.#messenger,\n      });\n\n      this.#log(`Creating new group for index ${groupIndex}...`);\n\n      group.init(groupState);\n\n      this.#accountGroups.set(groupIndex, group);\n    }\n    if (!this.#initialized) {\n      this.#initialized = true;\n      this.#status = 'ready';\n    }\n\n    this.#log('Finished initializing wallet state...');\n  }\n\n  /**\n   * Gets the multichain account wallet ID.\n   *\n   * @returns The multichain account wallet ID.\n   */\n  get id(): MultichainAccountWalletId {\n    return this.#id;\n  }\n\n  /**\n   * Gets the multichain account wallet type, which is always {@link AccountWalletType.Entropy}.\n   *\n   * @returns The multichain account wallet type.\n   */\n  get type(): AccountWalletType.Entropy {\n    return AccountWalletType.Entropy;\n  }\n\n  /**\n   * Gets the multichain account wallet entropy source.\n   *\n   * @returns The multichain account wallet entropy source.\n   */\n  get entropySource(): EntropySourceId {\n    return this.#entropySource;\n  }\n\n  /**\n   * Gets the multichain account wallet current status.\n   *\n   * @returns The multichain account wallet current status.\n   */\n  get status(): MultichainAccountWalletStatus {\n    return this.#status;\n  }\n\n  /**\n   * Set the wallet status and run the associated operation callback.\n   *\n   * @param status - Wallet status associated with this operation.\n   * @param operation - Operation to run.\n   * @returns The operation's result.\n   * @throws {Error} If the wallet is already running a mutable operation.\n   */\n  async #withLock<Return>(\n    status: MultichainAccountWalletStatus,\n    operation: () => Promise<Return>,\n  ): Promise<Return> {\n    const release = await this.#lock.acquire();\n    try {\n      this.#log(`Locking wallet with status \"${status}\"...`);\n      this.#status = status;\n      this.#messenger.publish(\n        'MultichainAccountService:walletStatusChange',\n        this.id,\n        this.#status,\n      );\n      return await operation();\n    } finally {\n      this.#status = 'ready';\n      this.#messenger.publish(\n        'MultichainAccountService:walletStatusChange',\n        this.id,\n        this.#status,\n      );\n      release();\n      this.#log(`Releasing wallet lock (was \"${status}\")`);\n    }\n  }\n\n  /**\n   * Create accounts with non‑EVM providers. Optional throttling is managed by each provider internally.\n   * When awaitAll is true, waits for all providers and throws if any failed.\n   * When false, starts work in background and logs errors without throwing.\n   *\n   * @param options - Method options.\n   * @param options.groupIndex - The group index to create accounts for.\n   * @param options.providers - The non‑EVM account providers.\n   * @param options.awaitAll - Whether to wait for all providers to finish.\n   * @param options.group - The group object pertaining to the group index to create accounts for.\n   * @throws If awaitAll is true and any provider fails to create accounts.\n   * @returns A promise that resolves when done (if awaitAll is true) or immediately (if false).\n   */\n  async #createNonEvmAccounts({\n    groupIndex,\n    providers,\n    awaitAll,\n    group,\n  }: {\n    groupIndex: number;\n    providers: Bip44AccountProvider<Account>[];\n    awaitAll: boolean;\n    group: MultichainAccountGroup<Account>;\n  }): Promise<void> {\n    if (awaitAll) {\n      const tasks = providers.map((provider) =>\n        provider\n          .createAccounts({\n            entropySource: this.#entropySource,\n            groupIndex,\n          })\n          .catch((error) => {\n            const sentryError = createSentryError(\n              `Unable to create account with provider \"${provider.getName()}\"`,\n              error,\n              {\n                groupIndex,\n                provider: provider.getName(),\n              },\n            );\n            this.#messenger.captureException?.(sentryError);\n            throw error;\n          }),\n      );\n\n      const results = await Promise.allSettled(tasks);\n\n      const providerFailures = results.reduce((acc, result, idx) => {\n        let newAcc = acc;\n        if (result.status === 'rejected') {\n          newAcc += `\\n- ${providers[idx].getName()}: ${result.reason.message}`;\n        }\n        return newAcc;\n      }, '');\n\n      if (providerFailures.length) {\n        // We warn there's failures on some providers and thus misalignment, but we still create the group\n        const message = `Unable to create some accounts for group index: ${groupIndex}. Providers threw the following errors:${providerFailures}`;\n        console.warn(message);\n        this.#log(`${WARNING_PREFIX} ${message}`);\n      }\n\n      // No need to fetch the accounts list from the AccountsController since we already have the account IDs to be used in the controller\n      const groupState = results.reduce<GroupState>((state, result, idx) => {\n        if (result.status === 'fulfilled') {\n          state[providers[idx].getName()] = result.value.map(\n            (account) => account.id,\n          );\n        }\n        return state;\n      }, {});\n\n      group.update(groupState);\n    } else {\n      // Create account with other providers in the background\n      providers.forEach((provider) => {\n        provider\n          .createAccounts({\n            entropySource: this.#entropySource,\n            groupIndex,\n          })\n          .then((accounts) => {\n            const accountIds = accounts.map((account) => account.id);\n            group.update({ [provider.getName()]: accountIds });\n            return group;\n          })\n          .catch((error) => {\n            // Log errors from background providers but don't fail the operation\n            const errorMessage = `Unable to create some accounts for group index: ${groupIndex} with provider \"${provider.getName()}\". Error: ${(error as Error).message}`;\n            console.warn(errorMessage);\n            this.#log(`${WARNING_PREFIX} ${errorMessage}:`, error);\n            const sentryError = createSentryError(\n              `Unable to create account with provider \"${provider.getName()}\"`,\n              error,\n              {\n                groupIndex,\n                provider: provider.getName(),\n              },\n            );\n            this.#messenger.captureException?.(sentryError);\n          });\n      });\n    }\n  }\n\n  /**\n   * Gets multichain account for a given ID.\n   * The default group ID will default to the multichain account with index 0.\n   *\n   * @param id - Account group ID.\n   * @returns Account group.\n   */\n  getAccountGroup(\n    id: AccountGroupId,\n  ): MultichainAccountGroup<Account> | undefined {\n    // We consider the \"default case\" to be mapped to index 0.\n    if (id === toDefaultAccountGroupId(this.id)) {\n      return this.#accountGroups.get(0);\n    }\n\n    // If it is not a valid ID, we cannot extract the group index\n    // from it, so we fail fast.\n    if (!isMultichainAccountGroupId(id)) {\n      return undefined;\n    }\n\n    const groupIndex = getGroupIndexFromMultichainAccountGroupId(id);\n    return this.#accountGroups.get(groupIndex);\n  }\n\n  /**\n   * Gets all multichain accounts. Similar to {@link MultichainAccountWallet.getMultichainAccountGroups}.\n   *\n   * @returns The multichain accounts.\n   */\n  getAccountGroups(): MultichainAccountGroup<Account>[] {\n    return this.getMultichainAccountGroups();\n  }\n\n  /**\n   * Gets multichain account group for a given index.\n   *\n   * @param groupIndex - Multichain account index.\n   * @returns The multichain account associated with the given index.\n   */\n  getMultichainAccountGroup(\n    groupIndex: number,\n  ): MultichainAccountGroup<Account> | undefined {\n    return this.#accountGroups.get(groupIndex);\n  }\n\n  /**\n   * Gets all multichain account groups.\n   *\n   * @returns The multichain accounts.\n   */\n  getMultichainAccountGroups(): MultichainAccountGroup<Account>[] {\n    return Array.from(this.#accountGroups.values()); // TODO: Prevent copy here.\n  }\n\n  /**\n   * Gets next group index for this wallet.\n   *\n   * @returns The next group index of this wallet.\n   */\n  getNextGroupIndex(): number {\n    // We do not check for gaps.\n    return (\n      Math.max(\n        -1, // So it will default to 0 if no groups.\n        ...this.#accountGroups.keys(),\n      ) + 1\n    );\n  }\n\n  /**\n   * Creates a multichain account group for a given group index.\n   *\n   * NOTE: This operation WILL lock the wallet's mutex.\n   *\n   * @param groupIndex - The group index to use.\n   * @param options - Options to configure the account creation.\n   * @param options.waitForAllProvidersToFinishCreatingAccounts - Whether to wait for all\n   * account providers to finish creating their accounts before returning. If `false`, only\n   * the EVM provider will be awaited, while all other providers will create their accounts\n   * in the background. Defaults to `false`.\n   * @throws If any of the account providers fails to create their accounts and\n   * the `waitForAllProvidersToFinishCreatingAccounts` option is set to `true`. If `false`,\n   * errors from non-EVM providers will be logged but ignored, and only errors from the\n   * EVM provider will be thrown.\n   * @returns The multichain account group for this group index.\n   */\n  async createMultichainAccountGroup(\n    groupIndex: number,\n    options: {\n      waitForAllProvidersToFinishCreatingAccounts?: boolean;\n    } = { waitForAllProvidersToFinishCreatingAccounts: false },\n  ): Promise<MultichainAccountGroup<Account>> {\n    return await this.#withLock('in-progress:create-accounts', async () => {\n      const nextGroupIndex = this.getNextGroupIndex();\n      if (groupIndex > nextGroupIndex) {\n        throw new Error(\n          `You cannot use a group index that is higher than the next available one: expected <=${nextGroupIndex}, got ${groupIndex}`,\n        );\n      }\n\n      let group = this.getMultichainAccountGroup(groupIndex);\n\n      if (group) {\n        this.#log(\n          `Trying to re-create existing group: [${group.id}] (idempotent)`,\n        );\n        return group;\n      }\n\n      this.#log(`Creating new group for index ${groupIndex}...`);\n\n      // Extract the EVM provider from the list of providers.\n      // We always await EVM account creation first.\n      const [evmProvider, ...otherProviders] = this.#providers;\n      assert(\n        evmProvider instanceof EvmAccountProvider,\n        'EVM account provider must be first',\n      );\n\n      const evmAccounts = await evmProvider\n        .createAccounts({\n          entropySource: this.#entropySource,\n          groupIndex,\n        })\n        .then((accounts) => accounts.map((account) => account.id))\n        .catch((error) => {\n          const errorMessage = `Unable to create some accounts for group index: ${groupIndex} with provider \"${evmProvider.getName()}\". Error: ${(error as Error).message}`;\n          console.warn(errorMessage);\n          this.#log(`${ERROR_PREFIX} ${errorMessage}:`, error);\n          const sentryError = createSentryError(\n            `Unable to create account with provider \"${evmProvider.getName()}\"`,\n            error as Error,\n            {\n              groupIndex,\n              provider: evmProvider.getName(),\n            },\n          );\n          this.#messenger.captureException?.(sentryError);\n          throw error;\n        });\n\n      group = new MultichainAccountGroup({\n        wallet: this,\n        providers: this.#providers,\n        groupIndex,\n        messenger: this.#messenger,\n      });\n\n      group.init({ [evmProvider.getName()]: evmAccounts });\n\n      // We then create accounts with other providers (some being throttled if configured).\n      // Depending on the options, we either await all providers or run them in background.\n      if (options?.waitForAllProvidersToFinishCreatingAccounts) {\n        await this.#createNonEvmAccounts({\n          groupIndex,\n          providers: otherProviders,\n          awaitAll: true,\n          group,\n        });\n      } else {\n        // eslint-disable-next-line no-void\n        void this.#createNonEvmAccounts({\n          groupIndex,\n          providers: otherProviders,\n          awaitAll: false,\n          group,\n        });\n      }\n\n      // Register the account(s) to our internal map.\n      this.#accountGroups.set(groupIndex, group);\n\n      this.#log(`New group created: [${group.id}]`);\n\n      if (this.#initialized) {\n        this.#messenger.publish(\n          'MultichainAccountService:multichainAccountGroupCreated',\n          group,\n        );\n      }\n\n      return group;\n    });\n  }\n\n  /**\n   * Creates the next multichain account group.\n   *\n   * @throws If any of the account providers fails to create their accounts.\n   * @returns The multichain account group for the next group index available.\n   */\n  async createNextMultichainAccountGroup(): Promise<\n    MultichainAccountGroup<Account>\n  > {\n    return this.createMultichainAccountGroup(this.getNextGroupIndex(), {\n      waitForAllProvidersToFinishCreatingAccounts: true,\n    });\n  }\n\n  /**\n   * Align all multichain account groups.\n   *\n   * NOTE: This operation WILL NOT lock the wallet's mutex.\n   */\n  async #alignAccounts(): Promise<void> {\n    const groups = this.getMultichainAccountGroups();\n    await Promise.all(groups.map((group) => group.alignAccounts()));\n  }\n\n  /**\n   * Align all accounts from each existing multichain account groups.\n   *\n   * NOTE: This operation WILL lock the wallet's mutex.\n   */\n  async alignAccounts(): Promise<void> {\n    await this.#withLock('in-progress:alignment', async () => {\n      await this.#alignAccounts();\n    });\n  }\n\n  /**\n   * Align a specific multichain account group.\n   *\n   * NOTE: This operation WILL lock the wallet's mutex.\n   *\n   * @param groupIndex - The group index to align.\n   */\n  async alignAccountsOf(groupIndex: number): Promise<void> {\n    await this.#withLock('in-progress:alignment', async () => {\n      const group = this.getMultichainAccountGroup(groupIndex);\n      if (group) {\n        await group.alignAccounts();\n      }\n    });\n  }\n\n  /**\n   * Discover and create accounts for all providers.\n   *\n   * NOTE: This operation WILL lock the wallet's mutex.\n   *\n   * @returns The discovered accounts for each provider.\n   */\n  async discoverAccounts(): Promise<Account[]> {\n    return this.#withLock('in-progress:discovery', async () => {\n      // Start with the next available group index (so we can resume the discovery\n      // from there).\n      let maxGroupIndex = this.getNextGroupIndex();\n      const discoveredGroupsState: DiscoveredGroupsState = {};\n\n      const addDiscoveryResultToState = (\n        result: Account[],\n        providerName: string,\n        groupIndex: number,\n      ) => {\n        const accountIds = result.map((account) => account.id);\n        discoveredGroupsState[groupIndex] ??= {};\n        discoveredGroupsState[groupIndex][providerName] = accountIds;\n      };\n\n      // One serialized loop per provider; all run concurrently\n      const runProviderDiscovery = async (\n        context: AccountProviderDiscoveryContext<Account>,\n      ): Promise<void> => {\n        const providerName = context.provider.getName();\n        const message = (stepName: string, groupIndex: number) =>\n          `[${providerName}] Discovery ${stepName} for group index: ${groupIndex}`;\n\n        while (!context.stopped) {\n          // Fast‑forward to current high‑water mark\n          const targetGroupIndex = Math.max(context.groupIndex, maxGroupIndex);\n\n          log(message('started', targetGroupIndex));\n\n          let accounts: Account[] = [];\n          try {\n            accounts = await context.provider.discoverAccounts({\n              entropySource: this.#entropySource,\n              groupIndex: targetGroupIndex,\n            });\n          } catch (error) {\n            context.stopped = true;\n            console.error(error);\n            log(\n              message(\n                `failed (with: \"${(error as Error).message}\")`,\n                targetGroupIndex,\n              ),\n              error,\n            );\n            const sentryError = createSentryError(\n              'Unable to discover accounts',\n              error as Error,\n              {\n                provider: providerName,\n                groupIndex: targetGroupIndex,\n              },\n            );\n            this.#messenger.captureException?.(sentryError);\n            break;\n          }\n\n          if (!accounts.length) {\n            log(\n              message('stopped (no accounts got discovered)', targetGroupIndex),\n            );\n            context.stopped = true;\n            break;\n          }\n\n          log(message('**succeeded**', targetGroupIndex));\n\n          context.accounts = context.accounts.concat(accounts);\n\n          addDiscoveryResultToState(accounts, providerName, targetGroupIndex);\n\n          const nextGroupIndex = targetGroupIndex + 1;\n          context.groupIndex = nextGroupIndex;\n\n          if (nextGroupIndex > maxGroupIndex) {\n            maxGroupIndex = nextGroupIndex;\n          }\n        }\n      };\n\n      const providerContexts: AccountProviderDiscoveryContext<Account>[] =\n        this.#providers.map((provider) => ({\n          provider,\n          stopped: false,\n          groupIndex: maxGroupIndex,\n          accounts: [],\n        }));\n\n      // Start discovery for each providers.\n      await Promise.all(providerContexts.map(runProviderDiscovery));\n\n      // Create discovered groups\n      for (const [groupIndexString, groupState] of Object.entries(\n        discoveredGroupsState,\n      )) {\n        const groupIndex = Number(groupIndexString);\n        const group = new MultichainAccountGroup({\n          wallet: this,\n          providers: this.#providers,\n          groupIndex,\n          messenger: this.#messenger,\n        });\n        group.init(groupState);\n        this.#accountGroups.set(groupIndex, group);\n      }\n\n      // Align missing accounts from group. This is required to create missing account from non-discovered\n      // indexes for some providers.\n      await this.#alignAccounts();\n\n      return providerContexts.flatMap((context) => context.accounts);\n    });\n  }\n}\n"]}

package/dist/MultichainAccountWallet.d.cts

@@ -2,8 +2,10 @@ import type { AccountGroupId, Bip44Account, MultichainAccountWalletId, Multichai
 import { AccountWalletType } from "@metamask/account-api";
 import type { EntropySourceId, KeyringAccount } from "@metamask/keyring-api";
 import { MultichainAccountGroup } from "./MultichainAccountGroup.cjs";
+import type { ServiceState, StateKeys } from "./MultichainAccountService.cjs";
 import type { Bip44AccountProvider } from "./providers/index.cjs";
 import type { MultichainAccountServiceMessenger } from "./types.cjs";
+export type WalletState = ServiceState[StateKeys['entropySource']];
 /**
  * A multichain account wallet that holds multiple multichain accounts (one multichain account per
  * group index).
@@ -16,12 +18,11 @@ export declare class MultichainAccountWallet<Account extends Bip44Account<Keyrin
         messenger: MultichainAccountServiceMessenger;
     });
     /**
-     * Force wallet synchronization.
+     * Initialize the wallet and construct the internal representation of multichain account groups.
      *
-     * This can be used if account providers got new accounts that the wallet
-     * doesn't know about.
+     * @param walletState - The wallet state.
      */
-    sync(): void;
+    init(walletState: WalletState): void;
     /**
      * Gets the multichain account wallet ID.
      *

package/dist/MultichainAccountWallet.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"MultichainAccountWallet.d.cts","sourceRoot":"","sources":["../src/MultichainAccountWallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,yBAAyB,EACzB,uBAAuB,IAAI,iCAAiC,EAC5D,6BAA6B,EAC9B,8BAA8B;AAC/B,OAAO,EACL,iBAAiB,EAKlB,8BAA8B;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,8BAA8B;AAW7E,OAAO,EAAE,sBAAsB,EAAE,qCAAiC;AAElE,OAAO,KAAK,EAAE,oBAAoB,EAAE,8BAAoB;AACxD,OAAO,KAAK,EAAE,iCAAiC,EAAE,oBAAgB;AAejE;;;GAGG;AACH,qBAAa,uBAAuB,CAClC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,CAC5C,YAAW,iCAAiC,CAAC,OAAO,CAAC;;gBAqBzC,EACV,SAAS,EACT,aAAa,EACb,SAAS,GACV,EAAE;QACD,SAAS,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,aAAa,EAAE,eAAe,CAAC;QAC/B,SAAS,EAAE,iCAAiC,CAAC;KAC9C;IAgBD;;;;;OAKG;IACH,IAAI,IAAI,IAAI;IAsDZ;;;;OAIG;IACH,IAAI,EAAE,IAAI,yBAAyB,CAElC;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,iBAAiB,CAAC,OAAO,CAEpC;IAED;;;;OAIG;IACH,IAAI,aAAa,IAAI,eAAe,CAEnC;IAED;;;;OAIG;IACH,IAAI,MAAM,IAAI,6BAA6B,CAE1C;IAqHD;;;;;;OAMG;IACH,eAAe,CACb,EAAE,EAAE,cAAc,GACjB,sBAAsB,CAAC,OAAO,CAAC,GAAG,SAAS;IAgB9C;;;;OAIG;IACH,gBAAgB,IAAI,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAIrD;;;;;OAKG;IACH,yBAAyB,CACvB,UAAU,EAAE,MAAM,GACjB,sBAAsB,CAAC,OAAO,CAAC,GAAG,SAAS;IAI9C;;;;OAIG;IACH,0BAA0B,IAAI,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAI/D;;;;OAIG;IACH,iBAAiB,IAAI,MAAM;IAU3B;;;;;;;;;;;;;;;;OAgBG;IACG,4BAA4B,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;QACP,2CAA2C,CAAC,EAAE,OAAO,CAAC;KACE,GACzD,OAAO,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAsH3C;;;;;OAKG;IACG,gCAAgC,IAAI,OAAO,CAC/C,sBAAsB,CAAC,OAAO,CAAC,CAChC;IAgBD;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAMpC;;;;;;OAMG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxD;;;;;;OAMG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;CA2F7C"}
+{"version":3,"file":"MultichainAccountWallet.d.cts","sourceRoot":"","sources":["../src/MultichainAccountWallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,yBAAyB,EACzB,uBAAuB,IAAI,iCAAiC,EAC5D,6BAA6B,EAC9B,8BAA8B;AAC/B,OAAO,EACL,iBAAiB,EAKlB,8BAA8B;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,8BAA8B;AAY7E,OAAO,EAAE,sBAAsB,EAAE,qCAAiC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,uCAAmC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,8BAAoB;AAExD,OAAO,KAAK,EAAE,iCAAiC,EAAE,oBAAgB;AAejE,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC;AAKnE;;;GAGG;AACH,qBAAa,uBAAuB,CAClC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,CAC5C,YAAW,iCAAiC,CAAC,OAAO,CAAC;;gBAoBzC,EACV,SAAS,EACT,aAAa,EACb,SAAS,GACV,EAAE;QACD,SAAS,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,aAAa,EAAE,eAAe,CAAC;QAC/B,SAAS,EAAE,iCAAiC,CAAC;KAC9C;IAaD;;;;OAIG;IACH,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IA0BpC;;;;OAIG;IACH,IAAI,EAAE,IAAI,yBAAyB,CAElC;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,iBAAiB,CAAC,OAAO,CAEpC;IAED;;;;OAIG;IACH,IAAI,aAAa,IAAI,eAAe,CAEnC;IAED;;;;OAIG;IACH,IAAI,MAAM,IAAI,6BAA6B,CAE1C;IA6ID;;;;;;OAMG;IACH,eAAe,CACb,EAAE,EAAE,cAAc,GACjB,sBAAsB,CAAC,OAAO,CAAC,GAAG,SAAS;IAgB9C;;;;OAIG;IACH,gBAAgB,IAAI,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAIrD;;;;;OAKG;IACH,yBAAyB,CACvB,UAAU,EAAE,MAAM,GACjB,sBAAsB,CAAC,OAAO,CAAC,GAAG,SAAS;IAI9C;;;;OAIG;IACH,0BAA0B,IAAI,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAI/D;;;;OAIG;IACH,iBAAiB,IAAI,MAAM;IAU3B;;;;;;;;;;;;;;;;OAgBG;IACG,4BAA4B,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;QACP,2CAA2C,CAAC,EAAE,OAAO,CAAC;KACE,GACzD,OAAO,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IA8F3C;;;;;OAKG;IACG,gCAAgC,IAAI,OAAO,CAC/C,sBAAsB,CAAC,OAAO,CAAC,CAChC;IAgBD;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAMpC;;;;;;OAMG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxD;;;;;;OAMG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;CAmH7C"}

package/dist/MultichainAccountWallet.d.mts

@@ -2,8 +2,10 @@ import type { AccountGroupId, Bip44Account, MultichainAccountWalletId, Multichai
 import { AccountWalletType } from "@metamask/account-api";
 import type { EntropySourceId, KeyringAccount } from "@metamask/keyring-api";
 import { MultichainAccountGroup } from "./MultichainAccountGroup.mjs";
+import type { ServiceState, StateKeys } from "./MultichainAccountService.mjs";
 import type { Bip44AccountProvider } from "./providers/index.mjs";
 import type { MultichainAccountServiceMessenger } from "./types.mjs";
+export type WalletState = ServiceState[StateKeys['entropySource']];
 /**
  * A multichain account wallet that holds multiple multichain accounts (one multichain account per
  * group index).
@@ -16,12 +18,11 @@ export declare class MultichainAccountWallet<Account extends Bip44Account<Keyrin
         messenger: MultichainAccountServiceMessenger;
     });
     /**
-     * Force wallet synchronization.
+     * Initialize the wallet and construct the internal representation of multichain account groups.
      *
-     * This can be used if account providers got new accounts that the wallet
-     * doesn't know about.
+     * @param walletState - The wallet state.
      */
-    sync(): void;
+    init(walletState: WalletState): void;
     /**
      * Gets the multichain account wallet ID.
      *

package/dist/MultichainAccountWallet.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"MultichainAccountWallet.d.mts","sourceRoot":"","sources":["../src/MultichainAccountWallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,yBAAyB,EACzB,uBAAuB,IAAI,iCAAiC,EAC5D,6BAA6B,EAC9B,8BAA8B;AAC/B,OAAO,EACL,iBAAiB,EAKlB,8BAA8B;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,8BAA8B;AAW7E,OAAO,EAAE,sBAAsB,EAAE,qCAAiC;AAElE,OAAO,KAAK,EAAE,oBAAoB,EAAE,8BAAoB;AACxD,OAAO,KAAK,EAAE,iCAAiC,EAAE,oBAAgB;AAejE;;;GAGG;AACH,qBAAa,uBAAuB,CAClC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,CAC5C,YAAW,iCAAiC,CAAC,OAAO,CAAC;;gBAqBzC,EACV,SAAS,EACT,aAAa,EACb,SAAS,GACV,EAAE;QACD,SAAS,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,aAAa,EAAE,eAAe,CAAC;QAC/B,SAAS,EAAE,iCAAiC,CAAC;KAC9C;IAgBD;;;;;OAKG;IACH,IAAI,IAAI,IAAI;IAsDZ;;;;OAIG;IACH,IAAI,EAAE,IAAI,yBAAyB,CAElC;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,iBAAiB,CAAC,OAAO,CAEpC;IAED;;;;OAIG;IACH,IAAI,aAAa,IAAI,eAAe,CAEnC;IAED;;;;OAIG;IACH,IAAI,MAAM,IAAI,6BAA6B,CAE1C;IAqHD;;;;;;OAMG;IACH,eAAe,CACb,EAAE,EAAE,cAAc,GACjB,sBAAsB,CAAC,OAAO,CAAC,GAAG,SAAS;IAgB9C;;;;OAIG;IACH,gBAAgB,IAAI,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAIrD;;;;;OAKG;IACH,yBAAyB,CACvB,UAAU,EAAE,MAAM,GACjB,sBAAsB,CAAC,OAAO,CAAC,GAAG,SAAS;IAI9C;;;;OAIG;IACH,0BAA0B,IAAI,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAI/D;;;;OAIG;IACH,iBAAiB,IAAI,MAAM;IAU3B;;;;;;;;;;;;;;;;OAgBG;IACG,4BAA4B,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;QACP,2CAA2C,CAAC,EAAE,OAAO,CAAC;KACE,GACzD,OAAO,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAsH3C;;;;;OAKG;IACG,gCAAgC,IAAI,OAAO,CAC/C,sBAAsB,CAAC,OAAO,CAAC,CAChC;IAgBD;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAMpC;;;;;;OAMG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxD;;;;;;OAMG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;CA2F7C"}
+{"version":3,"file":"MultichainAccountWallet.d.mts","sourceRoot":"","sources":["../src/MultichainAccountWallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,yBAAyB,EACzB,uBAAuB,IAAI,iCAAiC,EAC5D,6BAA6B,EAC9B,8BAA8B;AAC/B,OAAO,EACL,iBAAiB,EAKlB,8BAA8B;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,8BAA8B;AAY7E,OAAO,EAAE,sBAAsB,EAAE,qCAAiC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,uCAAmC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,8BAAoB;AAExD,OAAO,KAAK,EAAE,iCAAiC,EAAE,oBAAgB;AAejE,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC;AAKnE;;;GAGG;AACH,qBAAa,uBAAuB,CAClC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,CAC5C,YAAW,iCAAiC,CAAC,OAAO,CAAC;;gBAoBzC,EACV,SAAS,EACT,aAAa,EACb,SAAS,GACV,EAAE;QACD,SAAS,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,aAAa,EAAE,eAAe,CAAC;QAC/B,SAAS,EAAE,iCAAiC,CAAC;KAC9C;IAaD;;;;OAIG;IACH,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IA0BpC;;;;OAIG;IACH,IAAI,EAAE,IAAI,yBAAyB,CAElC;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,iBAAiB,CAAC,OAAO,CAEpC;IAED;;;;OAIG;IACH,IAAI,aAAa,IAAI,eAAe,CAEnC;IAED;;;;OAIG;IACH,IAAI,MAAM,IAAI,6BAA6B,CAE1C;IA6ID;;;;;;OAMG;IACH,eAAe,CACb,EAAE,EAAE,cAAc,GACjB,sBAAsB,CAAC,OAAO,CAAC,GAAG,SAAS;IAgB9C;;;;OAIG;IACH,gBAAgB,IAAI,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAIrD;;;;;OAKG;IACH,yBAAyB,CACvB,UAAU,EAAE,MAAM,GACjB,sBAAsB,CAAC,OAAO,CAAC,GAAG,SAAS;IAI9C;;;;OAIG;IACH,0BAA0B,IAAI,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAI/D;;;;OAIG;IACH,iBAAiB,IAAI,MAAM;IAU3B;;;;;;;;;;;;;;;;OAgBG;IACG,4BAA4B,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;QACP,2CAA2C,CAAC,EAAE,OAAO,CAAC;KACE,GACzD,OAAO,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IA8F3C;;;;;OAKG;IACG,gCAAgC,IAAI,OAAO,CAC/C,sBAAsB,CAAC,OAAO,CAAC,CAChC;IAgBD;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAMpC;;;;;;OAMG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxD;;;;;;OAMG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;CAmH7C"}