Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.blend.money/llms.txt

Use this file to discover all available pages before exploring further.

The server SDK (@blend-money/node) manages accounts and sessions from your backend. It can’t execute transactions directly.

​
Quick-start flow

  1. Install @blend-money/node
  2. Create a BlendServerSdk instance with your API key
  3. Look up or create an account with sdk.lookupAccount(address)
  4. Scope operations with sdk.forAccount(accountId)
  5. Create a session, quote, and manage the lifecycle manually

​
Install

pnpm add @blend-money/fe viem

​
Configuration

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

const sdk = new BlendServerSdk({
  apiKey: process.env.BLEND_API_KEY!,
  accountTypeId: "savings-usd",
});
FieldTypeRequiredDescription
apiKeystringYesServer secret (sk_live_). Never expose in client code.
accountTypeIdstringYesThe account type (product) to operate on
baseUrlstringNoBlend API base URL. Defaults to production.
fiatCurrencystringNoISO 4217 code (e.g. "EUR"). Adds this currency to monetary responses.
timeoutMsnumberNoRequest timeout in milliseconds. Default: 15000.
retriesnumberNoMax retries for 429 and 5xx. Default: 3.

​
Account management

​
lookupAccount

Finds an account by wallet address. Returns the account ID, Safe address, and deployed chains. 
const account = await sdk.lookupAccount("0x1234...abcd");
// account.accountId      -> "acc_..."
// account.safeAddress    -> "0x5678..."
// account.chainsDeployed -> [8453]
Returns a SafeAccountResponse:
FieldTypeDescription
accountIdstringBlend account ID
safeAddressstringDeterministic Safe address
chainsDeployednumber[]Chains where the Safe is live

​
createAccount

Creates an account and deploys a Safe on a specific chain. 
const account = await sdk.createAccount("0x1234...abcd", 8453);

​
forAccount

Returns a scoped BlendClient for a specific account. The client has discover, account, and sessions modules. 
const client = sdk.forAccount("acc_abc123");
All session and account operations go through this scoped client.

​
Session lifecycle

The server SDK cannot execute transactions directly. You must extract the action plan from the session, execute on-chain with your own signer, and then submit the transaction hashes back.

​
createSession

Creates or retrieves an active session for the scoped account. 
const client = sdk.forAccount("acc_abc123");

const session = await client.sessions.createSession({
  externalRef: "order-456",
});

​
quoteDeposit

Quotes a deposit on an open session. Uses inputAssetAddress (not tokenAddress). 
const session = await client.sessions.quoteDeposit(intentId, {
  chainId: 8453,
  inputAssetAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  eoa: "0x1234...abcd",
  amount: "100000000",
});
ParameterTypeRequiredDescription
chainIdnumberYesOrigin chain ID
inputAssetAddressstringYesToken contract on the origin chain
eoastringYesThe wallet address holding the tokens
amountstringYesSmallest unit, non-negative integer string

​
quoteWithdraw

Quotes a withdrawal on an open session. 
const session = await client.sessions.quoteWithdraw(intentId, {
  destinationChainId: 8453,
  amount: "50000000",
  isMaxWithdraw: false,
});

​
lock

Locks the session with a signer address. Transitions from OPEN to LOCKED. 
const session = await client.sessions.lock(intentId, {
  signerAddress: "0x1234...abcd",
});

​
submit

Submits transaction hashes after on-chain execution. Transitions from LOCKED to SUBMITTED. 
const session = await client.sessions.submit(intentId, {
  txHashes: [{ hash: "0xabc...", chainId: 8453 }],
});

​
cancel

Cancels a session from any non-terminal state. 
const session = await client.sessions.cancel(intentId);

​
get / list

Retrieve a session by ID or list sessions. 
const session = await client.sessions.get(intentId);

const active = await client.sessions.list({ status: "OPEN" });

​
execute

High-level orchestrator that handles lock, on-chain execution, submit, and polling. You provide the submitActionPlan callback. 
const result = await client.sessions.execute(intentId, {
  signerAddress: "0x1234...abcd",
  submitActionPlan: async (plan) => {
    // Execute on-chain with your backend signer
    const hash = await executeOnChain(plan);
    return [{ hash, chainId: plan.chainId }];
  },
  onStatusChange: (status) => console.log(status),
  pollIntervalMs: 3000,
  pollTimeoutMs: 300000,
});
ParameterTypeRequiredDescription
signerAddressstringYesEOA hex address
submitActionPlan(plan: ActionPlan) => Promise<Array<{ hash: string; chainId: number }>>YesYour on-chain execution callback
onStatusChange(status: SessionStatus) => voidNoCalled on each status transition
pollIntervalMsnumberNoPolling interval. Default: 3000.
pollTimeoutMsnumberNoMax polling time. Default: 300000 (5 min).

​
Action plans

Action plans bridge quotes and on-chain execution. Use these utilities to convert API responses into executable plans. 
import {
  depositQuoteToActionPlan,
  withdrawCalldataToActionPlans,
  combineActionPlans,
} from "@blend-money/core";

​
depositQuoteToActionPlan

Converts a raw deposit API response to a single ActionPlan with deployType: "direct". 
const plan = depositQuoteToActionPlan(session.payload, eoa);

​
withdrawCalldataToActionPlans

Converts a raw withdrawal API response to an ActionPlan[] (one per source chain) with deployType: "multisend". 
const plans = withdrawCalldataToActionPlans(session.payload);

​
combineActionPlans

Merges plans on the same chainId. "multisend" takes priority over "direct". 
const merged = combineActionPlans(plans);

​
Discovery

Available on the SDK instance without account scoping. 
const chains = await sdk.discover.depositChains();
const tokens = await sdk.discover.depositTokens(8453);
const destinations = await sdk.discover.withdrawDestinations();
const yieldData = await sdk.discover.yield();
See SDK Reference for response shapes.

​
Account data

Available on the scoped client after forAccount(). 
const client = sdk.forAccount("acc_abc123");

const balance = await client.account.balance();
const history = await client.account.balanceHistory();
const positions = await client.account.positions();
const returns = await client.account.returns();
See SDK Reference for response shapes.

​
What to watch out for

Don’t try to call sdk.execute() on the BlendServerSdk instance. The server SDK has no built-in transaction execution. Use client.sessions.execute() with a submitActionPlan callback, or manage the lock/submit lifecycle manually. Don’t expose your API key (sk_live_) in client code, logs, or version control. It grants full access to your organization’s accounts. Don’t skip forAccount(). Account-scoped operations like sessions and balances require a scoped client. Calling them on the root SDK will fail. Don’t forget that quoteDeposit uses inputAssetAddress on the server, not tokenAddress. The frontend SDK uses tokenAddress - the signatures differ.

Deposits & Withdrawals

Full deposit and withdrawal flows with cross-chain routing.

SDK Reference

Auth, accounts, balances, error codes, and types.
Last modified on May 7, 2026