@metamask/keyring-sdk 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.0]
+
+### Added
+
+- Add `generateId` option to `KeyringAccountRegistry` ([#503](https://github.com/MetaMask/accounts/pull/503))
+- Add `generateEthAccountId` to generate deterministic account IDs for EVM addresses, and use it by default in `EthKeyringWrapper` ([#504](https://github.com/MetaMask/accounts/pull/504))
+
 ## [1.1.0]
 
 ### Added
@@ -23,6 +30,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial release, extracted from `@metamask/keyring-api` ([#478](https://github.com/MetaMask/accounts/pull/478)), ([#482](https://github.com/MetaMask/accounts/pull/482))
 
-[Unreleased]: https://github.com/MetaMask/accounts/compare/@metamask/keyring-sdk@1.1.0...HEAD
+[Unreleased]: https://github.com/MetaMask/accounts/compare/@metamask/keyring-sdk@1.2.0...HEAD
+[1.2.0]: https://github.com/MetaMask/accounts/compare/@metamask/keyring-sdk@1.1.0...@metamask/keyring-sdk@1.2.0
 [1.1.0]: https://github.com/MetaMask/accounts/compare/@metamask/keyring-sdk@1.0.0...@metamask/keyring-sdk@1.1.0
 [1.0.0]: https://github.com/MetaMask/accounts/releases/tag/@metamask/keyring-sdk@1.0.0

package/dist/eth/account-id.cjs

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateEthAccountId = generateEthAccountId;
+const eth_sig_util_1 = require("@metamask/eth-sig-util");
+const utils_1 = require("@metamask/utils");
+const sha256_1 = require("ethereum-cryptography/sha256");
+const uuid_1 = require("uuid");
+/**
+ * Generates a deterministic account ID for a given Ethereum address.
+ *
+ * The address is first normalized (lowercased, `0x`-prefixed) so that
+ * checksum-cased and lowercase variants of the same address produce the
+ * same ID. The ID is then a UUID v4 derived by seeding the UUID generator
+ * with the first 16 bytes of the SHA-256 hash of the normalized address
+ * bytes.
+ *
+ * @param address - The Ethereum address (hex string) to generate the account
+ * ID from.
+ * @returns A deterministic UUID v4 string to use as the account ID.
+ */
+function generateEthAccountId(address) {
+    const normalized = (0, eth_sig_util_1.normalize)(address);
+    return (0, uuid_1.v4)({
+        random: (0, sha256_1.sha256)((0, utils_1.hexToBytes)(normalized)).slice(0, 16),
+    });
+}
+//# sourceMappingURL=account-id.cjs.map

package/dist/eth/account-id.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-id.cjs","sourceRoot":"","sources":["../../src/eth/account-id.ts"],"names":[],"mappings":";;AAmBA,oDAKC;AAxBD,yDAAmD;AAEnD,2CAA6C;AAC7C,yDAAsD;AACtD,+BAAoC;AAEpC;;;;;;;;;;;;GAYG;AACH,SAAgB,oBAAoB,CAAC,OAAe;IAClD,MAAM,UAAU,GAAG,IAAA,wBAAS,EAAC,OAAO,CAAW,CAAC;IAChD,OAAO,IAAA,SAAM,EAAC;QACZ,MAAM,EAAE,IAAA,eAAM,EAAC,IAAA,kBAAU,EAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;KACpD,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { normalize } from '@metamask/eth-sig-util';\nimport type { AccountId } from '@metamask/keyring-utils';\nimport { hexToBytes } from '@metamask/utils';\nimport { sha256 } from 'ethereum-cryptography/sha256';\nimport { v4 as uuidv4 } from 'uuid';\n\n/**\n * Generates a deterministic account ID for a given Ethereum address.\n *\n * The address is first normalized (lowercased, `0x`-prefixed) so that\n * checksum-cased and lowercase variants of the same address produce the\n * same ID. The ID is then a UUID v4 derived by seeding the UUID generator\n * with the first 16 bytes of the SHA-256 hash of the normalized address\n * bytes.\n *\n * @param address - The Ethereum address (hex string) to generate the account\n * ID from.\n * @returns A deterministic UUID v4 string to use as the account ID.\n */\nexport function generateEthAccountId(address: string): AccountId {\n  const normalized = normalize(address) as string;\n  return uuidv4({\n    random: sha256(hexToBytes(normalized)).slice(0, 16),\n  });\n}\n"]}

package/dist/eth/account-id.d.cts

@@ -0,0 +1,16 @@
+import type { AccountId } from "@metamask/keyring-utils";
+/**
+ * Generates a deterministic account ID for a given Ethereum address.
+ *
+ * The address is first normalized (lowercased, `0x`-prefixed) so that
+ * checksum-cased and lowercase variants of the same address produce the
+ * same ID. The ID is then a UUID v4 derived by seeding the UUID generator
+ * with the first 16 bytes of the SHA-256 hash of the normalized address
+ * bytes.
+ *
+ * @param address - The Ethereum address (hex string) to generate the account
+ * ID from.
+ * @returns A deterministic UUID v4 string to use as the account ID.
+ */
+export declare function generateEthAccountId(address: string): AccountId;
+//# sourceMappingURL=account-id.d.cts.map

package/dist/eth/account-id.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-id.d.cts","sourceRoot":"","sources":["../../src/eth/account-id.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,gCAAgC;AAKzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAK/D"}

package/dist/eth/account-id.d.mts

@@ -0,0 +1,16 @@
+import type { AccountId } from "@metamask/keyring-utils";
+/**
+ * Generates a deterministic account ID for a given Ethereum address.
+ *
+ * The address is first normalized (lowercased, `0x`-prefixed) so that
+ * checksum-cased and lowercase variants of the same address produce the
+ * same ID. The ID is then a UUID v4 derived by seeding the UUID generator
+ * with the first 16 bytes of the SHA-256 hash of the normalized address
+ * bytes.
+ *
+ * @param address - The Ethereum address (hex string) to generate the account
+ * ID from.
+ * @returns A deterministic UUID v4 string to use as the account ID.
+ */
+export declare function generateEthAccountId(address: string): AccountId;
+//# sourceMappingURL=account-id.d.mts.map

package/dist/eth/account-id.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-id.d.mts","sourceRoot":"","sources":["../../src/eth/account-id.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,gCAAgC;AAKzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAK/D"}

package/dist/eth/account-id.mjs

@@ -0,0 +1,24 @@
+import { normalize } from "@metamask/eth-sig-util";
+import { hexToBytes } from "@metamask/utils";
+import { sha256 } from "ethereum-cryptography/sha256";
+import { v4 as uuidv4 } from "uuid";
+/**
+ * Generates a deterministic account ID for a given Ethereum address.
+ *
+ * The address is first normalized (lowercased, `0x`-prefixed) so that
+ * checksum-cased and lowercase variants of the same address produce the
+ * same ID. The ID is then a UUID v4 derived by seeding the UUID generator
+ * with the first 16 bytes of the SHA-256 hash of the normalized address
+ * bytes.
+ *
+ * @param address - The Ethereum address (hex string) to generate the account
+ * ID from.
+ * @returns A deterministic UUID v4 string to use as the account ID.
+ */
+export function generateEthAccountId(address) {
+    const normalized = normalize(address);
+    return uuidv4({
+        random: sha256(hexToBytes(normalized)).slice(0, 16),
+    });
+}
+//# sourceMappingURL=account-id.mjs.map

package/dist/eth/account-id.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-id.mjs","sourceRoot":"","sources":["../../src/eth/account-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,+BAA+B;AAEnD,OAAO,EAAE,UAAU,EAAE,wBAAwB;AAC7C,OAAO,EAAE,MAAM,EAAE,qCAAqC;AACtD,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,aAAa;AAEpC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAW,CAAC;IAChD,OAAO,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;KACpD,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { normalize } from '@metamask/eth-sig-util';\nimport type { AccountId } from '@metamask/keyring-utils';\nimport { hexToBytes } from '@metamask/utils';\nimport { sha256 } from 'ethereum-cryptography/sha256';\nimport { v4 as uuidv4 } from 'uuid';\n\n/**\n * Generates a deterministic account ID for a given Ethereum address.\n *\n * The address is first normalized (lowercased, `0x`-prefixed) so that\n * checksum-cased and lowercase variants of the same address produce the\n * same ID. The ID is then a UUID v4 derived by seeding the UUID generator\n * with the first 16 bytes of the SHA-256 hash of the normalized address\n * bytes.\n *\n * @param address - The Ethereum address (hex string) to generate the account\n * ID from.\n * @returns A deterministic UUID v4 string to use as the account ID.\n */\nexport function generateEthAccountId(address: string): AccountId {\n  const normalized = normalize(address) as string;\n  return uuidv4({\n    random: sha256(hexToBytes(normalized)).slice(0, 16),\n  });\n}\n"]}

package/dist/eth/eth-keyring-wrapper.cjs

@@ -6,6 +6,7 @@ const eth_sig_util_1 = require("@metamask/eth-sig-util");
 const keyring_api_1 = require("@metamask/keyring-api");
 const superstruct_1 = require("@metamask/superstruct");
 const utils_1 = require("@metamask/utils");
+const account_id_1 = require("./account-id.cjs");
 const keyring_wrapper_1 = require("../keyring-wrapper.cjs");
 /**
  * Additional Ethereum methods supported by Eth keyrings that are not in the standard EthMethod enum.
@@ -32,6 +33,14 @@ var EthKeyringMethod;
  * - `exportAccount()` (optional): Export private key in specified format
  */
 class EthKeyringWrapper extends keyring_wrapper_1.KeyringWrapper {
+    constructor(options) {
+        super({
+            ...options,
+            // We use a custom ID generator to ensure that account IDs are deterministic based on
+            // the Ethereum address.
+            registryOptions: { generateId: account_id_1.generateEthAccountId },
+        });
+    }
     /**
      * Helper method to safely cast a KeyringAccount address to Hex type.
      * The KeyringAccount.address is typed as string, but for Ethereum accounts

package/dist/eth/eth-keyring-wrapper.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"eth-keyring-wrapper.cjs","sourceRoot":"","sources":["../../src/eth/eth-keyring-wrapper.ts"],"names":[],"mappings":"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","sourcesContent":["import { TransactionFactory, type TypedTxData } from '@ethereumjs/tx';\nimport type { MessageTypes, TypedMessage } from '@metamask/eth-sig-util';\nimport { SignTypedDataVersion } from '@metamask/eth-sig-util';\nimport type { KeyringAccount, KeyringRequest } from '@metamask/keyring-api';\nimport {\n  EthDecryptParamsStruct,\n  EthGetAppKeyAddressParamsStruct,\n  EthGetEncryptionPublicKeyParamsStruct,\n  EthPersonalSignParamsStruct,\n  EthSignEip7702AuthorizationParamsStruct,\n  EthSignParamsStruct,\n  EthSignTransactionParamsStruct,\n  EthSignTypedDataParamsStruct,\n  EthSignTypedDataV1ParamsStruct,\n  EthMethod,\n} from '@metamask/keyring-api';\nimport type { EthKeyring } from '@metamask/keyring-utils';\nimport { assert } from '@metamask/superstruct';\nimport { add0x, type Hex, type Json } from '@metamask/utils';\n\nimport { KeyringWrapper, type KeyringWrapperOptions } from '../keyring-wrapper';\n\n/**\n * Additional Ethereum methods supported by Eth keyrings that are not in the standard EthMethod enum.\n * These are primarily encryption and utility methods.\n */\nexport enum EthKeyringMethod {\n  Decrypt = 'eth_decrypt',\n  GetEncryptionPublicKey = 'eth_getEncryptionPublicKey',\n  GetAppKeyAddress = 'eth_getAppKeyAddress',\n  SignEip7702Authorization = 'eth_signEip7702Authorization',\n}\n\n/**\n * Options for constructing an EthKeyringWrapper.\n */\nexport type EthKeyringWrapperOptions<InnerKeyring extends EthKeyring> =\n  KeyringWrapperOptions<InnerKeyring>;\n\n/**\n * Abstract wrapper for Ethereum-based keyrings that extends KeyringWrapper, that itself implements KeyringV2.\n *\n * This class provides common functionality for all Ethereum keyrings including:\n * - Request handling for standard Ethereum signing methods\n * - Helper methods for Hex address conversion\n *\n * Subclasses must implement:\n * - `getAccounts()`: Return all managed accounts\n * - `createAccounts()`: Create new accounts based on options\n * - `deleteAccount()`: Remove an account from the keyring\n * - `exportAccount()` (optional): Export private key in specified format\n */\nexport abstract class EthKeyringWrapper<\n  InnerKeyring extends EthKeyring,\n  KeyringAccountType extends KeyringAccount = KeyringAccount,\n> extends KeyringWrapper<InnerKeyring, KeyringAccountType> {\n  /**\n   * Helper method to safely cast a KeyringAccount address to Hex type.\n   * The KeyringAccount.address is typed as string, but for Ethereum accounts\n   * it should always be a valid Hex address.\n   *\n   * @param address - The address from a KeyringAccount.\n   * @returns The address as Hex type.\n   */\n  protected toHexAddress(address: string): Hex {\n    return add0x(address);\n  }\n\n  /**\n   * Handle an Ethereum signing request.\n   *\n   * Routes the request to the appropriate legacy keyring method based on\n   * the RPC method name.\n   *\n   * @param request - The keyring request containing method and params.\n   * @returns The result of the signing operation.\n   */\n  async submitRequest(request: KeyringRequest): Promise<Json> {\n    const { method, params } = request.request;\n\n    const { address, methods } = await this.getAccount(request.account);\n    const hexAddress = this.toHexAddress(address);\n\n    // Validate account can handle the method\n    if (!methods.includes(method)) {\n      throw new Error(\n        `Account ${request.account} cannot handle method: ${method}`,\n      );\n    }\n\n    switch (method) {\n      case `${EthMethod.SignTransaction}`: {\n        if (!this.inner.signTransaction) {\n          throw new Error('Keyring does not support signTransaction');\n        }\n        assert(params, EthSignTransactionParamsStruct);\n        const [txData] = params;\n        // Convert validated transaction data to TypedTransaction\n        // TODO: Improve typing to ensure txData matches TypedTxData\n        const tx = TransactionFactory.fromTxData(txData as TypedTxData);\n        // Note: Bigints are not directly representable in JSON\n        return (await this.inner.signTransaction(\n          hexAddress,\n          tx,\n        )) as unknown as Json; // FIXME: Should return type be unknown?\n      }\n\n      case `${EthMethod.Sign}`: {\n        if (!this.inner.signMessage) {\n          throw new Error('Keyring does not support signMessage');\n        }\n        assert(params, EthSignParamsStruct);\n        const [, data] = params;\n        return this.inner.signMessage(hexAddress, data);\n      }\n\n      case `${EthMethod.PersonalSign}`: {\n        if (!this.inner.signPersonalMessage) {\n          throw new Error('Keyring does not support signPersonalMessage');\n        }\n        assert(params, EthPersonalSignParamsStruct);\n        const [data] = params;\n        return this.inner.signPersonalMessage(hexAddress, data as Hex);\n      }\n\n      case `${EthMethod.SignTypedDataV1}`: {\n        if (!this.inner.signTypedData) {\n          throw new Error('Keyring does not support signTypedData');\n        }\n        assert(params, EthSignTypedDataV1ParamsStruct);\n        const [, data] = params;\n        return this.inner.signTypedData(hexAddress, data, {\n          version: SignTypedDataVersion.V1,\n        });\n      }\n\n      case `${EthMethod.SignTypedDataV3}`: {\n        if (!this.inner.signTypedData) {\n          throw new Error('Keyring does not support signTypedData');\n        }\n        assert(params, EthSignTypedDataParamsStruct);\n        const [, data] = params;\n        return this.inner.signTypedData(\n          hexAddress,\n          // TODO: Improve typing to ensure data matches MessageTypes\n          data as TypedMessage<MessageTypes>,\n          {\n            version: SignTypedDataVersion.V3,\n          },\n        );\n      }\n\n      case `${EthMethod.SignTypedDataV4}`: {\n        if (!this.inner.signTypedData) {\n          throw new Error('Keyring does not support signTypedData');\n        }\n        assert(params, EthSignTypedDataParamsStruct);\n        const [, data] = params;\n        return this.inner.signTypedData(\n          hexAddress,\n          // TODO: Improve typing to ensure data matches MessageTypes\n          data as TypedMessage<MessageTypes>,\n          {\n            version: SignTypedDataVersion.V4,\n          },\n        );\n      }\n\n      case `${EthKeyringMethod.Decrypt}`: {\n        if (!this.inner.decryptMessage) {\n          throw new Error('Keyring does not support decryptMessage');\n        }\n        assert(params, EthDecryptParamsStruct);\n        const [encryptedData] = params;\n        return this.inner.decryptMessage(hexAddress, encryptedData);\n      }\n\n      case `${EthKeyringMethod.GetEncryptionPublicKey}`: {\n        if (!this.inner.getEncryptionPublicKey) {\n          throw new Error('Keyring does not support getEncryptionPublicKey');\n        }\n        assert(params, EthGetEncryptionPublicKeyParamsStruct);\n        const [, options] = params;\n        return this.inner.getEncryptionPublicKey(hexAddress, options);\n      }\n\n      case `${EthKeyringMethod.GetAppKeyAddress}`: {\n        if (!this.inner.getAppKeyAddress) {\n          throw new Error('Keyring does not support getAppKeyAddress');\n        }\n        assert(params, EthGetAppKeyAddressParamsStruct);\n        const [origin] = params;\n        return this.inner.getAppKeyAddress(hexAddress, origin);\n      }\n\n      case `${EthKeyringMethod.SignEip7702Authorization}`: {\n        if (!this.inner.signEip7702Authorization) {\n          throw new Error('Keyring does not support signEip7702Authorization');\n        }\n        assert(params, EthSignEip7702AuthorizationParamsStruct);\n        const [authorization] = params;\n        return this.inner.signEip7702Authorization(hexAddress, authorization);\n      }\n\n      default:\n        throw new Error(`Unsupported method for EthKeyringWrapper: ${method}`);\n    }\n  }\n}\n"]}
+{"version":3,"file":"eth-keyring-wrapper.cjs","sourceRoot":"","sources":["../../src/eth/eth-keyring-wrapper.ts"],"names":[],"mappings":"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","sourcesContent":["import { TransactionFactory, type TypedTxData } from '@ethereumjs/tx';\nimport type { MessageTypes, TypedMessage } from '@metamask/eth-sig-util';\nimport { SignTypedDataVersion } from '@metamask/eth-sig-util';\nimport type { KeyringAccount, KeyringRequest } from '@metamask/keyring-api';\nimport {\n  EthDecryptParamsStruct,\n  EthGetAppKeyAddressParamsStruct,\n  EthGetEncryptionPublicKeyParamsStruct,\n  EthPersonalSignParamsStruct,\n  EthSignEip7702AuthorizationParamsStruct,\n  EthSignParamsStruct,\n  EthSignTransactionParamsStruct,\n  EthSignTypedDataParamsStruct,\n  EthSignTypedDataV1ParamsStruct,\n  EthMethod,\n} from '@metamask/keyring-api';\nimport type { EthKeyring } from '@metamask/keyring-utils';\nimport { assert } from '@metamask/superstruct';\nimport { add0x, type Hex, type Json } from '@metamask/utils';\n\nimport { generateEthAccountId } from './account-id';\nimport { KeyringWrapper, type KeyringWrapperOptions } from '../keyring-wrapper';\n\n/**\n * Additional Ethereum methods supported by Eth keyrings that are not in the standard EthMethod enum.\n * These are primarily encryption and utility methods.\n */\nexport enum EthKeyringMethod {\n  Decrypt = 'eth_decrypt',\n  GetEncryptionPublicKey = 'eth_getEncryptionPublicKey',\n  GetAppKeyAddress = 'eth_getAppKeyAddress',\n  SignEip7702Authorization = 'eth_signEip7702Authorization',\n}\n\n/**\n * Options for constructing an {@link EthKeyringWrapper}.\n *\n * `registryOptions` is intentionally omitted: the registry is always\n * configured with {@link generateEthAccountId} to produce deterministic\n * account IDs for Ethereum addresses.\n */\nexport type EthKeyringWrapperOptions<InnerKeyring extends EthKeyring> = Omit<\n  KeyringWrapperOptions<InnerKeyring>,\n  'registryOptions'\n>;\n\n/**\n * Abstract wrapper for Ethereum-based keyrings that extends KeyringWrapper, that itself implements KeyringV2.\n *\n * This class provides common functionality for all Ethereum keyrings including:\n * - Request handling for standard Ethereum signing methods\n * - Helper methods for Hex address conversion\n *\n * Subclasses must implement:\n * - `getAccounts()`: Return all managed accounts\n * - `createAccounts()`: Create new accounts based on options\n * - `deleteAccount()`: Remove an account from the keyring\n * - `exportAccount()` (optional): Export private key in specified format\n */\nexport abstract class EthKeyringWrapper<\n  InnerKeyring extends EthKeyring,\n  KeyringAccountType extends KeyringAccount = KeyringAccount,\n> extends KeyringWrapper<InnerKeyring, KeyringAccountType> {\n  constructor(options: EthKeyringWrapperOptions<InnerKeyring>) {\n    super({\n      ...options,\n      // We use a custom ID generator to ensure that account IDs are deterministic based on\n      // the Ethereum address.\n      registryOptions: { generateId: generateEthAccountId },\n    });\n  }\n\n  /**\n   * Helper method to safely cast a KeyringAccount address to Hex type.\n   * The KeyringAccount.address is typed as string, but for Ethereum accounts\n   * it should always be a valid Hex address.\n   *\n   * @param address - The address from a KeyringAccount.\n   * @returns The address as Hex type.\n   */\n  protected toHexAddress(address: string): Hex {\n    return add0x(address);\n  }\n\n  /**\n   * Handle an Ethereum signing request.\n   *\n   * Routes the request to the appropriate legacy keyring method based on\n   * the RPC method name.\n   *\n   * @param request - The keyring request containing method and params.\n   * @returns The result of the signing operation.\n   */\n  async submitRequest(request: KeyringRequest): Promise<Json> {\n    const { method, params } = request.request;\n\n    const { address, methods } = await this.getAccount(request.account);\n    const hexAddress = this.toHexAddress(address);\n\n    // Validate account can handle the method\n    if (!methods.includes(method)) {\n      throw new Error(\n        `Account ${request.account} cannot handle method: ${method}`,\n      );\n    }\n\n    switch (method) {\n      case `${EthMethod.SignTransaction}`: {\n        if (!this.inner.signTransaction) {\n          throw new Error('Keyring does not support signTransaction');\n        }\n        assert(params, EthSignTransactionParamsStruct);\n        const [txData] = params;\n        // Convert validated transaction data to TypedTransaction\n        // TODO: Improve typing to ensure txData matches TypedTxData\n        const tx = TransactionFactory.fromTxData(txData as TypedTxData);\n        // Note: Bigints are not directly representable in JSON\n        return (await this.inner.signTransaction(\n          hexAddress,\n          tx,\n        )) as unknown as Json; // FIXME: Should return type be unknown?\n      }\n\n      case `${EthMethod.Sign}`: {\n        if (!this.inner.signMessage) {\n          throw new Error('Keyring does not support signMessage');\n        }\n        assert(params, EthSignParamsStruct);\n        const [, data] = params;\n        return this.inner.signMessage(hexAddress, data);\n      }\n\n      case `${EthMethod.PersonalSign}`: {\n        if (!this.inner.signPersonalMessage) {\n          throw new Error('Keyring does not support signPersonalMessage');\n        }\n        assert(params, EthPersonalSignParamsStruct);\n        const [data] = params;\n        return this.inner.signPersonalMessage(hexAddress, data as Hex);\n      }\n\n      case `${EthMethod.SignTypedDataV1}`: {\n        if (!this.inner.signTypedData) {\n          throw new Error('Keyring does not support signTypedData');\n        }\n        assert(params, EthSignTypedDataV1ParamsStruct);\n        const [, data] = params;\n        return this.inner.signTypedData(hexAddress, data, {\n          version: SignTypedDataVersion.V1,\n        });\n      }\n\n      case `${EthMethod.SignTypedDataV3}`: {\n        if (!this.inner.signTypedData) {\n          throw new Error('Keyring does not support signTypedData');\n        }\n        assert(params, EthSignTypedDataParamsStruct);\n        const [, data] = params;\n        return this.inner.signTypedData(\n          hexAddress,\n          // TODO: Improve typing to ensure data matches MessageTypes\n          data as TypedMessage<MessageTypes>,\n          {\n            version: SignTypedDataVersion.V3,\n          },\n        );\n      }\n\n      case `${EthMethod.SignTypedDataV4}`: {\n        if (!this.inner.signTypedData) {\n          throw new Error('Keyring does not support signTypedData');\n        }\n        assert(params, EthSignTypedDataParamsStruct);\n        const [, data] = params;\n        return this.inner.signTypedData(\n          hexAddress,\n          // TODO: Improve typing to ensure data matches MessageTypes\n          data as TypedMessage<MessageTypes>,\n          {\n            version: SignTypedDataVersion.V4,\n          },\n        );\n      }\n\n      case `${EthKeyringMethod.Decrypt}`: {\n        if (!this.inner.decryptMessage) {\n          throw new Error('Keyring does not support decryptMessage');\n        }\n        assert(params, EthDecryptParamsStruct);\n        const [encryptedData] = params;\n        return this.inner.decryptMessage(hexAddress, encryptedData);\n      }\n\n      case `${EthKeyringMethod.GetEncryptionPublicKey}`: {\n        if (!this.inner.getEncryptionPublicKey) {\n          throw new Error('Keyring does not support getEncryptionPublicKey');\n        }\n        assert(params, EthGetEncryptionPublicKeyParamsStruct);\n        const [, options] = params;\n        return this.inner.getEncryptionPublicKey(hexAddress, options);\n      }\n\n      case `${EthKeyringMethod.GetAppKeyAddress}`: {\n        if (!this.inner.getAppKeyAddress) {\n          throw new Error('Keyring does not support getAppKeyAddress');\n        }\n        assert(params, EthGetAppKeyAddressParamsStruct);\n        const [origin] = params;\n        return this.inner.getAppKeyAddress(hexAddress, origin);\n      }\n\n      case `${EthKeyringMethod.SignEip7702Authorization}`: {\n        if (!this.inner.signEip7702Authorization) {\n          throw new Error('Keyring does not support signEip7702Authorization');\n        }\n        assert(params, EthSignEip7702AuthorizationParamsStruct);\n        const [authorization] = params;\n        return this.inner.signEip7702Authorization(hexAddress, authorization);\n      }\n\n      default:\n        throw new Error(`Unsupported method for EthKeyringWrapper: ${method}`);\n    }\n  }\n}\n"]}

package/dist/eth/eth-keyring-wrapper.d.cts

@@ -13,9 +13,13 @@ export declare enum EthKeyringMethod {
     SignEip7702Authorization = "eth_signEip7702Authorization"
 }
 /**
- * Options for constructing an EthKeyringWrapper.
+ * Options for constructing an {@link EthKeyringWrapper}.
+ *
+ * `registryOptions` is intentionally omitted: the registry is always
+ * configured with {@link generateEthAccountId} to produce deterministic
+ * account IDs for Ethereum addresses.
  */
-export type EthKeyringWrapperOptions<InnerKeyring extends EthKeyring> = KeyringWrapperOptions<InnerKeyring>;
+export type EthKeyringWrapperOptions<InnerKeyring extends EthKeyring> = Omit<KeyringWrapperOptions<InnerKeyring>, 'registryOptions'>;
 /**
  * Abstract wrapper for Ethereum-based keyrings that extends KeyringWrapper, that itself implements KeyringV2.
  *
@@ -30,6 +34,7 @@ export type EthKeyringWrapperOptions<InnerKeyring extends EthKeyring> = KeyringW
  * - `exportAccount()` (optional): Export private key in specified format
  */
 export declare abstract class EthKeyringWrapper<InnerKeyring extends EthKeyring, KeyringAccountType extends KeyringAccount = KeyringAccount> extends KeyringWrapper<InnerKeyring, KeyringAccountType> {
+    constructor(options: EthKeyringWrapperOptions<InnerKeyring>);
     /**
      * Helper method to safely cast a KeyringAccount address to Hex type.
      * The KeyringAccount.address is typed as string, but for Ethereum accounts

package/dist/eth/eth-keyring-wrapper.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"eth-keyring-wrapper.d.cts","sourceRoot":"","sources":["../../src/eth/eth-keyring-wrapper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,8BAA8B;AAa5E,OAAO,KAAK,EAAE,UAAU,EAAE,gCAAgC;AAE1D,OAAO,EAAS,KAAK,GAAG,EAAE,KAAK,IAAI,EAAE,wBAAwB;AAE7D,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,+BAA2B;AAEhF;;;GAGG;AACH,oBAAY,gBAAgB;IAC1B,OAAO,gBAAgB;IACvB,sBAAsB,+BAA+B;IACrD,gBAAgB,yBAAyB;IACzC,wBAAwB,iCAAiC;CAC1D;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,CAAC,YAAY,SAAS,UAAU,IAClE,qBAAqB,CAAC,YAAY,CAAC,CAAC;AAEtC;;;;;;;;;;;;GAYG;AACH,8BAAsB,iBAAiB,CACrC,YAAY,SAAS,UAAU,EAC/B,kBAAkB,SAAS,cAAc,GAAG,cAAc,CAC1D,SAAQ,cAAc,CAAC,YAAY,EAAE,kBAAkB,CAAC;IACxD;;;;;;;OAOG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG;IAI5C;;;;;;;;OAQG;IACG,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAmI5D"}
+{"version":3,"file":"eth-keyring-wrapper.d.cts","sourceRoot":"","sources":["../../src/eth/eth-keyring-wrapper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,8BAA8B;AAa5E,OAAO,KAAK,EAAE,UAAU,EAAE,gCAAgC;AAE1D,OAAO,EAAS,KAAK,GAAG,EAAE,KAAK,IAAI,EAAE,wBAAwB;AAG7D,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,+BAA2B;AAEhF;;;GAGG;AACH,oBAAY,gBAAgB;IAC1B,OAAO,gBAAgB;IACvB,sBAAsB,+BAA+B;IACrD,gBAAgB,yBAAyB;IACzC,wBAAwB,iCAAiC;CAC1D;AAED;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,CAAC,YAAY,SAAS,UAAU,IAAI,IAAI,CAC1E,qBAAqB,CAAC,YAAY,CAAC,EACnC,iBAAiB,CAClB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,8BAAsB,iBAAiB,CACrC,YAAY,SAAS,UAAU,EAC/B,kBAAkB,SAAS,cAAc,GAAG,cAAc,CAC1D,SAAQ,cAAc,CAAC,YAAY,EAAE,kBAAkB,CAAC;gBAC5C,OAAO,EAAE,wBAAwB,CAAC,YAAY,CAAC;IAS3D;;;;;;;OAOG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG;IAI5C;;;;;;;;OAQG;IACG,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAmI5D"}

package/dist/eth/eth-keyring-wrapper.d.mts

@@ -13,9 +13,13 @@ export declare enum EthKeyringMethod {
     SignEip7702Authorization = "eth_signEip7702Authorization"
 }
 /**
- * Options for constructing an EthKeyringWrapper.
+ * Options for constructing an {@link EthKeyringWrapper}.
+ *
+ * `registryOptions` is intentionally omitted: the registry is always
+ * configured with {@link generateEthAccountId} to produce deterministic
+ * account IDs for Ethereum addresses.
  */
-export type EthKeyringWrapperOptions<InnerKeyring extends EthKeyring> = KeyringWrapperOptions<InnerKeyring>;
+export type EthKeyringWrapperOptions<InnerKeyring extends EthKeyring> = Omit<KeyringWrapperOptions<InnerKeyring>, 'registryOptions'>;
 /**
  * Abstract wrapper for Ethereum-based keyrings that extends KeyringWrapper, that itself implements KeyringV2.
  *
@@ -30,6 +34,7 @@ export type EthKeyringWrapperOptions<InnerKeyring extends EthKeyring> = KeyringW
  * - `exportAccount()` (optional): Export private key in specified format
  */
 export declare abstract class EthKeyringWrapper<InnerKeyring extends EthKeyring, KeyringAccountType extends KeyringAccount = KeyringAccount> extends KeyringWrapper<InnerKeyring, KeyringAccountType> {
+    constructor(options: EthKeyringWrapperOptions<InnerKeyring>);
     /**
      * Helper method to safely cast a KeyringAccount address to Hex type.
      * The KeyringAccount.address is typed as string, but for Ethereum accounts

package/dist/eth/eth-keyring-wrapper.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"eth-keyring-wrapper.d.mts","sourceRoot":"","sources":["../../src/eth/eth-keyring-wrapper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,8BAA8B;AAa5E,OAAO,KAAK,EAAE,UAAU,EAAE,gCAAgC;AAE1D,OAAO,EAAS,KAAK,GAAG,EAAE,KAAK,IAAI,EAAE,wBAAwB;AAE7D,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,+BAA2B;AAEhF;;;GAGG;AACH,oBAAY,gBAAgB;IAC1B,OAAO,gBAAgB;IACvB,sBAAsB,+BAA+B;IACrD,gBAAgB,yBAAyB;IACzC,wBAAwB,iCAAiC;CAC1D;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,CAAC,YAAY,SAAS,UAAU,IAClE,qBAAqB,CAAC,YAAY,CAAC,CAAC;AAEtC;;;;;;;;;;;;GAYG;AACH,8BAAsB,iBAAiB,CACrC,YAAY,SAAS,UAAU,EAC/B,kBAAkB,SAAS,cAAc,GAAG,cAAc,CAC1D,SAAQ,cAAc,CAAC,YAAY,EAAE,kBAAkB,CAAC;IACxD;;;;;;;OAOG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG;IAI5C;;;;;;;;OAQG;IACG,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAmI5D"}
+{"version":3,"file":"eth-keyring-wrapper.d.mts","sourceRoot":"","sources":["../../src/eth/eth-keyring-wrapper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,8BAA8B;AAa5E,OAAO,KAAK,EAAE,UAAU,EAAE,gCAAgC;AAE1D,OAAO,EAAS,KAAK,GAAG,EAAE,KAAK,IAAI,EAAE,wBAAwB;AAG7D,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,+BAA2B;AAEhF;;;GAGG;AACH,oBAAY,gBAAgB;IAC1B,OAAO,gBAAgB;IACvB,sBAAsB,+BAA+B;IACrD,gBAAgB,yBAAyB;IACzC,wBAAwB,iCAAiC;CAC1D;AAED;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,CAAC,YAAY,SAAS,UAAU,IAAI,IAAI,CAC1E,qBAAqB,CAAC,YAAY,CAAC,EACnC,iBAAiB,CAClB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,8BAAsB,iBAAiB,CACrC,YAAY,SAAS,UAAU,EAC/B,kBAAkB,SAAS,cAAc,GAAG,cAAc,CAC1D,SAAQ,cAAc,CAAC,YAAY,EAAE,kBAAkB,CAAC;gBAC5C,OAAO,EAAE,wBAAwB,CAAC,YAAY,CAAC;IAS3D;;;;;;;OAOG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG;IAI5C;;;;;;;;OAQG;IACG,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAmI5D"}

package/dist/eth/eth-keyring-wrapper.mjs

@@ -3,6 +3,7 @@ import { SignTypedDataVersion } from "@metamask/eth-sig-util";
 import { EthDecryptParamsStruct, EthGetAppKeyAddressParamsStruct, EthGetEncryptionPublicKeyParamsStruct, EthPersonalSignParamsStruct, EthSignEip7702AuthorizationParamsStruct, EthSignParamsStruct, EthSignTransactionParamsStruct, EthSignTypedDataParamsStruct, EthSignTypedDataV1ParamsStruct, EthMethod } from "@metamask/keyring-api";
 import { assert } from "@metamask/superstruct";
 import { add0x } from "@metamask/utils";
+import { generateEthAccountId } from "./account-id.mjs";
 import { KeyringWrapper } from "../keyring-wrapper.mjs";
 /**
  * Additional Ethereum methods supported by Eth keyrings that are not in the standard EthMethod enum.
@@ -29,6 +30,14 @@ export var EthKeyringMethod;
  * - `exportAccount()` (optional): Export private key in specified format
  */
 export class EthKeyringWrapper extends KeyringWrapper {
+    constructor(options) {
+        super({
+            ...options,
+            // We use a custom ID generator to ensure that account IDs are deterministic based on
+            // the Ethereum address.
+            registryOptions: { generateId: generateEthAccountId },
+        });
+    }
     /**
      * Helper method to safely cast a KeyringAccount address to Hex type.
      * The KeyringAccount.address is typed as string, but for Ethereum accounts

package/dist/eth/eth-keyring-wrapper.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"eth-keyring-wrapper.mjs","sourceRoot":"","sources":["../../src/eth/eth-keyring-wrapper.ts"],"names":[],"mappings":"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","sourcesContent":["import { TransactionFactory, type TypedTxData } from '@ethereumjs/tx';\nimport type { MessageTypes, TypedMessage } from '@metamask/eth-sig-util';\nimport { SignTypedDataVersion } from '@metamask/eth-sig-util';\nimport type { KeyringAccount, KeyringRequest } from '@metamask/keyring-api';\nimport {\n  EthDecryptParamsStruct,\n  EthGetAppKeyAddressParamsStruct,\n  EthGetEncryptionPublicKeyParamsStruct,\n  EthPersonalSignParamsStruct,\n  EthSignEip7702AuthorizationParamsStruct,\n  EthSignParamsStruct,\n  EthSignTransactionParamsStruct,\n  EthSignTypedDataParamsStruct,\n  EthSignTypedDataV1ParamsStruct,\n  EthMethod,\n} from '@metamask/keyring-api';\nimport type { EthKeyring } from '@metamask/keyring-utils';\nimport { assert } from '@metamask/superstruct';\nimport { add0x, type Hex, type Json } from '@metamask/utils';\n\nimport { KeyringWrapper, type KeyringWrapperOptions } from '../keyring-wrapper';\n\n/**\n * Additional Ethereum methods supported by Eth keyrings that are not in the standard EthMethod enum.\n * These are primarily encryption and utility methods.\n */\nexport enum EthKeyringMethod {\n  Decrypt = 'eth_decrypt',\n  GetEncryptionPublicKey = 'eth_getEncryptionPublicKey',\n  GetAppKeyAddress = 'eth_getAppKeyAddress',\n  SignEip7702Authorization = 'eth_signEip7702Authorization',\n}\n\n/**\n * Options for constructing an EthKeyringWrapper.\n */\nexport type EthKeyringWrapperOptions<InnerKeyring extends EthKeyring> =\n  KeyringWrapperOptions<InnerKeyring>;\n\n/**\n * Abstract wrapper for Ethereum-based keyrings that extends KeyringWrapper, that itself implements KeyringV2.\n *\n * This class provides common functionality for all Ethereum keyrings including:\n * - Request handling for standard Ethereum signing methods\n * - Helper methods for Hex address conversion\n *\n * Subclasses must implement:\n * - `getAccounts()`: Return all managed accounts\n * - `createAccounts()`: Create new accounts based on options\n * - `deleteAccount()`: Remove an account from the keyring\n * - `exportAccount()` (optional): Export private key in specified format\n */\nexport abstract class EthKeyringWrapper<\n  InnerKeyring extends EthKeyring,\n  KeyringAccountType extends KeyringAccount = KeyringAccount,\n> extends KeyringWrapper<InnerKeyring, KeyringAccountType> {\n  /**\n   * Helper method to safely cast a KeyringAccount address to Hex type.\n   * The KeyringAccount.address is typed as string, but for Ethereum accounts\n   * it should always be a valid Hex address.\n   *\n   * @param address - The address from a KeyringAccount.\n   * @returns The address as Hex type.\n   */\n  protected toHexAddress(address: string): Hex {\n    return add0x(address);\n  }\n\n  /**\n   * Handle an Ethereum signing request.\n   *\n   * Routes the request to the appropriate legacy keyring method based on\n   * the RPC method name.\n   *\n   * @param request - The keyring request containing method and params.\n   * @returns The result of the signing operation.\n   */\n  async submitRequest(request: KeyringRequest): Promise<Json> {\n    const { method, params } = request.request;\n\n    const { address, methods } = await this.getAccount(request.account);\n    const hexAddress = this.toHexAddress(address);\n\n    // Validate account can handle the method\n    if (!methods.includes(method)) {\n      throw new Error(\n        `Account ${request.account} cannot handle method: ${method}`,\n      );\n    }\n\n    switch (method) {\n      case `${EthMethod.SignTransaction}`: {\n        if (!this.inner.signTransaction) {\n          throw new Error('Keyring does not support signTransaction');\n        }\n        assert(params, EthSignTransactionParamsStruct);\n        const [txData] = params;\n        // Convert validated transaction data to TypedTransaction\n        // TODO: Improve typing to ensure txData matches TypedTxData\n        const tx = TransactionFactory.fromTxData(txData as TypedTxData);\n        // Note: Bigints are not directly representable in JSON\n        return (await this.inner.signTransaction(\n          hexAddress,\n          tx,\n        )) as unknown as Json; // FIXME: Should return type be unknown?\n      }\n\n      case `${EthMethod.Sign}`: {\n        if (!this.inner.signMessage) {\n          throw new Error('Keyring does not support signMessage');\n        }\n        assert(params, EthSignParamsStruct);\n        const [, data] = params;\n        return this.inner.signMessage(hexAddress, data);\n      }\n\n      case `${EthMethod.PersonalSign}`: {\n        if (!this.inner.signPersonalMessage) {\n          throw new Error('Keyring does not support signPersonalMessage');\n        }\n        assert(params, EthPersonalSignParamsStruct);\n        const [data] = params;\n        return this.inner.signPersonalMessage(hexAddress, data as Hex);\n      }\n\n      case `${EthMethod.SignTypedDataV1}`: {\n        if (!this.inner.signTypedData) {\n          throw new Error('Keyring does not support signTypedData');\n        }\n        assert(params, EthSignTypedDataV1ParamsStruct);\n        const [, data] = params;\n        return this.inner.signTypedData(hexAddress, data, {\n          version: SignTypedDataVersion.V1,\n        });\n      }\n\n      case `${EthMethod.SignTypedDataV3}`: {\n        if (!this.inner.signTypedData) {\n          throw new Error('Keyring does not support signTypedData');\n        }\n        assert(params, EthSignTypedDataParamsStruct);\n        const [, data] = params;\n        return this.inner.signTypedData(\n          hexAddress,\n          // TODO: Improve typing to ensure data matches MessageTypes\n          data as TypedMessage<MessageTypes>,\n          {\n            version: SignTypedDataVersion.V3,\n          },\n        );\n      }\n\n      case `${EthMethod.SignTypedDataV4}`: {\n        if (!this.inner.signTypedData) {\n          throw new Error('Keyring does not support signTypedData');\n        }\n        assert(params, EthSignTypedDataParamsStruct);\n        const [, data] = params;\n        return this.inner.signTypedData(\n          hexAddress,\n          // TODO: Improve typing to ensure data matches MessageTypes\n          data as TypedMessage<MessageTypes>,\n          {\n            version: SignTypedDataVersion.V4,\n          },\n        );\n      }\n\n      case `${EthKeyringMethod.Decrypt}`: {\n        if (!this.inner.decryptMessage) {\n          throw new Error('Keyring does not support decryptMessage');\n        }\n        assert(params, EthDecryptParamsStruct);\n        const [encryptedData] = params;\n        return this.inner.decryptMessage(hexAddress, encryptedData);\n      }\n\n      case `${EthKeyringMethod.GetEncryptionPublicKey}`: {\n        if (!this.inner.getEncryptionPublicKey) {\n          throw new Error('Keyring does not support getEncryptionPublicKey');\n        }\n        assert(params, EthGetEncryptionPublicKeyParamsStruct);\n        const [, options] = params;\n        return this.inner.getEncryptionPublicKey(hexAddress, options);\n      }\n\n      case `${EthKeyringMethod.GetAppKeyAddress}`: {\n        if (!this.inner.getAppKeyAddress) {\n          throw new Error('Keyring does not support getAppKeyAddress');\n        }\n        assert(params, EthGetAppKeyAddressParamsStruct);\n        const [origin] = params;\n        return this.inner.getAppKeyAddress(hexAddress, origin);\n      }\n\n      case `${EthKeyringMethod.SignEip7702Authorization}`: {\n        if (!this.inner.signEip7702Authorization) {\n          throw new Error('Keyring does not support signEip7702Authorization');\n        }\n        assert(params, EthSignEip7702AuthorizationParamsStruct);\n        const [authorization] = params;\n        return this.inner.signEip7702Authorization(hexAddress, authorization);\n      }\n\n      default:\n        throw new Error(`Unsupported method for EthKeyringWrapper: ${method}`);\n    }\n  }\n}\n"]}
+{"version":3,"file":"eth-keyring-wrapper.mjs","sourceRoot":"","sources":["../../src/eth/eth-keyring-wrapper.ts"],"names":[],"mappings":"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","sourcesContent":["import { TransactionFactory, type TypedTxData } from '@ethereumjs/tx';\nimport type { MessageTypes, TypedMessage } from '@metamask/eth-sig-util';\nimport { SignTypedDataVersion } from '@metamask/eth-sig-util';\nimport type { KeyringAccount, KeyringRequest } from '@metamask/keyring-api';\nimport {\n  EthDecryptParamsStruct,\n  EthGetAppKeyAddressParamsStruct,\n  EthGetEncryptionPublicKeyParamsStruct,\n  EthPersonalSignParamsStruct,\n  EthSignEip7702AuthorizationParamsStruct,\n  EthSignParamsStruct,\n  EthSignTransactionParamsStruct,\n  EthSignTypedDataParamsStruct,\n  EthSignTypedDataV1ParamsStruct,\n  EthMethod,\n} from '@metamask/keyring-api';\nimport type { EthKeyring } from '@metamask/keyring-utils';\nimport { assert } from '@metamask/superstruct';\nimport { add0x, type Hex, type Json } from '@metamask/utils';\n\nimport { generateEthAccountId } from './account-id';\nimport { KeyringWrapper, type KeyringWrapperOptions } from '../keyring-wrapper';\n\n/**\n * Additional Ethereum methods supported by Eth keyrings that are not in the standard EthMethod enum.\n * These are primarily encryption and utility methods.\n */\nexport enum EthKeyringMethod {\n  Decrypt = 'eth_decrypt',\n  GetEncryptionPublicKey = 'eth_getEncryptionPublicKey',\n  GetAppKeyAddress = 'eth_getAppKeyAddress',\n  SignEip7702Authorization = 'eth_signEip7702Authorization',\n}\n\n/**\n * Options for constructing an {@link EthKeyringWrapper}.\n *\n * `registryOptions` is intentionally omitted: the registry is always\n * configured with {@link generateEthAccountId} to produce deterministic\n * account IDs for Ethereum addresses.\n */\nexport type EthKeyringWrapperOptions<InnerKeyring extends EthKeyring> = Omit<\n  KeyringWrapperOptions<InnerKeyring>,\n  'registryOptions'\n>;\n\n/**\n * Abstract wrapper for Ethereum-based keyrings that extends KeyringWrapper, that itself implements KeyringV2.\n *\n * This class provides common functionality for all Ethereum keyrings including:\n * - Request handling for standard Ethereum signing methods\n * - Helper methods for Hex address conversion\n *\n * Subclasses must implement:\n * - `getAccounts()`: Return all managed accounts\n * - `createAccounts()`: Create new accounts based on options\n * - `deleteAccount()`: Remove an account from the keyring\n * - `exportAccount()` (optional): Export private key in specified format\n */\nexport abstract class EthKeyringWrapper<\n  InnerKeyring extends EthKeyring,\n  KeyringAccountType extends KeyringAccount = KeyringAccount,\n> extends KeyringWrapper<InnerKeyring, KeyringAccountType> {\n  constructor(options: EthKeyringWrapperOptions<InnerKeyring>) {\n    super({\n      ...options,\n      // We use a custom ID generator to ensure that account IDs are deterministic based on\n      // the Ethereum address.\n      registryOptions: { generateId: generateEthAccountId },\n    });\n  }\n\n  /**\n   * Helper method to safely cast a KeyringAccount address to Hex type.\n   * The KeyringAccount.address is typed as string, but for Ethereum accounts\n   * it should always be a valid Hex address.\n   *\n   * @param address - The address from a KeyringAccount.\n   * @returns The address as Hex type.\n   */\n  protected toHexAddress(address: string): Hex {\n    return add0x(address);\n  }\n\n  /**\n   * Handle an Ethereum signing request.\n   *\n   * Routes the request to the appropriate legacy keyring method based on\n   * the RPC method name.\n   *\n   * @param request - The keyring request containing method and params.\n   * @returns The result of the signing operation.\n   */\n  async submitRequest(request: KeyringRequest): Promise<Json> {\n    const { method, params } = request.request;\n\n    const { address, methods } = await this.getAccount(request.account);\n    const hexAddress = this.toHexAddress(address);\n\n    // Validate account can handle the method\n    if (!methods.includes(method)) {\n      throw new Error(\n        `Account ${request.account} cannot handle method: ${method}`,\n      );\n    }\n\n    switch (method) {\n      case `${EthMethod.SignTransaction}`: {\n        if (!this.inner.signTransaction) {\n          throw new Error('Keyring does not support signTransaction');\n        }\n        assert(params, EthSignTransactionParamsStruct);\n        const [txData] = params;\n        // Convert validated transaction data to TypedTransaction\n        // TODO: Improve typing to ensure txData matches TypedTxData\n        const tx = TransactionFactory.fromTxData(txData as TypedTxData);\n        // Note: Bigints are not directly representable in JSON\n        return (await this.inner.signTransaction(\n          hexAddress,\n          tx,\n        )) as unknown as Json; // FIXME: Should return type be unknown?\n      }\n\n      case `${EthMethod.Sign}`: {\n        if (!this.inner.signMessage) {\n          throw new Error('Keyring does not support signMessage');\n        }\n        assert(params, EthSignParamsStruct);\n        const [, data] = params;\n        return this.inner.signMessage(hexAddress, data);\n      }\n\n      case `${EthMethod.PersonalSign}`: {\n        if (!this.inner.signPersonalMessage) {\n          throw new Error('Keyring does not support signPersonalMessage');\n        }\n        assert(params, EthPersonalSignParamsStruct);\n        const [data] = params;\n        return this.inner.signPersonalMessage(hexAddress, data as Hex);\n      }\n\n      case `${EthMethod.SignTypedDataV1}`: {\n        if (!this.inner.signTypedData) {\n          throw new Error('Keyring does not support signTypedData');\n        }\n        assert(params, EthSignTypedDataV1ParamsStruct);\n        const [, data] = params;\n        return this.inner.signTypedData(hexAddress, data, {\n          version: SignTypedDataVersion.V1,\n        });\n      }\n\n      case `${EthMethod.SignTypedDataV3}`: {\n        if (!this.inner.signTypedData) {\n          throw new Error('Keyring does not support signTypedData');\n        }\n        assert(params, EthSignTypedDataParamsStruct);\n        const [, data] = params;\n        return this.inner.signTypedData(\n          hexAddress,\n          // TODO: Improve typing to ensure data matches MessageTypes\n          data as TypedMessage<MessageTypes>,\n          {\n            version: SignTypedDataVersion.V3,\n          },\n        );\n      }\n\n      case `${EthMethod.SignTypedDataV4}`: {\n        if (!this.inner.signTypedData) {\n          throw new Error('Keyring does not support signTypedData');\n        }\n        assert(params, EthSignTypedDataParamsStruct);\n        const [, data] = params;\n        return this.inner.signTypedData(\n          hexAddress,\n          // TODO: Improve typing to ensure data matches MessageTypes\n          data as TypedMessage<MessageTypes>,\n          {\n            version: SignTypedDataVersion.V4,\n          },\n        );\n      }\n\n      case `${EthKeyringMethod.Decrypt}`: {\n        if (!this.inner.decryptMessage) {\n          throw new Error('Keyring does not support decryptMessage');\n        }\n        assert(params, EthDecryptParamsStruct);\n        const [encryptedData] = params;\n        return this.inner.decryptMessage(hexAddress, encryptedData);\n      }\n\n      case `${EthKeyringMethod.GetEncryptionPublicKey}`: {\n        if (!this.inner.getEncryptionPublicKey) {\n          throw new Error('Keyring does not support getEncryptionPublicKey');\n        }\n        assert(params, EthGetEncryptionPublicKeyParamsStruct);\n        const [, options] = params;\n        return this.inner.getEncryptionPublicKey(hexAddress, options);\n      }\n\n      case `${EthKeyringMethod.GetAppKeyAddress}`: {\n        if (!this.inner.getAppKeyAddress) {\n          throw new Error('Keyring does not support getAppKeyAddress');\n        }\n        assert(params, EthGetAppKeyAddressParamsStruct);\n        const [origin] = params;\n        return this.inner.getAppKeyAddress(hexAddress, origin);\n      }\n\n      case `${EthKeyringMethod.SignEip7702Authorization}`: {\n        if (!this.inner.signEip7702Authorization) {\n          throw new Error('Keyring does not support signEip7702Authorization');\n        }\n        assert(params, EthSignEip7702AuthorizationParamsStruct);\n        const [authorization] = params;\n        return this.inner.signEip7702Authorization(hexAddress, authorization);\n      }\n\n      default:\n        throw new Error(`Unsupported method for EthKeyringWrapper: ${method}`);\n    }\n  }\n}\n"]}

package/dist/eth/index.cjs

@@ -14,5 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./account-id.cjs"), exports);
 __exportStar(require("./eth-keyring-wrapper.cjs"), exports);
 //# sourceMappingURL=index.cjs.map

package/dist/eth/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAAsC","sourcesContent":["export * from './eth-keyring-wrapper';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAA6B;AAC7B,4DAAsC","sourcesContent":["export * from './account-id';\nexport * from './eth-keyring-wrapper';\n"]}

package/dist/eth/index.d.cts

@@ -1,2 +1,3 @@
+export * from "./account-id.cjs";
 export * from "./eth-keyring-wrapper.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/eth/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":"AAAA,0CAAsC"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":"AAAA,iCAA6B;AAC7B,0CAAsC"}

package/dist/eth/index.d.mts

@@ -1,2 +1,3 @@
+export * from "./account-id.mjs";
 export * from "./eth-keyring-wrapper.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/eth/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":"AAAA,0CAAsC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":"AAAA,iCAA6B;AAC7B,0CAAsC"}

package/dist/eth/index.mjs

@@ -1,2 +1,3 @@
+export * from "./account-id.mjs";
 export * from "./eth-keyring-wrapper.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/eth/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":"AAAA,0CAAsC","sourcesContent":["export * from './eth-keyring-wrapper';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/eth/index.ts"],"names":[],"mappings":"AAAA,iCAA6B;AAC7B,0CAAsC","sourcesContent":["export * from './account-id';\nexport * from './eth-keyring-wrapper';\n"]}

package/dist/keyring-account-registry.cjs

@@ -1,10 +1,16 @@
 "use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
 var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _KeyringAccountRegistry_accountById, _KeyringAccountRegistry_idByAddress;
+var _KeyringAccountRegistry_accountById, _KeyringAccountRegistry_idByAddress, _KeyringAccountRegistry_generateId;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KeyringAccountRegistry = void 0;
 const uuid_1 = require("uuid");
@@ -15,9 +21,17 @@ const uuid_1 = require("uuid");
  * KeyringAccount objects for efficient retrieval.
  */
 class KeyringAccountRegistry {
-    constructor() {
+    /**
+     * Create a new KeyringAccountRegistry.
+     *
+     * @param options - Optional configuration.
+     * @param options.generateId - Custom ID generator. Defaults to `uuidv4`.
+     */
+    constructor(options) {
         _KeyringAccountRegistry_accountById.set(this, new Map());
         _KeyringAccountRegistry_idByAddress.set(this, new Map());
+        _KeyringAccountRegistry_generateId.set(this, void 0);
+        __classPrivateFieldSet(this, _KeyringAccountRegistry_generateId, options?.generateId ?? (() => (0, uuid_1.v4)()), "f");
     }
     /**
      * Get an account by its account ID.
@@ -58,7 +72,7 @@ class KeyringAccountRegistry {
         if (existing) {
             return existing;
         }
-        const id = (0, uuid_1.v4)();
+        const id = __classPrivateFieldGet(this, _KeyringAccountRegistry_generateId, "f").call(this, address);
         __classPrivateFieldGet(this, _KeyringAccountRegistry_idByAddress, "f").set(address, id);
         return id;
     }
@@ -131,5 +145,5 @@ class KeyringAccountRegistry {
     }
 }
 exports.KeyringAccountRegistry = KeyringAccountRegistry;
-_KeyringAccountRegistry_accountById = new WeakMap(), _KeyringAccountRegistry_idByAddress = new WeakMap();
+_KeyringAccountRegistry_accountById = new WeakMap(), _KeyringAccountRegistry_idByAddress = new WeakMap(), _KeyringAccountRegistry_generateId = new WeakMap();
 //# sourceMappingURL=keyring-account-registry.cjs.map

package/dist/keyring-account-registry.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"keyring-account-registry.cjs","sourceRoot":"","sources":["../src/keyring-account-registry.ts"],"names":[],"mappings":";;;;;;;;;AAEA,+BAAoC;AAEpC;;;;;GAKG;AACH,MAAa,sBAAsB;IAAnC;QAGW,8CAAe,IAAI,GAAG,EAAiC,EAAC;QAExD,8CAAe,IAAI,GAAG,EAAqB,EAAC;IA0HvD,CAAC;IAxHC;;;;;OAKG;IACH,GAAG,CAAC,SAAoB;QACtB,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,SAAoB;QAC7B,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,OAAe;QAC1B,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,OAAe;QACtB,MAAM,QAAQ,GAAG,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,EAAE,GAAG,IAAA,SAAM,GAAE,CAAC;QACpB,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;;;;;OAUG;IACH,GAAG,CAAC,OAA2B;QAC7B,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC3C,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAoB;QACzB,MAAM,OAAO,GAAG,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,OAAO,EAAE,CAAC;YACZ,uBAAA,IAAI,2CAAa,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1C,uBAAA,IAAI,2CAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,uBAAA,IAAI,2CAAa,CAAC,KAAK,EAAE,CAAC;QAC1B,uBAAA,IAAI,2CAAa,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,2CAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,2CAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,SAAoB;QACtB,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,IAAI,IAAI;QACN,OAAO,uBAAA,IAAI,2CAAa,CAAC,IAAI,CAAC;IAChC,CAAC;CACF;AA/HD,wDA+HC","sourcesContent":["import type { KeyringAccount } from '@metamask/keyring-api';\nimport type { AccountId } from '@metamask/keyring-utils';\nimport { v4 as uuidv4 } from 'uuid';\n\n/**\n * In-memory registry for KeyringAccount objects.\n *\n * Provides O(1) lookups by account ID or address, and stores the full\n * KeyringAccount objects for efficient retrieval.\n */\nexport class KeyringAccountRegistry<\n  KeyringAccountType extends KeyringAccount = KeyringAccount,\n> {\n  readonly #accountById = new Map<AccountId, KeyringAccountType>();\n\n  readonly #idByAddress = new Map<string, AccountId>();\n\n  /**\n   * Get an account by its account ID.\n   *\n   * @param accountId - The account ID to look up.\n   * @returns The KeyringAccount, or undefined if not found.\n   */\n  get(accountId: AccountId): KeyringAccountType | undefined {\n    return this.#accountById.get(accountId);\n  }\n\n  /**\n   * Get an account's address by its account ID.\n   *\n   * @param accountId - The account ID to look up.\n   * @returns The address, or undefined if not found.\n   */\n  getAddress(accountId: AccountId): string | undefined {\n    return this.#accountById.get(accountId)?.address;\n  }\n\n  /**\n   * Get an account ID by the underlying address.\n   *\n   * @param address - The address to look up.\n   * @returns The account ID, or undefined if not found.\n   */\n  getAccountId(address: string): AccountId | undefined {\n    return this.#idByAddress.get(address);\n  }\n\n  /**\n   * Register a new address and generate an account ID for it.\n   * If the address is already registered, returns the existing account ID.\n   *\n   * @param address - The address to register.\n   * @returns The account ID for this address.\n   */\n  register(address: string): AccountId {\n    const existing = this.#idByAddress.get(address);\n    if (existing) {\n      return existing;\n    }\n    const id = uuidv4();\n    this.#idByAddress.set(address, id);\n    return id;\n  }\n\n  /**\n   * Add an account to the registry.\n   * Also registers the address → account ID mapping.\n   *\n   * ⚠️ If an address was previously registered via `register()` with a\n   * different account ID, calling `set()` with an account that has a new ID for\n   * the same address will overwrite the address → ID mapping. The old ID\n   * becomes \"dangling\" (i.e., `get(oldId)` will return undefined).\n   *\n   * @param account - The KeyringAccount to cache.\n   */\n  set(account: KeyringAccountType): void {\n    this.#accountById.set(account.id, account);\n    this.#idByAddress.set(account.address, account.id);\n  }\n\n  /**\n   * Remove an account from the registry.\n   *\n   * @param accountId - The account ID to remove.\n   */\n  delete(accountId: AccountId): void {\n    const account = this.#accountById.get(accountId);\n    if (account) {\n      this.#idByAddress.delete(account.address);\n      this.#accountById.delete(accountId);\n    }\n  }\n\n  /**\n   * Clear all accounts from the registry.\n   */\n  clear(): void {\n    this.#accountById.clear();\n    this.#idByAddress.clear();\n  }\n\n  /**\n   * Get all cached accounts as an array.\n   *\n   * @returns Array of all KeyringAccountType objects in the registry.\n   */\n  values(): KeyringAccountType[] {\n    return Array.from(this.#accountById.values());\n  }\n\n  /**\n   * Get all account IDs in the registry.\n   *\n   * @returns Array of all account IDs.\n   */\n  keys(): AccountId[] {\n    return Array.from(this.#accountById.keys());\n  }\n\n  /**\n   * Check if an account exists in the registry.\n   *\n   * @param accountId - The account ID to check.\n   * @returns True if the account exists.\n   */\n  has(accountId: AccountId): boolean {\n    return this.#accountById.has(accountId);\n  }\n\n  /**\n   * Get the number of accounts in the registry.\n   *\n   * @returns The number of accounts.\n   */\n  get size(): number {\n    return this.#accountById.size;\n  }\n}\n"]}
+{"version":3,"file":"keyring-account-registry.cjs","sourceRoot":"","sources":["../src/keyring-account-registry.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAEA,+BAAoC;AAepC;;;;;GAKG;AACH,MAAa,sBAAsB;IASjC;;;;;OAKG;IACH,YAAY,OAAuC;QAZ1C,8CAAe,IAAI,GAAG,EAAiC,EAAC;QAExD,8CAAe,IAAI,GAAG,EAAqB,EAAC;QAE5C,qDAA4C;QASnD,uBAAA,IAAI,sCAAe,OAAO,EAAE,UAAU,IAAI,CAAC,GAAc,EAAE,CAAC,IAAA,SAAM,GAAE,CAAC,MAAA,CAAC;IACxE,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,SAAoB;QACtB,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,SAAoB;QAC7B,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,OAAe;QAC1B,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,OAAe;QACtB,MAAM,QAAQ,GAAG,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,EAAE,GAAG,uBAAA,IAAI,0CAAY,MAAhB,IAAI,EAAa,OAAO,CAAC,CAAC;QACrC,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;;;;;OAUG;IACH,GAAG,CAAC,OAA2B;QAC7B,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC3C,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAoB;QACzB,MAAM,OAAO,GAAG,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,OAAO,EAAE,CAAC;YACZ,uBAAA,IAAI,2CAAa,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1C,uBAAA,IAAI,2CAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,uBAAA,IAAI,2CAAa,CAAC,KAAK,EAAE,CAAC;QAC1B,uBAAA,IAAI,2CAAa,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,2CAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,2CAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,SAAoB;QACtB,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,IAAI,IAAI;QACN,OAAO,uBAAA,IAAI,2CAAa,CAAC,IAAI,CAAC;IAChC,CAAC;CACF;AA3ID,wDA2IC","sourcesContent":["import type { KeyringAccount } from '@metamask/keyring-api';\nimport type { AccountId } from '@metamask/keyring-utils';\nimport { v4 as uuidv4 } from 'uuid';\n\nexport type KeyringAccountRegistryOptions = {\n  /**\n   * Custom ID generator invoked when registering a new address.\n   *\n   * Receives the address being registered and must return a unique account ID.\n   * Defaults to a random UUID v4 when not provided.\n   *\n   * @param address - The address for which to generate an account ID.\n   * @returns A unique account ID string.\n   */\n  generateId?: (address: string) => AccountId;\n};\n\n/**\n * In-memory registry for KeyringAccount objects.\n *\n * Provides O(1) lookups by account ID or address, and stores the full\n * KeyringAccount objects for efficient retrieval.\n */\nexport class KeyringAccountRegistry<\n  KeyringAccountType extends KeyringAccount = KeyringAccount,\n> {\n  readonly #accountById = new Map<AccountId, KeyringAccountType>();\n\n  readonly #idByAddress = new Map<string, AccountId>();\n\n  readonly #generateId: (address: string) => AccountId;\n\n  /**\n   * Create a new KeyringAccountRegistry.\n   *\n   * @param options - Optional configuration.\n   * @param options.generateId - Custom ID generator. Defaults to `uuidv4`.\n   */\n  constructor(options?: KeyringAccountRegistryOptions) {\n    this.#generateId = options?.generateId ?? ((): AccountId => uuidv4());\n  }\n\n  /**\n   * Get an account by its account ID.\n   *\n   * @param accountId - The account ID to look up.\n   * @returns The KeyringAccount, or undefined if not found.\n   */\n  get(accountId: AccountId): KeyringAccountType | undefined {\n    return this.#accountById.get(accountId);\n  }\n\n  /**\n   * Get an account's address by its account ID.\n   *\n   * @param accountId - The account ID to look up.\n   * @returns The address, or undefined if not found.\n   */\n  getAddress(accountId: AccountId): string | undefined {\n    return this.#accountById.get(accountId)?.address;\n  }\n\n  /**\n   * Get an account ID by the underlying address.\n   *\n   * @param address - The address to look up.\n   * @returns The account ID, or undefined if not found.\n   */\n  getAccountId(address: string): AccountId | undefined {\n    return this.#idByAddress.get(address);\n  }\n\n  /**\n   * Register a new address and generate an account ID for it.\n   * If the address is already registered, returns the existing account ID.\n   *\n   * @param address - The address to register.\n   * @returns The account ID for this address.\n   */\n  register(address: string): AccountId {\n    const existing = this.#idByAddress.get(address);\n    if (existing) {\n      return existing;\n    }\n    const id = this.#generateId(address);\n    this.#idByAddress.set(address, id);\n    return id;\n  }\n\n  /**\n   * Add an account to the registry.\n   * Also registers the address → account ID mapping.\n   *\n   * ⚠️ If an address was previously registered via `register()` with a\n   * different account ID, calling `set()` with an account that has a new ID for\n   * the same address will overwrite the address → ID mapping. The old ID\n   * becomes \"dangling\" (i.e., `get(oldId)` will return undefined).\n   *\n   * @param account - The KeyringAccount to cache.\n   */\n  set(account: KeyringAccountType): void {\n    this.#accountById.set(account.id, account);\n    this.#idByAddress.set(account.address, account.id);\n  }\n\n  /**\n   * Remove an account from the registry.\n   *\n   * @param accountId - The account ID to remove.\n   */\n  delete(accountId: AccountId): void {\n    const account = this.#accountById.get(accountId);\n    if (account) {\n      this.#idByAddress.delete(account.address);\n      this.#accountById.delete(accountId);\n    }\n  }\n\n  /**\n   * Clear all accounts from the registry.\n   */\n  clear(): void {\n    this.#accountById.clear();\n    this.#idByAddress.clear();\n  }\n\n  /**\n   * Get all cached accounts as an array.\n   *\n   * @returns Array of all KeyringAccountType objects in the registry.\n   */\n  values(): KeyringAccountType[] {\n    return Array.from(this.#accountById.values());\n  }\n\n  /**\n   * Get all account IDs in the registry.\n   *\n   * @returns Array of all account IDs.\n   */\n  keys(): AccountId[] {\n    return Array.from(this.#accountById.keys());\n  }\n\n  /**\n   * Check if an account exists in the registry.\n   *\n   * @param accountId - The account ID to check.\n   * @returns True if the account exists.\n   */\n  has(accountId: AccountId): boolean {\n    return this.#accountById.has(accountId);\n  }\n\n  /**\n   * Get the number of accounts in the registry.\n   *\n   * @returns The number of accounts.\n   */\n  get size(): number {\n    return this.#accountById.size;\n  }\n}\n"]}

package/dist/keyring-account-registry.d.cts

@@ -1,5 +1,17 @@
 import type { KeyringAccount } from "@metamask/keyring-api";
 import type { AccountId } from "@metamask/keyring-utils";
+export type KeyringAccountRegistryOptions = {
+    /**
+     * Custom ID generator invoked when registering a new address.
+     *
+     * Receives the address being registered and must return a unique account ID.
+     * Defaults to a random UUID v4 when not provided.
+     *
+     * @param address - The address for which to generate an account ID.
+     * @returns A unique account ID string.
+     */
+    generateId?: (address: string) => AccountId;
+};
 /**
  * In-memory registry for KeyringAccount objects.
  *
@@ -8,6 +20,13 @@ import type { AccountId } from "@metamask/keyring-utils";
  */
 export declare class KeyringAccountRegistry<KeyringAccountType extends KeyringAccount = KeyringAccount> {
     #private;
+    /**
+     * Create a new KeyringAccountRegistry.
+     *
+     * @param options - Optional configuration.
+     * @param options.generateId - Custom ID generator. Defaults to `uuidv4`.
+     */
+    constructor(options?: KeyringAccountRegistryOptions);
     /**
      * Get an account by its account ID.
      *

package/dist/keyring-account-registry.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"keyring-account-registry.d.cts","sourceRoot":"","sources":["../src/keyring-account-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA8B;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,gCAAgC;AAGzD;;;;;GAKG;AACH,qBAAa,sBAAsB,CACjC,kBAAkB,SAAS,cAAc,GAAG,cAAc;;IAM1D;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,kBAAkB,GAAG,SAAS;IAIzD;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS;IAIpD;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIpD;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAUpC;;;;;;;;;;OAUG;IACH,GAAG,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAKtC;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAQlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,MAAM,IAAI,kBAAkB,EAAE;IAI9B;;;;OAIG;IACH,IAAI,IAAI,SAAS,EAAE;IAInB;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAIlC;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}
+{"version":3,"file":"keyring-account-registry.d.cts","sourceRoot":"","sources":["../src/keyring-account-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA8B;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,gCAAgC;AAGzD,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC;CAC7C,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,sBAAsB,CACjC,kBAAkB,SAAS,cAAc,GAAG,cAAc;;IAQ1D;;;;;OAKG;gBACS,OAAO,CAAC,EAAE,6BAA6B;IAInD;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,kBAAkB,GAAG,SAAS;IAIzD;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS;IAIpD;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIpD;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAUpC;;;;;;;;;;OAUG;IACH,GAAG,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAKtC;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAQlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,MAAM,IAAI,kBAAkB,EAAE;IAI9B;;;;OAIG;IACH,IAAI,IAAI,SAAS,EAAE;IAInB;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAIlC;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/keyring-account-registry.d.mts

@@ -1,5 +1,17 @@
 import type { KeyringAccount } from "@metamask/keyring-api";
 import type { AccountId } from "@metamask/keyring-utils";
+export type KeyringAccountRegistryOptions = {
+    /**
+     * Custom ID generator invoked when registering a new address.
+     *
+     * Receives the address being registered and must return a unique account ID.
+     * Defaults to a random UUID v4 when not provided.
+     *
+     * @param address - The address for which to generate an account ID.
+     * @returns A unique account ID string.
+     */
+    generateId?: (address: string) => AccountId;
+};
 /**
  * In-memory registry for KeyringAccount objects.
  *
@@ -8,6 +20,13 @@ import type { AccountId } from "@metamask/keyring-utils";
  */
 export declare class KeyringAccountRegistry<KeyringAccountType extends KeyringAccount = KeyringAccount> {
     #private;
+    /**
+     * Create a new KeyringAccountRegistry.
+     *
+     * @param options - Optional configuration.
+     * @param options.generateId - Custom ID generator. Defaults to `uuidv4`.
+     */
+    constructor(options?: KeyringAccountRegistryOptions);
     /**
      * Get an account by its account ID.
      *

package/dist/keyring-account-registry.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"keyring-account-registry.d.mts","sourceRoot":"","sources":["../src/keyring-account-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA8B;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,gCAAgC;AAGzD;;;;;GAKG;AACH,qBAAa,sBAAsB,CACjC,kBAAkB,SAAS,cAAc,GAAG,cAAc;;IAM1D;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,kBAAkB,GAAG,SAAS;IAIzD;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS;IAIpD;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIpD;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAUpC;;;;;;;;;;OAUG;IACH,GAAG,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAKtC;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAQlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,MAAM,IAAI,kBAAkB,EAAE;IAI9B;;;;OAIG;IACH,IAAI,IAAI,SAAS,EAAE;IAInB;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAIlC;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}
+{"version":3,"file":"keyring-account-registry.d.mts","sourceRoot":"","sources":["../src/keyring-account-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA8B;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,gCAAgC;AAGzD,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC;CAC7C,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,sBAAsB,CACjC,kBAAkB,SAAS,cAAc,GAAG,cAAc;;IAQ1D;;;;;OAKG;gBACS,OAAO,CAAC,EAAE,6BAA6B;IAInD;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,kBAAkB,GAAG,SAAS;IAIzD;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS;IAIpD;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIpD;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAUpC;;;;;;;;;;OAUG;IACH,GAAG,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAKtC;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAQlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,MAAM,IAAI,kBAAkB,EAAE;IAI9B;;;;OAIG;IACH,IAAI,IAAI,SAAS,EAAE;IAInB;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAIlC;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/keyring-account-registry.mjs

@@ -1,9 +1,15 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
 var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _KeyringAccountRegistry_accountById, _KeyringAccountRegistry_idByAddress;
+var _KeyringAccountRegistry_accountById, _KeyringAccountRegistry_idByAddress, _KeyringAccountRegistry_generateId;
 import { v4 as uuidv4 } from "uuid";
 /**
  * In-memory registry for KeyringAccount objects.
@@ -12,9 +18,17 @@ import { v4 as uuidv4 } from "uuid";
  * KeyringAccount objects for efficient retrieval.
  */
 export class KeyringAccountRegistry {
-    constructor() {
+    /**
+     * Create a new KeyringAccountRegistry.
+     *
+     * @param options - Optional configuration.
+     * @param options.generateId - Custom ID generator. Defaults to `uuidv4`.
+     */
+    constructor(options) {
         _KeyringAccountRegistry_accountById.set(this, new Map());
         _KeyringAccountRegistry_idByAddress.set(this, new Map());
+        _KeyringAccountRegistry_generateId.set(this, void 0);
+        __classPrivateFieldSet(this, _KeyringAccountRegistry_generateId, options?.generateId ?? (() => uuidv4()), "f");
     }
     /**
      * Get an account by its account ID.
@@ -55,7 +69,7 @@ export class KeyringAccountRegistry {
         if (existing) {
             return existing;
         }
-        const id = uuidv4();
+        const id = __classPrivateFieldGet(this, _KeyringAccountRegistry_generateId, "f").call(this, address);
         __classPrivateFieldGet(this, _KeyringAccountRegistry_idByAddress, "f").set(address, id);
         return id;
     }
@@ -127,5 +141,5 @@ export class KeyringAccountRegistry {
         return __classPrivateFieldGet(this, _KeyringAccountRegistry_accountById, "f").size;
     }
 }
-_KeyringAccountRegistry_accountById = new WeakMap(), _KeyringAccountRegistry_idByAddress = new WeakMap();
+_KeyringAccountRegistry_accountById = new WeakMap(), _KeyringAccountRegistry_idByAddress = new WeakMap(), _KeyringAccountRegistry_generateId = new WeakMap();
 //# sourceMappingURL=keyring-account-registry.mjs.map

package/dist/keyring-account-registry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"keyring-account-registry.mjs","sourceRoot":"","sources":["../src/keyring-account-registry.ts"],"names":[],"mappings":";;;;;;AAEA,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,aAAa;AAEpC;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IAAnC;QAGW,8CAAe,IAAI,GAAG,EAAiC,EAAC;QAExD,8CAAe,IAAI,GAAG,EAAqB,EAAC;IA0HvD,CAAC;IAxHC;;;;;OAKG;IACH,GAAG,CAAC,SAAoB;QACtB,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,SAAoB;QAC7B,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,OAAe;QAC1B,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,OAAe;QACtB,MAAM,QAAQ,GAAG,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;;;;;OAUG;IACH,GAAG,CAAC,OAA2B;QAC7B,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC3C,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAoB;QACzB,MAAM,OAAO,GAAG,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,OAAO,EAAE,CAAC;YACZ,uBAAA,IAAI,2CAAa,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1C,uBAAA,IAAI,2CAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,uBAAA,IAAI,2CAAa,CAAC,KAAK,EAAE,CAAC;QAC1B,uBAAA,IAAI,2CAAa,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,2CAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,2CAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,SAAoB;QACtB,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,IAAI,IAAI;QACN,OAAO,uBAAA,IAAI,2CAAa,CAAC,IAAI,CAAC;IAChC,CAAC;CACF","sourcesContent":["import type { KeyringAccount } from '@metamask/keyring-api';\nimport type { AccountId } from '@metamask/keyring-utils';\nimport { v4 as uuidv4 } from 'uuid';\n\n/**\n * In-memory registry for KeyringAccount objects.\n *\n * Provides O(1) lookups by account ID or address, and stores the full\n * KeyringAccount objects for efficient retrieval.\n */\nexport class KeyringAccountRegistry<\n  KeyringAccountType extends KeyringAccount = KeyringAccount,\n> {\n  readonly #accountById = new Map<AccountId, KeyringAccountType>();\n\n  readonly #idByAddress = new Map<string, AccountId>();\n\n  /**\n   * Get an account by its account ID.\n   *\n   * @param accountId - The account ID to look up.\n   * @returns The KeyringAccount, or undefined if not found.\n   */\n  get(accountId: AccountId): KeyringAccountType | undefined {\n    return this.#accountById.get(accountId);\n  }\n\n  /**\n   * Get an account's address by its account ID.\n   *\n   * @param accountId - The account ID to look up.\n   * @returns The address, or undefined if not found.\n   */\n  getAddress(accountId: AccountId): string | undefined {\n    return this.#accountById.get(accountId)?.address;\n  }\n\n  /**\n   * Get an account ID by the underlying address.\n   *\n   * @param address - The address to look up.\n   * @returns The account ID, or undefined if not found.\n   */\n  getAccountId(address: string): AccountId | undefined {\n    return this.#idByAddress.get(address);\n  }\n\n  /**\n   * Register a new address and generate an account ID for it.\n   * If the address is already registered, returns the existing account ID.\n   *\n   * @param address - The address to register.\n   * @returns The account ID for this address.\n   */\n  register(address: string): AccountId {\n    const existing = this.#idByAddress.get(address);\n    if (existing) {\n      return existing;\n    }\n    const id = uuidv4();\n    this.#idByAddress.set(address, id);\n    return id;\n  }\n\n  /**\n   * Add an account to the registry.\n   * Also registers the address → account ID mapping.\n   *\n   * ⚠️ If an address was previously registered via `register()` with a\n   * different account ID, calling `set()` with an account that has a new ID for\n   * the same address will overwrite the address → ID mapping. The old ID\n   * becomes \"dangling\" (i.e., `get(oldId)` will return undefined).\n   *\n   * @param account - The KeyringAccount to cache.\n   */\n  set(account: KeyringAccountType): void {\n    this.#accountById.set(account.id, account);\n    this.#idByAddress.set(account.address, account.id);\n  }\n\n  /**\n   * Remove an account from the registry.\n   *\n   * @param accountId - The account ID to remove.\n   */\n  delete(accountId: AccountId): void {\n    const account = this.#accountById.get(accountId);\n    if (account) {\n      this.#idByAddress.delete(account.address);\n      this.#accountById.delete(accountId);\n    }\n  }\n\n  /**\n   * Clear all accounts from the registry.\n   */\n  clear(): void {\n    this.#accountById.clear();\n    this.#idByAddress.clear();\n  }\n\n  /**\n   * Get all cached accounts as an array.\n   *\n   * @returns Array of all KeyringAccountType objects in the registry.\n   */\n  values(): KeyringAccountType[] {\n    return Array.from(this.#accountById.values());\n  }\n\n  /**\n   * Get all account IDs in the registry.\n   *\n   * @returns Array of all account IDs.\n   */\n  keys(): AccountId[] {\n    return Array.from(this.#accountById.keys());\n  }\n\n  /**\n   * Check if an account exists in the registry.\n   *\n   * @param accountId - The account ID to check.\n   * @returns True if the account exists.\n   */\n  has(accountId: AccountId): boolean {\n    return this.#accountById.has(accountId);\n  }\n\n  /**\n   * Get the number of accounts in the registry.\n   *\n   * @returns The number of accounts.\n   */\n  get size(): number {\n    return this.#accountById.size;\n  }\n}\n"]}
+{"version":3,"file":"keyring-account-registry.mjs","sourceRoot":"","sources":["../src/keyring-account-registry.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,aAAa;AAepC;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IASjC;;;;;OAKG;IACH,YAAY,OAAuC;QAZ1C,8CAAe,IAAI,GAAG,EAAiC,EAAC;QAExD,8CAAe,IAAI,GAAG,EAAqB,EAAC;QAE5C,qDAA4C;QASnD,uBAAA,IAAI,sCAAe,OAAO,EAAE,UAAU,IAAI,CAAC,GAAc,EAAE,CAAC,MAAM,EAAE,CAAC,MAAA,CAAC;IACxE,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,SAAoB;QACtB,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,SAAoB;QAC7B,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,OAAe;QAC1B,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,OAAe;QACtB,MAAM,QAAQ,GAAG,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,EAAE,GAAG,uBAAA,IAAI,0CAAY,MAAhB,IAAI,EAAa,OAAO,CAAC,CAAC;QACrC,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;;;;;OAUG;IACH,GAAG,CAAC,OAA2B;QAC7B,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC3C,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAoB;QACzB,MAAM,OAAO,GAAG,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,OAAO,EAAE,CAAC;YACZ,uBAAA,IAAI,2CAAa,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1C,uBAAA,IAAI,2CAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,uBAAA,IAAI,2CAAa,CAAC,KAAK,EAAE,CAAC;QAC1B,uBAAA,IAAI,2CAAa,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,2CAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,2CAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,SAAoB;QACtB,OAAO,uBAAA,IAAI,2CAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,IAAI,IAAI;QACN,OAAO,uBAAA,IAAI,2CAAa,CAAC,IAAI,CAAC;IAChC,CAAC;CACF","sourcesContent":["import type { KeyringAccount } from '@metamask/keyring-api';\nimport type { AccountId } from '@metamask/keyring-utils';\nimport { v4 as uuidv4 } from 'uuid';\n\nexport type KeyringAccountRegistryOptions = {\n  /**\n   * Custom ID generator invoked when registering a new address.\n   *\n   * Receives the address being registered and must return a unique account ID.\n   * Defaults to a random UUID v4 when not provided.\n   *\n   * @param address - The address for which to generate an account ID.\n   * @returns A unique account ID string.\n   */\n  generateId?: (address: string) => AccountId;\n};\n\n/**\n * In-memory registry for KeyringAccount objects.\n *\n * Provides O(1) lookups by account ID or address, and stores the full\n * KeyringAccount objects for efficient retrieval.\n */\nexport class KeyringAccountRegistry<\n  KeyringAccountType extends KeyringAccount = KeyringAccount,\n> {\n  readonly #accountById = new Map<AccountId, KeyringAccountType>();\n\n  readonly #idByAddress = new Map<string, AccountId>();\n\n  readonly #generateId: (address: string) => AccountId;\n\n  /**\n   * Create a new KeyringAccountRegistry.\n   *\n   * @param options - Optional configuration.\n   * @param options.generateId - Custom ID generator. Defaults to `uuidv4`.\n   */\n  constructor(options?: KeyringAccountRegistryOptions) {\n    this.#generateId = options?.generateId ?? ((): AccountId => uuidv4());\n  }\n\n  /**\n   * Get an account by its account ID.\n   *\n   * @param accountId - The account ID to look up.\n   * @returns The KeyringAccount, or undefined if not found.\n   */\n  get(accountId: AccountId): KeyringAccountType | undefined {\n    return this.#accountById.get(accountId);\n  }\n\n  /**\n   * Get an account's address by its account ID.\n   *\n   * @param accountId - The account ID to look up.\n   * @returns The address, or undefined if not found.\n   */\n  getAddress(accountId: AccountId): string | undefined {\n    return this.#accountById.get(accountId)?.address;\n  }\n\n  /**\n   * Get an account ID by the underlying address.\n   *\n   * @param address - The address to look up.\n   * @returns The account ID, or undefined if not found.\n   */\n  getAccountId(address: string): AccountId | undefined {\n    return this.#idByAddress.get(address);\n  }\n\n  /**\n   * Register a new address and generate an account ID for it.\n   * If the address is already registered, returns the existing account ID.\n   *\n   * @param address - The address to register.\n   * @returns The account ID for this address.\n   */\n  register(address: string): AccountId {\n    const existing = this.#idByAddress.get(address);\n    if (existing) {\n      return existing;\n    }\n    const id = this.#generateId(address);\n    this.#idByAddress.set(address, id);\n    return id;\n  }\n\n  /**\n   * Add an account to the registry.\n   * Also registers the address → account ID mapping.\n   *\n   * ⚠️ If an address was previously registered via `register()` with a\n   * different account ID, calling `set()` with an account that has a new ID for\n   * the same address will overwrite the address → ID mapping. The old ID\n   * becomes \"dangling\" (i.e., `get(oldId)` will return undefined).\n   *\n   * @param account - The KeyringAccount to cache.\n   */\n  set(account: KeyringAccountType): void {\n    this.#accountById.set(account.id, account);\n    this.#idByAddress.set(account.address, account.id);\n  }\n\n  /**\n   * Remove an account from the registry.\n   *\n   * @param accountId - The account ID to remove.\n   */\n  delete(accountId: AccountId): void {\n    const account = this.#accountById.get(accountId);\n    if (account) {\n      this.#idByAddress.delete(account.address);\n      this.#accountById.delete(accountId);\n    }\n  }\n\n  /**\n   * Clear all accounts from the registry.\n   */\n  clear(): void {\n    this.#accountById.clear();\n    this.#idByAddress.clear();\n  }\n\n  /**\n   * Get all cached accounts as an array.\n   *\n   * @returns Array of all KeyringAccountType objects in the registry.\n   */\n  values(): KeyringAccountType[] {\n    return Array.from(this.#accountById.values());\n  }\n\n  /**\n   * Get all account IDs in the registry.\n   *\n   * @returns Array of all account IDs.\n   */\n  keys(): AccountId[] {\n    return Array.from(this.#accountById.keys());\n  }\n\n  /**\n   * Check if an account exists in the registry.\n   *\n   * @param accountId - The account ID to check.\n   * @returns True if the account exists.\n   */\n  has(accountId: AccountId): boolean {\n    return this.#accountById.has(accountId);\n  }\n\n  /**\n   * Get the number of accounts in the registry.\n   *\n   * @returns The number of accounts.\n   */\n  get size(): number {\n    return this.#accountById.size;\n  }\n}\n"]}

package/dist/keyring-wrapper.cjs

@@ -33,17 +33,10 @@ class KeyringWrapper {
          * operations that mutate its state.
          */
         _KeyringWrapper_lock.set(this, new async_mutex_1.Mutex());
-        /**
-         * Registry for KeyringAccount objects.
-         * Provides O(1) lookups by AccountId or address.
-         *
-         * Subclasses should use this registry when creating accounts and
-         * clear/update it when deleting accounts or deserializing state.
-         */
-        this.registry = new keyring_account_registry_1.KeyringAccountRegistry();
         this.inner = options.inner;
         this.type = `${options.type}`;
         __classPrivateFieldSet(this, _KeyringWrapper_capabilities, options.capabilities, "f");
+        this.registry = new keyring_account_registry_1.KeyringAccountRegistry(options.registryOptions);
     }
     /**
      * Get the capabilities of this keyring.

package/dist/keyring-wrapper.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"keyring-wrapper.cjs","sourceRoot":"","sources":["../src/keyring-wrapper.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAYA,6CAAoC;AAEpC,6EAAoE;AAsBpE;;;;;;;;;GASG;AACH,MAAsB,cAAc;IA2BlC,YAAY,OAA4C;QApB/C,+CAAmC;QAI5C;;;WAGG;QACM,+BAAQ,IAAI,mBAAK,EAAE,EAAC;QAE7B;;;;;;WAMG;QACgB,aAAQ,GACzB,IAAI,iDAAsB,EAAsB,CAAC;QAGjD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC9B,uBAAA,IAAI,gCAAiB,OAAO,CAAC,YAAY,MAAA,CAAC;IAC5C,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,YAAY;QACd,OAAO,uBAAA,IAAI,oCAAc,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;OAYG;IACO,KAAK,CAAC,QAAQ,CACtB,QAA+B;QAE/B,OAAO,uBAAA,IAAI,4BAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;IAChC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,WAAW,CAAC,KAAW;QAC3B,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC7B,wCAAwC;YACxC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YAEtB,iCAAiC;YACjC,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAEpC,iDAAiD;YACjD,yEAAyE;YACzE,8DAA8D;YAC9D,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAgBD;;;;;;;;;OASG;IACH,KAAK,CAAC,UAAU,CAAC,SAAoB;QACnC,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,4CAA4C;QAC5C,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAEzB,mCAAmC;QACnC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,6BAA6B,SAAS,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CA+CF;AA3LD,wCA2LC","sourcesContent":["import type {\n  CreateAccountOptions,\n  ExportAccountOptions,\n  ExportedAccount,\n  KeyringAccount,\n  KeyringRequest,\n  KeyringV2,\n  KeyringCapabilities,\n  KeyringType,\n} from '@metamask/keyring-api';\nimport type { Keyring, AccountId } from '@metamask/keyring-utils';\nimport type { Json } from '@metamask/utils';\nimport { Mutex } from 'async-mutex';\n\nimport { KeyringAccountRegistry } from './keyring-account-registry';\n\n/**\n * Basic options for constructing a {@link KeyringWrapper}.\n */\nexport type KeyringWrapperOptions<InnerKeyring extends Keyring> = {\n  /**\n   * The underlying \"old\" keyring instance that this wrapper adapts.\n   */\n  inner: InnerKeyring;\n\n  /**\n   * The concrete keyring type exposed through the V2 interface.\n   */\n  type: KeyringType;\n\n  /**\n   * Capabilities of the underlying keyring.\n   */\n  capabilities: KeyringCapabilities;\n};\n\n/**\n * Generic adapter that turns an existing {@link Keyring} implementation into a\n * {@link KeyringV2} instance.\n *\n * Consumers are expected to provide concrete mappings between high-level V2\n * operations and the underlying keyring methods (for example BIP-44 account\n * creation, private-key import, and request handling). This class focuses on\n * the common mechanics required by all adapters: state serialization,\n * account-ID/address mapping and basic account management.\n */\nexport abstract class KeyringWrapper<\n  InnerKeyring extends Keyring,\n  KeyringAccountType extends KeyringAccount = KeyringAccount,\n> implements KeyringV2\n{\n  readonly type: `${KeyringType}`;\n\n  readonly #capabilities: KeyringCapabilities;\n\n  protected readonly inner: InnerKeyring;\n\n  /**\n   * Mutex to ensure exclusive access to the inner keyring during\n   * operations that mutate its state.\n   */\n  readonly #lock = new Mutex();\n\n  /**\n   * Registry for KeyringAccount objects.\n   * Provides O(1) lookups by AccountId or address.\n   *\n   * Subclasses should use this registry when creating accounts and\n   * clear/update it when deleting accounts or deserializing state.\n   */\n  protected readonly registry =\n    new KeyringAccountRegistry<KeyringAccountType>();\n\n  constructor(options: KeyringWrapperOptions<InnerKeyring>) {\n    this.inner = options.inner;\n    this.type = `${options.type}`;\n    this.#capabilities = options.capabilities;\n  }\n\n  /**\n   * Get the capabilities of this keyring.\n   *\n   * Subclasses can override this getter to return capabilities dynamically\n   * based on runtime state.\n   *\n   * @returns The keyring's capabilities.\n   */\n  get capabilities(): KeyringCapabilities {\n    return this.#capabilities;\n  }\n\n  /**\n   * Execute an operation with exclusive access to the inner keyring.\n   *\n   * This method ensures thread-safety for operations that read or mutate\n   * the inner keyring state. All operations that modify the keyring\n   * (createAccounts, deleteAccount, deserialize) should use this method\n   * to prevent race conditions.\n   *\n   * Within the callback, use `this.inner` to access the inner keyring.\n   *\n   * @param callback - A function that performs the operation.\n   * @returns The result of the callback.\n   */\n  protected async withLock<Result>(\n    callback: () => Promise<Result>,\n  ): Promise<Result> {\n    return this.#lock.runExclusive(callback);\n  }\n\n  /**\n   * Serialize the underlying keyring state to a JSON-serializable object.\n   *\n   * This simply delegates to the legacy keyring's {@link Keyring.serialize}\n   * implementation.\n   *\n   * @returns The serialized keyring state.\n   */\n  async serialize(): Promise<Json> {\n    return this.inner.serialize();\n  }\n\n  /**\n   * Hydrate the underlying keyring from a previously serialized state.\n   *\n   * This clears the registry, delegates to the legacy keyring's\n   * {@link Keyring.deserialize} implementation, and rebuilds the registry\n   * by calling {@link getAccounts}.\n   *\n   * @param state - The serialized keyring state.\n   */\n  async deserialize(state: Json): Promise<void> {\n    await this.withLock(async () => {\n      // Clear the registry when deserializing\n      this.registry.clear();\n\n      // Deserialize the legacy keyring\n      await this.inner.deserialize(state);\n\n      // Rebuild the registry by calling getAccounts().\n      // Subclass implementations of getAccounts() should populate the registry\n      // as a side effect (see the abstract method's documentation).\n      await this.getAccounts();\n    });\n  }\n\n  /**\n   * Return all accounts managed by this keyring.\n   *\n   * Concrete adapters are responsible for mapping the underlying keyring's\n   * notion of accounts (typically addresses returned by\n   * {@link Keyring.getAccounts}) into {@link KeyringAccount} objects.\n   * Implementations should use the configured {@link KeyringAccountRegistry}\n   * to establish the account ID/address mapping so that\n   * {@link getAccount} works as expected.\n   *\n   * @returns The list of managed accounts.\n   */\n  abstract getAccounts(): Promise<KeyringAccount[]>;\n\n  /**\n   * Look up a single account by its {@link AccountId}.\n   *\n   * This method first checks the registry for O(1) lookup.\n   * If not found, it falls back to calling {@link getAccounts} which\n   * should populate the registry as a side effect.\n   *\n   * @param accountId - The AccountId to look up.\n   * @returns The matching KeyringAccount.\n   */\n  async getAccount(accountId: AccountId): Promise<KeyringAccount> {\n    let cached = this.registry.get(accountId);\n    if (cached) {\n      return cached;\n    }\n\n    // Prime the registry by calling getAccounts\n    await this.getAccounts();\n\n    // Try registry again after priming\n    cached = this.registry.get(accountId);\n    if (!cached) {\n      throw new Error(`Account not found for id: ${accountId}`);\n    }\n\n    return cached;\n  }\n\n  /**\n   * Create one or more new accounts managed by this keyring.\n   *\n   * Implementations are responsible for interpreting the\n   * {@link CreateAccountOptions} (for example BIP-44 derivation or\n   * private-key import) and returning the resulting {@link KeyringAccount}\n   * objects. Implementors should also ensure that the registry is updated so\n   * that {@link getAccount} works for newly created accounts.\n   */\n  abstract createAccounts(\n    options: CreateAccountOptions,\n  ): Promise<KeyringAccount[]>;\n\n  /**\n   * Remove the account associated with the given {@link AccountId} from this\n   * keyring.\n   *\n   * Implementations are expected to translate the ID to an underlying\n   * address (typically via the registry) and then invoke the appropriate\n   * removal mechanism on the legacy keyring.\n   */\n  abstract deleteAccount(accountId: AccountId): Promise<void>;\n\n  /**\n   * Export the secrets associated with the given account in a format\n   * described by {@link ExportAccountOptions}.\n   *\n   * This method is optional, and concrete adapters should only\n   * implement it if the underlying keyring supports exporting\n   * accounts.\n   */\n  exportAccount?(\n    accountId: AccountId,\n    options?: ExportAccountOptions,\n  ): Promise<ExportedAccount>;\n\n  /**\n   * Handle a high-level {@link KeyringRequest} on behalf of this keyring.\n   *\n   * Concrete adapters are responsible for routing the request's method and\n   * parameters to the appropriate legacy keyring APIs (for example signing\n   * transactions or decrypting messages) and returning a JSON-serializable\n   * result.\n   */\n  abstract submitRequest(request: KeyringRequest): Promise<Json>;\n}\n"]}
+{"version":3,"file":"keyring-wrapper.cjs","sourceRoot":"","sources":["../src/keyring-wrapper.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAYA,6CAAoC;AAEpC,6EAGoC;AA2BpC;;;;;;;;;GASG;AACH,MAAsB,cAAc;IA0BlC,YAAY,OAA4C;QAnB/C,+CAAmC;QAI5C;;;WAGG;QACM,+BAAQ,IAAI,mBAAK,EAAE,EAAC;QAY3B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC9B,uBAAA,IAAI,gCAAiB,OAAO,CAAC,YAAY,MAAA,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,IAAI,iDAAsB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,YAAY;QACd,OAAO,uBAAA,IAAI,oCAAc,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;OAYG;IACO,KAAK,CAAC,QAAQ,CACtB,QAA+B;QAE/B,OAAO,uBAAA,IAAI,4BAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;IAChC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,WAAW,CAAC,KAAW;QAC3B,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC7B,wCAAwC;YACxC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YAEtB,iCAAiC;YACjC,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAEpC,iDAAiD;YACjD,yEAAyE;YACzE,8DAA8D;YAC9D,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAgBD;;;;;;;;;OASG;IACH,KAAK,CAAC,UAAU,CAAC,SAAoB;QACnC,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,4CAA4C;QAC5C,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAEzB,mCAAmC;QACnC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,6BAA6B,SAAS,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CA+CF;AA3LD,wCA2LC","sourcesContent":["import type {\n  CreateAccountOptions,\n  ExportAccountOptions,\n  ExportedAccount,\n  KeyringAccount,\n  KeyringRequest,\n  KeyringV2,\n  KeyringCapabilities,\n  KeyringType,\n} from '@metamask/keyring-api';\nimport type { Keyring, AccountId } from '@metamask/keyring-utils';\nimport type { Json } from '@metamask/utils';\nimport { Mutex } from 'async-mutex';\n\nimport {\n  KeyringAccountRegistry,\n  type KeyringAccountRegistryOptions,\n} from './keyring-account-registry';\n\n/**\n * Basic options for constructing a {@link KeyringWrapper}.\n */\nexport type KeyringWrapperOptions<InnerKeyring extends Keyring> = {\n  /**\n   * The underlying \"old\" keyring instance that this wrapper adapts.\n   */\n  inner: InnerKeyring;\n\n  /**\n   * The concrete keyring type exposed through the V2 interface.\n   */\n  type: KeyringType;\n\n  /**\n   * Capabilities of the underlying keyring.\n   */\n  capabilities: KeyringCapabilities;\n\n  /**\n   * Options forwarded to the {@link KeyringAccountRegistry} constructor.\n   */\n  registryOptions?: KeyringAccountRegistryOptions;\n};\n\n/**\n * Generic adapter that turns an existing {@link Keyring} implementation into a\n * {@link KeyringV2} instance.\n *\n * Consumers are expected to provide concrete mappings between high-level V2\n * operations and the underlying keyring methods (for example BIP-44 account\n * creation, private-key import, and request handling). This class focuses on\n * the common mechanics required by all adapters: state serialization,\n * account-ID/address mapping and basic account management.\n */\nexport abstract class KeyringWrapper<\n  InnerKeyring extends Keyring,\n  KeyringAccountType extends KeyringAccount = KeyringAccount,\n> implements KeyringV2\n{\n  readonly type: `${KeyringType}`;\n\n  readonly #capabilities: KeyringCapabilities;\n\n  protected readonly inner: InnerKeyring;\n\n  /**\n   * Mutex to ensure exclusive access to the inner keyring during\n   * operations that mutate its state.\n   */\n  readonly #lock = new Mutex();\n\n  /**\n   * Registry for KeyringAccount objects.\n   * Provides O(1) lookups by AccountId or address.\n   *\n   * Subclasses should use this registry when creating accounts and\n   * clear/update it when deleting accounts or deserializing state.\n   */\n  protected readonly registry: KeyringAccountRegistry<KeyringAccountType>;\n\n  constructor(options: KeyringWrapperOptions<InnerKeyring>) {\n    this.inner = options.inner;\n    this.type = `${options.type}`;\n    this.#capabilities = options.capabilities;\n    this.registry = new KeyringAccountRegistry(options.registryOptions);\n  }\n\n  /**\n   * Get the capabilities of this keyring.\n   *\n   * Subclasses can override this getter to return capabilities dynamically\n   * based on runtime state.\n   *\n   * @returns The keyring's capabilities.\n   */\n  get capabilities(): KeyringCapabilities {\n    return this.#capabilities;\n  }\n\n  /**\n   * Execute an operation with exclusive access to the inner keyring.\n   *\n   * This method ensures thread-safety for operations that read or mutate\n   * the inner keyring state. All operations that modify the keyring\n   * (createAccounts, deleteAccount, deserialize) should use this method\n   * to prevent race conditions.\n   *\n   * Within the callback, use `this.inner` to access the inner keyring.\n   *\n   * @param callback - A function that performs the operation.\n   * @returns The result of the callback.\n   */\n  protected async withLock<Result>(\n    callback: () => Promise<Result>,\n  ): Promise<Result> {\n    return this.#lock.runExclusive(callback);\n  }\n\n  /**\n   * Serialize the underlying keyring state to a JSON-serializable object.\n   *\n   * This simply delegates to the legacy keyring's {@link Keyring.serialize}\n   * implementation.\n   *\n   * @returns The serialized keyring state.\n   */\n  async serialize(): Promise<Json> {\n    return this.inner.serialize();\n  }\n\n  /**\n   * Hydrate the underlying keyring from a previously serialized state.\n   *\n   * This clears the registry, delegates to the legacy keyring's\n   * {@link Keyring.deserialize} implementation, and rebuilds the registry\n   * by calling {@link getAccounts}.\n   *\n   * @param state - The serialized keyring state.\n   */\n  async deserialize(state: Json): Promise<void> {\n    await this.withLock(async () => {\n      // Clear the registry when deserializing\n      this.registry.clear();\n\n      // Deserialize the legacy keyring\n      await this.inner.deserialize(state);\n\n      // Rebuild the registry by calling getAccounts().\n      // Subclass implementations of getAccounts() should populate the registry\n      // as a side effect (see the abstract method's documentation).\n      await this.getAccounts();\n    });\n  }\n\n  /**\n   * Return all accounts managed by this keyring.\n   *\n   * Concrete adapters are responsible for mapping the underlying keyring's\n   * notion of accounts (typically addresses returned by\n   * {@link Keyring.getAccounts}) into {@link KeyringAccount} objects.\n   * Implementations should use the configured {@link KeyringAccountRegistry}\n   * to establish the account ID/address mapping so that\n   * {@link getAccount} works as expected.\n   *\n   * @returns The list of managed accounts.\n   */\n  abstract getAccounts(): Promise<KeyringAccount[]>;\n\n  /**\n   * Look up a single account by its {@link AccountId}.\n   *\n   * This method first checks the registry for O(1) lookup.\n   * If not found, it falls back to calling {@link getAccounts} which\n   * should populate the registry as a side effect.\n   *\n   * @param accountId - The AccountId to look up.\n   * @returns The matching KeyringAccount.\n   */\n  async getAccount(accountId: AccountId): Promise<KeyringAccount> {\n    let cached = this.registry.get(accountId);\n    if (cached) {\n      return cached;\n    }\n\n    // Prime the registry by calling getAccounts\n    await this.getAccounts();\n\n    // Try registry again after priming\n    cached = this.registry.get(accountId);\n    if (!cached) {\n      throw new Error(`Account not found for id: ${accountId}`);\n    }\n\n    return cached;\n  }\n\n  /**\n   * Create one or more new accounts managed by this keyring.\n   *\n   * Implementations are responsible for interpreting the\n   * {@link CreateAccountOptions} (for example BIP-44 derivation or\n   * private-key import) and returning the resulting {@link KeyringAccount}\n   * objects. Implementors should also ensure that the registry is updated so\n   * that {@link getAccount} works for newly created accounts.\n   */\n  abstract createAccounts(\n    options: CreateAccountOptions,\n  ): Promise<KeyringAccount[]>;\n\n  /**\n   * Remove the account associated with the given {@link AccountId} from this\n   * keyring.\n   *\n   * Implementations are expected to translate the ID to an underlying\n   * address (typically via the registry) and then invoke the appropriate\n   * removal mechanism on the legacy keyring.\n   */\n  abstract deleteAccount(accountId: AccountId): Promise<void>;\n\n  /**\n   * Export the secrets associated with the given account in a format\n   * described by {@link ExportAccountOptions}.\n   *\n   * This method is optional, and concrete adapters should only\n   * implement it if the underlying keyring supports exporting\n   * accounts.\n   */\n  exportAccount?(\n    accountId: AccountId,\n    options?: ExportAccountOptions,\n  ): Promise<ExportedAccount>;\n\n  /**\n   * Handle a high-level {@link KeyringRequest} on behalf of this keyring.\n   *\n   * Concrete adapters are responsible for routing the request's method and\n   * parameters to the appropriate legacy keyring APIs (for example signing\n   * transactions or decrypting messages) and returning a JSON-serializable\n   * result.\n   */\n  abstract submitRequest(request: KeyringRequest): Promise<Json>;\n}\n"]}

package/dist/keyring-wrapper.d.cts

@@ -1,7 +1,7 @@
 import type { CreateAccountOptions, ExportAccountOptions, ExportedAccount, KeyringAccount, KeyringRequest, KeyringV2, KeyringCapabilities, KeyringType } from "@metamask/keyring-api";
 import type { Keyring, AccountId } from "@metamask/keyring-utils";
 import type { Json } from "@metamask/utils";
-import { KeyringAccountRegistry } from "./keyring-account-registry.cjs";
+import { KeyringAccountRegistry, type KeyringAccountRegistryOptions } from "./keyring-account-registry.cjs";
 /**
  * Basic options for constructing a {@link KeyringWrapper}.
  */
@@ -18,6 +18,10 @@ export type KeyringWrapperOptions<InnerKeyring extends Keyring> = {
      * Capabilities of the underlying keyring.
      */
     capabilities: KeyringCapabilities;
+    /**
+     * Options forwarded to the {@link KeyringAccountRegistry} constructor.
+     */
+    registryOptions?: KeyringAccountRegistryOptions;
 };
 /**
  * Generic adapter that turns an existing {@link Keyring} implementation into a

package/dist/keyring-wrapper.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"keyring-wrapper.d.cts","sourceRoot":"","sources":["../src/keyring-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,WAAW,EACZ,8BAA8B;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,gCAAgC;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAG5C,OAAO,EAAE,sBAAsB,EAAE,uCAAmC;AAEpE;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAAC,YAAY,SAAS,OAAO,IAAI;IAChE;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;IAEpB;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;OAEG;IACH,YAAY,EAAE,mBAAmB,CAAC;CACnC,CAAC;AAEF;;;;;;;;;GASG;AACH,8BAAsB,cAAc,CAClC,YAAY,SAAS,OAAO,EAC5B,kBAAkB,SAAS,cAAc,GAAG,cAAc,CAC1D,YAAW,SAAS;;IAEpB,QAAQ,CAAC,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC;IAIhC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAQvC;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,6CACwB;gBAEvC,OAAO,EAAE,qBAAqB,CAAC,YAAY,CAAC;IAMxD;;;;;;;OAOG;IACH,IAAI,YAAY,IAAI,mBAAmB,CAEtC;IAED;;;;;;;;;;;;OAYG;cACa,QAAQ,CAAC,MAAM,EAC7B,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;;;;OAQG;IACG,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7C;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAEjD;;;;;;;;;OASG;IACG,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC;IAkB/D;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAAc,CACrB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,EAAE,CAAC;IAE5B;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3D;;;;;;;OAOG;IACH,aAAa,CAAC,CACZ,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAE3B;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAC/D"}
+{"version":3,"file":"keyring-wrapper.d.cts","sourceRoot":"","sources":["../src/keyring-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,WAAW,EACZ,8BAA8B;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,gCAAgC;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAG5C,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,EACnC,uCAAmC;AAEpC;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAAC,YAAY,SAAS,OAAO,IAAI;IAChE;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;IAEpB;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;OAEG;IACH,YAAY,EAAE,mBAAmB,CAAC;IAElC;;OAEG;IACH,eAAe,CAAC,EAAE,6BAA6B,CAAC;CACjD,CAAC;AAEF;;;;;;;;;GASG;AACH,8BAAsB,cAAc,CAClC,YAAY,SAAS,OAAO,EAC5B,kBAAkB,SAAS,cAAc,GAAG,cAAc,CAC1D,YAAW,SAAS;;IAEpB,QAAQ,CAAC,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC;IAIhC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAQvC;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;gBAE5D,OAAO,EAAE,qBAAqB,CAAC,YAAY,CAAC;IAOxD;;;;;;;OAOG;IACH,IAAI,YAAY,IAAI,mBAAmB,CAEtC;IAED;;;;;;;;;;;;OAYG;cACa,QAAQ,CAAC,MAAM,EAC7B,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;;;;OAQG;IACG,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7C;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAEjD;;;;;;;;;OASG;IACG,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC;IAkB/D;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAAc,CACrB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,EAAE,CAAC;IAE5B;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3D;;;;;;;OAOG;IACH,aAAa,CAAC,CACZ,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAE3B;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAC/D"}

package/dist/keyring-wrapper.d.mts

@@ -1,7 +1,7 @@
 import type { CreateAccountOptions, ExportAccountOptions, ExportedAccount, KeyringAccount, KeyringRequest, KeyringV2, KeyringCapabilities, KeyringType } from "@metamask/keyring-api";
 import type { Keyring, AccountId } from "@metamask/keyring-utils";
 import type { Json } from "@metamask/utils";
-import { KeyringAccountRegistry } from "./keyring-account-registry.mjs";
+import { KeyringAccountRegistry, type KeyringAccountRegistryOptions } from "./keyring-account-registry.mjs";
 /**
  * Basic options for constructing a {@link KeyringWrapper}.
  */
@@ -18,6 +18,10 @@ export type KeyringWrapperOptions<InnerKeyring extends Keyring> = {
      * Capabilities of the underlying keyring.
      */
     capabilities: KeyringCapabilities;
+    /**
+     * Options forwarded to the {@link KeyringAccountRegistry} constructor.
+     */
+    registryOptions?: KeyringAccountRegistryOptions;
 };
 /**
  * Generic adapter that turns an existing {@link Keyring} implementation into a

package/dist/keyring-wrapper.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"keyring-wrapper.d.mts","sourceRoot":"","sources":["../src/keyring-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,WAAW,EACZ,8BAA8B;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,gCAAgC;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAG5C,OAAO,EAAE,sBAAsB,EAAE,uCAAmC;AAEpE;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAAC,YAAY,SAAS,OAAO,IAAI;IAChE;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;IAEpB;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;OAEG;IACH,YAAY,EAAE,mBAAmB,CAAC;CACnC,CAAC;AAEF;;;;;;;;;GASG;AACH,8BAAsB,cAAc,CAClC,YAAY,SAAS,OAAO,EAC5B,kBAAkB,SAAS,cAAc,GAAG,cAAc,CAC1D,YAAW,SAAS;;IAEpB,QAAQ,CAAC,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC;IAIhC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAQvC;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,6CACwB;gBAEvC,OAAO,EAAE,qBAAqB,CAAC,YAAY,CAAC;IAMxD;;;;;;;OAOG;IACH,IAAI,YAAY,IAAI,mBAAmB,CAEtC;IAED;;;;;;;;;;;;OAYG;cACa,QAAQ,CAAC,MAAM,EAC7B,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;;;;OAQG;IACG,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7C;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAEjD;;;;;;;;;OASG;IACG,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC;IAkB/D;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAAc,CACrB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,EAAE,CAAC;IAE5B;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3D;;;;;;;OAOG;IACH,aAAa,CAAC,CACZ,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAE3B;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAC/D"}
+{"version":3,"file":"keyring-wrapper.d.mts","sourceRoot":"","sources":["../src/keyring-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,WAAW,EACZ,8BAA8B;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,gCAAgC;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAG5C,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,EACnC,uCAAmC;AAEpC;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAAC,YAAY,SAAS,OAAO,IAAI;IAChE;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;IAEpB;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;OAEG;IACH,YAAY,EAAE,mBAAmB,CAAC;IAElC;;OAEG;IACH,eAAe,CAAC,EAAE,6BAA6B,CAAC;CACjD,CAAC;AAEF;;;;;;;;;GASG;AACH,8BAAsB,cAAc,CAClC,YAAY,SAAS,OAAO,EAC5B,kBAAkB,SAAS,cAAc,GAAG,cAAc,CAC1D,YAAW,SAAS;;IAEpB,QAAQ,CAAC,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC;IAIhC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAQvC;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;gBAE5D,OAAO,EAAE,qBAAqB,CAAC,YAAY,CAAC;IAOxD;;;;;;;OAOG;IACH,IAAI,YAAY,IAAI,mBAAmB,CAEtC;IAED;;;;;;;;;;;;OAYG;cACa,QAAQ,CAAC,MAAM,EAC7B,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;;;;OAQG;IACG,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7C;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAEjD;;;;;;;;;OASG;IACG,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC;IAkB/D;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAAc,CACrB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,EAAE,CAAC;IAE5B;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3D;;;;;;;OAOG;IACH,aAAa,CAAC,CACZ,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAE3B;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAC/D"}

package/dist/keyring-wrapper.mjs

@@ -30,17 +30,10 @@ export class KeyringWrapper {
          * operations that mutate its state.
          */
         _KeyringWrapper_lock.set(this, new Mutex());
-        /**
-         * Registry for KeyringAccount objects.
-         * Provides O(1) lookups by AccountId or address.
-         *
-         * Subclasses should use this registry when creating accounts and
-         * clear/update it when deleting accounts or deserializing state.
-         */
-        this.registry = new KeyringAccountRegistry();
         this.inner = options.inner;
         this.type = `${options.type}`;
         __classPrivateFieldSet(this, _KeyringWrapper_capabilities, options.capabilities, "f");
+        this.registry = new KeyringAccountRegistry(options.registryOptions);
     }
     /**
      * Get the capabilities of this keyring.

package/dist/keyring-wrapper.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"keyring-wrapper.mjs","sourceRoot":"","sources":["../src/keyring-wrapper.ts"],"names":[],"mappings":";;;;;;;;;;;;AAYA,OAAO,EAAE,KAAK,EAAE,oBAAoB;AAEpC,OAAO,EAAE,sBAAsB,EAAE,uCAAmC;AAsBpE;;;;;;;;;GASG;AACH,MAAM,OAAgB,cAAc;IA2BlC,YAAY,OAA4C;QApB/C,+CAAmC;QAI5C;;;WAGG;QACM,+BAAQ,IAAI,KAAK,EAAE,EAAC;QAE7B;;;;;;WAMG;QACgB,aAAQ,GACzB,IAAI,sBAAsB,EAAsB,CAAC;QAGjD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC9B,uBAAA,IAAI,gCAAiB,OAAO,CAAC,YAAY,MAAA,CAAC;IAC5C,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,YAAY;QACd,OAAO,uBAAA,IAAI,oCAAc,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;OAYG;IACO,KAAK,CAAC,QAAQ,CACtB,QAA+B;QAE/B,OAAO,uBAAA,IAAI,4BAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;IAChC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,WAAW,CAAC,KAAW;QAC3B,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC7B,wCAAwC;YACxC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YAEtB,iCAAiC;YACjC,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAEpC,iDAAiD;YACjD,yEAAyE;YACzE,8DAA8D;YAC9D,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAgBD;;;;;;;;;OASG;IACH,KAAK,CAAC,UAAU,CAAC,SAAoB;QACnC,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,4CAA4C;QAC5C,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAEzB,mCAAmC;QACnC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,6BAA6B,SAAS,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CA+CF","sourcesContent":["import type {\n  CreateAccountOptions,\n  ExportAccountOptions,\n  ExportedAccount,\n  KeyringAccount,\n  KeyringRequest,\n  KeyringV2,\n  KeyringCapabilities,\n  KeyringType,\n} from '@metamask/keyring-api';\nimport type { Keyring, AccountId } from '@metamask/keyring-utils';\nimport type { Json } from '@metamask/utils';\nimport { Mutex } from 'async-mutex';\n\nimport { KeyringAccountRegistry } from './keyring-account-registry';\n\n/**\n * Basic options for constructing a {@link KeyringWrapper}.\n */\nexport type KeyringWrapperOptions<InnerKeyring extends Keyring> = {\n  /**\n   * The underlying \"old\" keyring instance that this wrapper adapts.\n   */\n  inner: InnerKeyring;\n\n  /**\n   * The concrete keyring type exposed through the V2 interface.\n   */\n  type: KeyringType;\n\n  /**\n   * Capabilities of the underlying keyring.\n   */\n  capabilities: KeyringCapabilities;\n};\n\n/**\n * Generic adapter that turns an existing {@link Keyring} implementation into a\n * {@link KeyringV2} instance.\n *\n * Consumers are expected to provide concrete mappings between high-level V2\n * operations and the underlying keyring methods (for example BIP-44 account\n * creation, private-key import, and request handling). This class focuses on\n * the common mechanics required by all adapters: state serialization,\n * account-ID/address mapping and basic account management.\n */\nexport abstract class KeyringWrapper<\n  InnerKeyring extends Keyring,\n  KeyringAccountType extends KeyringAccount = KeyringAccount,\n> implements KeyringV2\n{\n  readonly type: `${KeyringType}`;\n\n  readonly #capabilities: KeyringCapabilities;\n\n  protected readonly inner: InnerKeyring;\n\n  /**\n   * Mutex to ensure exclusive access to the inner keyring during\n   * operations that mutate its state.\n   */\n  readonly #lock = new Mutex();\n\n  /**\n   * Registry for KeyringAccount objects.\n   * Provides O(1) lookups by AccountId or address.\n   *\n   * Subclasses should use this registry when creating accounts and\n   * clear/update it when deleting accounts or deserializing state.\n   */\n  protected readonly registry =\n    new KeyringAccountRegistry<KeyringAccountType>();\n\n  constructor(options: KeyringWrapperOptions<InnerKeyring>) {\n    this.inner = options.inner;\n    this.type = `${options.type}`;\n    this.#capabilities = options.capabilities;\n  }\n\n  /**\n   * Get the capabilities of this keyring.\n   *\n   * Subclasses can override this getter to return capabilities dynamically\n   * based on runtime state.\n   *\n   * @returns The keyring's capabilities.\n   */\n  get capabilities(): KeyringCapabilities {\n    return this.#capabilities;\n  }\n\n  /**\n   * Execute an operation with exclusive access to the inner keyring.\n   *\n   * This method ensures thread-safety for operations that read or mutate\n   * the inner keyring state. All operations that modify the keyring\n   * (createAccounts, deleteAccount, deserialize) should use this method\n   * to prevent race conditions.\n   *\n   * Within the callback, use `this.inner` to access the inner keyring.\n   *\n   * @param callback - A function that performs the operation.\n   * @returns The result of the callback.\n   */\n  protected async withLock<Result>(\n    callback: () => Promise<Result>,\n  ): Promise<Result> {\n    return this.#lock.runExclusive(callback);\n  }\n\n  /**\n   * Serialize the underlying keyring state to a JSON-serializable object.\n   *\n   * This simply delegates to the legacy keyring's {@link Keyring.serialize}\n   * implementation.\n   *\n   * @returns The serialized keyring state.\n   */\n  async serialize(): Promise<Json> {\n    return this.inner.serialize();\n  }\n\n  /**\n   * Hydrate the underlying keyring from a previously serialized state.\n   *\n   * This clears the registry, delegates to the legacy keyring's\n   * {@link Keyring.deserialize} implementation, and rebuilds the registry\n   * by calling {@link getAccounts}.\n   *\n   * @param state - The serialized keyring state.\n   */\n  async deserialize(state: Json): Promise<void> {\n    await this.withLock(async () => {\n      // Clear the registry when deserializing\n      this.registry.clear();\n\n      // Deserialize the legacy keyring\n      await this.inner.deserialize(state);\n\n      // Rebuild the registry by calling getAccounts().\n      // Subclass implementations of getAccounts() should populate the registry\n      // as a side effect (see the abstract method's documentation).\n      await this.getAccounts();\n    });\n  }\n\n  /**\n   * Return all accounts managed by this keyring.\n   *\n   * Concrete adapters are responsible for mapping the underlying keyring's\n   * notion of accounts (typically addresses returned by\n   * {@link Keyring.getAccounts}) into {@link KeyringAccount} objects.\n   * Implementations should use the configured {@link KeyringAccountRegistry}\n   * to establish the account ID/address mapping so that\n   * {@link getAccount} works as expected.\n   *\n   * @returns The list of managed accounts.\n   */\n  abstract getAccounts(): Promise<KeyringAccount[]>;\n\n  /**\n   * Look up a single account by its {@link AccountId}.\n   *\n   * This method first checks the registry for O(1) lookup.\n   * If not found, it falls back to calling {@link getAccounts} which\n   * should populate the registry as a side effect.\n   *\n   * @param accountId - The AccountId to look up.\n   * @returns The matching KeyringAccount.\n   */\n  async getAccount(accountId: AccountId): Promise<KeyringAccount> {\n    let cached = this.registry.get(accountId);\n    if (cached) {\n      return cached;\n    }\n\n    // Prime the registry by calling getAccounts\n    await this.getAccounts();\n\n    // Try registry again after priming\n    cached = this.registry.get(accountId);\n    if (!cached) {\n      throw new Error(`Account not found for id: ${accountId}`);\n    }\n\n    return cached;\n  }\n\n  /**\n   * Create one or more new accounts managed by this keyring.\n   *\n   * Implementations are responsible for interpreting the\n   * {@link CreateAccountOptions} (for example BIP-44 derivation or\n   * private-key import) and returning the resulting {@link KeyringAccount}\n   * objects. Implementors should also ensure that the registry is updated so\n   * that {@link getAccount} works for newly created accounts.\n   */\n  abstract createAccounts(\n    options: CreateAccountOptions,\n  ): Promise<KeyringAccount[]>;\n\n  /**\n   * Remove the account associated with the given {@link AccountId} from this\n   * keyring.\n   *\n   * Implementations are expected to translate the ID to an underlying\n   * address (typically via the registry) and then invoke the appropriate\n   * removal mechanism on the legacy keyring.\n   */\n  abstract deleteAccount(accountId: AccountId): Promise<void>;\n\n  /**\n   * Export the secrets associated with the given account in a format\n   * described by {@link ExportAccountOptions}.\n   *\n   * This method is optional, and concrete adapters should only\n   * implement it if the underlying keyring supports exporting\n   * accounts.\n   */\n  exportAccount?(\n    accountId: AccountId,\n    options?: ExportAccountOptions,\n  ): Promise<ExportedAccount>;\n\n  /**\n   * Handle a high-level {@link KeyringRequest} on behalf of this keyring.\n   *\n   * Concrete adapters are responsible for routing the request's method and\n   * parameters to the appropriate legacy keyring APIs (for example signing\n   * transactions or decrypting messages) and returning a JSON-serializable\n   * result.\n   */\n  abstract submitRequest(request: KeyringRequest): Promise<Json>;\n}\n"]}
+{"version":3,"file":"keyring-wrapper.mjs","sourceRoot":"","sources":["../src/keyring-wrapper.ts"],"names":[],"mappings":";;;;;;;;;;;;AAYA,OAAO,EAAE,KAAK,EAAE,oBAAoB;AAEpC,OAAO,EACL,sBAAsB,EAEvB,uCAAmC;AA2BpC;;;;;;;;;GASG;AACH,MAAM,OAAgB,cAAc;IA0BlC,YAAY,OAA4C;QAnB/C,+CAAmC;QAI5C;;;WAGG;QACM,+BAAQ,IAAI,KAAK,EAAE,EAAC;QAY3B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC9B,uBAAA,IAAI,gCAAiB,OAAO,CAAC,YAAY,MAAA,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,IAAI,sBAAsB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,YAAY;QACd,OAAO,uBAAA,IAAI,oCAAc,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;OAYG;IACO,KAAK,CAAC,QAAQ,CACtB,QAA+B;QAE/B,OAAO,uBAAA,IAAI,4BAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;IAChC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,WAAW,CAAC,KAAW;QAC3B,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC7B,wCAAwC;YACxC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YAEtB,iCAAiC;YACjC,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAEpC,iDAAiD;YACjD,yEAAyE;YACzE,8DAA8D;YAC9D,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAgBD;;;;;;;;;OASG;IACH,KAAK,CAAC,UAAU,CAAC,SAAoB;QACnC,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,4CAA4C;QAC5C,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAEzB,mCAAmC;QACnC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,6BAA6B,SAAS,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CA+CF","sourcesContent":["import type {\n  CreateAccountOptions,\n  ExportAccountOptions,\n  ExportedAccount,\n  KeyringAccount,\n  KeyringRequest,\n  KeyringV2,\n  KeyringCapabilities,\n  KeyringType,\n} from '@metamask/keyring-api';\nimport type { Keyring, AccountId } from '@metamask/keyring-utils';\nimport type { Json } from '@metamask/utils';\nimport { Mutex } from 'async-mutex';\n\nimport {\n  KeyringAccountRegistry,\n  type KeyringAccountRegistryOptions,\n} from './keyring-account-registry';\n\n/**\n * Basic options for constructing a {@link KeyringWrapper}.\n */\nexport type KeyringWrapperOptions<InnerKeyring extends Keyring> = {\n  /**\n   * The underlying \"old\" keyring instance that this wrapper adapts.\n   */\n  inner: InnerKeyring;\n\n  /**\n   * The concrete keyring type exposed through the V2 interface.\n   */\n  type: KeyringType;\n\n  /**\n   * Capabilities of the underlying keyring.\n   */\n  capabilities: KeyringCapabilities;\n\n  /**\n   * Options forwarded to the {@link KeyringAccountRegistry} constructor.\n   */\n  registryOptions?: KeyringAccountRegistryOptions;\n};\n\n/**\n * Generic adapter that turns an existing {@link Keyring} implementation into a\n * {@link KeyringV2} instance.\n *\n * Consumers are expected to provide concrete mappings between high-level V2\n * operations and the underlying keyring methods (for example BIP-44 account\n * creation, private-key import, and request handling). This class focuses on\n * the common mechanics required by all adapters: state serialization,\n * account-ID/address mapping and basic account management.\n */\nexport abstract class KeyringWrapper<\n  InnerKeyring extends Keyring,\n  KeyringAccountType extends KeyringAccount = KeyringAccount,\n> implements KeyringV2\n{\n  readonly type: `${KeyringType}`;\n\n  readonly #capabilities: KeyringCapabilities;\n\n  protected readonly inner: InnerKeyring;\n\n  /**\n   * Mutex to ensure exclusive access to the inner keyring during\n   * operations that mutate its state.\n   */\n  readonly #lock = new Mutex();\n\n  /**\n   * Registry for KeyringAccount objects.\n   * Provides O(1) lookups by AccountId or address.\n   *\n   * Subclasses should use this registry when creating accounts and\n   * clear/update it when deleting accounts or deserializing state.\n   */\n  protected readonly registry: KeyringAccountRegistry<KeyringAccountType>;\n\n  constructor(options: KeyringWrapperOptions<InnerKeyring>) {\n    this.inner = options.inner;\n    this.type = `${options.type}`;\n    this.#capabilities = options.capabilities;\n    this.registry = new KeyringAccountRegistry(options.registryOptions);\n  }\n\n  /**\n   * Get the capabilities of this keyring.\n   *\n   * Subclasses can override this getter to return capabilities dynamically\n   * based on runtime state.\n   *\n   * @returns The keyring's capabilities.\n   */\n  get capabilities(): KeyringCapabilities {\n    return this.#capabilities;\n  }\n\n  /**\n   * Execute an operation with exclusive access to the inner keyring.\n   *\n   * This method ensures thread-safety for operations that read or mutate\n   * the inner keyring state. All operations that modify the keyring\n   * (createAccounts, deleteAccount, deserialize) should use this method\n   * to prevent race conditions.\n   *\n   * Within the callback, use `this.inner` to access the inner keyring.\n   *\n   * @param callback - A function that performs the operation.\n   * @returns The result of the callback.\n   */\n  protected async withLock<Result>(\n    callback: () => Promise<Result>,\n  ): Promise<Result> {\n    return this.#lock.runExclusive(callback);\n  }\n\n  /**\n   * Serialize the underlying keyring state to a JSON-serializable object.\n   *\n   * This simply delegates to the legacy keyring's {@link Keyring.serialize}\n   * implementation.\n   *\n   * @returns The serialized keyring state.\n   */\n  async serialize(): Promise<Json> {\n    return this.inner.serialize();\n  }\n\n  /**\n   * Hydrate the underlying keyring from a previously serialized state.\n   *\n   * This clears the registry, delegates to the legacy keyring's\n   * {@link Keyring.deserialize} implementation, and rebuilds the registry\n   * by calling {@link getAccounts}.\n   *\n   * @param state - The serialized keyring state.\n   */\n  async deserialize(state: Json): Promise<void> {\n    await this.withLock(async () => {\n      // Clear the registry when deserializing\n      this.registry.clear();\n\n      // Deserialize the legacy keyring\n      await this.inner.deserialize(state);\n\n      // Rebuild the registry by calling getAccounts().\n      // Subclass implementations of getAccounts() should populate the registry\n      // as a side effect (see the abstract method's documentation).\n      await this.getAccounts();\n    });\n  }\n\n  /**\n   * Return all accounts managed by this keyring.\n   *\n   * Concrete adapters are responsible for mapping the underlying keyring's\n   * notion of accounts (typically addresses returned by\n   * {@link Keyring.getAccounts}) into {@link KeyringAccount} objects.\n   * Implementations should use the configured {@link KeyringAccountRegistry}\n   * to establish the account ID/address mapping so that\n   * {@link getAccount} works as expected.\n   *\n   * @returns The list of managed accounts.\n   */\n  abstract getAccounts(): Promise<KeyringAccount[]>;\n\n  /**\n   * Look up a single account by its {@link AccountId}.\n   *\n   * This method first checks the registry for O(1) lookup.\n   * If not found, it falls back to calling {@link getAccounts} which\n   * should populate the registry as a side effect.\n   *\n   * @param accountId - The AccountId to look up.\n   * @returns The matching KeyringAccount.\n   */\n  async getAccount(accountId: AccountId): Promise<KeyringAccount> {\n    let cached = this.registry.get(accountId);\n    if (cached) {\n      return cached;\n    }\n\n    // Prime the registry by calling getAccounts\n    await this.getAccounts();\n\n    // Try registry again after priming\n    cached = this.registry.get(accountId);\n    if (!cached) {\n      throw new Error(`Account not found for id: ${accountId}`);\n    }\n\n    return cached;\n  }\n\n  /**\n   * Create one or more new accounts managed by this keyring.\n   *\n   * Implementations are responsible for interpreting the\n   * {@link CreateAccountOptions} (for example BIP-44 derivation or\n   * private-key import) and returning the resulting {@link KeyringAccount}\n   * objects. Implementors should also ensure that the registry is updated so\n   * that {@link getAccount} works for newly created accounts.\n   */\n  abstract createAccounts(\n    options: CreateAccountOptions,\n  ): Promise<KeyringAccount[]>;\n\n  /**\n   * Remove the account associated with the given {@link AccountId} from this\n   * keyring.\n   *\n   * Implementations are expected to translate the ID to an underlying\n   * address (typically via the registry) and then invoke the appropriate\n   * removal mechanism on the legacy keyring.\n   */\n  abstract deleteAccount(accountId: AccountId): Promise<void>;\n\n  /**\n   * Export the secrets associated with the given account in a format\n   * described by {@link ExportAccountOptions}.\n   *\n   * This method is optional, and concrete adapters should only\n   * implement it if the underlying keyring supports exporting\n   * accounts.\n   */\n  exportAccount?(\n    accountId: AccountId,\n    options?: ExportAccountOptions,\n  ): Promise<ExportedAccount>;\n\n  /**\n   * Handle a high-level {@link KeyringRequest} on behalf of this keyring.\n   *\n   * Concrete adapters are responsible for routing the request's method and\n   * parameters to the appropriate legacy keyring APIs (for example signing\n   * transactions or decrypting messages) and returning a JSON-serializable\n   * result.\n   */\n  abstract submitRequest(request: KeyringRequest): Promise<Json>;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask/keyring-sdk",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "MetaMask Keyring SDK",
   "keywords": [
     "metamask",
@@ -53,6 +53,7 @@
     "@metamask/superstruct": "^3.1.0",
     "@metamask/utils": "^11.10.0",
     "async-mutex": "^0.5.0",
+    "ethereum-cryptography": "^2.1.2",
     "uuid": "^9.0.1"
   },
   "devDependencies": {