depositFunds

Transfer tokens from the user’s EOA to their Smart Wallet. Waits for transaction confirmation.

On the first deposit, this is also how a user is onboarded onto Zyfai: a pre-deployed Safe with an already-signed session key is assigned to them, live on Base, Arbitrum, and Ethereum Mainnet at once. No separate deploySafe or createSessionKey call is needed (or supported).

Supported assets:

• USDC: 6 decimals — e.g., "100000000" = 100 USDC
• WETH: 18 decimals — e.g., "1000000000000000000" = 1 WETH
• EURC: 6 decimals — e.g., "100000000" = 100 EURC (Mainnet and Base only)

The first time a user deposits into Zyfai, the backend associates their EOA with a pre-deployed Smart Account that already has a signed session key.

That Smart Account becomes available immediately on Base (8453), Arbitrum (42161), and Ethereum Mainnet (1) — not only on the chainId you pass to depositFunds. The user is the owner of that Safe.

This does not change how their EOA works: the EOA remains a normal wallet. Depositing only links a Zyfai Smart Wallet (with session) to that EOA as owner.

You must deposit WETH (Wrapped ETH), not native ETH. If the user has ETH, they must wrap it to WETH first before depositing.

Minimums apply to the total Safe balance after the deposit (current Safe balance + deposit amount). Top-ups smaller than the minimum are allowed if the Safe already holds enough of the asset to meet it. Pairs without a configured threshold are not checked.

Chain	USDC	WETH	EURC
Base / Arbitrum	$5	0.001 WETH	€5 (Base only)
Ethereum Mainnet	$10,000	5 WETH	€5

Signature

depositFunds(
  userAddress: string,
  chainId: SupportedChainId,
  amount: string,
  asset: string,
  strategy?: Strategy
): Promise<DepositResponse>

Parameters

Parameter	Type	Required	Description
userAddress	string	✅	User’s EOA address (owner of the Safe)
chainId	SupportedChainId	✅	Chain to deposit on
amount	string	✅	Amount in least decimal units (6 decimals for USDC/EURC, 18 for WETH)
asset	string	✅	Asset to deposit: "USDC", "WETH", or "EURC"
strategy	Strategy	❌	First-deposit strategy: "conservative" (default) or "aggressive"

What happens under the hood

1. Resolves the Safe address for the EOA (backend-assigned for pre-deployed wallets — not derived from the EOA).
2. Ensures the Safe is available on-chain.
3. First-deposit protocol patching (see below), then transfers the token from the EOA to the Safe and logs the deposit.

First-deposit protocol patching

Runs only when the USDC profile has no chains configured yet (later deposits and pauseAgent do not re-trigger it):

• Patches USDC, WETH, and EURC with chains [1, 8453, 42161] (EURC limited to [1, 8453]).
• Fetches protocols, filters by strategy / chain / asset + pool availability, and persists via updateUserProfile → assetTypeSettings.[usdc|eth|eurc].
• Failures are non-fatal (console.warn); the deposit still proceeds.

Protocols / chains are set on this first depositFunds call — not by any separate deploy or session-key step.

Returns

Deposit response with transaction hash and confirmation

Return Type

interface DepositResponse {
  success: boolean;
  txHash: string;
  smartWallet: string;
  amount: string;
}

Example

Deposit USDC

// Deposit 100 USDC (6 decimals) to Safe on Base
// Optional strategy applies on first deposit only (default: "conservative")
const result = await sdk.depositFunds(
  "0xUser...",
  8453,
  "100000000", // 100 USDC = 100 * 10^6
  "USDC",
  "conservative"
);
console.log("Deposit confirmed:", result.txHash);
console.log("Smart Wallet:", result.smartWallet);

Deposit WETH

// Deposit 0.5 WETH (18 decimals) to Safe on Base
// IMPORTANT: User must have WETH, not ETH. Wrap ETH to WETH first if needed.
const result = await sdk.depositFunds(
  "0xUser...",
  8453,
  "500000000000000000", // 0.5 WETH = 0.5 * 10^18
  "WETH"
);
console.log("WETH deposit confirmed:", result.txHash);

Deposit EURC

// Deposit 100 EURC (6 decimals) on Base (also supported on Mainnet)
const result = await sdk.depositFunds(
  "0xUser...",
  8453,
  "100000000",
  "EURC"
);
console.log("EURC deposit confirmed:", result.txHash);