@metamask-previews/keyring-sdk 1.1.0-018fb62

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.1.0]
+
+### Added
+
+- Add `encodeMnemonic` ([#495](https://github.com/MetaMask/accounts/pull/495))
+
+### Changed
+
+- Bump `@metamask/utils` from `^11.1.0` to `^11.10.0` ([#489](https://github.com/MetaMask/accounts/pull/489))
+
+## [1.0.0]
+
+### Added
+
+- 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
+[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/README.md

@@ -0,0 +1,47 @@
+# MetaMask Keyring SDK
+
+This package contains the heavy runtime dependencies related to the `@metamask/keyring-api` package
+to keep it as a lightweight API surface (types, structs, interfaces).
+
+## Installation
+
+```bash
+yarn add @metamask/keyring-sdk
+```
+
+or
+
+```bash
+npm install @metamask/keyring-sdk
+```
+
+## Usage
+
+```ts
+import { EthKeyringWrapper, EthKeyringMethod } from '@metamask/keyring-sdk';
+import { EthMethod, KeyringType } from '@metamask/keyring-api';
+
+export class MyKeyringV2 extends EthKeyringWrapper<MyLegacyKeyring> {
+  constructor(inner: MyLegacyKeyring) {
+    super({
+      type: KeyringType.Hd,
+      inner,
+      capabilities: { scopes: ['eip155:1'] },
+    });
+  }
+
+  async getAccounts() {
+    /* ... */
+  }
+  async createAccounts(options) {
+    /* ... */
+  }
+  async deleteAccount(accountId) {
+    /* ... */
+  }
+}
+```
+
+## Contributing
+
+This package is part of a monorepo. Instructions for contributing can be found in the [monorepo README](https://github.com/MetaMask/accounts#readme).

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

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EthKeyringWrapper = exports.EthKeyringMethod = void 0;
+const tx_1 = require("@ethereumjs/tx");
+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 keyring_wrapper_1 = require("../keyring-wrapper.cjs");
+/**
+ * Additional Ethereum methods supported by Eth keyrings that are not in the standard EthMethod enum.
+ * These are primarily encryption and utility methods.
+ */
+var EthKeyringMethod;
+(function (EthKeyringMethod) {
+    EthKeyringMethod["Decrypt"] = "eth_decrypt";
+    EthKeyringMethod["GetEncryptionPublicKey"] = "eth_getEncryptionPublicKey";
+    EthKeyringMethod["GetAppKeyAddress"] = "eth_getAppKeyAddress";
+    EthKeyringMethod["SignEip7702Authorization"] = "eth_signEip7702Authorization";
+})(EthKeyringMethod || (exports.EthKeyringMethod = EthKeyringMethod = {}));
+/**
+ * Abstract wrapper for Ethereum-based keyrings that extends KeyringWrapper, that itself implements KeyringV2.
+ *
+ * This class provides common functionality for all Ethereum keyrings including:
+ * - Request handling for standard Ethereum signing methods
+ * - Helper methods for Hex address conversion
+ *
+ * Subclasses must implement:
+ * - `getAccounts()`: Return all managed accounts
+ * - `createAccounts()`: Create new accounts based on options
+ * - `deleteAccount()`: Remove an account from the keyring
+ * - `exportAccount()` (optional): Export private key in specified format
+ */
+class EthKeyringWrapper extends keyring_wrapper_1.KeyringWrapper {
+    /**
+     * Helper method to safely cast a KeyringAccount address to Hex type.
+     * The KeyringAccount.address is typed as string, but for Ethereum accounts
+     * it should always be a valid Hex address.
+     *
+     * @param address - The address from a KeyringAccount.
+     * @returns The address as Hex type.
+     */
+    toHexAddress(address) {
+        return (0, utils_1.add0x)(address);
+    }
+    /**
+     * Handle an Ethereum signing request.
+     *
+     * Routes the request to the appropriate legacy keyring method based on
+     * the RPC method name.
+     *
+     * @param request - The keyring request containing method and params.
+     * @returns The result of the signing operation.
+     */
+    async submitRequest(request) {
+        const { method, params } = request.request;
+        const { address, methods } = await this.getAccount(request.account);
+        const hexAddress = this.toHexAddress(address);
+        // Validate account can handle the method
+        if (!methods.includes(method)) {
+            throw new Error(`Account ${request.account} cannot handle method: ${method}`);
+        }
+        switch (method) {
+            case `${keyring_api_1.EthMethod.SignTransaction}`: {
+                if (!this.inner.signTransaction) {
+                    throw new Error('Keyring does not support signTransaction');
+                }
+                (0, superstruct_1.assert)(params, keyring_api_1.EthSignTransactionParamsStruct);
+                const [txData] = params;
+                // Convert validated transaction data to TypedTransaction
+                // TODO: Improve typing to ensure txData matches TypedTxData
+                const tx = tx_1.TransactionFactory.fromTxData(txData);
+                // Note: Bigints are not directly representable in JSON
+                return (await this.inner.signTransaction(hexAddress, tx)); // FIXME: Should return type be unknown?
+            }
+            case `${keyring_api_1.EthMethod.Sign}`: {
+                if (!this.inner.signMessage) {
+                    throw new Error('Keyring does not support signMessage');
+                }
+                (0, superstruct_1.assert)(params, keyring_api_1.EthSignParamsStruct);
+                const [, data] = params;
+                return this.inner.signMessage(hexAddress, data);
+            }
+            case `${keyring_api_1.EthMethod.PersonalSign}`: {
+                if (!this.inner.signPersonalMessage) {
+                    throw new Error('Keyring does not support signPersonalMessage');
+                }
+                (0, superstruct_1.assert)(params, keyring_api_1.EthPersonalSignParamsStruct);
+                const [data] = params;
+                return this.inner.signPersonalMessage(hexAddress, data);
+            }
+            case `${keyring_api_1.EthMethod.SignTypedDataV1}`: {
+                if (!this.inner.signTypedData) {
+                    throw new Error('Keyring does not support signTypedData');
+                }
+                (0, superstruct_1.assert)(params, keyring_api_1.EthSignTypedDataV1ParamsStruct);
+                const [, data] = params;
+                return this.inner.signTypedData(hexAddress, data, {
+                    version: eth_sig_util_1.SignTypedDataVersion.V1,
+                });
+            }
+            case `${keyring_api_1.EthMethod.SignTypedDataV3}`: {
+                if (!this.inner.signTypedData) {
+                    throw new Error('Keyring does not support signTypedData');
+                }
+                (0, superstruct_1.assert)(params, keyring_api_1.EthSignTypedDataParamsStruct);
+                const [, data] = params;
+                return this.inner.signTypedData(hexAddress, 
+                // TODO: Improve typing to ensure data matches MessageTypes
+                data, {
+                    version: eth_sig_util_1.SignTypedDataVersion.V3,
+                });
+            }
+            case `${keyring_api_1.EthMethod.SignTypedDataV4}`: {
+                if (!this.inner.signTypedData) {
+                    throw new Error('Keyring does not support signTypedData');
+                }
+                (0, superstruct_1.assert)(params, keyring_api_1.EthSignTypedDataParamsStruct);
+                const [, data] = params;
+                return this.inner.signTypedData(hexAddress, 
+                // TODO: Improve typing to ensure data matches MessageTypes
+                data, {
+                    version: eth_sig_util_1.SignTypedDataVersion.V4,
+                });
+            }
+            case `${EthKeyringMethod.Decrypt}`: {
+                if (!this.inner.decryptMessage) {
+                    throw new Error('Keyring does not support decryptMessage');
+                }
+                (0, superstruct_1.assert)(params, keyring_api_1.EthDecryptParamsStruct);
+                const [encryptedData] = params;
+                return this.inner.decryptMessage(hexAddress, encryptedData);
+            }
+            case `${EthKeyringMethod.GetEncryptionPublicKey}`: {
+                if (!this.inner.getEncryptionPublicKey) {
+                    throw new Error('Keyring does not support getEncryptionPublicKey');
+                }
+                (0, superstruct_1.assert)(params, keyring_api_1.EthGetEncryptionPublicKeyParamsStruct);
+                const [, options] = params;
+                return this.inner.getEncryptionPublicKey(hexAddress, options);
+            }
+            case `${EthKeyringMethod.GetAppKeyAddress}`: {
+                if (!this.inner.getAppKeyAddress) {
+                    throw new Error('Keyring does not support getAppKeyAddress');
+                }
+                (0, superstruct_1.assert)(params, keyring_api_1.EthGetAppKeyAddressParamsStruct);
+                const [origin] = params;
+                return this.inner.getAppKeyAddress(hexAddress, origin);
+            }
+            case `${EthKeyringMethod.SignEip7702Authorization}`: {
+                if (!this.inner.signEip7702Authorization) {
+                    throw new Error('Keyring does not support signEip7702Authorization');
+                }
+                (0, superstruct_1.assert)(params, keyring_api_1.EthSignEip7702AuthorizationParamsStruct);
+                const [authorization] = params;
+                return this.inner.signEip7702Authorization(hexAddress, authorization);
+            }
+            default:
+                throw new Error(`Unsupported method for EthKeyringWrapper: ${method}`);
+        }
+    }
+}
+exports.EthKeyringWrapper = EthKeyringWrapper;
+//# sourceMappingURL=eth-keyring-wrapper.cjs.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,53 @@
+import type { KeyringAccount, KeyringRequest } from "@metamask/keyring-api";
+import type { EthKeyring } from "@metamask/keyring-utils";
+import { type Hex, type Json } from "@metamask/utils";
+import { KeyringWrapper, type KeyringWrapperOptions } from "../keyring-wrapper.cjs";
+/**
+ * Additional Ethereum methods supported by Eth keyrings that are not in the standard EthMethod enum.
+ * These are primarily encryption and utility methods.
+ */
+export declare enum EthKeyringMethod {
+    Decrypt = "eth_decrypt",
+    GetEncryptionPublicKey = "eth_getEncryptionPublicKey",
+    GetAppKeyAddress = "eth_getAppKeyAddress",
+    SignEip7702Authorization = "eth_signEip7702Authorization"
+}
+/**
+ * Options for constructing an EthKeyringWrapper.
+ */
+export type EthKeyringWrapperOptions<InnerKeyring extends EthKeyring> = KeyringWrapperOptions<InnerKeyring>;
+/**
+ * Abstract wrapper for Ethereum-based keyrings that extends KeyringWrapper, that itself implements KeyringV2.
+ *
+ * This class provides common functionality for all Ethereum keyrings including:
+ * - Request handling for standard Ethereum signing methods
+ * - Helper methods for Hex address conversion
+ *
+ * Subclasses must implement:
+ * - `getAccounts()`: Return all managed accounts
+ * - `createAccounts()`: Create new accounts based on options
+ * - `deleteAccount()`: Remove an account from the keyring
+ * - `exportAccount()` (optional): Export private key in specified format
+ */
+export declare abstract class EthKeyringWrapper<InnerKeyring extends EthKeyring, KeyringAccountType extends KeyringAccount = KeyringAccount> extends KeyringWrapper<InnerKeyring, KeyringAccountType> {
+    /**
+     * Helper method to safely cast a KeyringAccount address to Hex type.
+     * The KeyringAccount.address is typed as string, but for Ethereum accounts
+     * it should always be a valid Hex address.
+     *
+     * @param address - The address from a KeyringAccount.
+     * @returns The address as Hex type.
+     */
+    protected toHexAddress(address: string): Hex;
+    /**
+     * Handle an Ethereum signing request.
+     *
+     * Routes the request to the appropriate legacy keyring method based on
+     * the RPC method name.
+     *
+     * @param request - The keyring request containing method and params.
+     * @returns The result of the signing operation.
+     */
+    submitRequest(request: KeyringRequest): Promise<Json>;
+}
+//# sourceMappingURL=eth-keyring-wrapper.d.cts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,53 @@
+import type { KeyringAccount, KeyringRequest } from "@metamask/keyring-api";
+import type { EthKeyring } from "@metamask/keyring-utils";
+import { type Hex, type Json } from "@metamask/utils";
+import { KeyringWrapper, type KeyringWrapperOptions } from "../keyring-wrapper.mjs";
+/**
+ * Additional Ethereum methods supported by Eth keyrings that are not in the standard EthMethod enum.
+ * These are primarily encryption and utility methods.
+ */
+export declare enum EthKeyringMethod {
+    Decrypt = "eth_decrypt",
+    GetEncryptionPublicKey = "eth_getEncryptionPublicKey",
+    GetAppKeyAddress = "eth_getAppKeyAddress",
+    SignEip7702Authorization = "eth_signEip7702Authorization"
+}
+/**
+ * Options for constructing an EthKeyringWrapper.
+ */
+export type EthKeyringWrapperOptions<InnerKeyring extends EthKeyring> = KeyringWrapperOptions<InnerKeyring>;
+/**
+ * Abstract wrapper for Ethereum-based keyrings that extends KeyringWrapper, that itself implements KeyringV2.
+ *
+ * This class provides common functionality for all Ethereum keyrings including:
+ * - Request handling for standard Ethereum signing methods
+ * - Helper methods for Hex address conversion
+ *
+ * Subclasses must implement:
+ * - `getAccounts()`: Return all managed accounts
+ * - `createAccounts()`: Create new accounts based on options
+ * - `deleteAccount()`: Remove an account from the keyring
+ * - `exportAccount()` (optional): Export private key in specified format
+ */
+export declare abstract class EthKeyringWrapper<InnerKeyring extends EthKeyring, KeyringAccountType extends KeyringAccount = KeyringAccount> extends KeyringWrapper<InnerKeyring, KeyringAccountType> {
+    /**
+     * Helper method to safely cast a KeyringAccount address to Hex type.
+     * The KeyringAccount.address is typed as string, but for Ethereum accounts
+     * it should always be a valid Hex address.
+     *
+     * @param address - The address from a KeyringAccount.
+     * @returns The address as Hex type.
+     */
+    protected toHexAddress(address: string): Hex;
+    /**
+     * Handle an Ethereum signing request.
+     *
+     * Routes the request to the appropriate legacy keyring method based on
+     * the RPC method name.
+     *
+     * @param request - The keyring request containing method and params.
+     * @returns The result of the signing operation.
+     */
+    submitRequest(request: KeyringRequest): Promise<Json>;
+}
+//# sourceMappingURL=eth-keyring-wrapper.d.mts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,160 @@
+import { TransactionFactory } from "@ethereumjs/tx";
+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 { KeyringWrapper } from "../keyring-wrapper.mjs";
+/**
+ * Additional Ethereum methods supported by Eth keyrings that are not in the standard EthMethod enum.
+ * These are primarily encryption and utility methods.
+ */
+export var EthKeyringMethod;
+(function (EthKeyringMethod) {
+    EthKeyringMethod["Decrypt"] = "eth_decrypt";
+    EthKeyringMethod["GetEncryptionPublicKey"] = "eth_getEncryptionPublicKey";
+    EthKeyringMethod["GetAppKeyAddress"] = "eth_getAppKeyAddress";
+    EthKeyringMethod["SignEip7702Authorization"] = "eth_signEip7702Authorization";
+})(EthKeyringMethod || (EthKeyringMethod = {}));
+/**
+ * Abstract wrapper for Ethereum-based keyrings that extends KeyringWrapper, that itself implements KeyringV2.
+ *
+ * This class provides common functionality for all Ethereum keyrings including:
+ * - Request handling for standard Ethereum signing methods
+ * - Helper methods for Hex address conversion
+ *
+ * Subclasses must implement:
+ * - `getAccounts()`: Return all managed accounts
+ * - `createAccounts()`: Create new accounts based on options
+ * - `deleteAccount()`: Remove an account from the keyring
+ * - `exportAccount()` (optional): Export private key in specified format
+ */
+export class EthKeyringWrapper extends KeyringWrapper {
+    /**
+     * Helper method to safely cast a KeyringAccount address to Hex type.
+     * The KeyringAccount.address is typed as string, but for Ethereum accounts
+     * it should always be a valid Hex address.
+     *
+     * @param address - The address from a KeyringAccount.
+     * @returns The address as Hex type.
+     */
+    toHexAddress(address) {
+        return add0x(address);
+    }
+    /**
+     * Handle an Ethereum signing request.
+     *
+     * Routes the request to the appropriate legacy keyring method based on
+     * the RPC method name.
+     *
+     * @param request - The keyring request containing method and params.
+     * @returns The result of the signing operation.
+     */
+    async submitRequest(request) {
+        const { method, params } = request.request;
+        const { address, methods } = await this.getAccount(request.account);
+        const hexAddress = this.toHexAddress(address);
+        // Validate account can handle the method
+        if (!methods.includes(method)) {
+            throw new Error(`Account ${request.account} cannot handle method: ${method}`);
+        }
+        switch (method) {
+            case `${EthMethod.SignTransaction}`: {
+                if (!this.inner.signTransaction) {
+                    throw new Error('Keyring does not support signTransaction');
+                }
+                assert(params, EthSignTransactionParamsStruct);
+                const [txData] = params;
+                // Convert validated transaction data to TypedTransaction
+                // TODO: Improve typing to ensure txData matches TypedTxData
+                const tx = TransactionFactory.fromTxData(txData);
+                // Note: Bigints are not directly representable in JSON
+                return (await this.inner.signTransaction(hexAddress, tx)); // FIXME: Should return type be unknown?
+            }
+            case `${EthMethod.Sign}`: {
+                if (!this.inner.signMessage) {
+                    throw new Error('Keyring does not support signMessage');
+                }
+                assert(params, EthSignParamsStruct);
+                const [, data] = params;
+                return this.inner.signMessage(hexAddress, data);
+            }
+            case `${EthMethod.PersonalSign}`: {
+                if (!this.inner.signPersonalMessage) {
+                    throw new Error('Keyring does not support signPersonalMessage');
+                }
+                assert(params, EthPersonalSignParamsStruct);
+                const [data] = params;
+                return this.inner.signPersonalMessage(hexAddress, data);
+            }
+            case `${EthMethod.SignTypedDataV1}`: {
+                if (!this.inner.signTypedData) {
+                    throw new Error('Keyring does not support signTypedData');
+                }
+                assert(params, EthSignTypedDataV1ParamsStruct);
+                const [, data] = params;
+                return this.inner.signTypedData(hexAddress, data, {
+                    version: SignTypedDataVersion.V1,
+                });
+            }
+            case `${EthMethod.SignTypedDataV3}`: {
+                if (!this.inner.signTypedData) {
+                    throw new Error('Keyring does not support signTypedData');
+                }
+                assert(params, EthSignTypedDataParamsStruct);
+                const [, data] = params;
+                return this.inner.signTypedData(hexAddress, 
+                // TODO: Improve typing to ensure data matches MessageTypes
+                data, {
+                    version: SignTypedDataVersion.V3,
+                });
+            }
+            case `${EthMethod.SignTypedDataV4}`: {
+                if (!this.inner.signTypedData) {
+                    throw new Error('Keyring does not support signTypedData');
+                }
+                assert(params, EthSignTypedDataParamsStruct);
+                const [, data] = params;
+                return this.inner.signTypedData(hexAddress, 
+                // TODO: Improve typing to ensure data matches MessageTypes
+                data, {
+                    version: SignTypedDataVersion.V4,
+                });
+            }
+            case `${EthKeyringMethod.Decrypt}`: {
+                if (!this.inner.decryptMessage) {
+                    throw new Error('Keyring does not support decryptMessage');
+                }
+                assert(params, EthDecryptParamsStruct);
+                const [encryptedData] = params;
+                return this.inner.decryptMessage(hexAddress, encryptedData);
+            }
+            case `${EthKeyringMethod.GetEncryptionPublicKey}`: {
+                if (!this.inner.getEncryptionPublicKey) {
+                    throw new Error('Keyring does not support getEncryptionPublicKey');
+                }
+                assert(params, EthGetEncryptionPublicKeyParamsStruct);
+                const [, options] = params;
+                return this.inner.getEncryptionPublicKey(hexAddress, options);
+            }
+            case `${EthKeyringMethod.GetAppKeyAddress}`: {
+                if (!this.inner.getAppKeyAddress) {
+                    throw new Error('Keyring does not support getAppKeyAddress');
+                }
+                assert(params, EthGetAppKeyAddressParamsStruct);
+                const [origin] = params;
+                return this.inner.getAppKeyAddress(hexAddress, origin);
+            }
+            case `${EthKeyringMethod.SignEip7702Authorization}`: {
+                if (!this.inner.signEip7702Authorization) {
+                    throw new Error('Keyring does not support signEip7702Authorization');
+                }
+                assert(params, EthSignEip7702AuthorizationParamsStruct);
+                const [authorization] = params;
+                return this.inner.signEip7702Authorization(hexAddress, authorization);
+            }
+            default:
+                throw new Error(`Unsupported method for EthKeyringWrapper: ${method}`);
+        }
+    }
+}
+//# sourceMappingURL=eth-keyring-wrapper.mjs.map

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

@@ -0,0 +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"]}

package/dist/eth/index.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./eth-keyring-wrapper.cjs"), exports);
+//# sourceMappingURL=index.cjs.map

package/dist/eth/index.cjs.map

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

package/dist/eth/index.d.cts

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

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

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

package/dist/eth/index.d.mts

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

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

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

package/dist/eth/index.mjs

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

package/dist/eth/index.mjs.map

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

package/dist/index.cjs

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./keyring-wrapper.cjs"), exports);
+__exportStar(require("./keyring-account-registry.cjs"), exports);
+__exportStar(require("./mnemonic.cjs"), exports);
+__exportStar(require("./eth/index.cjs"), exports);
+//# sourceMappingURL=index.cjs.map