@dynamic-labs-wallet/node-evm 0.0.321 → 0.0.323

package/index.cjs.js

@@ -33,6 +33,7 @@ const ERROR_SIGN_MESSAGE = 'Error signing message';
 const ERROR_SIGN_TYPED_DATA = 'Error signing typed data';
 const ERROR_ACCOUNT_ADDRESS_REQUIRED = 'Account address is required';
 const ERROR_VERIFY_MESSAGE_SIGNATURE = 'Error verifying message signature';
+const ERROR_SIGN_RAW_MESSAGE = 'Error signing raw message';
 
 const formatEVMMessage = (message_)=>{
     const message = (()=>{
@@ -227,6 +228,37 @@ const logError$1 = node.createLogError('node-evm');
         throw error;
     }
 };
+/**
+ * Signs a pre-formatted (raw) message using delegated signing for EVM.
+ * The message must be a hex string representing already-hashed data.
+ */ const delegatedSignRawMessage = async (client, { walletId, walletApiKey, keyShare, message, context, onError })=>{
+    try {
+        if (!keyShare || !walletId || !walletApiKey) {
+            throw new Error('Delegated key share, wallet ID, and wallet API key are required to sign a raw message');
+        }
+        const prehashed = node.stripHexPrefix(message);
+        const signatureEcdsa = await node.delegatedSignMessage(client, {
+            walletId,
+            walletApiKey,
+            keyShare,
+            message: prehashed,
+            chainName: client.chainName,
+            isFormatted: true,
+            context,
+            onError
+        });
+        return serializeECDSASignature(signatureEcdsa);
+    } catch (error) {
+        logError$1({
+            message: 'Error in delegatedSignRawMessage',
+            error: error,
+            context: {
+                walletId
+            }
+        });
+        throw error;
+    }
+};
 /**
  * Revoke delegation - delegates to the node package
  */ const revokeDelegation = async (client, params)=>{
@@ -328,6 +360,7 @@ const createAccountAdapter = ({ evmClient, accountAddress, password, externalSer
 };
 
 const logError = node.createLogError('node-evm');
+const keySharesRequiredFor = (action)=>`External server key shares are required to ${action}. No backup shares available for recovery.`;
 class DynamicEvmWalletClient extends node.DynamicWalletClient {
     get jwtAuthToken() {
         return this.baseJWTAuthToken;
@@ -473,7 +506,7 @@ class DynamicEvmWalletClient extends node.DynamicWalletClient {
                 password,
                 walletOperation: node.WalletOperation.SIGN_MESSAGE,
                 externalServerKeyShares,
-                errorMessage: 'External server key shares are required to sign a message. No backup shares available for recovery.'
+                errorMessage: keySharesRequiredFor('sign a message')
             });
             const signatureEcdsa = await this.sign({
                 message: formattedMessage,
@@ -501,6 +534,26 @@ class DynamicEvmWalletClient extends node.DynamicWalletClient {
     isSignAuthorizationSupported() {
         return true;
     }
+    async signPrehashedMessage({ prehashed, accountAddress, password, externalServerKeyShares, context, onError, recoverErrorMessage }) {
+        await this.ensureKeySharesRecovered({
+            accountAddress,
+            password,
+            walletOperation: node.WalletOperation.SIGN_MESSAGE,
+            externalServerKeyShares,
+            errorMessage: recoverErrorMessage
+        });
+        const signatureEcdsa = await this.sign({
+            message: prehashed,
+            accountAddress: accountAddress,
+            chainName: this.chainName,
+            password,
+            externalServerKeyShares,
+            isFormatted: true,
+            context,
+            onError
+        });
+        return serializeECDSASignature(signatureEcdsa);
+    }
     async signAuthorization({ authorization, accountAddress, password = undefined, externalServerKeyShares, onError }) {
         try {
             if (!accountAddress) {
@@ -508,29 +561,18 @@ class DynamicEvmWalletClient extends node.DynamicWalletClient {
             }
             const digest = utils.hashAuthorization(authorization);
             const prehashed = digest.startsWith('0x') ? digest.slice(2) : digest;
-            // Attempt to recover key shares from backup if not provided
-            await this.ensureKeySharesRecovered({
+            const serializedSignature = await this.signPrehashedMessage({
+                prehashed,
                 accountAddress,
                 password,
-                walletOperation: node.WalletOperation.SIGN_MESSAGE,
-                externalServerKeyShares,
-                errorMessage: 'External server key shares are required to sign authorization. No backup shares available for recovery.'
-            });
-            const signatureEcdsa = await this.sign({
-                message: prehashed,
-                accountAddress: accountAddress,
-                chainName: this.chainName,
-                password,
                 externalServerKeyShares,
-                isFormatted: true,
                 context: {
                     eip7702Auth: authorization
                 },
-                onError
+                onError,
+                recoverErrorMessage: keySharesRequiredFor('sign authorization')
             });
-            const serializedSignature = serializeECDSASignature(signatureEcdsa);
-            const signature = viem.parseSignature(serializedSignature);
-            return signature;
+            return viem.parseSignature(serializedSignature);
         } catch (error) {
             logError({
                 message: ERROR_SIGN_MESSAGE,
@@ -542,34 +584,47 @@ class DynamicEvmWalletClient extends node.DynamicWalletClient {
             throw new Error(ERROR_SIGN_MESSAGE);
         }
     }
-    async signTypedData({ accountAddress, typedData, password = undefined, externalServerKeyShares, onError }) {
+    async signRawMessage({ message, accountAddress, password = undefined, externalServerKeyShares, context, onError }) {
         try {
             if (!accountAddress) {
                 throw new Error(ERROR_ACCOUNT_ADDRESS_REQUIRED);
             }
-            const formattedTypedData = formatTypedData(typedData);
-            // Attempt to recover key shares from backup if not provided
-            await this.ensureKeySharesRecovered({
+            return await this.signPrehashedMessage({
+                prehashed: node.stripHexPrefix(message),
                 accountAddress,
                 password,
-                walletOperation: node.WalletOperation.SIGN_MESSAGE,
                 externalServerKeyShares,
-                errorMessage: 'External server key shares are required to sign typed data. No backup shares available for recovery.'
+                context,
+                onError,
+                recoverErrorMessage: keySharesRequiredFor('sign a raw message')
             });
-            const signatureEcdsa = await this.sign({
-                message: formattedTypedData,
-                accountAddress: accountAddress,
-                chainName: this.chainName,
+        } catch (error) {
+            logError({
+                message: ERROR_SIGN_RAW_MESSAGE,
+                error: error,
+                context: {
+                    accountAddress
+                }
+            });
+            throw new Error(ERROR_SIGN_RAW_MESSAGE);
+        }
+    }
+    async signTypedData({ accountAddress, typedData, password = undefined, externalServerKeyShares, onError }) {
+        try {
+            if (!accountAddress) {
+                throw new Error(ERROR_ACCOUNT_ADDRESS_REQUIRED);
+            }
+            return await this.signPrehashedMessage({
+                prehashed: formatTypedData(typedData),
+                accountAddress,
                 password,
                 externalServerKeyShares,
-                isFormatted: true,
                 context: {
                     evmTypedData: typedData
                 },
-                onError
+                onError,
+                recoverErrorMessage: keySharesRequiredFor('sign typed data')
             });
-            const serializedSignature = serializeECDSASignature(signatureEcdsa);
-            return serializedSignature;
         } catch (error) {
             logError({
                 message: ERROR_SIGN_TYPED_DATA,
@@ -615,7 +670,7 @@ class DynamicEvmWalletClient extends node.DynamicWalletClient {
             password,
             walletOperation: node.WalletOperation.SIGN_TRANSACTION,
             externalServerKeyShares,
-            errorMessage: 'External server key shares are required to sign transaction. No backup shares available for recovery.'
+            errorMessage: keySharesRequiredFor('sign transaction')
         });
         const serializedTx = viem.serializeTransaction(transaction);
         const serializedTxBytes = Uint8Array.from(Buffer.from(serializedTx.slice(2), 'hex'));
@@ -665,7 +720,7 @@ class DynamicEvmWalletClient extends node.DynamicWalletClient {
             password,
             walletOperation: node.WalletOperation.EXPORT_PRIVATE_KEY,
             externalServerKeyShares,
-            errorMessage: 'External server key shares are required to export private key. No backup shares available for recovery.'
+            errorMessage: keySharesRequiredFor('export private key')
         });
         const { derivedPrivateKey } = await this.exportKey({
             accountAddress,
@@ -959,6 +1014,7 @@ exports.ERROR_ACCOUNT_ADDRESS_REQUIRED = ERROR_ACCOUNT_ADDRESS_REQUIRED;
 exports.ERROR_CREATE_WALLET_ACCOUNT = ERROR_CREATE_WALLET_ACCOUNT;
 exports.ERROR_KEYGEN_FAILED = ERROR_KEYGEN_FAILED;
 exports.ERROR_SIGN_MESSAGE = ERROR_SIGN_MESSAGE;
+exports.ERROR_SIGN_RAW_MESSAGE = ERROR_SIGN_RAW_MESSAGE;
 exports.ERROR_SIGN_TYPED_DATA = ERROR_SIGN_TYPED_DATA;
 exports.ERROR_VERIFY_MESSAGE_SIGNATURE = ERROR_VERIFY_MESSAGE_SIGNATURE;
 exports.EVM_SIGN_MESSAGE_PREFIX = EVM_SIGN_MESSAGE_PREFIX;
@@ -967,6 +1023,7 @@ exports.createDelegatedEvmWalletClient = createDelegatedEvmWalletClient;
 exports.createZerodevClient = createZerodevClient;
 exports.delegatedSignAuthorization = delegatedSignAuthorization;
 exports.delegatedSignMessage = delegatedSignMessage;
+exports.delegatedSignRawMessage = delegatedSignRawMessage;
 exports.delegatedSignTransaction = delegatedSignTransaction;
 exports.delegatedSignTypedData = delegatedSignTypedData;
 exports.deriveAccountAddress = deriveAccountAddress;

package/index.esm.js

@@ -1,5 +1,5 @@
 import { toAccount } from 'viem/accounts';
-import { MessageHash, createLogError, createDelegatedWalletClient, delegatedSignMessage as delegatedSignMessage$1, revokeDelegation as revokeDelegation$1, DynamicWalletClient, getMPCChainConfig, getExternalServerKeyShareBackupInfo, WalletOperation } from '@dynamic-labs-wallet/node';
+import { MessageHash, createLogError, createDelegatedWalletClient, delegatedSignMessage as delegatedSignMessage$1, stripHexPrefix, revokeDelegation as revokeDelegation$1, DynamicWalletClient, getMPCChainConfig, getExternalServerKeyShareBackupInfo, WalletOperation } from '@dynamic-labs-wallet/node';
 import { getAddress, stringToHex, bytesToHex, size, concat, hashTypedData, serializeSignature, parseSignature, serializeTransaction, createPublicClient, http, defineChain, createWalletClient } from 'viem';
 import { hashAuthorization } from 'viem/utils';
 import { mainnet } from 'viem/chains';
@@ -31,6 +31,7 @@ const ERROR_SIGN_MESSAGE = 'Error signing message';
 const ERROR_SIGN_TYPED_DATA = 'Error signing typed data';
 const ERROR_ACCOUNT_ADDRESS_REQUIRED = 'Account address is required';
 const ERROR_VERIFY_MESSAGE_SIGNATURE = 'Error verifying message signature';
+const ERROR_SIGN_RAW_MESSAGE = 'Error signing raw message';
 
 const formatEVMMessage = (message_)=>{
     const message = (()=>{
@@ -225,6 +226,37 @@ const logError$1 = createLogError('node-evm');
         throw error;
     }
 };
+/**
+ * Signs a pre-formatted (raw) message using delegated signing for EVM.
+ * The message must be a hex string representing already-hashed data.
+ */ const delegatedSignRawMessage = async (client, { walletId, walletApiKey, keyShare, message, context, onError })=>{
+    try {
+        if (!keyShare || !walletId || !walletApiKey) {
+            throw new Error('Delegated key share, wallet ID, and wallet API key are required to sign a raw message');
+        }
+        const prehashed = stripHexPrefix(message);
+        const signatureEcdsa = await delegatedSignMessage$1(client, {
+            walletId,
+            walletApiKey,
+            keyShare,
+            message: prehashed,
+            chainName: client.chainName,
+            isFormatted: true,
+            context,
+            onError
+        });
+        return serializeECDSASignature(signatureEcdsa);
+    } catch (error) {
+        logError$1({
+            message: 'Error in delegatedSignRawMessage',
+            error: error,
+            context: {
+                walletId
+            }
+        });
+        throw error;
+    }
+};
 /**
  * Revoke delegation - delegates to the node package
  */ const revokeDelegation = async (client, params)=>{
@@ -326,6 +358,7 @@ const createAccountAdapter = ({ evmClient, accountAddress, password, externalSer
 };
 
 const logError = createLogError('node-evm');
+const keySharesRequiredFor = (action)=>`External server key shares are required to ${action}. No backup shares available for recovery.`;
 class DynamicEvmWalletClient extends DynamicWalletClient {
     get jwtAuthToken() {
         return this.baseJWTAuthToken;
@@ -471,7 +504,7 @@ class DynamicEvmWalletClient extends DynamicWalletClient {
                 password,
                 walletOperation: WalletOperation.SIGN_MESSAGE,
                 externalServerKeyShares,
-                errorMessage: 'External server key shares are required to sign a message. No backup shares available for recovery.'
+                errorMessage: keySharesRequiredFor('sign a message')
             });
             const signatureEcdsa = await this.sign({
                 message: formattedMessage,
@@ -499,6 +532,26 @@ class DynamicEvmWalletClient extends DynamicWalletClient {
     isSignAuthorizationSupported() {
         return true;
     }
+    async signPrehashedMessage({ prehashed, accountAddress, password, externalServerKeyShares, context, onError, recoverErrorMessage }) {
+        await this.ensureKeySharesRecovered({
+            accountAddress,
+            password,
+            walletOperation: WalletOperation.SIGN_MESSAGE,
+            externalServerKeyShares,
+            errorMessage: recoverErrorMessage
+        });
+        const signatureEcdsa = await this.sign({
+            message: prehashed,
+            accountAddress: accountAddress,
+            chainName: this.chainName,
+            password,
+            externalServerKeyShares,
+            isFormatted: true,
+            context,
+            onError
+        });
+        return serializeECDSASignature(signatureEcdsa);
+    }
     async signAuthorization({ authorization, accountAddress, password = undefined, externalServerKeyShares, onError }) {
         try {
             if (!accountAddress) {
@@ -506,29 +559,18 @@ class DynamicEvmWalletClient extends DynamicWalletClient {
             }
             const digest = hashAuthorization(authorization);
             const prehashed = digest.startsWith('0x') ? digest.slice(2) : digest;
-            // Attempt to recover key shares from backup if not provided
-            await this.ensureKeySharesRecovered({
+            const serializedSignature = await this.signPrehashedMessage({
+                prehashed,
                 accountAddress,
                 password,
-                walletOperation: WalletOperation.SIGN_MESSAGE,
-                externalServerKeyShares,
-                errorMessage: 'External server key shares are required to sign authorization. No backup shares available for recovery.'
-            });
-            const signatureEcdsa = await this.sign({
-                message: prehashed,
-                accountAddress: accountAddress,
-                chainName: this.chainName,
-                password,
                 externalServerKeyShares,
-                isFormatted: true,
                 context: {
                     eip7702Auth: authorization
                 },
-                onError
+                onError,
+                recoverErrorMessage: keySharesRequiredFor('sign authorization')
             });
-            const serializedSignature = serializeECDSASignature(signatureEcdsa);
-            const signature = parseSignature(serializedSignature);
-            return signature;
+            return parseSignature(serializedSignature);
         } catch (error) {
             logError({
                 message: ERROR_SIGN_MESSAGE,
@@ -540,34 +582,47 @@ class DynamicEvmWalletClient extends DynamicWalletClient {
             throw new Error(ERROR_SIGN_MESSAGE);
         }
     }
-    async signTypedData({ accountAddress, typedData, password = undefined, externalServerKeyShares, onError }) {
+    async signRawMessage({ message, accountAddress, password = undefined, externalServerKeyShares, context, onError }) {
         try {
             if (!accountAddress) {
                 throw new Error(ERROR_ACCOUNT_ADDRESS_REQUIRED);
             }
-            const formattedTypedData = formatTypedData(typedData);
-            // Attempt to recover key shares from backup if not provided
-            await this.ensureKeySharesRecovered({
+            return await this.signPrehashedMessage({
+                prehashed: stripHexPrefix(message),
                 accountAddress,
                 password,
-                walletOperation: WalletOperation.SIGN_MESSAGE,
                 externalServerKeyShares,
-                errorMessage: 'External server key shares are required to sign typed data. No backup shares available for recovery.'
+                context,
+                onError,
+                recoverErrorMessage: keySharesRequiredFor('sign a raw message')
             });
-            const signatureEcdsa = await this.sign({
-                message: formattedTypedData,
-                accountAddress: accountAddress,
-                chainName: this.chainName,
+        } catch (error) {
+            logError({
+                message: ERROR_SIGN_RAW_MESSAGE,
+                error: error,
+                context: {
+                    accountAddress
+                }
+            });
+            throw new Error(ERROR_SIGN_RAW_MESSAGE);
+        }
+    }
+    async signTypedData({ accountAddress, typedData, password = undefined, externalServerKeyShares, onError }) {
+        try {
+            if (!accountAddress) {
+                throw new Error(ERROR_ACCOUNT_ADDRESS_REQUIRED);
+            }
+            return await this.signPrehashedMessage({
+                prehashed: formatTypedData(typedData),
+                accountAddress,
                 password,
                 externalServerKeyShares,
-                isFormatted: true,
                 context: {
                     evmTypedData: typedData
                 },
-                onError
+                onError,
+                recoverErrorMessage: keySharesRequiredFor('sign typed data')
             });
-            const serializedSignature = serializeECDSASignature(signatureEcdsa);
-            return serializedSignature;
         } catch (error) {
             logError({
                 message: ERROR_SIGN_TYPED_DATA,
@@ -613,7 +668,7 @@ class DynamicEvmWalletClient extends DynamicWalletClient {
             password,
             walletOperation: WalletOperation.SIGN_TRANSACTION,
             externalServerKeyShares,
-            errorMessage: 'External server key shares are required to sign transaction. No backup shares available for recovery.'
+            errorMessage: keySharesRequiredFor('sign transaction')
         });
         const serializedTx = serializeTransaction(transaction);
         const serializedTxBytes = Uint8Array.from(Buffer.from(serializedTx.slice(2), 'hex'));
@@ -663,7 +718,7 @@ class DynamicEvmWalletClient extends DynamicWalletClient {
             password,
             walletOperation: WalletOperation.EXPORT_PRIVATE_KEY,
             externalServerKeyShares,
-            errorMessage: 'External server key shares are required to export private key. No backup shares available for recovery.'
+            errorMessage: keySharesRequiredFor('export private key')
         });
         const { derivedPrivateKey } = await this.exportKey({
             accountAddress,
@@ -952,4 +1007,4 @@ const createZerodevClient = async (evmClient)=>{
     return client;
 };
 
-export { DynamicEvmWalletClient, ERROR_ACCOUNT_ADDRESS_REQUIRED, ERROR_CREATE_WALLET_ACCOUNT, ERROR_KEYGEN_FAILED, ERROR_SIGN_MESSAGE, ERROR_SIGN_TYPED_DATA, ERROR_VERIFY_MESSAGE_SIGNATURE, EVM_SIGN_MESSAGE_PREFIX, createAccountAdapter, createDelegatedEvmWalletClient, createZerodevClient, delegatedSignAuthorization, delegatedSignMessage, delegatedSignTransaction, delegatedSignTypedData, deriveAccountAddress, formatEVMMessage, formatTypedData, revokeDelegation, serializeECDSASignature };
+export { DynamicEvmWalletClient, ERROR_ACCOUNT_ADDRESS_REQUIRED, ERROR_CREATE_WALLET_ACCOUNT, ERROR_KEYGEN_FAILED, ERROR_SIGN_MESSAGE, ERROR_SIGN_RAW_MESSAGE, ERROR_SIGN_TYPED_DATA, ERROR_VERIFY_MESSAGE_SIGNATURE, EVM_SIGN_MESSAGE_PREFIX, createAccountAdapter, createDelegatedEvmWalletClient, createZerodevClient, delegatedSignAuthorization, delegatedSignMessage, delegatedSignRawMessage, delegatedSignTransaction, delegatedSignTypedData, deriveAccountAddress, formatEVMMessage, formatTypedData, revokeDelegation, serializeECDSASignature };

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@dynamic-labs-wallet/node-evm",
-  "version": "0.0.321",
+  "version": "0.0.323",
   "license": "MIT",
   "type": "module",
   "dependencies": {
-    "@dynamic-labs-wallet/node": "0.0.321",
+    "@dynamic-labs-wallet/node": "0.0.323",
     "@dynamic-labs/sdk-api-core": "^0.0.900",
     "@dynamic-labs-sdk/client": "0.3.0",
     "@dynamic-labs-sdk/zerodev": "0.3.0",