ZeroDust - Chain Exit Infrastructure

Paused. ZeroDust's agent interface is paused: the hosted MCP endpoint and agent API keys are switched off and the agent packages are deprecated on npm. The public API, the SDK and the local MCP server still work with your own key; for people, the place to sweep is https://zerodust.xyz.

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 the 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 });

Prove it before moving anything. Pass dryRun: true to run the whole flow - real quote, real EIP-712 typed data, all three real signatures - and stop before submitting. Nothing is broadcast and no balance changes.

const check = await agent.sweep(
  { fromChainId: 42161, toChainId: 8453 },
  { dryRun: true }
);
check.dryRun;                  // true
check.sweepId;                 // undefined - nothing was submitted
check.quote?.estimatedReceive; // what would have arrived

There is no testnet environment (the API serves no testnet chains), so dryRun is the way to validate an integration safely.

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

Local stdio only: npx @zerodust/mcp-server (the hosted endpoint is switched off). It can sweep, because the key stays on the agent's machine.

The sweep tools accept dryRun: true, which rehearses the whole flow and moves nothing. Use it first.

Sweeping requires ZERODUST_ALLOW_EXECUTE=true plus a signing key. The key can come from a signer module returning a viem LocalAccount (Turnkey, Privy, KMS), an encrypted V3 keystore, a key file, or ZERODUST_PRIVATE_KEY inline. Funds can only go to the agent's own address unless ZERODUST_ALLOWED_DESTINATIONS lists more.

Supported Chains

The live list is GET https://api.zerodust.xyz/chains (the EIP-7702 chains, swept by the sponsor) and GET https://api.zerodust.xyz/direct/chains (chains without EIP-7702, swept by the wallet itself with transactions the API plans). The table is in the repository README.

Cross-chain sweeps go through Relay, Across, Stargate or Gas.zip (best output wins), to any EVM chain one of them delivers native gas to. A few chains have no bridge at times; GET /chains shows which.

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 every chain via CREATE2):

0x3732398281d0606aCB7EC1D490dFB0591BE4c4f2

Links

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