Deposit - DZap

A deposit, or Zap In, turns a token you hold into a DeFi position: a liquidity pool, a lending market or a vault. DZap swaps into what the position needs, bridges first when the position is on another chain, and deposits. You name the position by its address in destToken. Pick EVM or Solana in any tab, and the rest of the page switches with it.

Setup

EVM
Solana

This example deposits 100 USDC into the Uniswap v3 WETH/USDC pool on Base, signing with walletClient, a viem wallet client built from the private key in PRIVATE_KEY. Amounts are strings in the token’s smallest unit, and no API key is needed.

import { DZapClient, Services, ApprovalModes, TxnStatus, type ZapStatusResponse } from '@dzapio/sdk';
import { createWalletClient, http } from 'viem';
import { base } from 'viem/chains';
import { privateKeyToAccount } from 'viem/accounts';

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const walletClient = createWalletClient({ account, chain: base, transport: http() });
const dzap = DZapClient.getInstance();

const USDC_BASE = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
const POOL = '0xd0b53D9277642d899DF5C87A3966A349A798F224';   // Uniswap v3 WETH/USDC 0.05% on Base
const AMOUNT = '100000000';                                  // 100 USDC (6 decimals)

Find position addresses for destToken with getZapPools, and the providers each chain supports with getZapChains.

This example deposits 100 USDC into Jupiter Lend on Solana. It signs with the keypair in SOLANA_SECRET_KEY using @solana/web3.js, which you install alongside the SDK, and sends through a Solana RPC connection. Amounts are strings in the token’s smallest unit, and no API key is needed.

import { DZapClient, type SVMTxnDetails, type ZapStatusResponse } from '@dzapio/sdk';
import { Connection, Keypair, VersionedTransaction } from '@solana/web3.js';

const dzap = DZapClient.getInstance();
const connection = new Connection('https://api.mainnet-beta.solana.com');
const keypair = Keypair.fromSecretKey(Uint8Array.from(JSON.parse(process.env.SOLANA_SECRET_KEY!)));

const account = keypair.publicKey.toBase58();
const USDC_SOL = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
const JUP_LEND_USDC = '9BEcn9aPEmhSPbPQeFGjidRiEKki46fVQDyPpSQXPA2D';   // Jupiter Lend USDC (jlUSDC)
const AMOUNT = '100000000';                                          // 100 USDC (6 decimals)

Find position addresses for destToken with getZapPools, and the providers each chain supports with getZapChains.

Steps

EVM
Solana

Quote

getZapQuote returns the route into the position without touching your wallet. quote.path lists each step of the route, and quote.output is the position you’ll hold, with its value in USD. To deposit on another chain, set destChainId to it; the route then bridges first.

const request = {
  srcChainId: 8453,
  destChainId: 8453,           // same chain = same-chain deposit
  account: account.address,
  srcToken: USDC_BASE,
  destToken: POOL,             // the position you're entering
  amount: AMOUNT,
  recipient: account.address,
  refundee: account.address,
  slippage: 1,                 // 1 = 1%
};

const quote = await dzap.getZapQuote(request);
console.log(quote.output[0].asset.symbol, quote.output[0].amountUSD); // the position and its USD value

On a concentrated-liquidity pool like this one, DZap picks a narrow range around the current price. To set your own, add poolDetails: { lowerTick, upperTick } to the request; getZapPoolDetails returns the current tick in slot0.tick.

Approve

The zap contract needs permission to move your USDC. Its address is the quote’s approvalData[0].approveTo: pass it as spender, so the allowance goes to the contract that will spend it. getAllowance reads the current allowance, and if it’s too low, approve() approves exactly the deposit amount. Native ETH has nothing to approve, and its approvalData is empty.

const spender = quote.approvalData[0].approveTo;

const { data } = await dzap.getAllowance({
  chainId: 8453,
  sender: account.address,
  tokens: [{ address: USDC_BASE, amount: AMOUNT }],
  service: Services.zap,
  mode: ApprovalModes.Default,
  spender,
});

if (data[USDC_BASE].allowance < BigInt(AMOUNT)) {
  await dzap.approve({
    chainId: 8453,
    signer: walletClient,
    tokens: [{ address: USDC_BASE, amount: AMOUNT }],
    service: Services.zap,
    mode: ApprovalModes.Default,
    spender,
  });
}

Build & send

buildZapTxn builds the deposit and checks it against your wallet, so it throws if the deposit would fail. zap() then signs and sends it. The swap and the deposit happen in that one transaction: the position goes to recipient, and whatever doesn’t fit into it comes back to you.

const route = await dzap.buildZapTxn(request);
const result = await dzap.zap({ request, steps: route.steps, signer: walletClient });
if (result.status !== TxnStatus.success) throw new Error(result.errorMsg);

Status

Poll getZapTxnStatus with the transaction hash until the status leaves PENDING; COMPLETED means every step finished, and status.steps reports each one. DZap answers 404 until it sees the transaction, and 429 once its rate limit is used up, so the catch skips only those two and rethrows anything else. The loop gives up after 5 minutes (raise it if the route bridges), and the check after it throws unless the status is COMPLETED.

let status: ZapStatusResponse | undefined;
for (let i = 0; i < 20; i++) {  // gives up after 5 minutes
  await new Promise((r) => setTimeout(r, 15_000));
  try {
    status = await dzap.getZapTxnStatus({ chainId: 8453, txnHash: result.txnHash! });
  } catch (e: any) {
    if (![404, 429].includes(e.response?.status)) throw e;
  }
  if (status && status.status !== 'PENDING') break;
}
if (status?.status !== 'COMPLETED') throw new Error(`Not completed: ${status?.status ?? 'no status'}`);

console.log(status.status); // 'COMPLETED'

Quote

Same call with Solana’s chain ID, 7565164, and base58 addresses. There’s nothing to approve on Solana: approvalData comes back empty. To deposit into a position on another chain, set destChainId to it and recipient to your address there; refundee stays your Solana address.

const request = {
  srcChainId: 7565164,
  destChainId: 7565164,
  account,
  srcToken: USDC_SOL,
  destToken: JUP_LEND_USDC,    // the position you're entering
  amount: AMOUNT,
  recipient: account,
  refundee: account,
  slippage: 1,                 // 1 = 1%
};

const quote = await dzap.getZapQuote(request);
console.log(quote.output[0].asset.symbol, quote.output[0].amountUSD); // the position and its USD value

Build

buildZapTxn builds the deposit and returns it in route.steps[0].data, where data is a list of base64 transactions. Jupiter Lend needs just one.

const route = await dzap.buildZapTxn(request);
const step = route.steps[0].data as SVMTxnDetails;

Sign & send

Sign the transaction with your keypair and send it through your Solana connection; the signature it returns identifies the transaction. Do it right away: the transaction expires about a minute after it’s built.

const tx = VersionedTransaction.deserialize(Buffer.from(step.data[0], 'base64'));
tx.sign([keypair]);
const signature = await connection.sendRawTransaction(tx.serialize());

Status

Poll getZapTxnStatus with that signature, not the build’s txnId, until the status leaves PENDING. Until DZap sees the transaction it answers 500 Failed to process transaction or 404, and 429 once its rate limit is used up, so the catch skips only those and rethrows anything else. The loop gives up after 5 minutes (raise it if the route bridges), and the check after it throws unless the status is COMPLETED.

let status: ZapStatusResponse | undefined;
for (let i = 0; i < 20; i++) {  // gives up after 5 minutes
  await new Promise((r) => setTimeout(r, 15_000));
  try {
    status = await dzap.getZapTxnStatus({ chainId: 7565164, txnHash: signature });
  } catch (e: any) {
    if (![404, 429, 500].includes(e.response?.status)) throw e;
  }
  if (status && status.status !== 'PENDING') break;
}
if (status?.status !== 'COMPLETED') throw new Error(`Not completed: ${status?.status ?? 'no status'}`);

console.log(status.status); // 'COMPLETED'

End-to-end

EVM
Solana

import { DZapClient, Services, ApprovalModes, TxnStatus, type ZapStatusResponse } from '@dzapio/sdk';
import { createWalletClient, http } from 'viem';
import { base } from 'viem/chains';
import { privateKeyToAccount } from 'viem/accounts';

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const walletClient = createWalletClient({ account, chain: base, transport: http() });
const dzap = DZapClient.getInstance();

const USDC_BASE = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
const POOL = '0xd0b53D9277642d899DF5C87A3966A349A798F224'; // Uniswap v3 WETH/USDC 0.05% on Base
const AMOUNT = '100000000'; // 100 USDC

// 1. Quote
const request = {
  srcChainId: 8453,
  destChainId: 8453,
  account: account.address,
  srcToken: USDC_BASE,
  destToken: POOL,
  amount: AMOUNT,
  recipient: account.address,
  refundee: account.address,
  slippage: 1,
};
const quote = await dzap.getZapQuote(request);
console.log(quote.output[0].asset.symbol, quote.output[0].amountUSD);

// 2. Approve the zap contract (if needed)
const spender = quote.approvalData[0].approveTo;
const { data } = await dzap.getAllowance({
  chainId: 8453,
  sender: account.address,
  tokens: [{ address: USDC_BASE, amount: AMOUNT }],
  service: Services.zap,
  mode: ApprovalModes.Default,
  spender,
});
if (data[USDC_BASE].allowance < BigInt(AMOUNT)) {
  await dzap.approve({
    chainId: 8453,
    signer: walletClient,
    tokens: [{ address: USDC_BASE, amount: AMOUNT }],
    service: Services.zap,
    mode: ApprovalModes.Default,
    spender,
  });
}

// 3. Build & send
const route = await dzap.buildZapTxn(request);
const result = await dzap.zap({ request, steps: route.steps, signer: walletClient });
if (result.status !== TxnStatus.success) throw new Error(result.errorMsg);

// 4. Status
let status: ZapStatusResponse | undefined;
for (let i = 0; i < 20; i++) {  // gives up after 5 minutes
  await new Promise((r) => setTimeout(r, 15_000));
  try {
    status = await dzap.getZapTxnStatus({ chainId: 8453, txnHash: result.txnHash! });
  } catch (e: any) {
    if (![404, 429].includes(e.response?.status)) throw e;
  }
  if (status && status.status !== 'PENDING') break;
}
if (status?.status !== 'COMPLETED') throw new Error(`Not completed: ${status?.status ?? 'no status'}`);
console.log('settled:', status.status);

import { DZapClient, type SVMTxnDetails, type ZapStatusResponse } from '@dzapio/sdk';
import { Connection, Keypair, VersionedTransaction } from '@solana/web3.js';

const dzap = DZapClient.getInstance();
const connection = new Connection('https://api.mainnet-beta.solana.com');
const keypair = Keypair.fromSecretKey(Uint8Array.from(JSON.parse(process.env.SOLANA_SECRET_KEY!)));

const account = keypair.publicKey.toBase58();
const USDC_SOL = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
const JUP_LEND_USDC = '9BEcn9aPEmhSPbPQeFGjidRiEKki46fVQDyPpSQXPA2D'; // Jupiter Lend USDC (jlUSDC)
const AMOUNT = '100000000'; // 100 USDC

// 1. Quote
const request = {
  srcChainId: 7565164,
  destChainId: 7565164,
  account,
  srcToken: USDC_SOL,
  destToken: JUP_LEND_USDC,
  amount: AMOUNT,
  recipient: account,
  refundee: account,
  slippage: 1,
};
const quote = await dzap.getZapQuote(request);
console.log(quote.output[0].asset.symbol, quote.output[0].amountUSD);

// 2. Build
const route = await dzap.buildZapTxn(request);
const step = route.steps[0].data as SVMTxnDetails;

// 3. Sign & send
const tx = VersionedTransaction.deserialize(Buffer.from(step.data[0], 'base64'));
tx.sign([keypair]);
const signature = await connection.sendRawTransaction(tx.serialize());

// 4. Status, by signature
let status: ZapStatusResponse | undefined;
for (let i = 0; i < 20; i++) {  // gives up after 5 minutes
  await new Promise((r) => setTimeout(r, 15_000));
  try {
    status = await dzap.getZapTxnStatus({ chainId: 7565164, txnHash: signature });
  } catch (e: any) {
    if (![404, 429, 500].includes(e.response?.status)) throw e;
  }
  if (status && status.status !== 'PENDING') break;
}
if (status?.status !== 'COMPLETED') throw new Error(`Not completed: ${status?.status ?? 'no status'}`);
console.log('settled:', status.status);

API usage

The same flow over REST, on the zap API at https://zap.dzap.io/v1. Each response wraps its result in data.

EVM
Solana

curl -X POST https://zap.dzap.io/v1/quote \
  -H "Content-Type: application/json" \
  -d '{
    "srcChainId": 8453,
    "destChainId": 8453,
    "account": "0xYourWallet",
    "srcToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "destToken": "0xd0b53D9277642d899DF5C87A3966A349A798F224",
    "amount": "100000000",
    "recipient": "0xYourWallet",
    "refundee": "0xYourWallet",
    "slippage": 1
  }'

curl -X POST https://zap.dzap.io/v1/buildTx \
  -H "Content-Type: application/json" \
  -d '{
    "srcChainId": 8453,
    "destChainId": 8453,
    "account": "0xYourWallet",
    "srcToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "destToken": "0xd0b53D9277642d899DF5C87A3966A349A798F224",
    "amount": "100000000",
    "recipient": "0xYourWallet",
    "refundee": "0xYourWallet",
    "slippage": 1
  }'

curl "https://zap.dzap.io/v1/status?chainId=8453&txnHash=0xabc..."

Approve the quote’s approvalData[0].approveTo for the USDC before building, since the build checks the allowance. Then send the build’s steps[0].data (callTo, callData, value) from your wallet. Full reference: Quote, Build Tx, Status.

curl -X POST https://zap.dzap.io/v1/quote \
  -H "Content-Type: application/json" \
  -d '{
    "srcChainId": 7565164,
    "destChainId": 7565164,
    "account": "YourSolanaWallet",
    "srcToken": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "destToken": "9BEcn9aPEmhSPbPQeFGjidRiEKki46fVQDyPpSQXPA2D",
    "amount": "100000000",
    "recipient": "YourSolanaWallet",
    "refundee": "YourSolanaWallet",
    "slippage": 1
  }'

curl -X POST https://zap.dzap.io/v1/buildTx \
  -H "Content-Type: application/json" \
  -d '{
    "srcChainId": 7565164,
    "destChainId": 7565164,
    "account": "YourSolanaWallet",
    "srcToken": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "destToken": "9BEcn9aPEmhSPbPQeFGjidRiEKki46fVQDyPpSQXPA2D",
    "amount": "100000000",
    "recipient": "YourSolanaWallet",
    "refundee": "YourSolanaWallet",
    "slippage": 1
  }'

curl "https://zap.dzap.io/v1/status?chainId=7565164&txnHash=<signature>"

The build returns the transaction base64-encoded in steps[0].data.data[0]; sign it and send it through your own Solana RPC, then query status by its signature. Full reference: Quote, Build Tx, Status.

What can go wrong

buildZapTxn throws Execution reverted: the build checks the deposit against your wallet, so the USDC and the allowance must be in place first. The error response’s message has the revert reason.
Only a swap, no deposit: destToken was a plain token rather than a position. quote.path ends with a deposit step when it’s right.
Some of the USDC comes back: the deposit takes only what fits the position’s price range when it executes and returns the rest. The default range is narrow, so a small price move can leave a large share behind; a wider poolDetails range keeps more of it in the position.
Several Solana transactions: some Solana routes return two or more transactions with isJitoTx: true, which have to land together as a Jito bundle. The SDK can’t submit bundles yet, so the code here covers single-transaction routes like Jupiter Lend.
Blockhash not found on Solana: the transaction expired before you sent it. Build and sign again right away.
Not completed: no status: DZap never returned a status, usually because the transaction failed on-chain. On Solana, query by the signature; the build’s txnId returns Failed to process transaction.
HTTP 429: the zap API allows 60 requests a minute.

See Error codes for the full catalog.

​Setup

​Steps

​End-to-end

​API usage

​What can go wrong

Setup

Steps

End-to-end

API usage

What can go wrong