Private - DZap

Ghost Mode routes your trade through private relays instead of the public mempool: no front-running, no copy-trading, no tipping off screeners before settlement. It is the standard bridge flow with one addition: private: true on the quote and the build.

Ghost Mode is EVM-only today. Non-EVM chains (Solana, Bitcoin, Sui) route through the public flow, private: true is ignored.

Setup

import { DZapClient, Services, ApprovalModes, TxnStatus } from '@dzapio/sdk';
import { createWalletClient, http } from 'viem';
import { arbitrum } from 'viem/chains';
import { privateKeyToAccount } from 'viem/accounts';

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const walletClient = createWalletClient({ account, chain: arbitrum, transport: http() });
const dzap = DZapClient.getInstance();

const USDC_ARB = '0xaf88d065e77c8cC2239327C5EDb3A432268e5831';
const USDC_BASE = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
const AMOUNT = '1000000000';                          // 1,000 USDC (6 decimals)

Steps

Quote

Request a private quote by setting private: true at the top level. Routing is restricted to providers that support a private mempool.

const quotes = await dzap.getTradeQuotes({
  fromChain: 42161,
  account: account.address,
  private: true,             // Ghost Mode
  data: [{
    srcToken: USDC_ARB,
    destToken: USDC_BASE,
    amount: AMOUNT,
    toChain: 8453,
    slippage: 1,
  }],
});

const pair = quotes[Object.keys(quotes)[0]];
const source = pair.recommendedSource ?? pair.bestReturnSource;

private is a top-level flag, not a per-leg one. Other quote options are in advanced quote fields.

Approve

Identical to a normal bridge: approval is on the source chain, and AutoPermit stays gasless where the token allows.

const { data } = await dzap.getAllowance({
  chainId: 42161,
  sender: account.address,
  tokens: [{ address: USDC_ARB, amount: AMOUNT }],
  service: Services.trade,
  mode: ApprovalModes.AutoPermit,
});

const entry = data[USDC_ARB];
if (entry.type !== 'eip2612' && entry.allowance < BigInt(AMOUNT)) {
  await dzap.approve({
    chainId: 42161,
    signer: walletClient,
    sender: account.address,
    tokens: [{ address: USDC_ARB, amount: AMOUNT }],
    service: Services.trade,
    mode: ApprovalModes.AutoPermit,
  });
}

Approvals are public by design: only the trade itself is routed privately. Other approval flows: Check allowance and Approval mechanisms.

Build

Carry the flag through to the build, set private: true on the request too, so the transaction is submitted through the private relay.

const request = {
  fromChain: 42161,
  sender: account.address,
  refundee: account.address,
  gasless: false,
  private: true,             // submit through the private relay
  data: [{
    srcToken: USDC_ARB,
    destToken: USDC_BASE,
    amount: AMOUNT,
    toChain: 8453,
    protocol: source,
    recipient: account.address,
    slippage: 1,
  }],
};

const result = await dzap.trade({ request, signer: walletClient });
console.log(`Sent privately: ${result.txnHash}`);

Set private on both the quote and the build. The response echoes private back so you can confirm the route was honored. Full request shape: Execute trade.

Status

Track it exactly like a normal bridge: poll to a terminal state.

const status = await dzap.getTradeTxnStatus({
  txHash: result.txnHash!,
  chainId: 42161,
});

console.log(status.status);   // PENDING → COMPLETED

Private routing can add slight latency versus the public mempool. See Track trade status for the polling helper.

End-to-end

import { DZapClient, Services, ApprovalModes, TxnStatus } from '@dzapio/sdk';
import { createWalletClient, http } from 'viem';
import { arbitrum } from 'viem/chains';
import { privateKeyToAccount } from 'viem/accounts';

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const walletClient = createWalletClient({ account, chain: arbitrum, transport: http() });
const dzap = DZapClient.getInstance();

const USDC_ARB = '0xaf88d065e77c8cC2239327C5EDb3A432268e5831';
const USDC_BASE = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
const AMOUNT = '1000000000'; // 1,000 USDC

// 1. Private quote
const quotes = await dzap.getTradeQuotes({
  fromChain: 42161,
  account: account.address,
  private: true,
  data: [{ srcToken: USDC_ARB, destToken: USDC_BASE, amount: AMOUNT, toChain: 8453, slippage: 1 }],
});
const pair = quotes[Object.keys(quotes)[0]];
const source = pair.recommendedSource ?? pair.bestReturnSource;

// 2. Approve (source chain only)
const { data } = await dzap.getAllowance({
  chainId: 42161,
  sender: account.address,
  tokens: [{ address: USDC_ARB, amount: AMOUNT }],
  service: Services.trade,
  mode: ApprovalModes.AutoPermit,
});
const entry = data[USDC_ARB];
if (entry.type !== 'eip2612' && entry.allowance < BigInt(AMOUNT)) {
  await dzap.approve({
    chainId: 42161,
    signer: walletClient,
    sender: account.address,
    tokens: [{ address: USDC_ARB, amount: AMOUNT }],
    service: Services.trade,
    mode: ApprovalModes.AutoPermit,
  });
}

// 3. Build + send privately
const request = {
  fromChain: 42161,
  sender: account.address,
  refundee: account.address,
  gasless: false,
  private: true,
  data: [{ srcToken: USDC_ARB, destToken: USDC_BASE, amount: AMOUNT, toChain: 8453, protocol: source, recipient: account.address, slippage: 1 }],
};
const result = await dzap.trade({ request, signer: walletClient });
if (result.status !== TxnStatus.success) throw new Error(result.errorMsg ?? 'private bridge failed');

// 4. Status
const status = await dzap.getTradeTxnStatus({ txHash: result.txnHash!, chainId: 42161 });
console.log('settled:', status.status);

API usage

Set "private": true on both the quote and the build; status is unchanged.

curl -X POST https://api.dzap.io/v1/quotes \
  -H "Content-Type: application/json" \
  -d '{
    "fromChain": 42161,
    "private": true,
    "data": [{
      "amount": "1000000000",
      "srcToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "destToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "toChain": 8453,
      "slippage": 1
    }],
    "account": "0xUser"
  }'

curl -X POST https://api.dzap.io/v1/buildTx \
  -H "Content-Type: application/json" \
  -d '{
    "sender": "0xUser",
    "refundee": "0xUser",
    "fromChain": 42161,
    "gasless": false,
    "private": true,
    "data": [{
      "amount": "1000000000",
      "srcToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "destToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "toChain": 8453,
      "protocol": "<recommendedSource from quote>",
      "recipient": "0xUser",
      "slippage": 1
    }]
  }'

curl "https://api.dzap.io/v1/status?txHash=0xabc...&chainId=42161"

Full reference: Quote, Build Tx, Status.

Public vs Ghost Mode

	Public Bridge	Ghost Mode
Front-run protection	Partial	Full
Settlement latency	Seconds	Slightly higher
Solver liquidity	Open	Permissioned pool
Fees	Standard	Slight premium

​Setup

​Steps

​End-to-end

​API usage

​Public vs Ghost Mode

Setup

Steps

End-to-end

API usage

Public vs Ghost Mode