@dynamic-labs-wallet/node-evm 1.1.52 → 1.1.54

package/index.cjs

@@ -423,6 +423,347 @@ const createAccountAdapter = ({ evmClient, walletMetadata, password, externalSer
     });
 };
 
+function _object_without_properties_loose(source, excluded) {
+    if (source == null) return {};
+    var target = {};
+    var sourceKeys = Object.keys(source);
+    var key, i;
+    for(i = 0; i < sourceKeys.length; i++){
+        key = sourceKeys[i];
+        if (excluded.indexOf(key) >= 0) continue;
+        target[key] = source[key];
+    }
+    return target;
+}
+
+const ERROR_EARN_NOT_EVM_WALLET = 'Wallet metadata is not for an EVM wallet';
+const ERROR_EARN_MISSING_EVM_TRANSACTION = 'Earn signing payload is missing EVM transaction data';
+const ERROR_EARN_CHAIN_MISMATCH = 'The provided chain does not match the chain the Earn transaction was prepared for';
+const ERROR_EARN_APPROVAL_FAILED = 'The ERC-20 approval for the Earn transaction reverted';
+const ERROR_EARN_CHAIN_REQUIRED = 'Either chain or rpcUrl is required to execute an Earn transaction. Provide an RPC URL for the vault chain.';
+/**
+ * Vault deposits and withdrawals rebalance the underlying lending markets, so gas estimated at
+ * the current block is regularly lower than what execution needs once the transaction is mined.
+ */ const EARN_GAS_LIMIT_BUFFER_PERCENT = 30n;
+const ERC20_ALLOWANCE_AND_APPROVE_ABI = [
+    {
+        name: 'allowance',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [
+            {
+                name: 'owner',
+                type: 'address'
+            },
+            {
+                name: 'spender',
+                type: 'address'
+            }
+        ],
+        outputs: [
+            {
+                name: '',
+                type: 'uint256'
+            }
+        ]
+    },
+    {
+        name: 'approve',
+        type: 'function',
+        stateMutability: 'nonpayable',
+        inputs: [
+            {
+                name: 'spender',
+                type: 'address'
+            },
+            {
+                name: 'amount',
+                type: 'uint256'
+            }
+        ],
+        outputs: [
+            {
+                name: '',
+                type: 'bool'
+            }
+        ]
+    }
+];
+
+/**
+ * Builds a stateless Earn client for EVM vaults: it prepares vault actions through the
+ * Dynamic API and executes the returned unsigned transactions with the caller's wallet,
+ * sending an ERC-20 approval first when the vault requires one.
+ */ const createEvmEarnClient = ({ getEarnClient, createViemPublicClient, getWalletClient, sendSponsoredTransaction })=>{
+    const resolveChain = ({ chain, chainId, rpcUrl })=>{
+        if (chain) {
+            if (chain.id !== chainId) {
+                throw new Error(ERROR_EARN_CHAIN_MISMATCH);
+            }
+            return chain;
+        }
+        if (!rpcUrl) {
+            throw new Error(ERROR_EARN_CHAIN_REQUIRED);
+        }
+        return viem.defineChain({
+            id: chainId,
+            name: `Chain ${chainId}`,
+            nativeCurrency: {
+                name: 'Ether',
+                symbol: 'ETH',
+                decimals: 18
+            },
+            rpcUrls: {
+                default: {
+                    http: [
+                        rpcUrl
+                    ]
+                }
+            }
+        });
+    };
+    const buildGasLimitAndNonce = async ({ transaction, publicClient, accountAddress })=>{
+        const params = {};
+        if (transaction.gasLimit) {
+            params.gas = BigInt(transaction.gasLimit);
+        } else {
+            const estimatedGas = await publicClient.estimateGas({
+                account: accountAddress,
+                to: transaction.to,
+                data: transaction.data,
+                value: transaction.value
+            });
+            params.gas = estimatedGas + estimatedGas * EARN_GAS_LIMIT_BUFFER_PERCENT / 100n;
+        }
+        if (transaction.nonce !== undefined) {
+            params.nonce = transaction.nonce;
+        }
+        return params;
+    };
+    const relaySponsoredEarnTransaction = async ({ chainId, evmApproval, evmTransaction, externalServerKeyShares, onStepChange, password, publicClient, resolvedChain, rpcUrl, traceContext, walletMetadata })=>{
+        const calls = [];
+        if (evmApproval) {
+            const currentAllowance = await publicClient.readContract({
+                address: evmApproval.tokenAddress,
+                abi: ERC20_ALLOWANCE_AND_APPROVE_ABI,
+                functionName: 'allowance',
+                args: [
+                    walletMetadata.accountAddress,
+                    evmApproval.spenderAddress
+                ]
+            });
+            const requiredAllowance = BigInt(evmApproval.amount);
+            if (currentAllowance < requiredAllowance) {
+                onStepChange == null ? void 0 : onStepChange('approval');
+                calls.push({
+                    target: evmApproval.tokenAddress,
+                    data: viem.encodeFunctionData({
+                        abi: ERC20_ALLOWANCE_AND_APPROVE_ABI,
+                        functionName: 'approve',
+                        args: [
+                            evmApproval.spenderAddress,
+                            requiredAllowance
+                        ]
+                    }),
+                    value: 0n
+                });
+            }
+        }
+        onStepChange == null ? void 0 : onStepChange('transaction');
+        calls.push({
+            target: evmTransaction.to,
+            data: evmTransaction.data,
+            value: evmTransaction.value ? BigInt(evmTransaction.value) : 0n
+        });
+        return sendSponsoredTransaction({
+            walletMetadata,
+            calls,
+            chainId,
+            password,
+            externalServerKeyShares,
+            // The relayer needs an RPC to read the wallet's on-chain state; fall back to the
+            // resolved chain's default when the caller passed `chain` without `rpcUrl`.
+            rpcUrl: rpcUrl != null ? rpcUrl : resolvedChain.rpcUrls.default.http[0],
+            traceContext,
+            autoDelegate: true
+        });
+    };
+    const executeEarnTransaction = async ({ signingPayload, traceContext, walletMetadata, password, externalServerKeyShares, sponsored, chain, rpcUrl, onStepChange })=>{
+        if (walletMetadata.chainName !== 'EVM') {
+            throw new Error(ERROR_EARN_NOT_EVM_WALLET);
+        }
+        const { evmTransaction, evmApproval } = signingPayload;
+        if (!evmTransaction) {
+            throw new Error(ERROR_EARN_MISSING_EVM_TRANSACTION);
+        }
+        const chainId = Number(signingPayload.chainId);
+        const resolvedChain = resolveChain({
+            chain,
+            chainId,
+            rpcUrl
+        });
+        const publicClient = createViemPublicClient({
+            chain: resolvedChain,
+            rpcUrl
+        });
+        // Sponsored execution relays the approval and vault call as one batch through the
+        // gasless relayer, so no gas estimation or EOA sending is needed.
+        if (sponsored === true) {
+            return relaySponsoredEarnTransaction({
+                chainId,
+                evmApproval,
+                evmTransaction,
+                externalServerKeyShares,
+                onStepChange,
+                password,
+                publicClient,
+                resolvedChain,
+                rpcUrl,
+                traceContext,
+                walletMetadata
+            });
+        }
+        const walletClient = await getWalletClient({
+            walletMetadata,
+            password,
+            externalServerKeyShares,
+            chain: resolvedChain,
+            rpcUrl
+        });
+        if (evmApproval) {
+            const currentAllowance = await publicClient.readContract({
+                address: evmApproval.tokenAddress,
+                abi: ERC20_ALLOWANCE_AND_APPROVE_ABI,
+                functionName: 'allowance',
+                args: [
+                    walletMetadata.accountAddress,
+                    evmApproval.spenderAddress
+                ]
+            });
+            const requiredAllowance = BigInt(evmApproval.amount);
+            if (currentAllowance < requiredAllowance) {
+                onStepChange == null ? void 0 : onStepChange('approval');
+                const approvalHash = await walletClient.sendTransaction({
+                    to: evmApproval.tokenAddress,
+                    data: viem.encodeFunctionData({
+                        abi: ERC20_ALLOWANCE_AND_APPROVE_ABI,
+                        functionName: 'approve',
+                        args: [
+                            evmApproval.spenderAddress,
+                            requiredAllowance
+                        ]
+                    }),
+                    value: 0n
+                });
+                const approvalReceipt = await publicClient.waitForTransactionReceipt({
+                    hash: approvalHash
+                });
+                if (approvalReceipt.status !== 'success') {
+                    throw new Error(ERROR_EARN_APPROVAL_FAILED);
+                }
+            }
+        }
+        onStepChange == null ? void 0 : onStepChange('transaction');
+        let value = 0n;
+        if (evmTransaction.value) {
+            value = BigInt(evmTransaction.value);
+        }
+        const gasLimitAndNonce = await buildGasLimitAndNonce({
+            transaction: _extends({}, evmTransaction, {
+                value
+            }),
+            publicClient,
+            accountAddress: walletMetadata.accountAddress
+        });
+        const request = _extends({
+            to: evmTransaction.to,
+            data: evmTransaction.data,
+            value
+        }, gasLimitAndNonce);
+        const hasEip1559Fees = Boolean(evmTransaction.maxFeePerGas && evmTransaction.maxPriorityFeePerGas);
+        if (hasEip1559Fees) {
+            const transactionHash = await walletClient.sendTransaction(_extends({}, request, {
+                maxFeePerGas: BigInt(evmTransaction.maxFeePerGas),
+                maxPriorityFeePerGas: BigInt(evmTransaction.maxPriorityFeePerGas)
+            }));
+            return {
+                transactionHash
+            };
+        }
+        if (evmTransaction.gasPrice) {
+            const transactionHash = await walletClient.sendTransaction(_extends({}, request, {
+                gasPrice: BigInt(evmTransaction.gasPrice)
+            }));
+            return {
+                transactionHash
+            };
+        }
+        const transactionHash = await walletClient.sendTransaction(request);
+        return {
+            transactionHash
+        };
+    };
+    const depositToEarnVault = async (_param)=>{
+        var { vaultId, amount, receiverAddress, traceContext } = _param, walletParams = _object_without_properties_loose(_param, [
+            "vaultId",
+            "amount",
+            "receiverAddress",
+            "traceContext"
+        ]);
+        const signingPayload = await getEarnClient().prepareDeposit({
+            vaultId,
+            ownerAddress: walletParams.walletMetadata.accountAddress,
+            amount,
+            receiverAddress,
+            traceContext
+        });
+        return executeEarnTransaction(_extends({
+            signingPayload,
+            traceContext
+        }, walletParams));
+    };
+    const withdrawFromEarnVault = async (_param)=>{
+        var { vaultId, amount, receiverAddress, traceContext } = _param, walletParams = _object_without_properties_loose(_param, [
+            "vaultId",
+            "amount",
+            "receiverAddress",
+            "traceContext"
+        ]);
+        const signingPayload = await getEarnClient().prepareWithdrawal({
+            vaultId,
+            ownerAddress: walletParams.walletMetadata.accountAddress,
+            amount,
+            receiverAddress,
+            traceContext
+        });
+        return executeEarnTransaction(_extends({
+            signingPayload,
+            traceContext
+        }, walletParams));
+    };
+    const claimEarnRewards = async (_param)=>{
+        var { vaultId, traceContext } = _param, walletParams = _object_without_properties_loose(_param, [
+            "vaultId",
+            "traceContext"
+        ]);
+        const signingPayload = await getEarnClient().prepareClaimRewards({
+            vaultId,
+            ownerAddress: walletParams.walletMetadata.accountAddress,
+            traceContext
+        });
+        return executeEarnTransaction(_extends({
+            signingPayload,
+            traceContext
+        }, walletParams));
+    };
+    return {
+        executeEarnTransaction,
+        depositToEarnVault,
+        withdrawFromEarnVault,
+        claimEarnRewards
+    };
+};
+
 /** The Fireblocks Universal Gasless Delegate (UGD) contract address used for EIP-7702 delegation. */ const DELEGATION_CONTRACT_ADDRESS = '0x0000Fb7702036ff9f76044a501ac1aA74cbab16b';
 /** Default sponsored transaction validity duration in seconds (10 minutes). */ const DEFAULT_VALID_FOR_SECONDS = 600;
 /** EIP-7702 delegation code prefix used to identify delegated accounts. */ const DELEGATION_CODE_PREFIX = '0xef0100';
@@ -1325,6 +1666,32 @@ class DynamicEvmWalletClient extends node.DynamicWalletClient {
    */ async waitForSponsoredTransaction(params) {
         return this.evmGasless.waitForSponsoredTransaction(params);
     }
+    // ---------------------------------------------------------------------------
+    // Earn (yield vaults)
+    // ---------------------------------------------------------------------------
+    get evmEarn() {
+        return createEvmEarnClient({
+            getEarnClient: ()=>this.earn,
+            createViemPublicClient: (args)=>this.createViemPublicClient(args),
+            getWalletClient: (args)=>this.getWalletClient(args),
+            sendSponsoredTransaction: (args)=>this.sendSponsoredTransaction(args)
+        });
+    }
+    /**
+   * Executes an Earn signing payload returned by the prepare* methods, sending the
+   * ERC-20 approval first when the vault requires one.
+   */ async executeEarnTransaction(params) {
+        return this.evmEarn.executeEarnTransaction(params);
+    }
+    /** Prepares and executes a deposit into an Earn vault. */ async depositToEarnVault(params) {
+        return this.evmEarn.depositToEarnVault(params);
+    }
+    /** Prepares and executes a withdrawal from an Earn vault. */ async withdrawFromEarnVault(params) {
+        return this.evmEarn.withdrawFromEarnVault(params);
+    }
+    /** Prepares and executes a claim of accrued Earn vault rewards. */ async claimEarnRewards(params) {
+        return this.evmEarn.claimEarnRewards(params);
+    }
     constructor({ environmentId, baseApiUrl, baseMPCRelayApiUrl, debug, enableMPCAccelerator, logger }){
         super({
             environmentId,
@@ -1337,19 +1704,6 @@ class DynamicEvmWalletClient extends node.DynamicWalletClient {
     }
 }
 
-function _object_without_properties_loose(source, excluded) {
-    if (source == null) return {};
-    var target = {};
-    var sourceKeys = Object.keys(source);
-    var key, i;
-    for(i = 0; i < sourceKeys.length; i++){
-        key = sourceKeys[i];
-        if (excluded.indexOf(key) >= 0) continue;
-        target[key] = source[key];
-    }
-    return target;
-}
-
 const logError = node.createLogError('node-evm');
 const ERROR_DELEGATED_GASLESS_CREDENTIALS_REQUIRED = 'Delegated key share, wallet ID, and wallet API key are required to sponsor a transaction';
 const ERROR_DELEGATED_GASLESS_USER_ID_REQUIRED = 'userId is required — a delegated wallet is always owned by an end user, so a sponsored transaction cannot be attributed to the calling service';
@@ -1685,6 +2039,11 @@ exports.ERROR_ACCOUNT_ADDRESS_REQUIRED = ERROR_ACCOUNT_ADDRESS_REQUIRED;
 exports.ERROR_CREATE_WALLET_ACCOUNT = ERROR_CREATE_WALLET_ACCOUNT;
 exports.ERROR_DELEGATED_GASLESS_CREDENTIALS_REQUIRED = ERROR_DELEGATED_GASLESS_CREDENTIALS_REQUIRED;
 exports.ERROR_DELEGATED_GASLESS_USER_ID_REQUIRED = ERROR_DELEGATED_GASLESS_USER_ID_REQUIRED;
+exports.ERROR_EARN_APPROVAL_FAILED = ERROR_EARN_APPROVAL_FAILED;
+exports.ERROR_EARN_CHAIN_MISMATCH = ERROR_EARN_CHAIN_MISMATCH;
+exports.ERROR_EARN_CHAIN_REQUIRED = ERROR_EARN_CHAIN_REQUIRED;
+exports.ERROR_EARN_MISSING_EVM_TRANSACTION = ERROR_EARN_MISSING_EVM_TRANSACTION;
+exports.ERROR_EARN_NOT_EVM_WALLET = ERROR_EARN_NOT_EVM_WALLET;
 exports.ERROR_GASLESS_MISSING_REQUEST_ID = ERROR_GASLESS_MISSING_REQUEST_ID;
 exports.ERROR_GASLESS_MISSING_YPARITY = ERROR_GASLESS_MISSING_YPARITY;
 exports.ERROR_GASLESS_RELAY_FAILED = ERROR_GASLESS_RELAY_FAILED;
@@ -1702,6 +2061,7 @@ exports.EVM_SIGN_MESSAGE_PREFIX = EVM_SIGN_MESSAGE_PREFIX;
 exports.UGD_ABI = UGD_ABI;
 exports.createAccountAdapter = createAccountAdapter;
 exports.createDelegatedEvmWalletClient = createDelegatedEvmWalletClient;
+exports.createEvmEarnClient = createEvmEarnClient;
 exports.createZerodevClient = createZerodevClient;
 exports.delegatedSendSponsoredTransaction = delegatedSendSponsoredTransaction;
 exports.delegatedSign7702Authorization = delegatedSign7702Authorization;

package/index.esm.js

@@ -1,6 +1,6 @@
 import { toAccount } from 'viem/accounts';
 import { MessageHash, createLogError, createDelegatedWalletClient, delegatedSignMessage as delegatedSignMessage$1, resolveRawSignContext, stripHexPrefix, revokeDelegation as revokeDelegation$1, DynamicWalletClient, getMPCChainConfig, WalletOperation, withDelegatedServerAuth } from '@dynamic-labs-wallet/node';
-import { getAddress, stringToHex, bytesToHex, size, concat, hashTypedData, validateTypedData, serializeSignature, parseSignature, serializeTransaction, defineChain, createPublicClient, http, createWalletClient } from 'viem';
+import { getAddress, stringToHex, bytesToHex, size, concat, hashTypedData, validateTypedData, serializeSignature, parseSignature, serializeTransaction, encodeFunctionData, defineChain, createPublicClient, http, createWalletClient } from 'viem';
 import { hashAuthorization } from 'viem/utils';
 import { mainnet } from 'viem/chains';
 import { randomBytes } from 'node:crypto';
@@ -421,6 +421,347 @@ const createAccountAdapter = ({ evmClient, walletMetadata, password, externalSer
     });
 };
 
+function _object_without_properties_loose(source, excluded) {
+    if (source == null) return {};
+    var target = {};
+    var sourceKeys = Object.keys(source);
+    var key, i;
+    for(i = 0; i < sourceKeys.length; i++){
+        key = sourceKeys[i];
+        if (excluded.indexOf(key) >= 0) continue;
+        target[key] = source[key];
+    }
+    return target;
+}
+
+const ERROR_EARN_NOT_EVM_WALLET = 'Wallet metadata is not for an EVM wallet';
+const ERROR_EARN_MISSING_EVM_TRANSACTION = 'Earn signing payload is missing EVM transaction data';
+const ERROR_EARN_CHAIN_MISMATCH = 'The provided chain does not match the chain the Earn transaction was prepared for';
+const ERROR_EARN_APPROVAL_FAILED = 'The ERC-20 approval for the Earn transaction reverted';
+const ERROR_EARN_CHAIN_REQUIRED = 'Either chain or rpcUrl is required to execute an Earn transaction. Provide an RPC URL for the vault chain.';
+/**
+ * Vault deposits and withdrawals rebalance the underlying lending markets, so gas estimated at
+ * the current block is regularly lower than what execution needs once the transaction is mined.
+ */ const EARN_GAS_LIMIT_BUFFER_PERCENT = 30n;
+const ERC20_ALLOWANCE_AND_APPROVE_ABI = [
+    {
+        name: 'allowance',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [
+            {
+                name: 'owner',
+                type: 'address'
+            },
+            {
+                name: 'spender',
+                type: 'address'
+            }
+        ],
+        outputs: [
+            {
+                name: '',
+                type: 'uint256'
+            }
+        ]
+    },
+    {
+        name: 'approve',
+        type: 'function',
+        stateMutability: 'nonpayable',
+        inputs: [
+            {
+                name: 'spender',
+                type: 'address'
+            },
+            {
+                name: 'amount',
+                type: 'uint256'
+            }
+        ],
+        outputs: [
+            {
+                name: '',
+                type: 'bool'
+            }
+        ]
+    }
+];
+
+/**
+ * Builds a stateless Earn client for EVM vaults: it prepares vault actions through the
+ * Dynamic API and executes the returned unsigned transactions with the caller's wallet,
+ * sending an ERC-20 approval first when the vault requires one.
+ */ const createEvmEarnClient = ({ getEarnClient, createViemPublicClient, getWalletClient, sendSponsoredTransaction })=>{
+    const resolveChain = ({ chain, chainId, rpcUrl })=>{
+        if (chain) {
+            if (chain.id !== chainId) {
+                throw new Error(ERROR_EARN_CHAIN_MISMATCH);
+            }
+            return chain;
+        }
+        if (!rpcUrl) {
+            throw new Error(ERROR_EARN_CHAIN_REQUIRED);
+        }
+        return defineChain({
+            id: chainId,
+            name: `Chain ${chainId}`,
+            nativeCurrency: {
+                name: 'Ether',
+                symbol: 'ETH',
+                decimals: 18
+            },
+            rpcUrls: {
+                default: {
+                    http: [
+                        rpcUrl
+                    ]
+                }
+            }
+        });
+    };
+    const buildGasLimitAndNonce = async ({ transaction, publicClient, accountAddress })=>{
+        const params = {};
+        if (transaction.gasLimit) {
+            params.gas = BigInt(transaction.gasLimit);
+        } else {
+            const estimatedGas = await publicClient.estimateGas({
+                account: accountAddress,
+                to: transaction.to,
+                data: transaction.data,
+                value: transaction.value
+            });
+            params.gas = estimatedGas + estimatedGas * EARN_GAS_LIMIT_BUFFER_PERCENT / 100n;
+        }
+        if (transaction.nonce !== undefined) {
+            params.nonce = transaction.nonce;
+        }
+        return params;
+    };
+    const relaySponsoredEarnTransaction = async ({ chainId, evmApproval, evmTransaction, externalServerKeyShares, onStepChange, password, publicClient, resolvedChain, rpcUrl, traceContext, walletMetadata })=>{
+        const calls = [];
+        if (evmApproval) {
+            const currentAllowance = await publicClient.readContract({
+                address: evmApproval.tokenAddress,
+                abi: ERC20_ALLOWANCE_AND_APPROVE_ABI,
+                functionName: 'allowance',
+                args: [
+                    walletMetadata.accountAddress,
+                    evmApproval.spenderAddress
+                ]
+            });
+            const requiredAllowance = BigInt(evmApproval.amount);
+            if (currentAllowance < requiredAllowance) {
+                onStepChange == null ? void 0 : onStepChange('approval');
+                calls.push({
+                    target: evmApproval.tokenAddress,
+                    data: encodeFunctionData({
+                        abi: ERC20_ALLOWANCE_AND_APPROVE_ABI,
+                        functionName: 'approve',
+                        args: [
+                            evmApproval.spenderAddress,
+                            requiredAllowance
+                        ]
+                    }),
+                    value: 0n
+                });
+            }
+        }
+        onStepChange == null ? void 0 : onStepChange('transaction');
+        calls.push({
+            target: evmTransaction.to,
+            data: evmTransaction.data,
+            value: evmTransaction.value ? BigInt(evmTransaction.value) : 0n
+        });
+        return sendSponsoredTransaction({
+            walletMetadata,
+            calls,
+            chainId,
+            password,
+            externalServerKeyShares,
+            // The relayer needs an RPC to read the wallet's on-chain state; fall back to the
+            // resolved chain's default when the caller passed `chain` without `rpcUrl`.
+            rpcUrl: rpcUrl != null ? rpcUrl : resolvedChain.rpcUrls.default.http[0],
+            traceContext,
+            autoDelegate: true
+        });
+    };
+    const executeEarnTransaction = async ({ signingPayload, traceContext, walletMetadata, password, externalServerKeyShares, sponsored, chain, rpcUrl, onStepChange })=>{
+        if (walletMetadata.chainName !== 'EVM') {
+            throw new Error(ERROR_EARN_NOT_EVM_WALLET);
+        }
+        const { evmTransaction, evmApproval } = signingPayload;
+        if (!evmTransaction) {
+            throw new Error(ERROR_EARN_MISSING_EVM_TRANSACTION);
+        }
+        const chainId = Number(signingPayload.chainId);
+        const resolvedChain = resolveChain({
+            chain,
+            chainId,
+            rpcUrl
+        });
+        const publicClient = createViemPublicClient({
+            chain: resolvedChain,
+            rpcUrl
+        });
+        // Sponsored execution relays the approval and vault call as one batch through the
+        // gasless relayer, so no gas estimation or EOA sending is needed.
+        if (sponsored === true) {
+            return relaySponsoredEarnTransaction({
+                chainId,
+                evmApproval,
+                evmTransaction,
+                externalServerKeyShares,
+                onStepChange,
+                password,
+                publicClient,
+                resolvedChain,
+                rpcUrl,
+                traceContext,
+                walletMetadata
+            });
+        }
+        const walletClient = await getWalletClient({
+            walletMetadata,
+            password,
+            externalServerKeyShares,
+            chain: resolvedChain,
+            rpcUrl
+        });
+        if (evmApproval) {
+            const currentAllowance = await publicClient.readContract({
+                address: evmApproval.tokenAddress,
+                abi: ERC20_ALLOWANCE_AND_APPROVE_ABI,
+                functionName: 'allowance',
+                args: [
+                    walletMetadata.accountAddress,
+                    evmApproval.spenderAddress
+                ]
+            });
+            const requiredAllowance = BigInt(evmApproval.amount);
+            if (currentAllowance < requiredAllowance) {
+                onStepChange == null ? void 0 : onStepChange('approval');
+                const approvalHash = await walletClient.sendTransaction({
+                    to: evmApproval.tokenAddress,
+                    data: encodeFunctionData({
+                        abi: ERC20_ALLOWANCE_AND_APPROVE_ABI,
+                        functionName: 'approve',
+                        args: [
+                            evmApproval.spenderAddress,
+                            requiredAllowance
+                        ]
+                    }),
+                    value: 0n
+                });
+                const approvalReceipt = await publicClient.waitForTransactionReceipt({
+                    hash: approvalHash
+                });
+                if (approvalReceipt.status !== 'success') {
+                    throw new Error(ERROR_EARN_APPROVAL_FAILED);
+                }
+            }
+        }
+        onStepChange == null ? void 0 : onStepChange('transaction');
+        let value = 0n;
+        if (evmTransaction.value) {
+            value = BigInt(evmTransaction.value);
+        }
+        const gasLimitAndNonce = await buildGasLimitAndNonce({
+            transaction: _extends({}, evmTransaction, {
+                value
+            }),
+            publicClient,
+            accountAddress: walletMetadata.accountAddress
+        });
+        const request = _extends({
+            to: evmTransaction.to,
+            data: evmTransaction.data,
+            value
+        }, gasLimitAndNonce);
+        const hasEip1559Fees = Boolean(evmTransaction.maxFeePerGas && evmTransaction.maxPriorityFeePerGas);
+        if (hasEip1559Fees) {
+            const transactionHash = await walletClient.sendTransaction(_extends({}, request, {
+                maxFeePerGas: BigInt(evmTransaction.maxFeePerGas),
+                maxPriorityFeePerGas: BigInt(evmTransaction.maxPriorityFeePerGas)
+            }));
+            return {
+                transactionHash
+            };
+        }
+        if (evmTransaction.gasPrice) {
+            const transactionHash = await walletClient.sendTransaction(_extends({}, request, {
+                gasPrice: BigInt(evmTransaction.gasPrice)
+            }));
+            return {
+                transactionHash
+            };
+        }
+        const transactionHash = await walletClient.sendTransaction(request);
+        return {
+            transactionHash
+        };
+    };
+    const depositToEarnVault = async (_param)=>{
+        var { vaultId, amount, receiverAddress, traceContext } = _param, walletParams = _object_without_properties_loose(_param, [
+            "vaultId",
+            "amount",
+            "receiverAddress",
+            "traceContext"
+        ]);
+        const signingPayload = await getEarnClient().prepareDeposit({
+            vaultId,
+            ownerAddress: walletParams.walletMetadata.accountAddress,
+            amount,
+            receiverAddress,
+            traceContext
+        });
+        return executeEarnTransaction(_extends({
+            signingPayload,
+            traceContext
+        }, walletParams));
+    };
+    const withdrawFromEarnVault = async (_param)=>{
+        var { vaultId, amount, receiverAddress, traceContext } = _param, walletParams = _object_without_properties_loose(_param, [
+            "vaultId",
+            "amount",
+            "receiverAddress",
+            "traceContext"
+        ]);
+        const signingPayload = await getEarnClient().prepareWithdrawal({
+            vaultId,
+            ownerAddress: walletParams.walletMetadata.accountAddress,
+            amount,
+            receiverAddress,
+            traceContext
+        });
+        return executeEarnTransaction(_extends({
+            signingPayload,
+            traceContext
+        }, walletParams));
+    };
+    const claimEarnRewards = async (_param)=>{
+        var { vaultId, traceContext } = _param, walletParams = _object_without_properties_loose(_param, [
+            "vaultId",
+            "traceContext"
+        ]);
+        const signingPayload = await getEarnClient().prepareClaimRewards({
+            vaultId,
+            ownerAddress: walletParams.walletMetadata.accountAddress,
+            traceContext
+        });
+        return executeEarnTransaction(_extends({
+            signingPayload,
+            traceContext
+        }, walletParams));
+    };
+    return {
+        executeEarnTransaction,
+        depositToEarnVault,
+        withdrawFromEarnVault,
+        claimEarnRewards
+    };
+};
+
 /** The Fireblocks Universal Gasless Delegate (UGD) contract address used for EIP-7702 delegation. */ const DELEGATION_CONTRACT_ADDRESS = '0x0000Fb7702036ff9f76044a501ac1aA74cbab16b';
 /** Default sponsored transaction validity duration in seconds (10 minutes). */ const DEFAULT_VALID_FOR_SECONDS = 600;
 /** EIP-7702 delegation code prefix used to identify delegated accounts. */ const DELEGATION_CODE_PREFIX = '0xef0100';
@@ -1323,6 +1664,32 @@ class DynamicEvmWalletClient extends DynamicWalletClient {
    */ async waitForSponsoredTransaction(params) {
         return this.evmGasless.waitForSponsoredTransaction(params);
     }
+    // ---------------------------------------------------------------------------
+    // Earn (yield vaults)
+    // ---------------------------------------------------------------------------
+    get evmEarn() {
+        return createEvmEarnClient({
+            getEarnClient: ()=>this.earn,
+            createViemPublicClient: (args)=>this.createViemPublicClient(args),
+            getWalletClient: (args)=>this.getWalletClient(args),
+            sendSponsoredTransaction: (args)=>this.sendSponsoredTransaction(args)
+        });
+    }
+    /**
+   * Executes an Earn signing payload returned by the prepare* methods, sending the
+   * ERC-20 approval first when the vault requires one.
+   */ async executeEarnTransaction(params) {
+        return this.evmEarn.executeEarnTransaction(params);
+    }
+    /** Prepares and executes a deposit into an Earn vault. */ async depositToEarnVault(params) {
+        return this.evmEarn.depositToEarnVault(params);
+    }
+    /** Prepares and executes a withdrawal from an Earn vault. */ async withdrawFromEarnVault(params) {
+        return this.evmEarn.withdrawFromEarnVault(params);
+    }
+    /** Prepares and executes a claim of accrued Earn vault rewards. */ async claimEarnRewards(params) {
+        return this.evmEarn.claimEarnRewards(params);
+    }
     constructor({ environmentId, baseApiUrl, baseMPCRelayApiUrl, debug, enableMPCAccelerator, logger }){
         super({
             environmentId,
@@ -1335,19 +1702,6 @@ class DynamicEvmWalletClient extends DynamicWalletClient {
     }
 }
 
-function _object_without_properties_loose(source, excluded) {
-    if (source == null) return {};
-    var target = {};
-    var sourceKeys = Object.keys(source);
-    var key, i;
-    for(i = 0; i < sourceKeys.length; i++){
-        key = sourceKeys[i];
-        if (excluded.indexOf(key) >= 0) continue;
-        target[key] = source[key];
-    }
-    return target;
-}
-
 const logError = createLogError('node-evm');
 const ERROR_DELEGATED_GASLESS_CREDENTIALS_REQUIRED = 'Delegated key share, wallet ID, and wallet API key are required to sponsor a transaction';
 const ERROR_DELEGATED_GASLESS_USER_ID_REQUIRED = 'userId is required — a delegated wallet is always owned by an end user, so a sponsored transaction cannot be attributed to the calling service';
@@ -1673,4 +2027,4 @@ const createZerodevClient = async (evmClient)=>{
     return client;
 };
 
-export { AUTHORIZED_EXECUTIONS_TYPES, BATCH_CALL_OPDATA_AUTH_MODE, DEFAULT_VALID_FOR_SECONDS, DELEGATION_CODE_PREFIX, DELEGATION_CONTRACT_ADDRESS, DynamicEvmWalletClient, ERROR_ACCOUNT_ADDRESS_REQUIRED, ERROR_CREATE_WALLET_ACCOUNT, ERROR_DELEGATED_GASLESS_CREDENTIALS_REQUIRED, ERROR_DELEGATED_GASLESS_USER_ID_REQUIRED, ERROR_GASLESS_MISSING_REQUEST_ID, ERROR_GASLESS_MISSING_YPARITY, ERROR_GASLESS_RELAY_FAILED, ERROR_GASLESS_RPC_REQUIRED, ERROR_GASLESS_RPC_REQUIRED_FOR_AUTO_DELEGATE, ERROR_GASLESS_TIMEOUT, ERROR_KEYGEN_FAILED, ERROR_SIGN_MESSAGE, ERROR_SIGN_RAW_MESSAGE, ERROR_SIGN_TYPED_DATA, ERROR_VERIFY_MESSAGE_SIGNATURE, EVM_GASLESS_DEFAULT_POLL_INTERVAL_MS, EVM_GASLESS_DEFAULT_TIMEOUT_MS, EVM_SIGN_MESSAGE_PREFIX, UGD_ABI, createAccountAdapter, createDelegatedEvmWalletClient, createZerodevClient, delegatedSendSponsoredTransaction, delegatedSign7702Authorization, delegatedSignAuthorization, delegatedSignMessage, delegatedSignRawMessage, delegatedSignSponsoredTransaction, delegatedSignTransaction, delegatedSignTypedData, deriveAccountAddress, formatEVMMessage, formatTypedData, mapTransactionToEvmTransaction, revokeDelegation, serializeECDSASignature };
+export { AUTHORIZED_EXECUTIONS_TYPES, BATCH_CALL_OPDATA_AUTH_MODE, DEFAULT_VALID_FOR_SECONDS, DELEGATION_CODE_PREFIX, DELEGATION_CONTRACT_ADDRESS, DynamicEvmWalletClient, ERROR_ACCOUNT_ADDRESS_REQUIRED, ERROR_CREATE_WALLET_ACCOUNT, ERROR_DELEGATED_GASLESS_CREDENTIALS_REQUIRED, ERROR_DELEGATED_GASLESS_USER_ID_REQUIRED, ERROR_EARN_APPROVAL_FAILED, ERROR_EARN_CHAIN_MISMATCH, ERROR_EARN_CHAIN_REQUIRED, ERROR_EARN_MISSING_EVM_TRANSACTION, ERROR_EARN_NOT_EVM_WALLET, ERROR_GASLESS_MISSING_REQUEST_ID, ERROR_GASLESS_MISSING_YPARITY, ERROR_GASLESS_RELAY_FAILED, ERROR_GASLESS_RPC_REQUIRED, ERROR_GASLESS_RPC_REQUIRED_FOR_AUTO_DELEGATE, ERROR_GASLESS_TIMEOUT, ERROR_KEYGEN_FAILED, ERROR_SIGN_MESSAGE, ERROR_SIGN_RAW_MESSAGE, ERROR_SIGN_TYPED_DATA, ERROR_VERIFY_MESSAGE_SIGNATURE, EVM_GASLESS_DEFAULT_POLL_INTERVAL_MS, EVM_GASLESS_DEFAULT_TIMEOUT_MS, EVM_SIGN_MESSAGE_PREFIX, UGD_ABI, createAccountAdapter, createDelegatedEvmWalletClient, createEvmEarnClient, createZerodevClient, delegatedSendSponsoredTransaction, delegatedSign7702Authorization, delegatedSignAuthorization, delegatedSignMessage, delegatedSignRawMessage, delegatedSignSponsoredTransaction, delegatedSignTransaction, delegatedSignTypedData, deriveAccountAddress, formatEVMMessage, formatTypedData, mapTransactionToEvmTransaction, revokeDelegation, serializeECDSASignature };

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@dynamic-labs-wallet/node-evm",
-  "version": "1.1.52",
+  "version": "1.1.54",
   "license": "MIT",
   "type": "module",
   "dependencies": {
-    "@dynamic-labs-wallet/node": "1.1.52",
+    "@dynamic-labs-wallet/node": "1.1.54",
     "@dynamic-labs/sdk-api-core": "0.115.0",
     "@dynamic-labs-sdk/client": "1.18.0",
     "@dynamic-labs-sdk/zerodev": "1.18.0",
     "@dynamic-labs-sdk/evm": "1.18.0",
     "@zerodev/ecdsa-validator": "5.4.9",
     "@zerodev/sdk": "5.4.36",
-    "@dynamic-labs-wallet/core": "1.1.52"
+    "@dynamic-labs-wallet/core": "1.1.54"
   },
   "publishConfig": {
     "access": "public"

package/src/client/client.d.ts

@@ -1,6 +1,7 @@
 import { DynamicWalletClient, type DynamicWalletClientProps, type EcdsaKeygenResult, type EcdsaPublicKey, type Ed25519KeygenResult, type RawSignPreImage, type ServerKeyShare, type ThresholdSignatureScheme, type WalletApiKeyCreationResult, type WalletMetadata } from '@dynamic-labs-wallet/node';
 import type { SignMessageContext, SponsorEVMTransactionResponse } from '@dynamic-labs-wallet/core';
 import { type Account, type Chain, type Hex, type PublicClient, type SignableMessage, type TransactionSerializable, type Transport, type TypedData, type WalletClient } from 'viem';
+import type { ClaimEarnRewardsParams, DepositToEarnVaultParams, EarnTransactionResult, ExecuteEarnTransactionParams, WithdrawFromEarnVaultParams } from './earn.types.js';
 import type { GetAvailableEvmGaslessRelayerParams, GetEVMSponsoredTransactionStatusParams, Is7702DelegationActiveParams, RelaySponsoredTransactionParams, SerializedAuthorization, Sign7702AuthorizationParams, SignedSponsoredTransaction, SignSponsoredTransactionParams, SponsoredTransactionStatusResult, WaitForSponsoredTransactionParams } from './gasless.types.js';
 export declare class DynamicEvmWalletClient extends DynamicWalletClient {
     readonly chainName = "EVM";
@@ -204,5 +205,17 @@ export declare class DynamicEvmWalletClient extends DynamicWalletClient {
     waitForSponsoredTransaction(params: WaitForSponsoredTransactionParams): Promise<{
         transactionHash: Hex;
     }>;
+    private get evmEarn();
+    /**
+     * Executes an Earn signing payload returned by the prepare* methods, sending the
+     * ERC-20 approval first when the vault requires one.
+     */
+    executeEarnTransaction(params: ExecuteEarnTransactionParams): Promise<EarnTransactionResult>;
+    /** Prepares and executes a deposit into an Earn vault. */
+    depositToEarnVault(params: DepositToEarnVaultParams): Promise<EarnTransactionResult>;
+    /** Prepares and executes a withdrawal from an Earn vault. */
+    withdrawFromEarnVault(params: WithdrawFromEarnVaultParams): Promise<EarnTransactionResult>;
+    /** Prepares and executes a claim of accrued Earn vault rewards. */
+    claimEarnRewards(params: ClaimEarnRewardsParams): Promise<EarnTransactionResult>;
 }
 //# sourceMappingURL=client.d.ts.map

package/src/client/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"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"}

package/src/client/earn.client.d.ts

@@ -0,0 +1,35 @@
+import type { EarnClient, ServerKeyShare, WalletMetadata } from '@dynamic-labs-wallet/node';
+import { type Account, type Chain, type Hex, type PublicClient, type Transport, type WalletClient } from 'viem';
+import type { ClaimEarnRewardsParams, DepositToEarnVaultParams, EarnTransactionResult, ExecuteEarnTransactionParams, WithdrawFromEarnVaultParams } from './earn.types.js';
+import type { RelaySponsoredTransactionParams } from './gasless.types.js';
+/** Primitives the Earn client borrows from whoever owns the wallet. */
+export type EvmEarnClientDeps = {
+    getEarnClient: () => EarnClient;
+    createViemPublicClient: (args: {
+        chain: Chain;
+        rpcUrl?: string;
+    }) => PublicClient;
+    getWalletClient: (args: {
+        walletMetadata: WalletMetadata;
+        password?: string;
+        externalServerKeyShares?: ServerKeyShare[];
+        chain?: Chain;
+        chainId?: number;
+        rpcUrl?: string;
+    }) => Promise<WalletClient<Transport, Chain, Account>>;
+    sendSponsoredTransaction: (args: RelaySponsoredTransactionParams) => Promise<{
+        transactionHash: Hex;
+    }>;
+};
+/**
+ * Builds a stateless Earn client for EVM vaults: it prepares vault actions through the
+ * Dynamic API and executes the returned unsigned transactions with the caller's wallet,
+ * sending an ERC-20 approval first when the vault requires one.
+ */
+export declare const createEvmEarnClient: ({ getEarnClient, createViemPublicClient, getWalletClient, sendSponsoredTransaction, }: EvmEarnClientDeps) => {
+    executeEarnTransaction: ({ signingPayload, traceContext, walletMetadata, password, externalServerKeyShares, sponsored, chain, rpcUrl, onStepChange, }: ExecuteEarnTransactionParams) => Promise<EarnTransactionResult>;
+    depositToEarnVault: ({ vaultId, amount, receiverAddress, traceContext, ...walletParams }: DepositToEarnVaultParams) => Promise<EarnTransactionResult>;
+    withdrawFromEarnVault: ({ vaultId, amount, receiverAddress, traceContext, ...walletParams }: WithdrawFromEarnVaultParams) => Promise<EarnTransactionResult>;
+    claimEarnRewards: ({ vaultId, traceContext, ...walletParams }: ClaimEarnRewardsParams) => Promise<EarnTransactionResult>;
+};
+//# sourceMappingURL=earn.client.d.ts.map

package/src/client/earn.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"earn.client.d.ts","sourceRoot":"","sources":["../../src/client/earn.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAsB,cAAc,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChH,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,KAAK,EAGV,KAAK,GAAG,EACR,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,YAAY,EAClB,MAAM,MAAM,CAAC;AAUd,OAAO,KAAK,EACV,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,+BAA+B,EAA4B,MAAM,oBAAoB,CAAC;AAEpG,uEAAuE;AACvE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,aAAa,EAAE,MAAM,UAAU,CAAC;IAChC,sBAAsB,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,YAAY,CAAC;IAClF,eAAe,EAAE,CAAC,IAAI,EAAE;QACtB,cAAc,EAAE,cAAc,CAAC;QAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,uBAAuB,CAAC,EAAE,cAAc,EAAE,CAAC;QAC3C,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAK,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,wBAAwB,EAAE,CAAC,IAAI,EAAE,+BAA+B,KAAK,OAAO,CAAC;QAAE,eAAe,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;CACxG,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,0FAK7B,iBAAiB;2JAoIf,4BAA4B,KAAG,OAAO,CAAC,qBAAqB,CAAC;8FAyH7D,wBAAwB,KAAG,OAAO,CAAC,qBAAqB,CAAC;iGAkBzD,2BAA2B,KAAG,OAAO,CAAC,qBAAqB,CAAC;mEAgB5D,sBAAsB,KAAG,OAAO,CAAC,qBAAqB,CAAC;CAgB3D,CAAC"}

package/src/client/earn.constants.d.ts

@@ -0,0 +1,42 @@
+export declare const ERROR_EARN_NOT_EVM_WALLET = "Wallet metadata is not for an EVM wallet";
+export declare const ERROR_EARN_MISSING_EVM_TRANSACTION = "Earn signing payload is missing EVM transaction data";
+export declare const ERROR_EARN_CHAIN_MISMATCH = "The provided chain does not match the chain the Earn transaction was prepared for";
+export declare const ERROR_EARN_APPROVAL_FAILED = "The ERC-20 approval for the Earn transaction reverted";
+export declare const ERROR_EARN_CHAIN_REQUIRED = "Either chain or rpcUrl is required to execute an Earn transaction. Provide an RPC URL for the vault chain.";
+/**
+ * Vault deposits and withdrawals rebalance the underlying lending markets, so gas estimated at
+ * the current block is regularly lower than what execution needs once the transaction is mined.
+ */
+export declare const EARN_GAS_LIMIT_BUFFER_PERCENT = 30n;
+export declare const ERC20_ALLOWANCE_AND_APPROVE_ABI: readonly [{
+    readonly name: "allowance";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "approve";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}];
+//# sourceMappingURL=earn.constants.d.ts.map

package/src/client/earn.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"earn.constants.d.ts","sourceRoot":"","sources":["../../src/client/earn.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,6CAA6C,CAAC;AAEpF,eAAO,MAAM,kCAAkC,yDAAyD,CAAC;AAEzG,eAAO,MAAM,yBAAyB,sFAC+C,CAAC;AAEtF,eAAO,MAAM,0BAA0B,0DAA0D,CAAC;AAElG,eAAO,MAAM,yBAAyB,+GACwE,CAAC;AAE/G;;;GAGG;AACH,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBlC,CAAC"}

package/src/client/earn.types.d.ts

@@ -0,0 +1,33 @@
+import type { EarnExecutionStep, EarnSigningPayload, ServerKeyShare, TraceContext, WalletMetadata } from '@dynamic-labs-wallet/node';
+import type { Chain } from 'viem';
+export type { EarnExecutionStep, EarnTransactionResult } from '@dynamic-labs-wallet/node';
+/** Wallet context and chain access every Earn write action needs. */
+export type EvmEarnWalletParams = {
+    walletMetadata: WalletMetadata;
+    password?: string;
+    externalServerKeyShares?: ServerKeyShare[];
+    /** Viem chain for the vault. When omitted, the chain is built from the payload's chain id and `rpcUrl`. */
+    chain?: Chain;
+    rpcUrl?: string;
+    /** Opt in to Dynamic gas sponsorship: the approval and vault call are relayed as one batch. */
+    sponsored?: boolean;
+    onStepChange?: (step: EarnExecutionStep) => void;
+    traceContext?: TraceContext;
+};
+export type ExecuteEarnTransactionParams = EvmEarnWalletParams & {
+    signingPayload: EarnSigningPayload;
+};
+export type DepositToEarnVaultParams = EvmEarnWalletParams & {
+    vaultId: string;
+    amount: string;
+    receiverAddress?: string;
+};
+export type WithdrawFromEarnVaultParams = EvmEarnWalletParams & {
+    vaultId: string;
+    amount: string;
+    receiverAddress?: string;
+};
+export type ClaimEarnRewardsParams = EvmEarnWalletParams & {
+    vaultId: string;
+};
+//# sourceMappingURL=earn.types.d.ts.map

package/src/client/earn.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"earn.types.d.ts","sourceRoot":"","sources":["../../src/client/earn.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,cAAc,EACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAElC,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAE1F,qEAAqE;AACrE,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3C,2GAA2G;IAC3G,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+FAA+F;IAC/F,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACjD,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,mBAAmB,GAAG;IAC/D,cAAc,EAAE,kBAAkB,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,GAAG;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,mBAAmB,GAAG;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,GAAG;IACzD,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/src/client/index.d.ts

@@ -2,6 +2,10 @@ export * from './accountAdapter.js';
 export * from './client.js';
 export * from './constants.js';
 export * from '../utils.js';
+export { createEvmEarnClient } from './earn.client.js';
+export type { EvmEarnClientDeps } from './earn.client.js';
+export type { ClaimEarnRewardsParams, DepositToEarnVaultParams, EarnExecutionStep, EarnTransactionResult, EvmEarnWalletParams, ExecuteEarnTransactionParams, WithdrawFromEarnVaultParams, } from './earn.types.js';
+export { ERROR_EARN_APPROVAL_FAILED, ERROR_EARN_CHAIN_MISMATCH, ERROR_EARN_CHAIN_REQUIRED, ERROR_EARN_MISSING_EVM_TRANSACTION, ERROR_EARN_NOT_EVM_WALLET, } from './earn.constants.js';
 export type { GaslessWalletRef, SerializedAuthorization, SignedSponsoredTransaction, SponsoredTransactionCall, SponsoredTransactionStatus, SponsoredTransactionStatusResult, } from './gasless.types.js';
 export { AUTHORIZED_EXECUTIONS_TYPES, BATCH_CALL_OPDATA_AUTH_MODE, DEFAULT_VALID_FOR_SECONDS, DELEGATION_CODE_PREFIX, DELEGATION_CONTRACT_ADDRESS, ERROR_GASLESS_MISSING_REQUEST_ID, ERROR_GASLESS_MISSING_YPARITY, ERROR_GASLESS_RELAY_FAILED, ERROR_GASLESS_RPC_REQUIRED, ERROR_GASLESS_RPC_REQUIRED_FOR_AUTO_DELEGATE, ERROR_GASLESS_TIMEOUT, EVM_GASLESS_DEFAULT_POLL_INTERVAL_MS, EVM_GASLESS_DEFAULT_TIMEOUT_MS, UGD_ABI, } from './gasless.constants.js';
 //# sourceMappingURL=index.d.ts.map

package/src/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,yBAAyB,EACzB,sBAAsB,EACtB,2BAA2B,EAC3B,gCAAgC,EAChC,6BAA6B,EAC7B,0BAA0B,EAC1B,0BAA0B,EAC1B,4CAA4C,EAC5C,qBAAqB,EACrB,oCAAoC,EACpC,8BAA8B,EAC9B,OAAO,GACR,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EACV,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,kCAAkC,EAClC,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,yBAAyB,EACzB,sBAAsB,EACtB,2BAA2B,EAC3B,gCAAgC,EAChC,6BAA6B,EAC7B,0BAA0B,EAC1B,0BAA0B,EAC1B,4CAA4C,EAC5C,qBAAqB,EACrB,oCAAoC,EACpC,8BAA8B,EAC9B,OAAO,GACR,MAAM,wBAAwB,CAAC"}