ZeroDust - Chain Exit Infrastructure

ZeroDust sweeps 100% of native gas tokens from EVM chains, leaving exactly zero balance. It uses EIP-7702 sponsored execution so users never pay gas directly.

When to Use This Skill

• User says "sweep", "dust", "exit chain", "consolidate", "clean up wallet", "move everything"
• User has small native token balances scattered across chains
• User wants to fully exit a blockchain (balance goes to exactly 0)
• Agent needs to consolidate funds from multiple chains to one

How It Works

1. Check balances across 25 supported chains
2. Get a quote with fee breakdown
3. User signs EIP-7702 authorization + EIP-712 sweep intent (2 signatures)
4. ZeroDust executes the sweep - user receives funds on destination chain

The user never pays gas. ZeroDust's sponsor pays gas and is reimbursed from the swept amount.

Integration Options

Choose based on your context:

Quick Start: TypeScript SDK

import { ZeroDustAgent } from '@zerodust/sdk';
import { privateKeyToAccount } from 'viem/accounts';

const agent = new ZeroDustAgent({
  account: privateKeyToAccount('0x...'),
  environment: 'mainnet',
});

// Check what can be swept
const balances = await agent.getSweepableBalances();

// Sweep one chain (Arbitrum -> Base)
const result = await agent.sweep({
  fromChainId: 42161,
  toChainId: 8453,
  destination: '0x...',
});

// Or sweep ALL chains to Base
const results = await agent.sweepAll({ toChainId: 8453 });

Quick Start: REST API

# 1. Check balances
curl https://api.zerodust.xyz/balances/0xYOUR_ADDRESS?testnet=false

# 2. Get quote
curl "https://api.zerodust.xyz/quote?fromChainId=42161&toChainId=8453&userAddress=0x...&destination=0x..."

# 3. Get signing data
curl -X POST https://api.zerodust.xyz/authorization \
  -H "Content-Type: application/json" \
  -d '{"quoteId": "uuid-from-step-2"}'

# 4. Submit signed sweep
curl -X POST https://api.zerodust.xyz/sweep \
  -H "Content-Type: application/json" \
  -d '{
    "quoteId": "...",
    "signature": "0x...",
    "eip7702Authorization": {...},
    "revokeAuthorization": {...}
  }'

# 5. Check status
curl https://api.zerodust.xyz/sweep/SWEEP_ID

Quick Start: MCP

ZeroDust exposes an MCP server at https://api.zerodust.xyz/mcp with these tools:

• zerodust_get_chains - List all supported chains
• zerodust_get_balances - Check native token balances across all 25 chains
• zerodust_get_quote - Get a quote for sweeping
• zerodust_get_sweep_status - Check status of a submitted sweep
• zerodust_list_sweeps - List past sweeps for an address
• zerodust_info - Service details, pricing, integration info

Agent API (Simplified)

For AI agents, there are dedicated endpoints that reduce round trips:

# Register for an API key
curl -X POST https://api.zerodust.xyz/agent/register \
  -H "Content-Type: application/json" \
  -d '{"name": "My Agent", "agentId": "agent-001"}'
# Returns: { "apiKey": "zd_..." }

# Single sweep (combines quote + auth data)
curl -X POST https://api.zerodust.xyz/agent/sweep \
  -H "Authorization: Bearer zd_..." \
  -H "Content-Type: application/json" \
  -d '{
    "fromChainId": 42161,
    "toChainId": 8453,
    "userAddress": "0x...",
    "destination": "0x..."
  }'

# Batch sweep (multiple chains at once)
curl -X POST https://api.zerodust.xyz/agent/batch-sweep \
  -H "Authorization: Bearer zd_..." \
  -H "Content-Type: application/json" \
  -d '{
    "sweeps": [
      {"fromChainId": 42161},
      {"fromChainId": 10},
      {"fromChainId": 137}
    ],
    "destination": "0x...",
    "consolidateToChainId": 8453
  }'

Supported Chains (25 Mainnet)

All chains support cross-chain sweeps to any other chain via Gas.zip (650 routes).

Pricing

Gas costs (~1-3%) are included and paid by ZeroDust's sponsor, reimbursed from the sweep.

Sweep Flow Details

For the complete API reference with all endpoints, request/response schemas, and error codes, see references/API.md.

For SDK usage patterns including the Agent module, see references/SDK.md.

Key Constraints

• Native tokens only - ETH, BNB, MATIC, etc. Not ERC-20 tokens.
• Sweep-all only - Always sweeps 100% of balance. No partial sweeps.
• EIP-7702 required - Only works on chains that support EIP-7702.
• Minimum balance - Each chain has a minimum sweepable balance (covers fees).
• Quote expires in 55 seconds - Must sign and submit quickly.

Contract

Mainnet address (same on all 25 chains via CREATE2):

0x3732398281d0606aCB7EC1D490dFB0591BE4c4f2

Links

• Website: https://zerodust.xyz
• API Docs: https://api.zerodust.xyz/docs
• MCP Server: https://api.zerodust.xyz/mcp
• ERC-8004 Agent: https://www.8004scan.io/agents/base/1435
• GitHub: https://github.com/andresdefi