Enums & Constants

Use these enums and constants from @dzapio/sdk to avoid typos and ensure correct values in API calls.

Services

Use with getAllowance, approve, and sign when specifying the DZap service:

import { Services } from "@dzapio/sdk";

Services.trade;  // "trade" - swaps and bridges
Services.dca;    // "dca"  - DCA operations
Services.zap;    // "zap"  - Zap operations

There is no Services.swap; use Services.trade for swap/bridge.

TxnStatus

Returned on transaction and approval results. Use for status checks:

import { TxnStatus } from "@dzapio/sdk";

TxnStatus.mining;
TxnStatus.success;
TxnStatus.rejected;
TxnStatus.error;
TxnStatus.reverted;
TxnStatus.pendingWalletConfirmation;
TxnStatus.partialSuccess;
TxnStatus.waitingForExecution;

Example: if (result.status === TxnStatus.success) { ... }

ApprovalModes

Use with getAllowance and approve (parameter name is mode, not permitType):

import { ApprovalModes } from "@dzapio/sdk";

ApprovalModes.Default;                      // Standard ERC20 approval
ApprovalModes.PermitSingle;
ApprovalModes.PermitWitnessTransferFrom;
ApprovalModes.PermitBatchWitnessTransferFrom;
ApprovalModes.AutoPermit;                   // Recommended: auto-select best

PermitTypes

Use with sign() for permit signatures (parameter name is permitType):

import { PermitTypes } from "@dzapio/sdk";

PermitTypes.PermitSingle;
PermitTypes.PermitWitnessTransferFrom;
PermitTypes.PermitBatchWitnessTransferFrom;
PermitTypes.EIP2612Permit;
PermitTypes.AutoPermit;

contractErrorActions (trade failure actions)

When a trade fails, the response may include action with one of:

// From SDK types (contractErrorActions)
"TRY_ANOTHER_ROUTE";   // Retry with bestReturnSource
"INCREASE_SLIPPAGE";   // User should increase slippage
"INCREASE_ALLOWANCE";  // Allowance issue

Handle TRY_ANOTHER_ROUTE by rebuilding the trade request with protocol: bestReturnSource and calling trade() again.

Native token address

Skip approval for the native token (e.g. ETH). Use this address for comparisons:

0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE

Filter it out before calling getAllowance or approve:

const NATIVE = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
const tokensForApproval = tokens.filter(
  (t) => t.address.toLowerCase() !== NATIVE.toLowerCase()
);

Next steps

Types reference - Request/response interfaces
Errors reference - Status codes and error handling

​Services

​TxnStatus

​ApprovalModes

​PermitTypes

​contractErrorActions (trade failure actions)

​Native token address

​Next steps