
Zerodust
io.github.andresdefiv0.5.1更新於 Oct 9, 2026
Recover stranded native gas: empty a chain's balance to exactly zero on 25 EVM chains.
概覽
讓助理查詢 EVM 鏈上滯留的原生 gas 餘額,並在明確開啟並設定簽章金鑰後將其完全清零。
- 功能
- ZeroDust 是一套以意圖為基礎的原生 gas 代幣退出服務,涵蓋多條 EVM 鏈。唯讀工具可回報某個地址是否有滯留餘額以及回收成本;清掃工具接著把全部餘額轉到代理自己的地址或已核准的收款地址,讓來源鏈餘額精確歸零。清掃支援同鏈與跨鏈,所有清掃工具都接受 dryRun 選項,可取得真實報價並產生簽章但不廣播。代理也能自行申請 API 金鑰以取得較高頻率上限。
- 適用情境
- 適合因為套利、跨鏈、測試或部署而在多條鏈上累積少量原生 gas 餘額、想整合或徹底退出這些鏈的代理或使用者。建議先連上託管的唯讀端點,確認是否真有滯留資金,再決定是否在本機安裝。
- 執行需求
- 可使用遠端端點 npx 執行本機 npm 套件 @zerodust/mcp-server。執行清掃需要設定 ZERODUST_ALLOW_EXECUTE=true,並提供下列簽章金鑰來源之一:ZERODUST_SIGNER_MODULE、ZERODUST_KEYSTORE_FILE 搭配 ZERODUST_KEYSTORE_PASSWORD_FILE 或 ZERODUST_KEYSTORE_PASSWORD、ZERODUST_PRIVATE_KEY_FILE,或 ZERODUST_PRIVATE_KEY。選用:ZERODUST_API_KEY、ZERODUST_API_URL、ZERODUST_ALLOWED_DESTINATIONS。需要連線至 API 與 EVM 鏈的網路。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Zerodust,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
其他 MCP 客戶端
把它新增到你客戶端的 mcpServers 設定中。
{
"mcpServers": {
"zerodust": {
"type": "http",
"url": "https://api.zerodust.xyz/mcp"
}
}
}README
ZeroDust
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.
For AI agents
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.
Look first, no install, no key
The hosted MCP server needs nothing installed. Point any MCP client at:
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.
Then sweep, with the key wherever you keep it
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:
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.
Try it without risking anything
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.
Agents can provision their own credentials
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:
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.
The Problem
When users want to fully exit a blockchain, they face an impossible situation:
ZeroDust is the only solution that enables complete chain exits for native gas tokens.
How It Works
- 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
Supported Sweep Cases
Post-Condition (enforced on-chain): Source balance = exactly 0 wei
Supported Chains
Contract Address (same on all chains): 0x3732398281d0606aCB7EC1D490dFB0591BE4c4f2
The contract is deployed on 52 mainnets, all live in the API. Sweeps can be sent
to any EVM chain a bridge (Gas.zip, Relay, Across) delivers native gas to, not
only these: GET /destinations?fromChainId= lists them.
Two chains are token delivery: their native coin has no gas bridge, so it arrives as that
chain's token on BNB Chain, not as gas (quotes say so in receiveToken): Mitosis (MITO, via
Hyperlane) and Endurance (ACE, via Fusionist's bridge, to the sending wallet only).
This table is generated from the live API, which is the only authoritative answer to what an integration can actually use:
Please 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.
Project Structure
Architecture
Contract Architecture
Security Model
- 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
Fee Structure
Service Fee: 1% of swept value, with $0.05 minimum and $0.50 maximum; balances under $1 pay 5% with no minimum.
Documentation
- contracts/README.md - Contract details and deployment
- contracts/SPECIFICATION.md - Technical specification
- contracts/DEPLOYMENT.md - Deployment guide
Security
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)
Status
Smart Contract: Deployed on 52 mainnets + 46 testnets. All 52 mainnets are enabled in the API; the API serves no testnets.
Contract Versions
Verified Mainnet Sweeps
See contracts/README.md for full deployment list.
Testnets NOT Supporting EIP-7702
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.
Cross-Chain Bridging
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
License
MIT License - see LICENSE
Live on 25 mainnet chains. Contract: 0x3732398281d0606aCB7EC1D490dFB0591BE4c4f2
(same address on every chain, via CREATE2).
來源:README.md,提交 b55a2b1
工具
0版本歷史
5- v0.5.1最新Oct 1, 2026
- v0.4.1Oct 1, 2026
- v0.4.0Sep 29, 2026
- v0.3.2Sep 27, 2026
- v0.3.1Sep 16, 2026

