depositToEarnVault

​

Function Signature

depositToEarnVault(params: {
  vaultId: string;
  amount: string;
  receiverAddress?: string;
  walletMetadata: WalletMetadata;
  password?: string;
  externalServerKeyShares?: ServerKeyShare[];
  sponsored?: boolean;
  chain?: Chain;
  rpcUrl?: string;
  onStepChange?: (step: EarnExecutionStep) => void;
  traceContext?: TraceContext;
}): Promise<EarnTransactionResult>

​

Description

​

Parameters

​

Required Parameters

• vaultId (string): The vault identifier from listVaults.
• amount (string): How much of the vault’s underlying asset to deposit, in the asset’s human-readable units ('12.5' USDC, not '12500000'). Needs a leading zero ('0.01', not '.01').
• walletMetadata (WalletMetadata): Non-sensitive wallet metadata persisted from createWalletAccount() / importPrivateKey(). Its chainName must be 'EVM'.

​

Optional Parameters

• receiverAddress (string): The address that receives the vault shares. Defaults to the depositing wallet.
• password (string): Required if the wallet was created with backUpToDynamic: true. Used for backup decryption when externalServerKeyShares is not provided.
• externalServerKeyShares (ServerKeyShare[]): Caller-supplied plaintext shares.
• sponsored (boolean): When true, relays the approval and vault call as one gasless batch. See EVM Gas Sponsorship.
• chain (Chain): The viem chain for the vault. Its id must match the vault’s chainId. When omitted, the chain is built from rpcUrl, so one of chain or rpcUrl is required.
• rpcUrl (string): RPC endpoint for the vault’s chain.
• onStepChange ((step: EarnExecutionStep) => void): Reports approval then transaction as execution proceeds.
• traceContext (TraceContext): Trace context forwarded to the Dynamic API.

​

Returns

• Promise<EarnTransactionResult>: An object with transactionHash, the hash of the vault transaction.

​

Example

import { authenticatedEvmClient } from './client';

const evmClient = await authenticatedEvmClient();

const { transactionHash } = await evmClient.depositToEarnVault({
  vaultId: 'steakhouse-prime-usdc',
  amount: '12.5',
  walletMetadata,
  externalServerKeyShares,
  password: 'user-password',
  rpcUrl: 'https://mainnet.base.org',
  onStepChange: (step) => console.log(`Step: ${step}`),
});

​

Error Handling

​

See Also

• Earn
• withdrawFromEarnVault
• executeEarnTransaction