ZeroDust 链退出功能

ZeroDust 利用 EIP-7702 赞助执行机制，支持将原生 Gas 代币余额精确清零（完全归零）。该功能仅适用于支持 EIP-7702 的区块链（并非所有 EVM 兼容链均支持）。

适用场景

当用户提出以下任一需求时，应启用此能力：

• 彻底退出某条区块链（将全部原生代币转出）
• 清理钱包中的“灰尘余额”（dust）或小额余额
• 100% 转出账户全部余额，不留任何剩余
• 完全清空某个钱包
• 将多个链上的资金统一归集至单一链

触发语句

• “完全退出当前链”
• “将我在 [chain] 上的全部余额转出”
• “帮我清理灰尘余额”
• “清空这个钱包”
• “把所有资产转移到 [chain]”
• “确保余额为零”

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

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

API 基础 URL

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

步骤 1：注册获取 API Key（一次性操作）

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"
  }'

响应示例：

{
  "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 值保存为环境变量 ZERODUST_API_KEY。

步骤 2：获取报价（Quote）

在执行清零操作前，先查询用户的余额与预估费用：

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

响应示例：

{
  "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"
}

步骤 3：获取授权数据（Authorization Data）

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

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（委托参数）。

步骤 4：用户签署消息

用户需签署以下三项内容：

1. EIP-7702 委托授权 —— 将其 EOA 地址委托给 ZeroDust 合约
2. EIP-7702 撤回授权 —— 已预先签名的撤回指令（清零完成后自动执行）
3. EIP-712 清零意图 —— 授权本次清零操作的具体参数

步骤 5：提交清零请求

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..."
  }'

响应示例：

{
  "sweepId": "uuid",
  "status": "pending",
  "txHash": null
}

通过轮询 GET /sweep/{sweepId} 获取状态更新，直至返回 status: "completed"。

便捷端点：合并报价 + 授权（Quote + Auth）

对 Agent 用户，可使用该单端点同时获取报价与授权数据：

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

批量清零（多链并行）

单次请求即可从多条链发起清零操作：

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

费用说明

• 服务费：余额的 1%（最低 $0.05，最高 $0.50）
• Gas 成本：由 ZeroDust 支付，从清零金额中扣除返还
• 用户实际到账：约为余额的 97–99%（受实时 Gas 价格影响）

速率限制

• Agent 密钥：300 次请求/分钟，1000 次清零/天
• 如需更高配额，请联系 ZeroDust 团队

错误码

Agent 对话示例

用户：“我想把 Arbitrum 上的所有 ETH 全部转到 Base”

Agent：

1. 调用 /quote 查询余额与费用
2. 向用户展示：“您在 Arbitrum 上有 0.005 ETH。扣除约 1% 费用后，您将在 Base 收到约 0.00495 ETH。此操作需签署 3 条消息，是否继续？”
3. 若用户确认，调用 /authorization 获取类型化数据
4. 引导用户钱包完成三重签名（EIP-7702 委托、EIP-7702 撤回、EIP-712 清零意图）
5. 携带全部签名调用 /sweep 提交请求
6. 轮询状态直至完成
7. 最终确认：“已完成！您的 Arbitrum 余额现已精确归零，Base 已到账 0.00494 ETH。”

重要注意事项

1. 必须支持 EIP-7702：用户钱包须兼容 EIP-7702。截至 2026 年，主流钱包均已支持。

2. 必须由用户签名：清零操作全程依赖用户钱包签名，ZeroDust 不持有任何私钥或资产托管权限。

3. 结果严格归零：清零完成后，源链余额将精确等于 0（无任何残留）。

4. 支持跨链：可通过 Gas.zip 桥接协议，将资产清零至任意已支持的目标链。

5. 非全量 EVM 链支持：仅上表所列 25 条链支持 EIP-7702。请勿在未列出的链上尝试清零操作。