Exit a blockchain completely - transfer 100% of your native gas balance via EIP-7702
ZeroDust is an intent-based exit system that enables users to sweep their entire native gas token balance to exactly zero via EIP-7702 sponsored execution.
Agents accumulate dust as a byproduct of existing. Anything doing multi-chain work — arbitrage, bridging, testing, deployment — ends up with stranded gas on chains it will never touch again. A human notices and shrugs; an unattended agent leaks capital indefinitely.
The hosted MCP server needs nothing installed. Point any MCP client at:
https://api.zerodust.xyz/mcp
That is enough to find out whether an address has anything stranded and what recovering it would cost. It is read-only, because it holds no keys.
{
"mcpServers": {
"zerodust": {
"command": "npx",
"args": ["@zerodust/mcp-server"],
"env": {
"ZERODUST_ALLOW_EXECUTE": "true",
"ZERODUST_SIGNER_MODULE": "./my-signer.mjs"
}
}
}
}Read-only by default. Sweeping needs the explicit opt-in above plus a signing key, and there are four ways to supply one so a raw key never has to sit in a config file:
| Variable | Key lives in |
|---|---|
ZERODUST_SIGNER_MODULE |
your custody provider — any module returning a viem LocalAccount, which is what Turnkey, Privy and KMS adapters produce |
ZERODUST_KEYSTORE_FILE |
an encrypted V3 keystore, with the password in a separate file |
ZERODUST_PRIVATE_KEY_FILE |
a file on disk, not in the config |
ZERODUST_PRIVATE_KEY |
the config (simplest, least private) |
Funds can only go to the agent's own address unless
ZERODUST_ALLOWED_DESTINATIONS says otherwise — so a prompt-injected agent still
cannot send funds somewhere you never approved.
Every sweep tool and every SDK sweep accepts dryRun. It fetches a real quote,
produces all three real signatures, and stops before submitting. Nothing is
broadcast and no balance moves:
"Do a dry run of sweeping my Arbitrum balance to Base"
There is deliberately no testnet mode: the API serves no testnet chains, so a
testnet flag would only return empty chain lists and failing quotes. dryRun
gives the same confidence against production.
The read-only tools work with no credential at all. For higher limits an agent
can issue itself a key with no human in the loop, via the zerodust_register_api_key
tool or directly:
curl -X POST https://api.zerodust.xyz/agent/register \
-H "Content-Type: application/json" \
-d '{"name": "my-agent", "agentId": "my-agent-1"}'
# -> { "apiKey": "zd_...", "rateLimits": { "perMinute": 300, "daily": 1000 } }| Package | Use |
|---|---|
@zerodust/mcp-server |
MCP (Claude Code, Claude Desktop, any MCP client) |
@zerodust/sdk |
TypeScript, direct — createAgentFromPrivateKey |
@zerodust/langchain |
LangChain tools |
@zerodust/ai-sdk |
Vercel AI SDK tools |
Verified on mainnet (2026-07-21): Optimism → Base, source balance to exactly
0, delegation auto-revoked, 99.88% delivered, 23.2s end to end —
0x19456ea8….
Note on wallets: the browser UI needs the non-standard
wallet_signAuthorizationRPC, which no shipping wallet exposes yet (MetaMask #7836, Rabby #3411). Agents are unaffected — they hold their own keys and sign locally.
When users want to fully exit a blockchain, they face an impossible situation:
User has: 0.0008 ETH on Arbitrum
User wants: 0 ETH on Arbitrum (transfer everything to Base)
The Problem:
├── To send ETH, you need ETH for gas
├── If you send all your ETH, you can't pay gas
├── If you keep gas, you can't send all your ETH
└── Result: Small amount always stranded
ZeroDust is the only solution that enables complete chain exits for native gas tokens.
- User connects wallet to ZeroDust
- User selects source chain and destination (same-chain or cross-chain)
- User signs ONE authorization (no gas needed)
- ZeroDust sponsor executes the sweep
- User receives funds on destination
- Origin chain balance: EXACTLY ZERO
| Case | Description | Example |
|---|---|---|
| Cross-chain, same address | Exit to yourself on another chain | Arbitrum → Base (same wallet) |
| Cross-chain, different address | Exit to another wallet on another chain | Arbitrum → Base (different wallet) |
| Same-chain, different address | Consolidate to another wallet | Arbitrum → Arbitrum (different wallet) |
Post-Condition (enforced on-chain): Source balance = exactly 0 wei
Contract Address (same on all chains): 0x3732398281d0606aCB7EC1D490dFB0591BE4c4f2
The contract is deployed on 26 mainnets. 25 of those are live in the API — Apechain (33139) is deployed but disabled, because it turned out not to support EIP-7702.
| Chain | ID | Token | Chain | ID | Token |
|---|---|---|---|---|---|
| Ethereum | 1 | ETH | Mantle | 5000 | MNT |
| Optimism | 10 | ETH | Superseed | 5330 | ETH |
| BNB Chain | 56 | BNB | Base | 8453 | ETH |
| Gnosis | 100 | xDAI | Plasma | 9745 | XPL |
| Unichain | 130 | ETH | Mode | 34443 | ETH |
| Polygon | 137 | POL | Arbitrum | 42161 | ETH |
| Sonic | 146 | S | Celo | 42220 | CELO |
| X Layer | 196 | OKB | Ink | 57073 | ETH |
| Fraxtal | 252 | FRAX | BOB | 60808 | ETH |
| World Chain | 480 | ETH | Berachain | 80094 | BERA |
| Sei | 1329 | SEI | Scroll | 534352 | ETH |
| Story | 1514 | IP | Zora | 7777777 | ETH |
| Soneium | 1868 | ETH |
This table is generated from the live API, which is the only authoritative answer to what an integration can actually use:
node scripts/generate-chain-docs.mjs # regenerate
node scripts/generate-chain-docs.mjs --check # fail if a doc has drifted
curl https://api.zerodust.xyz/chains # the source of truthPlease do not hand-edit it. Earlier versions of this table claimed 26 live chains and named 1514 "Astar zkEVM", 5330 "Kaia" and 57073 "Redstone" — three chains that are not the ones deployed there. An agent that acts on a wrong chain name gets an error and reasonably concludes the service is broken.
The contract is also on 46 testnets, but the API serves no testnet chains, so
there is no testnet environment to integrate against. Use the dryRun option in
the SDK or the MCP server to exercise the full flow without moving funds.
See contracts/README.md for explorer links.
zerodust/
├── contracts/ # Smart contracts (Foundry)
│ ├── src/
│ │ ├── ZeroDustSweepMainnet.sol # Production contract
│ │ └── ZeroDustSweepTEST.sol # Testnet contract
│ ├── script/
│ │ └── DeployMainnet.s.sol # Mainnet deployment (CREATE2)
│ └── broadcast/ # Deployment logs
└── docs/
┌─────────────────────────────────────────────────────────────┐
│ User's EOA │
│ (EIP-7702 delegated) │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ ZeroDustSweepMainnet (bytecode) │ │
│ │ │ │
│ │ executeSweep(intent, sig) │ │
│ │ │ │ │
│ │ ┌────────────┴────────────┐ │ │
│ │ ▼ ▼ │ │
│ │ MODE_TRANSFER (0) MODE_CALL (1) │ │
│ │ Same-chain sweep Cross-chain sweep │ │
│ │ │ │ │ │
│ │ ▼ ▼ │ │
│ │ Transfer to Call bridge target │ │
│ │ destination (callTarget + callData) │ │
│ │ │ │ │
│ └─────────────────────────────────────┼────────────────┘ │
│ │ │
└────────────────────────────────────────┼─────────────────────┘
│
▼
┌─────────────────────────┐
│ External Bridge │
│ (Gas.zip) │
│ │
│ Delivers funds on │
│ destination chain │
└─────────────────────────┘
- No admin functions - Immutable after deployment
- No upgradability - What you see is what you get
- Unified SweepIntent - Single signed structure for all sweep types
- Zero balance enforcement - Contract reverts if any balance remains
- ERC-7201 storage - Prevents slot collisions with other EIP-7702 apps
- Immutable sponsors - Stored in bytecode, not storage
Service Fee: 1% of swept value, with $0.05 minimum and $0.50 maximum.
Total Fee = Gas Reimbursement + Service Fee + Bridge Fee (if cross-chain)
Examples:
- $5 balance → $0.05 fee (1% = $0.05, at min) → User receives ~$4.95
- $10 balance → $0.10 fee (1%) → User receives ~$9.90
- $60 balance → $0.50 fee (max) → User receives ~$59.50
- contracts/README.md - Contract details and deployment
- contracts/SPECIFICATION.md - Technical specification
- contracts/DEPLOYMENT.md - Deployment guide
ZeroDust is designed with security as the top priority:
- No fund custody - All operations are atomic, single-transaction
- User-controlled limits - maxTotalFeeWei and minReceive signed by user
- Mandatory simulation - Every transaction simulated before execution
- routeHash binding - Signature bound to specific bridge route (cross-chain)
- Internal security review - 7 rounds, 16 issues identified and fixed
- External audit - Pending (required before full launch)
Smart Contract: Deployed on 26 mainnets + 46 testnets. 25 mainnets are enabled in the API; the API serves no testnets.
| Contract | Status | Features |
|---|---|---|
| ZeroDustSweepMainnet | Production | Unified SweepIntent, granular fees, sponsor model |
| ZeroDustSweepTEST | Testnet | Same as mainnet, for testing |
| Chain | Swept | TX |
|---|---|---|
| Base | $3.46 → 0 | View |
| Arbitrum | $3.57 → 0 | View |
| BSC | $2.25 → 0 | View |
| Polygon | $7.55 → 0 | View |
See contracts/README.md for full deployment list.
The following testnets were tested and do not support EIP-7702:
Abstract, Lens, zkSync, Taiko, opBNB, Avalanche, Swell, Cyber, Boba, Metis, Fuse, Aurora, Flare, Vana, Corn, Rootstock, Apechain, IoTeX, Viction, XDC, Telos, Kava, EDU Chain, Gravity, Manta Pacific, Lightlink, Moonbase, Nibiru, Somnia, Rari, Blast, Xai, B3, Mezo, Chiliz, HashKey, Memecore
Note: Mainnet support may differ from testnet.
ZeroDust supports cross-chain sweeps via the MODE_CALL pattern:
- callTarget: Bridge contract address
- callData: Bridge-specific transaction data
- routeHash:
keccak256(callData)- binds signature to specific route
Primary Bridge: Gas.zip - 239+ chains, ~5 second delivery
MIT License - see LICENSE
Live on 25 mainnet chains. Contract: 0x3732398281d0606aCB7EC1D490dFB0591BE4c4f2
(same address on every chain, via CREATE2).