@metamask-previews/account-tree-controller 7.6.1-preview-58a4a8b71 → 7.6.1-preview-4c8a5dfcb

package/dist/state/export.mjs

@@ -1,204 +0,0 @@
-import { AccountWalletType } from "@metamask/account-api";
-import { HdKeyring } from "@metamask/eth-hd-keyring/v2";
-import { EthAccountType } from "@metamask/keyring-api";
-import { KeyringTypes } from "@metamask/keyring-controller";
-import { encodeMnemonicWords } from "@metamask/keyring-sdk";
-import { IdMap } from "./id-map.mjs";
-import { AccountTreeSnapshot } from "./snapshot.mjs";
-/**
- * Returns `true` if `wallet` is an HD entropy wallet ({@link AccountWalletEntropyObject}).
- *
- * @param wallet - The wallet object to test.
- * @returns Type predicate narrowing to {@link AccountWalletEntropyObject}.
- */
-export function isMnemonicWalletObject(wallet) {
-    return wallet.type === AccountWalletType.Entropy;
-}
-/**
- * Returns `true` if `wallet` is an imported private-key wallet
- * ({@link AccountWalletKeyringObject} with keyring type {@link KeyringTypes.simple}).
- *
- * @param wallet - The wallet object to test.
- * @returns Type predicate narrowing to {@link AccountWalletKeyringObject}.
- */
-export function isPrivateKeyWalletObject(wallet) {
-    return (wallet.type === AccountWalletType.Keyring &&
-        wallet.metadata.keyring.type === KeyringTypes.simple);
-}
-/**
- * Exports a single entropy (HD) wallet object as an {@link AccountWalletMnemonicPayload}.
- *
- * Calls `KeyringController:withKeyringV2Unsafe` to derive the stable entropy source ID
- * via {@link HdKeyring.toEntropySourceId} and, when `includeSecrets` is `true`, to read
- * the raw mnemonic bytes.
- *
- * @param context - Export context.
- * @param walletObj - The local entropy wallet to export.
- * @param includeSecrets - When `true`, the BIP-39 mnemonic is included in the payload.
- * @param idMap - ID map to populate with local↔payload ID pairs for this wallet and its groups.
- * @returns The mnemonic wallet payload entry.
- * @throws If `includeSecrets` is `true` but the mnemonic cannot be read from the keyring.
- */
-async function exportMnemonicWalletObject(context, walletObj, includeSecrets, idMap) {
-    const result = await context.messenger.call('KeyringController:withKeyringV2Unsafe', 
-    // The local wallet entropy ID is the keyring ID.
-    { id: walletObj.metadata.entropy.id }, async ({ keyring }) => {
-        const hdKeyring = keyring;
-        const includeMnemonic = includeSecrets &&
-            hdKeyring.mnemonic !== null &&
-            hdKeyring.mnemonic !== undefined;
-        return {
-            // Compute the stable entropy source ID from the keyring's mnemonic (BIP-39 seed).
-            entropySourceId: await hdKeyring.toEntropySourceId(),
-            // No need to include the mnemonic here if we're not exporting secrets.
-            mnemonic: includeMnemonic ? hdKeyring.mnemonic : undefined,
-        };
-    });
-    const { entropySourceId, mnemonic } = result;
-    // We use the stable entropy source ID as the payload wallet ID, rather than the local wallet ID, to
-    // ensure that the exported snapshot is stable across different installations and sessions.
-    const wallet = {
-        type: 'mnemonic',
-        id: `wallet:${entropySourceId}`,
-        metadata: { name: walletObj.metadata.name },
-        groups: [],
-    };
-    idMap.add(walletObj.id, wallet.id);
-    for (const groupObj of Object.values(walletObj.groups)) {
-        const { groupIndex } = groupObj.metadata.entropy;
-        const group = {
-            id: `${wallet.id}/${groupIndex}`,
-            groupIndex,
-            metadata: {
-                name: groupObj.metadata.name,
-                pinned: groupObj.metadata.pinned,
-                hidden: groupObj.metadata.hidden,
-            },
-        };
-        idMap.add(groupObj.id, group.id);
-        wallet.groups.push(group);
-    }
-    // This should never happen, but we check just in case.
-    if (includeSecrets) {
-        if (mnemonic === undefined) {
-            throw new Error(`Failed to export mnemonic for wallet ${wallet.id}`);
-        }
-        wallet.value = encodeMnemonicWords(mnemonic);
-    }
-    return wallet;
-}
-/**
- * Exports a single simple-keyring wallet object as an {@link AccountWalletPrivateKeyPayload}.
- *
- * All groups from the wallet are merged into the `'private-key'` singleton payload entry.
- * When `includeSecrets` is `true`, each group's private key is exported via
- * `KeyringController:withKeyringV2`.
- *
- * @param context - Export context.
- * @param walletObj - The local simple-keyring wallet to export.
- * @param includeSecrets - When `true`, private keys are included in the payload.
- * @param idMap - ID map to populate with local↔payload ID pairs for this wallet and its groups.
- * @returns The private-key wallet payload entry.
- * @throws If `includeSecrets` is `true` but a private key cannot be exported for an account.
- */
-async function exportPrivateKeyWalletObject(context, walletObj, includeSecrets, idMap) {
-    // We use a singleton wallet ID for private keys.
-    const wallet = {
-        type: 'private-key',
-        id: `wallet:private-key`,
-        metadata: { name: walletObj.metadata.name },
-        groups: [],
-    };
-    idMap.add(walletObj.id, wallet.id);
-    for (const groupObj of Object.values(walletObj.groups)) {
-        const accountId = groupObj.accounts[0];
-        if (!accountId) {
-            continue;
-        }
-        const account = context.messenger.call('AccountsController:getAccount', accountId);
-        if (!account) {
-            continue;
-        }
-        const { address } = account;
-        let exported;
-        if (includeSecrets) {
-            const result = await context.messenger.call('KeyringController:withKeyringV2', { address }, async ({ keyring }) => {
-                if (!keyring.exportAccount) {
-                    throw new Error(`Keyring for account ${accountId} does not support exportAccount`);
-                }
-                return keyring.exportAccount(accountId, {
-                    type: 'private-key',
-                    encoding: 'hexadecimal',
-                });
-            });
-            exported = result;
-        }
-        const group = {
-            id: `${wallet.id}/${address}`,
-            metadata: {
-                name: groupObj.metadata.name,
-                pinned: groupObj.metadata.pinned,
-                hidden: groupObj.metadata.hidden,
-            },
-        };
-        if (includeSecrets) {
-            if (!exported) {
-                throw new Error(`Failed to export private key for account ${accountId}`);
-            }
-            group.value = {
-                privateKey: exported.privateKey,
-                encoding: exported.encoding,
-                type: EthAccountType.Eoa,
-            };
-        }
-        idMap.add(groupObj.id, group.id);
-        wallet.groups.push(group);
-    }
-    return wallet;
-}
-/**
- * Builds an {@link AccountTreeSnapshot} from the current controller state.
- *
- * Iterates over all wallets in the tree:
- * - {@link AccountWalletType.Entropy} (HD) wallets -> `'mnemonic'` payload entries.
- * - {@link AccountWalletType.Keyring} wallets of type `simple` -> `'private-key'` payload entries.
- * - Snap wallets and hardware keyrings are skipped in v1.
- *
- * @param context - Export context providing state and messenger access.
- * @param options - Export options.
- * @returns A promise that resolves to the built snapshot.
- * @throws If `options.includeSecrets` is `true` and the vault is locked.
- */
-export async function exportState(context, options = {}) {
-    const state = context.getState();
-    const includeSecrets = options.includeSecrets ?? false;
-    const { isUnlocked } = context.messenger.call('KeyringController:getState');
-    if (includeSecrets && !isUnlocked) {
-        throw new Error('Cannot include secrets in export when vault is locked');
-    }
-    const idMap = new IdMap();
-    const entries = [];
-    let privateKeyWallet;
-    for (const walletObj of Object.values(state.accountTree.wallets)) {
-        if (isMnemonicWalletObject(walletObj)) {
-            entries.push(await exportMnemonicWalletObject(context, walletObj, includeSecrets, idMap));
-        }
-        else if (isPrivateKeyWalletObject(walletObj)) {
-            const exported = await exportPrivateKeyWalletObject(context, walletObj, includeSecrets, idMap);
-            if (privateKeyWallet) {
-                privateKeyWallet.groups.push(...exported.groups);
-            }
-            else {
-                privateKeyWallet = exported;
-            }
-        }
-        else {
-            // AccountWalletType.Snap and hardware keyrings: skipped for now.
-        }
-    }
-    if (privateKeyWallet) {
-        entries.push(privateKeyWallet);
-    }
-    return new AccountTreeSnapshot(entries, idMap);
-}
-//# sourceMappingURL=export.mjs.map

package/dist/state/export.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"export.mjs","sourceRoot":"","sources":["../../src/state/export.ts"],"names":[],"mappings":"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","sourcesContent":["import { AccountWalletType } from '@metamask/account-api';\nimport { HdKeyring } from '@metamask/eth-hd-keyring/v2';\nimport { EthAccountType } from '@metamask/keyring-api';\nimport { PrivateKeyExportedAccount } from '@metamask/keyring-api/v2';\nimport { KeyringTypes } from '@metamask/keyring-controller';\nimport { encodeMnemonicWords } from '@metamask/keyring-sdk';\n\nimport type {\n  AccountTreeControllerMessenger,\n  AccountTreeControllerState,\n} from '../types.js';\nimport type { AccountWalletObject } from '../wallet.js';\nimport {\n  AccountWalletEntropyObject,\n  AccountWalletKeyringObject,\n} from '../wallet.js';\nimport { IdMap } from './id-map.js';\nimport type {\n  AccountTreeWalletEntry,\n  AccountWalletMnemonicGroupEntry,\n  AccountWalletMnemonicPayload,\n  AccountWalletPrivateKeyGroupEntry,\n  AccountWalletPrivateKeyPayload,\n  ExportStateOptions,\n} from './payload.js';\nimport { AccountTreeSnapshot } from './snapshot.js';\n\n/**\n * Returns `true` if `wallet` is an HD entropy wallet ({@link AccountWalletEntropyObject}).\n *\n * @param wallet - The wallet object to test.\n * @returns Type predicate narrowing to {@link AccountWalletEntropyObject}.\n */\nexport function isMnemonicWalletObject(\n  wallet: AccountWalletObject,\n): wallet is AccountWalletEntropyObject {\n  return wallet.type === AccountWalletType.Entropy;\n}\n\n/**\n * Returns `true` if `wallet` is an imported private-key wallet\n * ({@link AccountWalletKeyringObject} with keyring type {@link KeyringTypes.simple}).\n *\n * @param wallet - The wallet object to test.\n * @returns Type predicate narrowing to {@link AccountWalletKeyringObject}.\n */\nexport function isPrivateKeyWalletObject(\n  wallet: AccountWalletObject,\n): wallet is AccountWalletKeyringObject {\n  return (\n    wallet.type === AccountWalletType.Keyring &&\n    wallet.metadata.keyring.type === KeyringTypes.simple\n  );\n}\n\n/** Context required by {@link exportState}. */\nexport type ExportContext = {\n  getState: () => AccountTreeControllerState;\n  messenger: AccountTreeControllerMessenger;\n};\n\n/**\n * Exports a single entropy (HD) wallet object as an {@link AccountWalletMnemonicPayload}.\n *\n * Calls `KeyringController:withKeyringV2Unsafe` to derive the stable entropy source ID\n * via {@link HdKeyring.toEntropySourceId} and, when `includeSecrets` is `true`, to read\n * the raw mnemonic bytes.\n *\n * @param context - Export context.\n * @param walletObj - The local entropy wallet to export.\n * @param includeSecrets - When `true`, the BIP-39 mnemonic is included in the payload.\n * @param idMap - ID map to populate with local↔payload ID pairs for this wallet and its groups.\n * @returns The mnemonic wallet payload entry.\n * @throws If `includeSecrets` is `true` but the mnemonic cannot be read from the keyring.\n */\nasync function exportMnemonicWalletObject(\n  context: ExportContext,\n  walletObj: AccountWalletEntropyObject,\n  includeSecrets: boolean,\n  idMap: IdMap,\n): Promise<AccountWalletMnemonicPayload> {\n  const result = await context.messenger.call(\n    'KeyringController:withKeyringV2Unsafe',\n    // The local wallet entropy ID is the keyring ID.\n    { id: walletObj.metadata.entropy.id },\n    async ({ keyring }) => {\n      const hdKeyring = keyring as HdKeyring;\n      const includeMnemonic =\n        includeSecrets &&\n        hdKeyring.mnemonic !== null &&\n        hdKeyring.mnemonic !== undefined;\n\n      return {\n        // Compute the stable entropy source ID from the keyring's mnemonic (BIP-39 seed).\n        entropySourceId: await hdKeyring.toEntropySourceId(),\n        // No need to include the mnemonic here if we're not exporting secrets.\n        mnemonic: includeMnemonic ? hdKeyring.mnemonic : undefined,\n      };\n    },\n  );\n  const { entropySourceId, mnemonic } = result as {\n    entropySourceId: string;\n    mnemonic?: Uint8Array;\n  };\n\n  // We use the stable entropy source ID as the payload wallet ID, rather than the local wallet ID, to\n  // ensure that the exported snapshot is stable across different installations and sessions.\n  const wallet: AccountWalletMnemonicPayload = {\n    type: 'mnemonic',\n    id: `wallet:${entropySourceId}`,\n    metadata: { name: walletObj.metadata.name },\n    groups: [],\n  };\n\n  idMap.add(walletObj.id, wallet.id);\n\n  for (const groupObj of Object.values(walletObj.groups)) {\n    const { groupIndex } = groupObj.metadata.entropy;\n\n    const group: AccountWalletMnemonicGroupEntry = {\n      id: `${wallet.id}/${groupIndex}`,\n      groupIndex,\n      metadata: {\n        name: groupObj.metadata.name,\n        pinned: groupObj.metadata.pinned,\n        hidden: groupObj.metadata.hidden,\n      },\n    };\n\n    idMap.add(groupObj.id, group.id);\n\n    wallet.groups.push(group);\n  }\n\n  // This should never happen, but we check just in case.\n  if (includeSecrets) {\n    if (mnemonic === undefined) {\n      throw new Error(`Failed to export mnemonic for wallet ${wallet.id}`);\n    }\n\n    wallet.value = encodeMnemonicWords(mnemonic);\n  }\n\n  return wallet;\n}\n\n/**\n * Exports a single simple-keyring wallet object as an {@link AccountWalletPrivateKeyPayload}.\n *\n * All groups from the wallet are merged into the `'private-key'` singleton payload entry.\n * When `includeSecrets` is `true`, each group's private key is exported via\n * `KeyringController:withKeyringV2`.\n *\n * @param context - Export context.\n * @param walletObj - The local simple-keyring wallet to export.\n * @param includeSecrets - When `true`, private keys are included in the payload.\n * @param idMap - ID map to populate with local↔payload ID pairs for this wallet and its groups.\n * @returns The private-key wallet payload entry.\n * @throws If `includeSecrets` is `true` but a private key cannot be exported for an account.\n */\nasync function exportPrivateKeyWalletObject(\n  context: ExportContext,\n  walletObj: AccountWalletKeyringObject,\n  includeSecrets: boolean,\n  idMap: IdMap,\n): Promise<AccountWalletPrivateKeyPayload> {\n  // We use a singleton wallet ID for private keys.\n  const wallet: AccountWalletPrivateKeyPayload = {\n    type: 'private-key',\n    id: `wallet:private-key`,\n    metadata: { name: walletObj.metadata.name },\n    groups: [],\n  };\n\n  idMap.add(walletObj.id, wallet.id);\n\n  for (const groupObj of Object.values(walletObj.groups)) {\n    const accountId = groupObj.accounts[0];\n    if (!accountId) {\n      continue;\n    }\n    const account = context.messenger.call(\n      'AccountsController:getAccount',\n      accountId,\n    );\n    if (!account) {\n      continue;\n    }\n\n    const { address } = account;\n\n    let exported: PrivateKeyExportedAccount | undefined;\n    if (includeSecrets) {\n      const result = await context.messenger.call(\n        'KeyringController:withKeyringV2',\n        { address },\n        async ({ keyring }) => {\n          if (!keyring.exportAccount) {\n            throw new Error(\n              `Keyring for account ${accountId} does not support exportAccount`,\n            );\n          }\n\n          return keyring.exportAccount(accountId, {\n            type: 'private-key',\n            encoding: 'hexadecimal',\n          });\n        },\n      );\n\n      exported = result as PrivateKeyExportedAccount;\n    }\n\n    const group: AccountWalletPrivateKeyGroupEntry = {\n      id: `${wallet.id}/${address}`,\n      metadata: {\n        name: groupObj.metadata.name,\n        pinned: groupObj.metadata.pinned,\n        hidden: groupObj.metadata.hidden,\n      },\n    };\n\n    if (includeSecrets) {\n      if (!exported) {\n        throw new Error(\n          `Failed to export private key for account ${accountId}`,\n        );\n      }\n      group.value = {\n        privateKey: exported.privateKey,\n        encoding: exported.encoding,\n        type: EthAccountType.Eoa,\n      };\n    }\n\n    idMap.add(groupObj.id, group.id);\n\n    wallet.groups.push(group);\n  }\n\n  return wallet;\n}\n\n/**\n * Builds an {@link AccountTreeSnapshot} from the current controller state.\n *\n * Iterates over all wallets in the tree:\n * - {@link AccountWalletType.Entropy} (HD) wallets -> `'mnemonic'` payload entries.\n * - {@link AccountWalletType.Keyring} wallets of type `simple` -> `'private-key'` payload entries.\n * - Snap wallets and hardware keyrings are skipped in v1.\n *\n * @param context - Export context providing state and messenger access.\n * @param options - Export options.\n * @returns A promise that resolves to the built snapshot.\n * @throws If `options.includeSecrets` is `true` and the vault is locked.\n */\nexport async function exportState(\n  context: ExportContext,\n  options: ExportStateOptions = {},\n): Promise<AccountTreeSnapshot> {\n  const state = context.getState();\n\n  const includeSecrets = options.includeSecrets ?? false;\n  const { isUnlocked } = context.messenger.call('KeyringController:getState');\n  if (includeSecrets && !isUnlocked) {\n    throw new Error('Cannot include secrets in export when vault is locked');\n  }\n\n  const idMap = new IdMap();\n  const entries: AccountTreeWalletEntry[] = [];\n  let privateKeyWallet: AccountWalletPrivateKeyPayload | undefined;\n\n  for (const walletObj of Object.values(state.accountTree.wallets)) {\n    if (isMnemonicWalletObject(walletObj)) {\n      entries.push(\n        await exportMnemonicWalletObject(\n          context,\n          walletObj,\n          includeSecrets,\n          idMap,\n        ),\n      );\n    } else if (isPrivateKeyWalletObject(walletObj)) {\n      const exported = await exportPrivateKeyWalletObject(\n        context,\n        walletObj,\n        includeSecrets,\n        idMap,\n      );\n\n      if (privateKeyWallet) {\n        privateKeyWallet.groups.push(...exported.groups);\n      } else {\n        privateKeyWallet = exported;\n      }\n    } else {\n      // AccountWalletType.Snap and hardware keyrings: skipped for now.\n    }\n  }\n\n  if (privateKeyWallet) {\n    entries.push(privateKeyWallet);\n  }\n\n  return new AccountTreeSnapshot(entries, idMap);\n}\n"]}

package/dist/state/id-map.cjs

@@ -1,59 +0,0 @@
-"use strict";
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _IdMap_localToPayload, _IdMap_payloadToLocal;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IdMap = void 0;
-/**
- * Bidirectional map between local controller IDs and portable payload IDs.
- *
- * Populated during {@link exportState} so that callers can bridge between
- * device-local wallet/group IDs and the stable cross-device IDs that appear
- * in a serialized {@link AccountTreePayload}.
- */
-class IdMap {
-    /**
-     * @param entries - Optional seed pairs `[localId, payloadId]` to pre-populate the map.
-     */
-    constructor(entries = []) {
-        _IdMap_localToPayload.set(this, new Map());
-        _IdMap_payloadToLocal.set(this, new Map());
-        for (const [localId, payloadId] of entries) {
-            this.add(localId, payloadId);
-        }
-    }
-    /**
-     * Registers a local↔payload ID pair.
-     *
-     * @param localId - Local controller wallet or group ID.
-     * @param payloadId - Corresponding portable payload ID.
-     */
-    add(localId, payloadId) {
-        __classPrivateFieldGet(this, _IdMap_localToPayload, "f").set(localId, payloadId);
-        __classPrivateFieldGet(this, _IdMap_payloadToLocal, "f").set(payloadId, localId);
-    }
-    /**
-     * Returns the portable payload ID for a given local ID.
-     *
-     * @param localId - Local controller wallet or group ID.
-     * @returns The payload ID, or `undefined` if not registered.
-     */
-    getPayloadId(localId) {
-        return __classPrivateFieldGet(this, _IdMap_localToPayload, "f").get(localId);
-    }
-    /**
-     * Returns the local controller ID for a given payload ID.
-     *
-     * @param payloadId - Portable payload ID.
-     * @returns The local wallet or group ID, or `undefined` if not registered.
-     */
-    getLocalId(payloadId) {
-        return __classPrivateFieldGet(this, _IdMap_payloadToLocal, "f").get(payloadId);
-    }
-}
-exports.IdMap = IdMap;
-_IdMap_localToPayload = new WeakMap(), _IdMap_payloadToLocal = new WeakMap();
-//# sourceMappingURL=id-map.cjs.map

package/dist/state/id-map.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"id-map.cjs","sourceRoot":"","sources":["../../src/state/id-map.ts"],"names":[],"mappings":";;;;;;;;;AAUA;;;;;;GAMG;AACH,MAAa,KAAK;IAKhB;;OAEG;IACH,YAAY,UAAsD,EAAE;QAP3D,gCAA2C,IAAI,GAAG,EAAE,EAAC;QAErD,gCAA2C,IAAI,GAAG,EAAE,EAAC;QAM5D,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,OAAO,EAAE,CAAC;YAC3C,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,OAAgB,EAAE,SAAoB;QACxC,uBAAA,IAAI,6BAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC7C,uBAAA,IAAI,6BAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,OAAgB;QAC3B,OAAO,uBAAA,IAAI,6BAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,SAAoB;QAC7B,OAAO,uBAAA,IAAI,6BAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;CACF;AA5CD,sBA4CC","sourcesContent":["import type { AccountGroupId, AccountWalletId } from '@metamask/account-api';\n\nimport type {\n  AccountGroupPayloadId,\n  AccountWalletPayloadId,\n} from './payload.js';\n\ntype LocalId = AccountWalletId | AccountGroupId;\ntype PayloadId = AccountWalletPayloadId | AccountGroupPayloadId;\n\n/**\n * Bidirectional map between local controller IDs and portable payload IDs.\n *\n * Populated during {@link exportState} so that callers can bridge between\n * device-local wallet/group IDs and the stable cross-device IDs that appear\n * in a serialized {@link AccountTreePayload}.\n */\nexport class IdMap {\n  readonly #localToPayload: Map<LocalId, PayloadId> = new Map();\n\n  readonly #payloadToLocal: Map<PayloadId, LocalId> = new Map();\n\n  /**\n   * @param entries - Optional seed pairs `[localId, payloadId]` to pre-populate the map.\n   */\n  constructor(entries: [localId: LocalId, payloadId: PayloadId][] = []) {\n    for (const [localId, payloadId] of entries) {\n      this.add(localId, payloadId);\n    }\n  }\n\n  /**\n   * Registers a local↔payload ID pair.\n   *\n   * @param localId - Local controller wallet or group ID.\n   * @param payloadId - Corresponding portable payload ID.\n   */\n  add(localId: LocalId, payloadId: PayloadId): void {\n    this.#localToPayload.set(localId, payloadId);\n    this.#payloadToLocal.set(payloadId, localId);\n  }\n\n  /**\n   * Returns the portable payload ID for a given local ID.\n   *\n   * @param localId - Local controller wallet or group ID.\n   * @returns The payload ID, or `undefined` if not registered.\n   */\n  getPayloadId(localId: LocalId): PayloadId | undefined {\n    return this.#localToPayload.get(localId);\n  }\n\n  /**\n   * Returns the local controller ID for a given payload ID.\n   *\n   * @param payloadId - Portable payload ID.\n   * @returns The local wallet or group ID, or `undefined` if not registered.\n   */\n  getLocalId(payloadId: PayloadId): LocalId | undefined {\n    return this.#payloadToLocal.get(payloadId);\n  }\n}\n"]}

package/dist/state/id-map.d.cts

@@ -1,41 +0,0 @@
-import type { AccountGroupId, AccountWalletId } from "@metamask/account-api";
-import type { AccountGroupPayloadId, AccountWalletPayloadId } from "./payload.cjs";
-type LocalId = AccountWalletId | AccountGroupId;
-type PayloadId = AccountWalletPayloadId | AccountGroupPayloadId;
-/**
- * Bidirectional map between local controller IDs and portable payload IDs.
- *
- * Populated during {@link exportState} so that callers can bridge between
- * device-local wallet/group IDs and the stable cross-device IDs that appear
- * in a serialized {@link AccountTreePayload}.
- */
-export declare class IdMap {
-    #private;
-    /**
-     * @param entries - Optional seed pairs `[localId, payloadId]` to pre-populate the map.
-     */
-    constructor(entries?: [localId: LocalId, payloadId: PayloadId][]);
-    /**
-     * Registers a local↔payload ID pair.
-     *
-     * @param localId - Local controller wallet or group ID.
-     * @param payloadId - Corresponding portable payload ID.
-     */
-    add(localId: LocalId, payloadId: PayloadId): void;
-    /**
-     * Returns the portable payload ID for a given local ID.
-     *
-     * @param localId - Local controller wallet or group ID.
-     * @returns The payload ID, or `undefined` if not registered.
-     */
-    getPayloadId(localId: LocalId): PayloadId | undefined;
-    /**
-     * Returns the local controller ID for a given payload ID.
-     *
-     * @param payloadId - Portable payload ID.
-     * @returns The local wallet or group ID, or `undefined` if not registered.
-     */
-    getLocalId(payloadId: PayloadId): LocalId | undefined;
-}
-export {};
-//# sourceMappingURL=id-map.d.cts.map

package/dist/state/id-map.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"id-map.d.cts","sourceRoot":"","sources":["../../src/state/id-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,8BAA8B;AAE7E,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACvB,sBAAqB;AAEtB,KAAK,OAAO,GAAG,eAAe,GAAG,cAAc,CAAC;AAChD,KAAK,SAAS,GAAG,sBAAsB,GAAG,qBAAqB,CAAC;AAEhE;;;;;;GAMG;AACH,qBAAa,KAAK;;IAKhB;;OAEG;gBACS,OAAO,GAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,EAAO;IAMpE;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAKjD;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS;IAIrD;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS;CAGtD"}

package/dist/state/id-map.d.mts

@@ -1,41 +0,0 @@
-import type { AccountGroupId, AccountWalletId } from "@metamask/account-api";
-import type { AccountGroupPayloadId, AccountWalletPayloadId } from "./payload.mjs";
-type LocalId = AccountWalletId | AccountGroupId;
-type PayloadId = AccountWalletPayloadId | AccountGroupPayloadId;
-/**
- * Bidirectional map between local controller IDs and portable payload IDs.
- *
- * Populated during {@link exportState} so that callers can bridge between
- * device-local wallet/group IDs and the stable cross-device IDs that appear
- * in a serialized {@link AccountTreePayload}.
- */
-export declare class IdMap {
-    #private;
-    /**
-     * @param entries - Optional seed pairs `[localId, payloadId]` to pre-populate the map.
-     */
-    constructor(entries?: [localId: LocalId, payloadId: PayloadId][]);
-    /**
-     * Registers a local↔payload ID pair.
-     *
-     * @param localId - Local controller wallet or group ID.
-     * @param payloadId - Corresponding portable payload ID.
-     */
-    add(localId: LocalId, payloadId: PayloadId): void;
-    /**
-     * Returns the portable payload ID for a given local ID.
-     *
-     * @param localId - Local controller wallet or group ID.
-     * @returns The payload ID, or `undefined` if not registered.
-     */
-    getPayloadId(localId: LocalId): PayloadId | undefined;
-    /**
-     * Returns the local controller ID for a given payload ID.
-     *
-     * @param payloadId - Portable payload ID.
-     * @returns The local wallet or group ID, or `undefined` if not registered.
-     */
-    getLocalId(payloadId: PayloadId): LocalId | undefined;
-}
-export {};
-//# sourceMappingURL=id-map.d.mts.map

package/dist/state/id-map.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"id-map.d.mts","sourceRoot":"","sources":["../../src/state/id-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,8BAA8B;AAE7E,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACvB,sBAAqB;AAEtB,KAAK,OAAO,GAAG,eAAe,GAAG,cAAc,CAAC;AAChD,KAAK,SAAS,GAAG,sBAAsB,GAAG,qBAAqB,CAAC;AAEhE;;;;;;GAMG;AACH,qBAAa,KAAK;;IAKhB;;OAEG;gBACS,OAAO,GAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,EAAO;IAMpE;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAKjD;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS;IAIrD;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS;CAGtD"}

package/dist/state/id-map.mjs

@@ -1,55 +0,0 @@
-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 _IdMap_localToPayload, _IdMap_payloadToLocal;
-/**
- * Bidirectional map between local controller IDs and portable payload IDs.
- *
- * Populated during {@link exportState} so that callers can bridge between
- * device-local wallet/group IDs and the stable cross-device IDs that appear
- * in a serialized {@link AccountTreePayload}.
- */
-export class IdMap {
-    /**
-     * @param entries - Optional seed pairs `[localId, payloadId]` to pre-populate the map.
-     */
-    constructor(entries = []) {
-        _IdMap_localToPayload.set(this, new Map());
-        _IdMap_payloadToLocal.set(this, new Map());
-        for (const [localId, payloadId] of entries) {
-            this.add(localId, payloadId);
-        }
-    }
-    /**
-     * Registers a local↔payload ID pair.
-     *
-     * @param localId - Local controller wallet or group ID.
-     * @param payloadId - Corresponding portable payload ID.
-     */
-    add(localId, payloadId) {
-        __classPrivateFieldGet(this, _IdMap_localToPayload, "f").set(localId, payloadId);
-        __classPrivateFieldGet(this, _IdMap_payloadToLocal, "f").set(payloadId, localId);
-    }
-    /**
-     * Returns the portable payload ID for a given local ID.
-     *
-     * @param localId - Local controller wallet or group ID.
-     * @returns The payload ID, or `undefined` if not registered.
-     */
-    getPayloadId(localId) {
-        return __classPrivateFieldGet(this, _IdMap_localToPayload, "f").get(localId);
-    }
-    /**
-     * Returns the local controller ID for a given payload ID.
-     *
-     * @param payloadId - Portable payload ID.
-     * @returns The local wallet or group ID, or `undefined` if not registered.
-     */
-    getLocalId(payloadId) {
-        return __classPrivateFieldGet(this, _IdMap_payloadToLocal, "f").get(payloadId);
-    }
-}
-_IdMap_localToPayload = new WeakMap(), _IdMap_payloadToLocal = new WeakMap();
-//# sourceMappingURL=id-map.mjs.map

package/dist/state/id-map.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"id-map.mjs","sourceRoot":"","sources":["../../src/state/id-map.ts"],"names":[],"mappings":";;;;;;AAUA;;;;;;GAMG;AACH,MAAM,OAAO,KAAK;IAKhB;;OAEG;IACH,YAAY,UAAsD,EAAE;QAP3D,gCAA2C,IAAI,GAAG,EAAE,EAAC;QAErD,gCAA2C,IAAI,GAAG,EAAE,EAAC;QAM5D,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,OAAO,EAAE,CAAC;YAC3C,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,OAAgB,EAAE,SAAoB;QACxC,uBAAA,IAAI,6BAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC7C,uBAAA,IAAI,6BAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,OAAgB;QAC3B,OAAO,uBAAA,IAAI,6BAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,SAAoB;QAC7B,OAAO,uBAAA,IAAI,6BAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;CACF","sourcesContent":["import type { AccountGroupId, AccountWalletId } from '@metamask/account-api';\n\nimport type {\n  AccountGroupPayloadId,\n  AccountWalletPayloadId,\n} from './payload.js';\n\ntype LocalId = AccountWalletId | AccountGroupId;\ntype PayloadId = AccountWalletPayloadId | AccountGroupPayloadId;\n\n/**\n * Bidirectional map between local controller IDs and portable payload IDs.\n *\n * Populated during {@link exportState} so that callers can bridge between\n * device-local wallet/group IDs and the stable cross-device IDs that appear\n * in a serialized {@link AccountTreePayload}.\n */\nexport class IdMap {\n  readonly #localToPayload: Map<LocalId, PayloadId> = new Map();\n\n  readonly #payloadToLocal: Map<PayloadId, LocalId> = new Map();\n\n  /**\n   * @param entries - Optional seed pairs `[localId, payloadId]` to pre-populate the map.\n   */\n  constructor(entries: [localId: LocalId, payloadId: PayloadId][] = []) {\n    for (const [localId, payloadId] of entries) {\n      this.add(localId, payloadId);\n    }\n  }\n\n  /**\n   * Registers a local↔payload ID pair.\n   *\n   * @param localId - Local controller wallet or group ID.\n   * @param payloadId - Corresponding portable payload ID.\n   */\n  add(localId: LocalId, payloadId: PayloadId): void {\n    this.#localToPayload.set(localId, payloadId);\n    this.#payloadToLocal.set(payloadId, localId);\n  }\n\n  /**\n   * Returns the portable payload ID for a given local ID.\n   *\n   * @param localId - Local controller wallet or group ID.\n   * @returns The payload ID, or `undefined` if not registered.\n   */\n  getPayloadId(localId: LocalId): PayloadId | undefined {\n    return this.#localToPayload.get(localId);\n  }\n\n  /**\n   * Returns the local controller ID for a given payload ID.\n   *\n   * @param payloadId - Portable payload ID.\n   * @returns The local wallet or group ID, or `undefined` if not registered.\n   */\n  getLocalId(payloadId: PayloadId): LocalId | undefined {\n    return this.#payloadToLocal.get(payloadId);\n  }\n}\n"]}