Trade Build & Execute Types - DZap

Types used with buildTradeTxn and trade. Import from @dzapio/sdk.

TradeBuildTxnRequest

type TradeBuildTxnRequest = {
  sender: HexString;
  refundee: HexString;
  fromChain: number;
  gasless: boolean;
  private?: boolean;
  disableEstimation?: boolean;
  data: TradeBuildTxnRequestData[];
  hasPermit2ApprovalForAllTokens?: boolean;
  publicKey?: string; // Bitcoin chains only
};

TradeBuildTxnRequestData

type TradeBuildTxnRequestData = {
  amount: string;
  srcToken: string;
  srcDecimals?: number;
  destToken: string;
  destDecimals?: number;
  toChain: number;
  protocol: string;   // from quote recommendedSource or bestReturnSource
  recipient: string;
  slippage: number;
  additionalInfo?: AdditionalInfo;
  permitData?: string;
};

TradeBuildTxnResponse (buildTradeTxn / build response, non-gasless)

Returned by buildTradeTxn(request) (when gasless: false) and passed as txnData to trade(). transaction is the chain-specific payload; several fields are also mirrored at the top level for backwards compatibility (@deprecated, EVM-only):

type TradeBuildTxnResponse = {
  status: "success";
  txId: string;        // Build/transaction ID
  chainId: number;
  transaction: EvmTxData | SvmTxData | BtcTxData | BtclnTxData | HyperLiquidTxData;
  gasless: false;
  private: boolean;
  quotes: Record<string, ParamQuotes>;

  // @deprecated top-level mirror of transaction, EVM only:
  data: string;
  from: string;
  to?: string;
  value?: string;
  gasLimit?: string;

  svmTxData?: { blockhash: string; lastValidBlockHeight: number };
  btcTxData?: { inputs: PsbtInput[]; outputs: PsbtOutput[]; feeRate: number };
  btclnTxData?: { paymentRequestType: "bolt11"; paymentRequest: string; paymentExpiry: number };
  additionalInfo: Record<string, Record<string, unknown>>;
  updatedQuotes: Record<string, string>;
};

type EvmTxData = { from: HexString; data: HexString; to: HexString; value: string; gasLimit: string };

type ParamQuotes = {
  additionalInfo?: Record<string, unknown>;
  destAmount: string;
  provider: string;
  minDestAmount: string;
  priceImpact?: string | null;
  duration?: string;
};

When gasless: true is requested instead, the response is a GaslessTradeBuildTxnResponse:

type GaslessTradeBuildTxnResponse = {
  status: "success";
  txId: HexString;
  transaction: BridgeGaslessTxData | SwapGaslessTxData;
  quotes: Record<string, ParamQuotes>;
  gasless: true;
  onlySwapData: false;
};

DZapTransactionResponse (trade / zap execution result)

type DZapTransactionResponse = {
  status: TxnStatus;
  errorMsg?: string;
  code: StatusCodes | number;
  action?: "TRY_ANOTHER_ROUTE" | "INCREASE_SLIPPAGE" | "INCREASE_ALLOWANCE";
  txnHash?: HexString;
  error?: unknown;
  additionalInfo?: Record<string, unknown>;
  updatedQuotes?: Record<string, string>;
};

Next steps

Last modified on July 29, 2026