Deposits & Withdrawals

Quote and execute deposits and withdrawals. Cross-chain routing is handled automatically.

Deposits

Discover chains and tokens

Find which chains and tokens are available for deposits.

Frontend
Server

const chains = await sdk.discover.depositChains();
const tokens = await sdk.discover.depositTokens(8453);

const usdc = tokens.find((t) => t.symbol === "USDC")!;

depositTokens includes wallet balances when the user is signed in.

const chains = await sdk.discover.depositChains();
const tokens = await sdk.discover.depositTokens(8453);

const usdc = tokens.find((t) => t.symbol === "USDC")!;

Quoting a deposit

Frontend
Server

import { parseAmount } from "@blend-money/fe";

const quote = await sdk.quoteDeposit({
  chainId: 8453,
  tokenAddress: usdc.address,
  amount: parseAmount("100", usdc.decimals),
  externalRef: "order-123",
});

The frontend SDK uses tokenAddress. It creates a session automatically.

import { parseAmount } from "@blend-money/node";

const client = sdk.forAccount("acc_abc123");
const session = await client.sessions.createSession();

const quoted = await client.sessions.quoteDeposit(session.intentId, {
  chainId: 8453,
  inputAssetAddress: usdc.address,
  eoa: "0x1234...abcd",
  amount: parseAmount("100", usdc.decimals),
});

The server SDK uses inputAssetAddress. You create and manage sessions manually.

The deposit quote tells you what the user sends and receives:

Field	Type	Description
`intentId`	`string`	Session ID
`input`	`object`	Symbol, amount, and USD value the user sends
`output`	`object`	Symbol, amount, and USD value arriving in the vault
`fees.totalUsd`	`string`	Total fees in USD
`estimatedSeconds`	`number`	Estimated time to settlement
`expiresAt`	`string`	When this quote expires

Executing a deposit

Frontend
Server

const result = await sdk.execute(quote, {
  signerAddress: walletClient.account.address,
  deriveSigner: async (chainId) => ({
    signer: getWalletClient({ chainId }),
    publicClient: getPublicClient({ chainId }),
  }),
  onStatusChange: (status) => console.log(status),
});

const result = await client.sessions.execute(session.intentId, {
  signerAddress: "0x1234...abcd",
  submitActionPlan: async (plan) => {
    const hash = await executeOnChain(plan);
    return [{ hash, chainId: plan.chainId }];
  },
});

Re-quoting the same session

Call quoteDeposit() again on an open session to update prices. The session stays the same. Don’t create a new session for price refreshes.

Frontend
Server

// Same session, fresh prices
const freshQuote = await sdk.quoteDeposit({
  chainId: 8453,
  tokenAddress: usdc.address,
  amount: parseAmount("200", usdc.decimals),
});

const freshQuote = await client.sessions.quoteDeposit(session.intentId, {
  chainId: 8453,
  inputAssetAddress: usdc.address,
  eoa: "0x1234...abcd",
  amount: parseAmount("200", usdc.decimals),
});

To switch tokens or chains, pass forceReset: true. This cancels the existing session and creates a new one.

Withdrawals

Discover destinations

Find which chains accept withdrawals and which loan token the user will receive.

const destinations = await sdk.discover.withdrawDestinations();
// [{ chainId: 8453, name: "Base", loanTokenAddress: "0x..." }]

Quoting a withdrawal

Frontend
Server

const quote = await sdk.quoteWithdraw({
  destinationChainId: 8453,
  amount: parseAmount("50", 6),
});

For a full exit:

const quote = await sdk.quoteWithdraw({
  destinationChainId: 8453,
  amount: "0",
  isMaxWithdraw: true,
});

const session = await client.sessions.createSession();

const quoted = await client.sessions.quoteWithdraw(session.intentId, {
  destinationChainId: 8453,
  amount: parseAmount("50", 6),
});

The withdrawal quote tells you where funds are pulled from:

Field	Type	Description
`intentId`	`string`	Session ID
`totalAmount`	`string`	Total withdrawal in loan token smallest units
`totalFeesUsd`	`string`	Total fees in USD
`estimatedSeconds`	`number`	Estimated time to settlement
`sourceChainIds`	`number[]`	Which chains Blend pulls funds from
`sourceChainCount`	`number`	Number of source chains

Executing a withdrawal

Withdrawals may span multiple chains. The SDK handles multi-chain signing automatically.

Frontend
Server

const result = await sdk.execute(quote, {
  signerAddress: walletClient.account.address,
  deriveSigner: async (chainId) => ({
    signer: getWalletClient({ chainId }),
    publicClient: getPublicClient({ chainId }),
  }),
});

deriveSigner is called once per source chain. Handle wallet chain-switching inside the callback.

Withdrawals produce multiple action plans (one per source chain). Execute each plan and collect all hashes.

const result = await client.sessions.execute(session.intentId, {
  signerAddress: "0x1234...abcd",
  submitActionPlan: async (plan) => {
    const hash = await executeOnChain(plan);
    return [{ hash, chainId: plan.chainId }];
  },
});

Flow plan conflicts

If a rebalance is in progress, withdrawal quoting returns a 409 with error code FLOWPLAN_CONFLICT. Show a “try again shortly” message to your user. Don’t auto-retry - wait for the rebalance to finish.

Cross-chain

Blend routes deposits and withdrawals across chains automatically using the Relay bridge.

Bridge adapters

Adapter	Protocol	When it’s used
Across	Across Protocol	Primary bridge for cross-chain transfers. Fast finality.
CCTP	Circle CCTP	Native USDC bridging between supported chains. No wrapped tokens.

The SDK picks the best adapter based on the token and route. You don’t need to choose.

Safe address determinism

Safe addresses are deterministic. The same wallet address produces the same Safe address on every chain. This means cross-chain deposits route to the correct Safe automatically, even if the Safe hasn’t been deployed on the destination chain yet.

liquidityReset as delegateCall

During withdrawals, the liquidityReset step flushes vault positions back to the loan token. This step runs as a delegateCall through the Safe (the only step that does). The isDelegateCall: true flag in the action plan’s transaction marks it.

Testing

Test these scenarios before going to production:

Scenario	How to test	Expected result
Same-chain deposit	Deposit USDC on Base to a Base-native vault	Single action plan, fast settlement
Cross-chain deposit	Deposit USDC on Ethereum to a Base vault	Bridge routing, longer settlement
Partial withdrawal	Withdraw 50% of balance	Funds pulled from fewest chains possible
Full withdrawal	`isMaxWithdraw: true`	All positions closed across all chains
Quote expiration	Wait past `expiresAt`	Re-quote required, same session ID
Flow plan conflict	Withdraw during an active rebalance	`409` with `FLOWPLAN_CONFLICT`

What to watch out for

Don’t use forceReset: true to update prices. Call quoteDeposit() or quoteWithdraw() on the existing session. forceReset cancels the session and starts fresh - use it only when switching tokens or chains. Don’t auto-retry on FLOWPLAN_CONFLICT. The rebalance needs to finish first. Show a message and let the user try again. Don’t assume single-chain for withdrawals. Funds may be spread across chains. Your deriveSigner (frontend) or submitActionPlan (server) callback must handle multiple chains. Don’t skip the amount field when using isMaxWithdraw: true. Pass "0" as the amount.

Frontend SDK

Frontend configuration, auth, and execution details.

Server SDK

Server configuration, account management, and session lifecycle.

SDK Reference

Error codes, types, and utility functions.

Best Practices

Production patterns for session management and error recovery.

Getting Started

Portal Guide

SDK

Going Deeper

Deposits & Withdrawals

Deposits

Discover chains and tokens

Quoting a deposit

Executing a deposit

Re-quoting the same session

Withdrawals

Discover destinations

Quoting a withdrawal

Executing a withdrawal

Flow plan conflicts

Cross-chain

Bridge adapters

Safe address determinism

liquidityReset as delegateCall

Testing

What to watch out for

Frontend SDK

Server SDK

SDK Reference

Best Practices

Getting Started

Portal Guide

SDK

Going Deeper

Documentation Index

​Deposits

​Discover chains and tokens

​Quoting a deposit

​Executing a deposit

​Re-quoting the same session

​Withdrawals

​Discover destinations

​Quoting a withdrawal

​Executing a withdrawal

​Flow plan conflicts

​Cross-chain

​Bridge adapters

​Safe address determinism

​liquidityReset as delegateCall

​Testing

​What to watch out for

Frontend SDK

Server SDK

SDK Reference

Best Practices

Deposits

Discover chains and tokens

Quoting a deposit

Executing a deposit

Re-quoting the same session

Withdrawals

Discover destinations

Quoting a withdrawal

Executing a withdrawal

Flow plan conflicts

Cross-chain

Bridge adapters

Safe address determinism

liquidityReset as delegateCall

Testing

What to watch out for