@metamask/eth-hd-keyring 9.0.1 → 10.0.1

package/dist/index.mjs

@@ -1,70 +1,83 @@
+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 _HdKeyring_instances, _HdKeyring_wallets, _HdKeyring_cryptographicFunctions, _HdKeyring_uint8ArrayToString, _HdKeyring_stringToUint8Array, _HdKeyring_mnemonicToUint8Array, _HdKeyring_getPrivateKeyFor, _HdKeyring_getWalletForAccount, _HdKeyring_initFromMnemonic, _HdKeyring_addressfromPublicKey, _HdKeyring_normalizeAddress;
 import { privateToPublic, publicToAddress, ecsign, arrToBufArr, bufferToHex } from "@ethereumjs/util";
-import { concatSig, decrypt, getEncryptionPublicKey, normalize, personalSign, signTypedData, SignTypedDataVersion } from "@metamask/eth-sig-util";
+import { concatSig, decrypt, getEncryptionPublicKey, normalize, personalSign, signEIP7702Authorization, signTypedData, SignTypedDataVersion } from "@metamask/eth-sig-util";
 import { mnemonicToSeed } from "@metamask/key-tree";
 import { generateMnemonic } from "@metamask/scure-bip39";
 import { wordlist } from "@metamask/scure-bip39/dist/wordlists/english.js";
-import { assertIsHexString, remove0x } from "@metamask/utils";
+import { add0x, assert, assertIsHexString, remove0x } from "@metamask/utils";
 import { HDKey } from "ethereum-cryptography/hdkey";
 import { keccak256 } from "ethereum-cryptography/keccak";
 import { bytesToHex } from "ethereum-cryptography/utils";
 // Options:
 const hdPathString = `m/44'/60'/0'/0`;
 const type = 'HD Key Tree';
+/**
+ * Checks if the given value is a valid serialized Buffer compatible with
+ * the return type of `Buffer.toJSON`.
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid serialized buffer, `false` otherwise.
+ */
+function isSerializedBuffer(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'type' in value &&
+        value.type === 'Buffer' &&
+        'data' in value &&
+        Array.isArray(value.data));
+}
 class HdKeyring {
-    /* PUBLIC METHODS */
     constructor(opts = {}) {
+        _HdKeyring_instances.add(this);
         this.type = type;
-        this._wallets = [];
+        this.hdPath = hdPathString;
+        _HdKeyring_wallets.set(this, []);
+        _HdKeyring_cryptographicFunctions.set(this, void 0);
         // Cryptographic functions to be used by `@metamask/key-tree`. It will use built-in implementations if not provided here.
-        this._cryptographicFunctions = opts.cryptographicFunctions;
+        __classPrivateFieldSet(this, _HdKeyring_cryptographicFunctions, opts.cryptographicFunctions, "f");
     }
+    /**
+     * Initialize the keyring with a random mnemonic.
+     *
+     * @returns A promise that resolves when the process is complete.
+     */
     async generateRandomMnemonic() {
-        await this._initFromMnemonic(generateMnemonic(wordlist));
-    }
-    _uint8ArrayToString(mnemonic) {
-        const recoveredIndices = Array.from(new Uint16Array(new Uint8Array(mnemonic).buffer));
-        return recoveredIndices.map((i) => wordlist[i]).join(' ');
-    }
-    _stringToUint8Array(mnemonic) {
-        const indices = mnemonic.split(' ').map((word) => wordlist.indexOf(word));
-        return new Uint8Array(new Uint16Array(indices).buffer);
-    }
-    _mnemonicToUint8Array(mnemonic) {
-        let mnemonicData = mnemonic;
-        // when encrypted/decrypted, buffers get cast into js object with a property type set to buffer
-        if (mnemonic && mnemonic.type && mnemonic.type === 'Buffer') {
-            mnemonicData = mnemonic.data;
-        }
-        if (
-        // this block is for backwards compatibility with vaults that were previously stored as buffers, number arrays or plain text strings
-        typeof mnemonicData === 'string' ||
-            Buffer.isBuffer(mnemonicData) ||
-            Array.isArray(mnemonicData)) {
-            let mnemonicAsString = mnemonicData;
-            if (Array.isArray(mnemonicData)) {
-                mnemonicAsString = Buffer.from(mnemonicData).toString();
-            }
-            else if (Buffer.isBuffer(mnemonicData)) {
-                mnemonicAsString = mnemonicData.toString();
-            }
-            return this._stringToUint8Array(mnemonicAsString);
-        }
-        else if (mnemonicData instanceof Object &&
-            !(mnemonicData instanceof Uint8Array)) {
-            // when encrypted/decrypted the Uint8Array becomes a js object we need to cast back to a Uint8Array
-            return Uint8Array.from(Object.values(mnemonicData));
-        }
-        return mnemonicData;
+        await __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_initFromMnemonic).call(this, generateMnemonic(wordlist));
     }
+    /**
+     * Return the serialized state of the keyring.
+     *
+     * @returns The serialized state of the keyring.
+     */
     async serialize() {
-        const mnemonicAsString = this._uint8ArrayToString(this.mnemonic);
-        const uint8ArrayMnemonic = new TextEncoder('utf-8').encode(mnemonicAsString);
+        let mnemonic = [];
+        if (this.mnemonic) {
+            const mnemonicAsString = __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_uint8ArrayToString).call(this, this.mnemonic);
+            mnemonic = Array.from(new TextEncoder().encode(mnemonicAsString));
+        }
         return {
-            mnemonic: Array.from(uint8ArrayMnemonic),
-            numberOfAccounts: this._wallets.length,
+            mnemonic,
+            numberOfAccounts: __classPrivateFieldGet(this, _HdKeyring_wallets, "f").length,
             hdPath: this.hdPath,
         };
     }
+    /**
+     * Initialize the keyring with the given serialized state.
+     *
+     * @param opts - The serialized state of the keyring.
+     * @returns An empty array.
+     */
     async deserialize(opts = {}) {
         if (opts.numberOfAccounts && !opts.mnemonic) {
             throw new Error('Eth-Hd-Keyring: Deserialize method cannot be called with an opts value for numberOfAccounts and no menmonic');
@@ -72,159 +85,301 @@ class HdKeyring {
         if (this.root) {
             throw new Error('Eth-Hd-Keyring: Secret recovery phrase already provided');
         }
-        this.opts = opts;
-        this._wallets = [];
+        __classPrivateFieldSet(this, _HdKeyring_wallets, [], "f");
         this.mnemonic = null;
         this.root = null;
-        this.hdPath = opts.hdPath || hdPathString;
+        this.hdPath = opts.hdPath ?? hdPathString;
         if (opts.mnemonic) {
-            await this._initFromMnemonic(opts.mnemonic);
+            await __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_initFromMnemonic).call(this, opts.mnemonic);
         }
         if (opts.numberOfAccounts) {
             return this.addAccounts(opts.numberOfAccounts);
         }
         return [];
     }
-    addAccounts(numberOfAccounts = 1) {
+    /**
+     * Add new accounts to the keyring. The accounts will be derived
+     * sequentially from the root HD wallet, using increasing indices.
+     *
+     * @param numberOfAccounts - The number of accounts to add.
+     * @returns The addresses of the new accounts.
+     */
+    async addAccounts(numberOfAccounts = 1) {
         if (!this.root) {
             throw new Error('Eth-Hd-Keyring: No secret recovery phrase provided');
         }
-        const oldLen = this._wallets.length;
+        const oldLen = __classPrivateFieldGet(this, _HdKeyring_wallets, "f").length;
         const newWallets = [];
         for (let i = oldLen; i < numberOfAccounts + oldLen; i++) {
             const wallet = this.root.deriveChild(i);
             newWallets.push(wallet);
-            this._wallets.push(wallet);
+            __classPrivateFieldGet(this, _HdKeyring_wallets, "f").push(wallet);
         }
-        const hexWallets = newWallets.map((w) => {
-            return this._addressfromPublicKey(w.publicKey);
+        const hexWallets = newWallets.map((wallet) => {
+            assert(wallet.publicKey, 'Expected public key to be set');
+            return __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_addressfromPublicKey).call(this, wallet.publicKey);
         });
         return Promise.resolve(hexWallets);
     }
+    /**
+     * Get the addresses of all accounts in the keyring.
+     *
+     * @returns The addresses of all accounts in the keyring.
+     */
     getAccounts() {
-        return this._wallets.map((w) => this._addressfromPublicKey(w.publicKey));
+        return __classPrivateFieldGet(this, _HdKeyring_wallets, "f").map((wallet) => {
+            assert(wallet.publicKey, 'Expected public key to be set');
+            return __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_addressfromPublicKey).call(this, wallet.publicKey);
+        });
     }
-    /* BASE KEYRING METHODS */
-    // returns an address specific to an app
+    /**
+     * Get the public address of the account for the given app key origin.
+     *
+     * @param address - The address of the account.
+     * @param origin - The origin of the app requesting the account.
+     * @returns The public address of the account.
+     */
     async getAppKeyAddress(address, origin) {
         if (!origin || typeof origin !== 'string') {
             throw new Error(`'origin' must be a non-empty string`);
         }
-        const wallet = this._getWalletForAccount(address, {
+        const wallet = __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_getWalletForAccount).call(this, address, {
             withAppKeyOrigin: origin,
         });
-        const appKeyAddress = normalize(publicToAddress(wallet.publicKey).toString('hex'));
+        assert(wallet.publicKey, 'Expected public key to be set');
+        const appKeyAddress = __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_normalizeAddress).call(this, publicToAddress(wallet.publicKey).toString('hex'));
         return appKeyAddress;
     }
-    // exportAccount should return a hex-encoded private key:
-    async exportAccount(address, opts = {}) {
-        const wallet = this._getWalletForAccount(address, opts);
-        return bytesToHex(wallet.privateKey);
+    /**
+     * Export the private key for a specific account.
+     *
+     * @param address - The address of the account.
+     * @param opts - The options for exporting the account.
+     * @param opts.withAppKeyOrigin - An optional string to export the account
+     * for a specific app origin.
+     * @returns The private key of the account.
+     */
+    async exportAccount(address, opts) {
+        const wallet = opts
+            ? __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_getWalletForAccount).call(this, address, opts)
+            : __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_getWalletForAccount).call(this, address);
+        const { privateKey } = wallet;
+        assert(privateKey instanceof Uint8Array, 'Expected private key to be of type Uint8Array');
+        return bytesToHex(privateKey);
     }
-    // tx is an instance of the ethereumjs-transaction class.
+    /**
+     * Sign a transaction using the private key of the specified account.
+     *
+     * @param address - The address of the account.
+     * @param tx - The transaction to sign.
+     * @param opts - The options for signing the transaction.
+     * @returns The signed transaction.
+     */
     async signTransaction(address, tx, opts = {}) {
-        const privKey = this._getPrivateKeyFor(address, opts);
-        const signedTx = tx.sign(privKey);
+        const privKey = __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_getPrivateKeyFor).call(this, address, opts);
+        const signedTx = tx.sign(Buffer.from(privKey));
         // Newer versions of Ethereumjs-tx are immutable and return a new tx object
-        return signedTx === undefined ? tx : signedTx;
+        return signedTx ?? tx;
     }
-    // For eth_sign, we need to sign arbitrary data:
+    /**
+     * Sign a message using the private key of the specified account.
+     *
+     * @param address - The address of the account.
+     * @param data - The data to sign.
+     * @param opts - The options for signing the message.
+     * @returns The signature of the message.
+     */
     async signMessage(address, data, opts = {}) {
         assertIsHexString(data);
         const message = remove0x(data);
-        const privKey = this._getPrivateKeyFor(address, opts);
-        const msgSig = ecsign(Buffer.from(message, 'hex'), privKey);
-        const rawMsgSig = concatSig(msgSig.v, msgSig.r, msgSig.s);
+        const privKey = __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_getPrivateKeyFor).call(this, address, opts);
+        const msgSig = ecsign(Buffer.from(message, 'hex'), Buffer.from(privKey));
+        const rawMsgSig = concatSig(
+        // WARN: verify this cast to Buffer
+        msgSig.v, msgSig.r, msgSig.s);
         return rawMsgSig;
     }
-    // For personal_sign, we need to prefix the message:
+    /**
+     * Sign a personal message using the private key of the specified account.
+     * This method is compatible with the `personal_sign` RPC method.
+     *
+     * @param address - The address of the account.
+     * @param msgHex - The message to sign.
+     * @param opts - The options for signing the message.
+     * @returns The signature of the message.
+     */
     async signPersonalMessage(address, msgHex, opts = {}) {
-        const privKey = this._getPrivateKeyFor(address, opts);
-        const privateKey = Buffer.from(privKey, 'hex');
-        const sig = personalSign({ privateKey, data: msgHex });
-        return sig;
+        const privKey = __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_getPrivateKeyFor).call(this, address, opts);
+        const privateKey = Buffer.from(privKey);
+        return personalSign({ privateKey, data: msgHex });
     }
-    // For eth_decryptMessage:
+    /**
+     * Decrypt an encrypted message using the private key of the specified account.
+     * The message must be encrypted using the public key of the account.
+     * This method is compatible with the `eth_decryptMessage` RPC method
+     *
+     * @param withAccount - The address of the account.
+     * @param encryptedData - The encrypted data.
+     * @returns The decrypted message.
+     */
     async decryptMessage(withAccount, encryptedData) {
-        const wallet = this._getWalletForAccount(withAccount);
+        const wallet = __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_getWalletForAccount).call(this, withAccount);
         const { privateKey: privateKeyAsUint8Array } = wallet;
+        assert(privateKeyAsUint8Array, 'Expected private key to be set');
         const privateKeyAsHex = Buffer.from(privateKeyAsUint8Array).toString('hex');
-        const sig = decrypt({ privateKey: privateKeyAsHex, encryptedData });
-        return sig;
+        return decrypt({ privateKey: privateKeyAsHex, encryptedData });
     }
-    // personal_signTypedData, signs data along with the schema
+    /**
+     * Sign a typed message using the private key of the specified account.
+     * This method is compatible with the `eth_signTypedData` RPC method.
+     *
+     * @param withAccount - The address of the account.
+     * @param typedData - The typed data to sign.
+     * @param opts - The options for signing the message.
+     * @returns The signature of the message.
+     */
     async signTypedData(withAccount, typedData, opts = { version: SignTypedDataVersion.V1 }) {
         // Treat invalid versions as "V1"
         const version = Object.keys(SignTypedDataVersion).includes(opts.version)
             ? opts.version
             : SignTypedDataVersion.V1;
-        const privateKey = this._getPrivateKeyFor(withAccount, opts);
-        return signTypedData({ privateKey, data: typedData, version });
+        const privateKey = __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_getPrivateKeyFor).call(this, withAccount, opts);
+        return signTypedData({
+            privateKey: Buffer.from(privateKey),
+            data: typedData,
+            version,
+        });
     }
+    /**
+     * Sign an EIP-7702 authorization using the private key of the specified account.
+     * This method is compatible with the EIP-7702 standard for enabling smart contract code for EOAs.
+     *
+     * @param withAccount - The address of the account.
+     * @param authorization - The EIP-7702 authorization to sign.
+     * @param opts - The options for selecting the account.
+     * @returns The signature of the authorization.
+     */
+    async signEip7702Authorization(withAccount, authorization, opts) {
+        const privateKey = __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_getPrivateKeyFor).call(this, withAccount, opts);
+        return signEIP7702Authorization({
+            privateKey: Buffer.from(privateKey),
+            authorization,
+        });
+    }
+    /**
+     * Remove an account from the keyring.
+     *
+     * @param account - The address of the account to remove.
+     */
     removeAccount(account) {
-        const address = normalize(account);
-        if (!this._wallets
-            .map(({ publicKey }) => this._addressfromPublicKey(publicKey))
+        const address = __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_normalizeAddress).call(this, account);
+        if (!__classPrivateFieldGet(this, _HdKeyring_wallets, "f")
+            .map(({ publicKey }) => publicKey && __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_addressfromPublicKey).call(this, publicKey))
             .includes(address)) {
             throw new Error(`Address ${address} not found in this keyring`);
         }
-        this._wallets = this._wallets.filter(({ publicKey }) => this._addressfromPublicKey(publicKey) !== address);
+        __classPrivateFieldSet(this, _HdKeyring_wallets, __classPrivateFieldGet(this, _HdKeyring_wallets, "f").filter(({ publicKey }) => publicKey && __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_addressfromPublicKey).call(this, publicKey) !== address), "f");
     }
-    // get public key for nacl
+    /**
+     * Get the public key of the account to be used for encryption.
+     *
+     * @param withAccount - The address of the account.
+     * @param opts - The options for selecting the account.
+     * @returns The public key of the account.
+     */
     async getEncryptionPublicKey(withAccount, opts = {}) {
-        const privKey = this._getPrivateKeyFor(withAccount, opts);
-        const publicKey = getEncryptionPublicKey(privKey);
+        const privKey = __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_getPrivateKeyFor).call(this, withAccount, opts);
+        const publicKey = getEncryptionPublicKey(bytesToHex(privKey));
         return publicKey;
     }
-    _getPrivateKeyFor(address, opts = {}) {
-        if (!address) {
-            throw new Error('Must specify address.');
-        }
-        const wallet = this._getWalletForAccount(address, opts);
-        return wallet.privateKey;
+}
+_HdKeyring_wallets = new WeakMap(), _HdKeyring_cryptographicFunctions = new WeakMap(), _HdKeyring_instances = new WeakSet(), _HdKeyring_uint8ArrayToString = function _HdKeyring_uint8ArrayToString(mnemonic) {
+    const recoveredIndices = Array.from(new Uint16Array(new Uint8Array(mnemonic).buffer));
+    return recoveredIndices.map((i) => wordlist[i]).join(' ');
+}, _HdKeyring_stringToUint8Array = function _HdKeyring_stringToUint8Array(mnemonic) {
+    const indices = mnemonic.split(' ').map((word) => wordlist.indexOf(word));
+    return new Uint8Array(new Uint16Array(indices).buffer);
+}, _HdKeyring_mnemonicToUint8Array = function _HdKeyring_mnemonicToUint8Array(mnemonic) {
+    let mnemonicData = mnemonic;
+    // When using `Buffer.toJSON()`, the Buffer is serialized into an object
+    // with the structure `{ type: 'Buffer', data: [...] }`
+    if (isSerializedBuffer(mnemonic)) {
+        mnemonicData = mnemonic.data;
     }
-    _getWalletForAccount(account, opts = {}) {
-        const address = normalize(account);
-        let wallet = this._wallets.find(({ publicKey }) => {
-            return this._addressfromPublicKey(publicKey) === address;
-        });
-        if (!wallet) {
-            throw new Error('HD Keyring - Unable to find matching address.');
+    if (
+    // this block is for backwards compatibility with vaults that were previously stored as buffers, number arrays or plain text strings
+    typeof mnemonicData === 'string' ||
+        Buffer.isBuffer(mnemonicData) ||
+        Array.isArray(mnemonicData)) {
+        let mnemonicAsString;
+        if (Array.isArray(mnemonicData)) {
+            mnemonicAsString = Buffer.from(mnemonicData).toString();
         }
-        if (opts.withAppKeyOrigin) {
-            const { privateKey } = wallet;
-            const appKeyOriginBuffer = Buffer.from(opts.withAppKeyOrigin, 'utf8');
-            const appKeyBuffer = Buffer.concat([privateKey, appKeyOriginBuffer]);
-            const appKeyPrivateKey = arrToBufArr(keccak256(appKeyBuffer, 256));
-            const appKeyPublicKey = privateToPublic(appKeyPrivateKey);
-            wallet = { privateKey: appKeyPrivateKey, publicKey: appKeyPublicKey };
+        else if (Buffer.isBuffer(mnemonicData)) {
+            mnemonicAsString = mnemonicData.toString();
         }
-        return wallet;
-    }
-    /* PRIVATE / UTILITY METHODS */
-    /**
-     * Sets appropriate properties for the keyring based on the given
-     * BIP39-compliant mnemonic.
-     *
-     * @param {string|Array<number>|Buffer} mnemonic - A seed phrase represented
-     * as a string, an array of UTF-8 bytes, or a Buffer. Mnemonic input
-     * passed as type buffer or array of UTF-8 bytes must be NFKD normalized.
-     */
-    async _initFromMnemonic(mnemonic) {
-        if (this.root) {
-            throw new Error('Eth-Hd-Keyring: Secret recovery phrase already provided');
+        else {
+            mnemonicAsString = mnemonicData;
         }
-        this.mnemonic = this._mnemonicToUint8Array(mnemonic);
-        const seed = await mnemonicToSeed(this.mnemonic, '', // No passphrase
-        this._cryptographicFunctions);
-        this.hdWallet = HDKey.fromMasterSeed(seed);
-        this.root = this.hdWallet.derive(this.hdPath);
+        return __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_stringToUint8Array).call(this, mnemonicAsString);
     }
-    // small helper function to convert publicKey in Uint8Array form to a publicAddress as a hex
-    _addressfromPublicKey(publicKey) {
-        return bufferToHex(publicToAddress(Buffer.from(publicKey), true)).toLowerCase();
+    else if (mnemonicData instanceof Object &&
+        !(mnemonicData instanceof Uint8Array)) {
+        // when encrypted/decrypted the Uint8Array becomes a js object we need to cast back to a Uint8Array
+        return Uint8Array.from(Object.values(mnemonicData));
     }
-}
+    assert(mnemonicData instanceof Uint8Array, 'Expected Uint8Array mnemonic');
+    return mnemonicData;
+}, _HdKeyring_getPrivateKeyFor = function _HdKeyring_getPrivateKeyFor(address, opts) {
+    if (!address) {
+        throw new Error('Must specify address.');
+    }
+    const wallet = __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_getWalletForAccount).call(this, address, opts);
+    assert(wallet.privateKey, 'Missing private key');
+    return wallet.privateKey;
+}, _HdKeyring_getWalletForAccount = function _HdKeyring_getWalletForAccount(account, { withAppKeyOrigin } = {}) {
+    const address = __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_normalizeAddress).call(this, account);
+    const wallet = __classPrivateFieldGet(this, _HdKeyring_wallets, "f").find(({ publicKey }) => {
+        return publicKey && __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_addressfromPublicKey).call(this, publicKey) === address;
+    });
+    if (!wallet) {
+        throw new Error('HD Keyring - Unable to find matching address.');
+    }
+    if (withAppKeyOrigin) {
+        const { privateKey } = wallet;
+        assert(privateKey, 'Expected private key to be set');
+        const appKeyOriginBuffer = Buffer.from(withAppKeyOrigin, 'utf8');
+        const appKeyBuffer = Buffer.concat([privateKey, appKeyOriginBuffer]);
+        const appKeyPrivateKey = arrToBufArr(keccak256(appKeyBuffer));
+        const appKeyPublicKey = privateToPublic(appKeyPrivateKey);
+        return { privateKey: appKeyPrivateKey, publicKey: appKeyPublicKey };
+    }
+    return wallet;
+}, _HdKeyring_initFromMnemonic = 
+/**
+ * Sets appropriate properties for the keyring based on the given
+ * BIP39-compliant mnemonic.
+ *
+ * @param mnemonic - A seed phrase represented
+ * as a string, an array of UTF-8 bytes, or a Buffer. Mnemonic input
+ * passed as type buffer or array of UTF-8 bytes must be NFKD normalized.
+ */
+async function _HdKeyring_initFromMnemonic(mnemonic) {
+    if (this.root) {
+        throw new Error('Eth-Hd-Keyring: Secret recovery phrase already provided');
+    }
+    this.mnemonic = __classPrivateFieldGet(this, _HdKeyring_instances, "m", _HdKeyring_mnemonicToUint8Array).call(this, mnemonic);
+    const seed = await mnemonicToSeed(this.mnemonic, '', // No passphrase
+    __classPrivateFieldGet(this, _HdKeyring_cryptographicFunctions, "f"));
+    this.hdWallet = HDKey.fromMasterSeed(seed);
+    this.root = this.hdWallet.derive(this.hdPath);
+}, _HdKeyring_addressfromPublicKey = function _HdKeyring_addressfromPublicKey(publicKey) {
+    return add0x(bufferToHex(publicToAddress(Buffer.from(publicKey), true)).toLowerCase());
+}, _HdKeyring_normalizeAddress = function _HdKeyring_normalizeAddress(address) {
+    const normalized = normalize(address);
+    assert(normalized, 'Expected address to be set');
+    return add0x(normalized);
+};
 HdKeyring.type = type;
 export default HdKeyring;
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"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","sourcesContent":["import {\n  privateToPublic,\n  publicToAddress,\n  ecsign,\n  arrToBufArr,\n  bufferToHex,\n} from '@ethereumjs/util';\nimport {\n  concatSig,\n  decrypt,\n  getEncryptionPublicKey,\n  normalize,\n  personalSign,\n  signTypedData,\n  SignTypedDataVersion,\n} from '@metamask/eth-sig-util';\nimport { mnemonicToSeed } from '@metamask/key-tree';\nimport { generateMnemonic } from '@metamask/scure-bip39';\nimport { wordlist } from '@metamask/scure-bip39/dist/wordlists/english';\nimport { assertIsHexString, remove0x } from '@metamask/utils';\nimport { HDKey } from 'ethereum-cryptography/hdkey';\nimport { keccak256 } from 'ethereum-cryptography/keccak';\nimport { bytesToHex } from 'ethereum-cryptography/utils';\n\n// Options:\nconst hdPathString = `m/44'/60'/0'/0`;\nconst type = 'HD Key Tree';\n\nclass HdKeyring {\n  /* PUBLIC METHODS */\n  constructor(opts = {}) {\n    this.type = type;\n    this._wallets = [];\n    // Cryptographic functions to be used by `@metamask/key-tree`. It will use built-in implementations if not provided here.\n    this._cryptographicFunctions = opts.cryptographicFunctions;\n  }\n\n  async generateRandomMnemonic() {\n    await this._initFromMnemonic(generateMnemonic(wordlist));\n  }\n\n  _uint8ArrayToString(mnemonic) {\n    const recoveredIndices = Array.from(\n      new Uint16Array(new Uint8Array(mnemonic).buffer),\n    );\n    return recoveredIndices.map((i) => wordlist[i]).join(' ');\n  }\n\n  _stringToUint8Array(mnemonic) {\n    const indices = mnemonic.split(' ').map((word) => wordlist.indexOf(word));\n    return new Uint8Array(new Uint16Array(indices).buffer);\n  }\n\n  _mnemonicToUint8Array(mnemonic) {\n    let mnemonicData = mnemonic;\n    // when encrypted/decrypted, buffers get cast into js object with a property type set to buffer\n    if (mnemonic && mnemonic.type && mnemonic.type === 'Buffer') {\n      mnemonicData = mnemonic.data;\n    }\n\n    if (\n      // this block is for backwards compatibility with vaults that were previously stored as buffers, number arrays or plain text strings\n      typeof mnemonicData === 'string' ||\n      Buffer.isBuffer(mnemonicData) ||\n      Array.isArray(mnemonicData)\n    ) {\n      let mnemonicAsString = mnemonicData;\n      if (Array.isArray(mnemonicData)) {\n        mnemonicAsString = Buffer.from(mnemonicData).toString();\n      } else if (Buffer.isBuffer(mnemonicData)) {\n        mnemonicAsString = mnemonicData.toString();\n      }\n      return this._stringToUint8Array(mnemonicAsString);\n    } else if (\n      mnemonicData instanceof Object &&\n      !(mnemonicData instanceof Uint8Array)\n    ) {\n      // when encrypted/decrypted the Uint8Array becomes a js object we need to cast back to a Uint8Array\n      return Uint8Array.from(Object.values(mnemonicData));\n    }\n    return mnemonicData;\n  }\n\n  async serialize() {\n    const mnemonicAsString = this._uint8ArrayToString(this.mnemonic);\n    const uint8ArrayMnemonic = new TextEncoder('utf-8').encode(\n      mnemonicAsString,\n    );\n\n    return {\n      mnemonic: Array.from(uint8ArrayMnemonic),\n      numberOfAccounts: this._wallets.length,\n      hdPath: this.hdPath,\n    };\n  }\n\n  async deserialize(opts = {}) {\n    if (opts.numberOfAccounts && !opts.mnemonic) {\n      throw new Error(\n        'Eth-Hd-Keyring: Deserialize method cannot be called with an opts value for numberOfAccounts and no menmonic',\n      );\n    }\n\n    if (this.root) {\n      throw new Error(\n        'Eth-Hd-Keyring: Secret recovery phrase already provided',\n      );\n    }\n    this.opts = opts;\n    this._wallets = [];\n    this.mnemonic = null;\n    this.root = null;\n    this.hdPath = opts.hdPath || hdPathString;\n\n    if (opts.mnemonic) {\n      await this._initFromMnemonic(opts.mnemonic);\n    }\n\n    if (opts.numberOfAccounts) {\n      return this.addAccounts(opts.numberOfAccounts);\n    }\n\n    return [];\n  }\n\n  addAccounts(numberOfAccounts = 1) {\n    if (!this.root) {\n      throw new Error('Eth-Hd-Keyring: No secret recovery phrase provided');\n    }\n\n    const oldLen = this._wallets.length;\n    const newWallets = [];\n    for (let i = oldLen; i < numberOfAccounts + oldLen; i++) {\n      const wallet = this.root.deriveChild(i);\n      newWallets.push(wallet);\n      this._wallets.push(wallet);\n    }\n    const hexWallets = newWallets.map((w) => {\n      return this._addressfromPublicKey(w.publicKey);\n    });\n    return Promise.resolve(hexWallets);\n  }\n\n  getAccounts() {\n    return this._wallets.map((w) => this._addressfromPublicKey(w.publicKey));\n  }\n\n  /* BASE KEYRING METHODS */\n\n  // returns an address specific to an app\n  async getAppKeyAddress(address, origin) {\n    if (!origin || typeof origin !== 'string') {\n      throw new Error(`'origin' must be a non-empty string`);\n    }\n    const wallet = this._getWalletForAccount(address, {\n      withAppKeyOrigin: origin,\n    });\n    const appKeyAddress = normalize(\n      publicToAddress(wallet.publicKey).toString('hex'),\n    );\n\n    return appKeyAddress;\n  }\n\n  // exportAccount should return a hex-encoded private key:\n  async exportAccount(address, opts = {}) {\n    const wallet = this._getWalletForAccount(address, opts);\n    return bytesToHex(wallet.privateKey);\n  }\n\n  // tx is an instance of the ethereumjs-transaction class.\n  async signTransaction(address, tx, opts = {}) {\n    const privKey = this._getPrivateKeyFor(address, opts);\n    const signedTx = tx.sign(privKey);\n    // Newer versions of Ethereumjs-tx are immutable and return a new tx object\n    return signedTx === undefined ? tx : signedTx;\n  }\n\n  // For eth_sign, we need to sign arbitrary data:\n  async signMessage(address, data, opts = {}) {\n    assertIsHexString(data);\n    const message = remove0x(data);\n    const privKey = this._getPrivateKeyFor(address, opts);\n    const msgSig = ecsign(Buffer.from(message, 'hex'), privKey);\n    const rawMsgSig = concatSig(msgSig.v, msgSig.r, msgSig.s);\n    return rawMsgSig;\n  }\n\n  // For personal_sign, we need to prefix the message:\n  async signPersonalMessage(address, msgHex, opts = {}) {\n    const privKey = this._getPrivateKeyFor(address, opts);\n    const privateKey = Buffer.from(privKey, 'hex');\n    const sig = personalSign({ privateKey, data: msgHex });\n    return sig;\n  }\n\n  // For eth_decryptMessage:\n  async decryptMessage(withAccount, encryptedData) {\n    const wallet = this._getWalletForAccount(withAccount);\n    const { privateKey: privateKeyAsUint8Array } = wallet;\n    const privateKeyAsHex = Buffer.from(privateKeyAsUint8Array).toString('hex');\n    const sig = decrypt({ privateKey: privateKeyAsHex, encryptedData });\n    return sig;\n  }\n\n  // personal_signTypedData, signs data along with the schema\n  async signTypedData(\n    withAccount,\n    typedData,\n    opts = { version: SignTypedDataVersion.V1 },\n  ) {\n    // Treat invalid versions as \"V1\"\n    const version = Object.keys(SignTypedDataVersion).includes(opts.version)\n      ? opts.version\n      : SignTypedDataVersion.V1;\n\n    const privateKey = this._getPrivateKeyFor(withAccount, opts);\n    return signTypedData({ privateKey, data: typedData, version });\n  }\n\n  removeAccount(account) {\n    const address = normalize(account);\n    if (\n      !this._wallets\n        .map(({ publicKey }) => this._addressfromPublicKey(publicKey))\n        .includes(address)\n    ) {\n      throw new Error(`Address ${address} not found in this keyring`);\n    }\n\n    this._wallets = this._wallets.filter(\n      ({ publicKey }) => this._addressfromPublicKey(publicKey) !== address,\n    );\n  }\n\n  // get public key for nacl\n  async getEncryptionPublicKey(withAccount, opts = {}) {\n    const privKey = this._getPrivateKeyFor(withAccount, opts);\n    const publicKey = getEncryptionPublicKey(privKey);\n    return publicKey;\n  }\n\n  _getPrivateKeyFor(address, opts = {}) {\n    if (!address) {\n      throw new Error('Must specify address.');\n    }\n    const wallet = this._getWalletForAccount(address, opts);\n    return wallet.privateKey;\n  }\n\n  _getWalletForAccount(account, opts = {}) {\n    const address = normalize(account);\n    let wallet = this._wallets.find(({ publicKey }) => {\n      return this._addressfromPublicKey(publicKey) === address;\n    });\n    if (!wallet) {\n      throw new Error('HD Keyring - Unable to find matching address.');\n    }\n\n    if (opts.withAppKeyOrigin) {\n      const { privateKey } = wallet;\n      const appKeyOriginBuffer = Buffer.from(opts.withAppKeyOrigin, 'utf8');\n      const appKeyBuffer = Buffer.concat([privateKey, appKeyOriginBuffer]);\n      const appKeyPrivateKey = arrToBufArr(keccak256(appKeyBuffer, 256));\n      const appKeyPublicKey = privateToPublic(appKeyPrivateKey);\n      wallet = { privateKey: appKeyPrivateKey, publicKey: appKeyPublicKey };\n    }\n\n    return wallet;\n  }\n\n  /* PRIVATE / UTILITY METHODS */\n\n  /**\n   * Sets appropriate properties for the keyring based on the given\n   * BIP39-compliant mnemonic.\n   *\n   * @param {string|Array<number>|Buffer} mnemonic - A seed phrase represented\n   * as a string, an array of UTF-8 bytes, or a Buffer. Mnemonic input\n   * passed as type buffer or array of UTF-8 bytes must be NFKD normalized.\n   */\n  async _initFromMnemonic(mnemonic) {\n    if (this.root) {\n      throw new Error(\n        'Eth-Hd-Keyring: Secret recovery phrase already provided',\n      );\n    }\n\n    this.mnemonic = this._mnemonicToUint8Array(mnemonic);\n\n    const seed = await mnemonicToSeed(\n      this.mnemonic,\n      '', // No passphrase\n      this._cryptographicFunctions,\n    );\n    this.hdWallet = HDKey.fromMasterSeed(seed);\n    this.root = this.hdWallet.derive(this.hdPath);\n  }\n\n  // small helper function to convert publicKey in Uint8Array form to a publicAddress as a hex\n  _addressfromPublicKey(publicKey) {\n    return bufferToHex(\n      publicToAddress(Buffer.from(publicKey), true),\n    ).toLowerCase();\n  }\n}\n\nHdKeyring.type = type;\nexport default HdKeyring;\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TypedTransaction } from '@ethereumjs/tx';\nimport {\n  privateToPublic,\n  publicToAddress,\n  ecsign,\n  arrToBufArr,\n  bufferToHex,\n} from '@ethereumjs/util';\nimport {\n  concatSig,\n  decrypt,\n  type EIP7702Authorization,\n  type EthEncryptedData,\n  getEncryptionPublicKey,\n  type MessageTypes,\n  normalize,\n  personalSign,\n  signEIP7702Authorization,\n  signTypedData,\n  SignTypedDataVersion,\n  type TypedDataV1,\n  type TypedMessage,\n} from '@metamask/eth-sig-util';\nimport {\n  type CryptographicFunctions,\n  mnemonicToSeed,\n} from '@metamask/key-tree';\nimport { generateMnemonic } from '@metamask/scure-bip39';\nimport { wordlist } from '@metamask/scure-bip39/dist/wordlists/english';\nimport {\n  add0x,\n  assert,\n  assertIsHexString,\n  type Hex,\n  remove0x,\n} from '@metamask/utils';\nimport { HDKey } from 'ethereum-cryptography/hdkey';\nimport { keccak256 } from 'ethereum-cryptography/keccak';\nimport { bytesToHex } from 'ethereum-cryptography/utils';\n\n// Options:\nconst hdPathString = `m/44'/60'/0'/0`;\nconst type = 'HD Key Tree';\n\nexport type HDKeyringOptions = {\n  cryptographicFunctions?: CryptographicFunctions;\n};\n\n/**\n * The serialized state of an `HDKeyring` instance.\n *\n * @property mnemonic - The mnemonic seed phrase as an array of numbers.\n * @property numberOfAccounts - The number of accounts in the keyring.\n * @property hdPath - The HD path used to derive accounts.\n */\nexport type HDKeyringState = {\n  mnemonic: number[] | Uint8Array | Buffer | string;\n  numberOfAccounts: number;\n  hdPath: string;\n};\n\n/**\n * Options for selecting an account from an `HDKeyring` instance.\n *\n * @property withAppKeyOrigin - The origin of the app requesting the account.\n */\nexport type HDKeyringAccountSelectionOptions = {\n  withAppKeyOrigin?: string;\n};\n\ntype SerializedBuffer = ReturnType<Buffer['toJSON']>;\n\n/**\n * Checks if the given value is a valid serialized Buffer compatible with\n * the return type of `Buffer.toJSON`.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a valid serialized buffer, `false` otherwise.\n */\nfunction isSerializedBuffer(value: unknown): value is SerializedBuffer {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'type' in value &&\n    value.type === 'Buffer' &&\n    'data' in value &&\n    Array.isArray(value.data)\n  );\n}\n\nclass HdKeyring {\n  static type: string = type;\n\n  type: string = type;\n\n  mnemonic?: Uint8Array | null;\n\n  root?: HDKey | null;\n\n  hdWallet?: HDKey;\n\n  hdPath: string = hdPathString;\n\n  #wallets: HDKey[] = [];\n\n  readonly #cryptographicFunctions?: CryptographicFunctions;\n\n  constructor(opts: HDKeyringOptions = {}) {\n    // Cryptographic functions to be used by `@metamask/key-tree`. It will use built-in implementations if not provided here.\n    this.#cryptographicFunctions = opts.cryptographicFunctions;\n  }\n\n  /**\n   * Initialize the keyring with a random mnemonic.\n   *\n   * @returns A promise that resolves when the process is complete.\n   */\n  async generateRandomMnemonic(): Promise<void> {\n    await this.#initFromMnemonic(generateMnemonic(wordlist));\n  }\n\n  /**\n   * Return the serialized state of the keyring.\n   *\n   * @returns The serialized state of the keyring.\n   */\n  async serialize(): Promise<HDKeyringState> {\n    let mnemonic: number[] = [];\n\n    if (this.mnemonic) {\n      const mnemonicAsString = this.#uint8ArrayToString(this.mnemonic);\n      mnemonic = Array.from(new TextEncoder().encode(mnemonicAsString));\n    }\n\n    return {\n      mnemonic,\n      numberOfAccounts: this.#wallets.length,\n      hdPath: this.hdPath,\n    };\n  }\n\n  /**\n   * Initialize the keyring with the given serialized state.\n   *\n   * @param opts - The serialized state of the keyring.\n   * @returns An empty array.\n   */\n  async deserialize(opts: Partial<HDKeyringState> = {}): Promise<string[]> {\n    if (opts.numberOfAccounts && !opts.mnemonic) {\n      throw new Error(\n        'Eth-Hd-Keyring: Deserialize method cannot be called with an opts value for numberOfAccounts and no menmonic',\n      );\n    }\n\n    if (this.root) {\n      throw new Error(\n        'Eth-Hd-Keyring: Secret recovery phrase already provided',\n      );\n    }\n    this.#wallets = [];\n    this.mnemonic = null;\n    this.root = null;\n    this.hdPath = opts.hdPath ?? hdPathString;\n\n    if (opts.mnemonic) {\n      await this.#initFromMnemonic(opts.mnemonic);\n    }\n\n    if (opts.numberOfAccounts) {\n      return this.addAccounts(opts.numberOfAccounts);\n    }\n\n    return [];\n  }\n\n  /**\n   * Add new accounts to the keyring. The accounts will be derived\n   * sequentially from the root HD wallet, using increasing indices.\n   *\n   * @param numberOfAccounts - The number of accounts to add.\n   * @returns The addresses of the new accounts.\n   */\n  async addAccounts(numberOfAccounts = 1): Promise<Hex[]> {\n    if (!this.root) {\n      throw new Error('Eth-Hd-Keyring: No secret recovery phrase provided');\n    }\n\n    const oldLen = this.#wallets.length;\n    const newWallets: HDKey[] = [];\n    for (let i = oldLen; i < numberOfAccounts + oldLen; i++) {\n      const wallet = this.root.deriveChild(i);\n      newWallets.push(wallet);\n      this.#wallets.push(wallet);\n    }\n    const hexWallets = newWallets.map((wallet) => {\n      assert(wallet.publicKey, 'Expected public key to be set');\n      return this.#addressfromPublicKey(wallet.publicKey);\n    });\n    return Promise.resolve(hexWallets);\n  }\n\n  /**\n   * Get the addresses of all accounts in the keyring.\n   *\n   * @returns The addresses of all accounts in the keyring.\n   */\n  getAccounts(): Hex[] {\n    return this.#wallets.map((wallet) => {\n      assert(wallet.publicKey, 'Expected public key to be set');\n      return this.#addressfromPublicKey(wallet.publicKey);\n    });\n  }\n\n  /**\n   * Get the public address of the account for the given app key origin.\n   *\n   * @param address - The address of the account.\n   * @param origin - The origin of the app requesting the account.\n   * @returns The public address of the account.\n   */\n  async getAppKeyAddress(address: Hex, origin: string): Promise<Hex> {\n    if (!origin || typeof origin !== 'string') {\n      throw new Error(`'origin' must be a non-empty string`);\n    }\n    const wallet = this.#getWalletForAccount(address, {\n      withAppKeyOrigin: origin,\n    });\n    assert(wallet.publicKey, 'Expected public key to be set');\n    const appKeyAddress = this.#normalizeAddress(\n      publicToAddress(wallet.publicKey).toString('hex'),\n    );\n    return appKeyAddress;\n  }\n\n  /**\n   * Export the private key for a specific account.\n   *\n   * @param address - The address of the account.\n   * @param opts - The options for exporting the account.\n   * @param opts.withAppKeyOrigin - An optional string to export the account\n   * for a specific app origin.\n   * @returns The private key of the account.\n   */\n  async exportAccount(\n    address: Hex,\n    opts?: { withAppKeyOrigin: string },\n  ): Promise<string> {\n    const wallet = opts\n      ? this.#getWalletForAccount(address, opts)\n      : this.#getWalletForAccount(address);\n    const { privateKey } = wallet;\n    assert(\n      privateKey instanceof Uint8Array,\n      'Expected private key to be of type Uint8Array',\n    );\n    return bytesToHex(privateKey);\n  }\n\n  /**\n   * Sign a transaction using the private key of the specified account.\n   *\n   * @param address - The address of the account.\n   * @param tx - The transaction to sign.\n   * @param opts - The options for signing the transaction.\n   * @returns The signed transaction.\n   */\n  async signTransaction(\n    address: Hex,\n    tx: TypedTransaction,\n    opts = {},\n  ): Promise<TypedTransaction> {\n    const privKey = this.#getPrivateKeyFor(address, opts);\n    const signedTx = tx.sign(Buffer.from(privKey));\n    // Newer versions of Ethereumjs-tx are immutable and return a new tx object\n    return signedTx ?? tx;\n  }\n\n  /**\n   * Sign a message using the private key of the specified account.\n   *\n   * @param address - The address of the account.\n   * @param data - The data to sign.\n   * @param opts - The options for signing the message.\n   * @returns The signature of the message.\n   */\n  async signMessage(\n    address: Hex,\n    data: string,\n    opts: HDKeyringAccountSelectionOptions = {},\n  ): Promise<string> {\n    assertIsHexString(data);\n    const message = remove0x(data);\n    const privKey = this.#getPrivateKeyFor(address, opts);\n    const msgSig = ecsign(Buffer.from(message, 'hex'), Buffer.from(privKey));\n    const rawMsgSig = concatSig(\n      // WARN: verify this cast to Buffer\n      msgSig.v as unknown as Buffer,\n      msgSig.r,\n      msgSig.s,\n    );\n    return rawMsgSig;\n  }\n\n  /**\n   * Sign a personal message using the private key of the specified account.\n   * This method is compatible with the `personal_sign` RPC method.\n   *\n   * @param address - The address of the account.\n   * @param msgHex - The message to sign.\n   * @param opts - The options for signing the message.\n   * @returns The signature of the message.\n   */\n  async signPersonalMessage(\n    address: Hex,\n    msgHex: string,\n    opts: HDKeyringAccountSelectionOptions = {},\n  ): Promise<string> {\n    const privKey = this.#getPrivateKeyFor(address, opts);\n    const privateKey = Buffer.from(privKey);\n    return personalSign({ privateKey, data: msgHex });\n  }\n\n  /**\n   * Decrypt an encrypted message using the private key of the specified account.\n   * The message must be encrypted using the public key of the account.\n   * This method is compatible with the `eth_decryptMessage` RPC method\n   *\n   * @param withAccount - The address of the account.\n   * @param encryptedData - The encrypted data.\n   * @returns The decrypted message.\n   */\n  async decryptMessage(\n    withAccount: Hex,\n    encryptedData: EthEncryptedData,\n  ): Promise<string> {\n    const wallet = this.#getWalletForAccount(withAccount);\n    const { privateKey: privateKeyAsUint8Array } = wallet;\n    assert(privateKeyAsUint8Array, 'Expected private key to be set');\n    const privateKeyAsHex = Buffer.from(privateKeyAsUint8Array).toString('hex');\n    return decrypt({ privateKey: privateKeyAsHex, encryptedData });\n  }\n\n  /**\n   * Sign a typed message using the private key of the specified account.\n   * This method is compatible with the `eth_signTypedData` RPC method.\n   *\n   * @param withAccount - The address of the account.\n   * @param typedData - The typed data to sign.\n   * @param opts - The options for signing the message.\n   * @returns The signature of the message.\n   */\n  async signTypedData<Types extends MessageTypes>(\n    withAccount: Hex,\n    typedData: TypedDataV1 | TypedMessage<Types>,\n    opts: HDKeyringAccountSelectionOptions & {\n      version: SignTypedDataVersion;\n    } = { version: SignTypedDataVersion.V1 },\n  ): Promise<string> {\n    // Treat invalid versions as \"V1\"\n    const version = Object.keys(SignTypedDataVersion).includes(opts.version)\n      ? opts.version\n      : SignTypedDataVersion.V1;\n\n    const privateKey = this.#getPrivateKeyFor(withAccount, opts);\n    return signTypedData({\n      privateKey: Buffer.from(privateKey),\n      data: typedData,\n      version,\n    });\n  }\n\n  /**\n   * Sign an EIP-7702 authorization using the private key of the specified account.\n   * This method is compatible with the EIP-7702 standard for enabling smart contract code for EOAs.\n   *\n   * @param withAccount - The address of the account.\n   * @param authorization - The EIP-7702 authorization to sign.\n   * @param opts - The options for selecting the account.\n   * @returns The signature of the authorization.\n   */\n  async signEip7702Authorization(\n    withAccount: Hex,\n    authorization: EIP7702Authorization,\n    opts?: HDKeyringAccountSelectionOptions,\n  ): Promise<string> {\n    const privateKey = this.#getPrivateKeyFor(withAccount, opts);\n    return signEIP7702Authorization({\n      privateKey: Buffer.from(privateKey),\n      authorization,\n    });\n  }\n\n  /**\n   * Remove an account from the keyring.\n   *\n   * @param account - The address of the account to remove.\n   */\n  removeAccount(account: Hex): void {\n    const address = this.#normalizeAddress(account);\n    if (\n      !this.#wallets\n        .map(\n          ({ publicKey }) => publicKey && this.#addressfromPublicKey(publicKey),\n        )\n        .includes(address)\n    ) {\n      throw new Error(`Address ${address} not found in this keyring`);\n    }\n\n    this.#wallets = this.#wallets.filter(\n      ({ publicKey }) =>\n        publicKey && this.#addressfromPublicKey(publicKey) !== address,\n    );\n  }\n\n  /**\n   * Get the public key of the account to be used for encryption.\n   *\n   * @param withAccount - The address of the account.\n   * @param opts - The options for selecting the account.\n   * @returns The public key of the account.\n   */\n  async getEncryptionPublicKey(\n    withAccount: Hex,\n    opts: HDKeyringAccountSelectionOptions = {},\n  ): Promise<string> {\n    const privKey = this.#getPrivateKeyFor(withAccount, opts);\n    const publicKey = getEncryptionPublicKey(bytesToHex(privKey));\n    return publicKey;\n  }\n\n  /**\n   * Convert a Uint8Array mnemonic to a secret recovery phrase,\n   * using the english wordlist.\n   *\n   * @param mnemonic - The Uint8Array mnemonic.\n   * @returns The string mnemonic.\n   */\n  #uint8ArrayToString(mnemonic: Uint8Array): string {\n    const recoveredIndices = Array.from(\n      new Uint16Array(new Uint8Array(mnemonic).buffer),\n    );\n    return recoveredIndices.map((i) => wordlist[i]).join(' ');\n  }\n\n  /**\n   * Convert a secret recovery phrase to a Uint8Array mnemonic,\n   * using the english wordlist.\n   *\n   * @param mnemonic - The string mnemonic.\n   * @returns The Uint8Array mnemonic.\n   */\n  #stringToUint8Array(mnemonic: string): Uint8Array {\n    const indices = mnemonic.split(' ').map((word) => wordlist.indexOf(word));\n    return new Uint8Array(new Uint16Array(indices).buffer);\n  }\n\n  /**\n   * Convert a mnemonic to a Uint8Array mnemonic.\n   *\n   * @param mnemonic - The mnemonic seed phrase.\n   * @returns The Uint8Array mnemonic.\n   */\n  #mnemonicToUint8Array(\n    mnemonic: Buffer | SerializedBuffer | string | Uint8Array | number[],\n  ): Uint8Array {\n    let mnemonicData: unknown = mnemonic;\n    // When using `Buffer.toJSON()`, the Buffer is serialized into an object\n    // with the structure `{ type: 'Buffer', data: [...] }`\n    if (isSerializedBuffer(mnemonic)) {\n      mnemonicData = mnemonic.data;\n    }\n\n    if (\n      // this block is for backwards compatibility with vaults that were previously stored as buffers, number arrays or plain text strings\n      typeof mnemonicData === 'string' ||\n      Buffer.isBuffer(mnemonicData) ||\n      Array.isArray(mnemonicData)\n    ) {\n      let mnemonicAsString: string;\n      if (Array.isArray(mnemonicData)) {\n        mnemonicAsString = Buffer.from(mnemonicData).toString();\n      } else if (Buffer.isBuffer(mnemonicData)) {\n        mnemonicAsString = mnemonicData.toString();\n      } else {\n        mnemonicAsString = mnemonicData;\n      }\n      return this.#stringToUint8Array(mnemonicAsString);\n    } else if (\n      mnemonicData instanceof Object &&\n      !(mnemonicData instanceof Uint8Array)\n    ) {\n      // when encrypted/decrypted the Uint8Array becomes a js object we need to cast back to a Uint8Array\n      return Uint8Array.from(Object.values(mnemonicData));\n    }\n\n    assert(mnemonicData instanceof Uint8Array, 'Expected Uint8Array mnemonic');\n    return mnemonicData;\n  }\n\n  /**\n   * Get the private key for the specified account.\n   *\n   * @param address - The address of the account.\n   * @param opts - The options for selecting the account.\n   * @returns The private key of the account.\n   */\n  #getPrivateKeyFor(\n    address: Hex,\n    opts?: HDKeyringAccountSelectionOptions,\n  ): Uint8Array | Buffer {\n    if (!address) {\n      throw new Error('Must specify address.');\n    }\n    const wallet = this.#getWalletForAccount(address, opts);\n    assert(wallet.privateKey, 'Missing private key');\n    return wallet.privateKey;\n  }\n\n  /**\n   * Get the wallet for the specified account.\n   *\n   * @param account - The address of the account.\n   * @returns The wallet for the account as HDKey.\n   */\n  #getWalletForAccount(account: Hex): HDKey;\n\n  /**\n   * Get the wallet for the specified account and app origin.\n   *\n   * @param account - The address of the account.\n   * @param opts - The options for selecting the account.\n   * @returns A key pair representing the wallet.\n   */\n  #getWalletForAccount(\n    accounts: Hex,\n    opts: { withAppKeyOrigin: string },\n  ): { privateKey: Buffer; publicKey: Buffer };\n\n  /**\n   * Get the wallet for the specified account with optional\n   * additional options.\n   *\n   * @param account - The address of the account.\n   * @param opts - The options for selecting the account.\n   * @returns A key pair representing the wallet.\n   */\n  #getWalletForAccount(\n    account: Hex,\n    opts?: HDKeyringAccountSelectionOptions,\n  ): HDKey | { privateKey: Buffer; publicKey: Buffer };\n\n  #getWalletForAccount(\n    account: Hex,\n    { withAppKeyOrigin }: HDKeyringAccountSelectionOptions = {},\n  ): HDKey | { privateKey: Buffer; publicKey: Buffer } {\n    const address = this.#normalizeAddress(account);\n    const wallet = this.#wallets.find(({ publicKey }) => {\n      return publicKey && this.#addressfromPublicKey(publicKey) === address;\n    });\n    if (!wallet) {\n      throw new Error('HD Keyring - Unable to find matching address.');\n    }\n\n    if (withAppKeyOrigin) {\n      const { privateKey } = wallet;\n      assert(privateKey, 'Expected private key to be set');\n      const appKeyOriginBuffer = Buffer.from(withAppKeyOrigin, 'utf8');\n      const appKeyBuffer = Buffer.concat([privateKey, appKeyOriginBuffer]);\n      const appKeyPrivateKey = arrToBufArr(keccak256(appKeyBuffer));\n      const appKeyPublicKey = privateToPublic(appKeyPrivateKey);\n      return { privateKey: appKeyPrivateKey, publicKey: appKeyPublicKey };\n    }\n\n    return wallet;\n  }\n\n  /**\n   * Sets appropriate properties for the keyring based on the given\n   * BIP39-compliant mnemonic.\n   *\n   * @param mnemonic - A seed phrase represented\n   * as a string, an array of UTF-8 bytes, or a Buffer. Mnemonic input\n   * passed as type buffer or array of UTF-8 bytes must be NFKD normalized.\n   */\n  async #initFromMnemonic(\n    mnemonic: string | number[] | Buffer | Uint8Array,\n  ): Promise<void> {\n    if (this.root) {\n      throw new Error(\n        'Eth-Hd-Keyring: Secret recovery phrase already provided',\n      );\n    }\n\n    this.mnemonic = this.#mnemonicToUint8Array(mnemonic);\n\n    const seed = await mnemonicToSeed(\n      this.mnemonic,\n      '', // No passphrase\n      this.#cryptographicFunctions,\n    );\n    this.hdWallet = HDKey.fromMasterSeed(seed);\n    this.root = this.hdWallet.derive(this.hdPath);\n  }\n\n  /**\n   * Get the address of the account from the public key.\n   *\n   * @param publicKey - The public key of the account.\n   * @returns The address of the account.\n   */\n  #addressfromPublicKey(publicKey: Uint8Array): Hex {\n    return add0x(\n      bufferToHex(publicToAddress(Buffer.from(publicKey), true)).toLowerCase(),\n    );\n  }\n\n  /**\n   * Normalize an address to a lower-cased '0x'-prefixed hex string.\n   *\n   * @param address - The address to normalize.\n   * @returns The normalized address.\n   */\n  #normalizeAddress(address: string): Hex {\n    const normalized = normalize(address);\n    assert(normalized, 'Expected address to be set');\n    return add0x(normalized);\n  }\n}\n\nexport default HdKeyring;\n"]}