SDK Reference

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

const sdk = new BlendServerSdk({
  apiKey: process.env.BLEND_API_KEY!,
  accountTypeId: "savings-usd",
});

// Check if Safe is deployed on a chain
const result = await sdk.account.safe.resolve(8453);

// Request deployment on a new chain
await sdk.account.safe.request(8453);

const balance = await sdk.account.balance();

const history = await sdk.account.balanceHistory({
  startDate: "2025-01-01",
  endDate: "2025-03-01",
});

const positions = await sdk.account.positions();

const returns = await sdk.account.returns();

const yieldData = await sdk.discover.yield();

import { SdkError } from "@blend-money/core";

try {
  await sdk.quoteDeposit({ /* ... */ });
} catch (error) {
  if (error instanceof SdkError) {
    error.status;           // HTTP status code (0 for network)
    error.code;             // machine-readable code string
    error.message;          // human-readable description
    error.response;         // raw API response body
    error.isRetryable();    // true for 429, 5xx, network errors
    error.getUserMessage(); // user-friendly message
  }
}

import { parseAmount, formatAmount } from "@blend-money/core";

parseAmount("100.50", 6);   // "100500000"  (USDC: 6 decimals)
parseAmount("1.5", 18);     // "1500000000000000000"  (18 decimals)

formatAmount("100500000", 6);           // "100.5"
formatAmount("1500000000000000000", 18); // "1.5"

type SessionStatus = "OPEN" | "LOCKED" | "SUBMITTED" | "SETTLED" | "FAILED" | "CANCELLED";

type DepositQuote = {
  readonly type: "DEPOSIT";
  readonly intentId: string;
  readonly originChainId: number;
  readonly destinationChainId: number;
  readonly input: { readonly symbol: string; readonly amount: string; readonly amountUsd: string };
  readonly output: { readonly symbol: string; readonly amount: string; readonly amountUsd: string };
  readonly fees: { readonly totalUsd: string };
  readonly estimatedSeconds: number;
  readonly expiresAt: string;
};

type WithdrawQuote = {
  readonly type: "WITHDRAW";
  readonly intentId: string;
  readonly destinationChainId: number;
  readonly totalAmount: string;
  readonly totalFeesUsd: string;
  readonly estimatedSeconds: number;
  readonly sourceChainCount: number;
  readonly sourceChainIds: readonly number[];
  readonly expiresAt: string;
};

type ExecuteResult = {
  status: "settled" | "failed" | "cancelled";
  txHashes: Array<{ hash: string; chainId: number }>;
  settledAt: string | null;
  error: string | null;
};

type ActionPlan = {
  deployType: "direct" | "multisend";
  requiredApprovals: Txn[];
  requiredTxns: Txn[];
  chainId: number;
};

type BalanceResponse = {
  accountId: string;
  safeAddress: string;
  perChain: BalancePerChain[];
  total: FiatAmount;
  heldAssets: HeldAsset[];
};