DZapClient - DZap

DZapClient is a singleton, one instance per app. All SDK calls flow through it.

Get an instance

import { DZapClient } from '@dzapio/sdk';

const dzap = DZapClient.getInstance();
// Or with API key + custom RPCs:
const dzap = DZapClient.getInstance('dzap_...', {
  42161: ['https://arbitrum.llamarpc.com'],
});

getInstance() returns the same singleton across calls. The first call wins for apiKey and rpcUrlsByChainId, subsequent calls reuse those.

Public methods

Group	Methods
Trade	`getTradeQuotes`, `buildTradeTxn`, `trade`, `tradeGasless`, `getTradeTxnStatus`, `getTradeMultiTxnStatus`, `broadcastTradeTx`
Zap (Fuse)	`getZapQuote`, `buildZapTxn`, `zap`, `getZapTxnStatus`, `getZapBundleQuote`, `buildZapBundleTx`, `broadcastZapTx`, `getZapPositions`, `getZapPools`, `getZapPoolDetails`, `getZapChains`, `getZapProviders`
Tokens	`getAllTokens`, `getTokenDetails`, `getTokensDetails`, `getTokenPrices`, `getBalances`
Approvals	`getAllowance`, `approve`, `sign`
Chain	`getAllSupportedChains`, `getDZapContractAddress`
Misc	`sendTransaction`, `sendBatchCalls`, `waitForBatchTransactionReceipt`, `decodeTxnData`, `calculatePoints`
Static (class-level, not on an instance)	`DZapClient.getInstance()`, `DZapClient.getChainConfig()`, `DZapClient.getDZapAbi()`, `DZapClient.getOtherAbi()`

Each is documented in the dedicated pages: Trade, Zap, Approvals, Tokens & Balances, Utilities.

Errors

The SDK doesn’t throw a dedicated error class. Execution methods (trade, zap, tradeGasless, approve, sign, …) resolve (not reject) with a result object carrying status/code/errorMsg instead of throwing:

const result = await dzap.trade({ request, signer });

if (result.status !== "success") {
  console.log(result.code);      // StatusCodes, e.g. 4001 (UserRejectedRequest), 417 (SimulationFailure)
  console.log(result.errorMsg);  // human-readable message
  console.log(result.error);     // original underlying error, if any
}

Read/quote calls (getTradeQuotes, getZapQuote, getAllTokens, …) call the REST API directly and can reject with a raw Axios error on network/HTTP failure, wrap those in try/catch if you need to handle that case explicitly. See Error Codes for the full StatusCodes/TxnStatus catalog.

Last modified on July 29, 2026