ZeroDust 链上清空

ZeroDust 利用 EIP-7702 赞助执行功能，可将原生 Gas 代币余额精确清零。此功能仅适用于支持 EIP-7702 的链（并非所有 EVM 链都支持）。

何时使用此技能

当用户希望以下操作时激活：

• - 完全退出某条区块链（将所有原生代币转出）
• 清空钱包中的小额/零散余额
• 转移 100% 余额，不留任何剩余
• 完全清空钱包
• 合并来自多条链的资金

触发短语

• - 完全退出此链
• 将我在 [链名] 的所有余额转出
• 清空我的零散余额
• 清空此钱包
• 将所有资产转移到 [链名]
• 余额归零

支持的链（25 条兼容 EIP-7702 的链）

注意： Avalanche、Blast、Linea 和 Apechain 等链不支持 EIP-7702，无法进行清空操作。

API 基础 URL

https://zerodust-backend-production.up.railway.app

第一步：注册获取 API 密钥（一次性操作）

bash
curl -X POST https://zerodust-backend-production.up.railway.app/agent/register \
-H Content-Type: application/json \
-d {
name: My OpenClaw Agent,
agentId: openclaw-unique-id
}

响应：
json
{
apiKey: zd_abc123...,
keyPrefix: zd_abc12,
keyId: uuid,
keyType: agent,
rateLimits: { perMinute: 300, daily: 1000 },
message: IMPORTANT: Save your API key now - it will not be shown again!
}

将 apiKey 存储为 ZERODUSTAPIKEY 环境变量。

第二步：获取报价

在清空前检查用户余额和费用：

bash
curl https://zerodust-backend-production.up.railway.app/quote?userAddress=0xUSER&fromChainId=42161&toChainId=8453&destination=0xDEST

响应：
json
{
quoteId: uuid,
fromChainId: 42161,
toChainId: 8453,
userAddress: 0x...,
destination: 0x...,
balance: 500000000000000,
balanceFormatted: 0.0005,
estimatedReceive: 485000000000000,
estimatedReceiveFormatted: 0.000485,
totalFeeWei: 15000000000000,
serviceFeeWei: 5000000000000,
gasFeeWei: 10000000000000,
expiresAt: 2026-02-04T16:00:00Z
}

第三步：获取授权数据

获取用于签名的 EIP-712 类型化数据：

bash
curl -X POST https://zerodust-backend-production.up.railway.app/authorization \
-H Content-Type: application/json \
-d {quoteId: uuid-from-quote}

响应包含 typedData（用于清空的 EIP-712 数据）和 eip7702（委托参数）。

第四步：用户签署消息

用户需要签署：

1. 1. EIP-7702 委托授权 - 将其 EOA 委托给 ZeroDust 合约
2. EIP-7702 撤销授权 - 预先签署的撤销授权（清空后执行）
3. EIP-712 清空意图 - 授权特定的清空参数

第五步：提交清空请求

bash
curl -X POST https://zerodust-backend-production.up.railway.app/sweep \
-H Content-Type: application/json \
-d {
quoteId: uuid,
delegationSignature: 0x...,
revokeSignature: 0x...,
sweepSignature: 0x...
}

响应：
json
{
sweepId: uuid,
status: pending,
txHash: null
}

轮询 GET /sweep/{sweepId} 获取状态更新，直到 status: completed。

便捷接口：合并报价 + 授权

对于代理，使用此单一接口同时获取报价和授权数据：

bash
curl -X POST https://zerodust-backend-production.up.railway.app/agent/sweep \
-H Content-Type: application/json \
-H X-API-Key: $ZERODUSTAPIKEY \
-d {
fromChainId: 42161,
toChainId: 8453,
userAddress: 0x...,
destination: 0x...
}

批量清空（多条链）

一次请求中清空多条链：

bash
curl -X POST https://zerodust-backend-production.up.railway.app/agent/batch-sweep \
-H Content-Type: application/json \
-H X-API-Key: $ZERODUSTAPIKEY \
-d {
sweeps: [
{fromChainId: 42161},
{fromChainId: 10},
{fromChainId: 137}
],
destination: 0x...,
consolidateToChainId: 8453
}

费用

• - 服务费： 余额的 1%（最低 $0.05，最高 $0.50）
• Gas 费用： 由 ZeroDust 支付，从清空金额中扣除
• 用户收到： 约余额的 97-99%（因 Gas 价格而异）

速率限制

• - 代理密钥：每分钟 300 次请求，每天 1000 次清空
• 如需更高限制，请联系 ZeroDust

错误代码

代理对话示例

用户： 我想把我所有的 ETH 从 Arbitrum 转到 Base

代理：

1. 1. 调用 /quote 检查余额和费用
2. 向用户显示：您在 Arbitrum 上有 0.005 ETH。扣除费用（约 1%）后，您将在 Base 上收到约 0.00495 ETH。这需要签署 3 条消息。是否继续？
3. 如果同意，调用 /authorization 获取类型化数据
4. 请求钱包签名（EIP-7702 委托、撤销和 EIP-712 清空）
5. 将签名提交到 /sweep
6. 轮询状态直到完成
7. 确认：完成！您的 Arbitrum 余额现在正好为 0。在 Base 上收到 0.00494 ETH。

重要说明

1. 1. 需要 EIP-7702： 用户的钱包必须支持 EIP-7702。截至