elizaos-plugin-zerodust

@elizaos/plugin-zerodust

ElizaOS plugin for sweeping native gas tokens to exactly zero balance using EIP-7702.

Installation

npm install @elizaos/plugin-zerodust

Configuration

Set your ZeroDust API key:

export ZERODUST_API_KEY=zd_your_key_here

Or in your agent's character file:

{
  "settings": {
    "secrets": {
      "ZERODUST_API_KEY": "zd_your_key_here"
    }
  }
}

Getting an API Key

curl -X POST https://zerodust-backend-production.up.railway.app/agent/register \
  -H "Content-Type: application/json" \
  -d '{"name": "My ElizaOS Agent", "agentId": "eliza-001"}'

Save the apiKey from the response - it's only shown once.

Usage

Add the plugin to your agent:

import { zerodustPlugin } from '@elizaos/plugin-zerodust';

const agent = {
  plugins: [zerodustPlugin],
  // ... other config
};

Actions

CHECK_DUST_BALANCES

Check sweepable balances across all supported chains.

Triggers:

• "check my dust balances"
• "how much do I have on each chain?"
• "show my balances"

Example:

User: check my dust balances for 0x1234...
Agent: **Sweepable Balances**
| Chain | Balance | USD |
|-------|---------|-----|
| Arbitrum | 0.004 ETH | $9.54 |
| Polygon | 18.95 POL | $2.03 |
...

EXIT_CHAIN

Sweep 100% of native balance from a single chain.

Triggers:

• "exit Arbitrum to Base"
• "sweep my dust from Polygon"
• "move all my ETH from Optimism"
• "empty my wallet on BSC"

Example:

User: exit Arbitrum to Base
Agent: **Sweep Quote**
From: Arbitrum (42161)
To: Base (8453)
Balance: 0.004 ETH
You'll Receive: ~0.00388 ETH
Fee: 1% (min $0.05, max $0.50)
...

EXIT_ALL_CHAINS

Batch sweep from multiple chains to a single destination.

Triggers:

• "consolidate everything to Base"
• "sweep all chains"
• "exit everything to Ethereum"

Example:

User: consolidate everything to Base
Agent: **Batch Sweep Preview**
Destination: Base (8453)
Chains to sweep:
| Chain | Balance | USD |
|-------|---------|-----|
| Arbitrum | 0.004 ETH | $9.54 |
| Polygon | 18.95 POL | $2.03 |
| Optimism | 0.0008 ETH | $1.72 |
Total Value: ~$13.29
...

Supported Chains (25 EIP-7702 Compatible)

Chain	ID	Native Token
Ethereum	1	ETH
Optimism	10	ETH
BSC	56	BNB
Gnosis	100	XDAI
Unichain	130	ETH
Polygon	137	POL
Sonic	146	S
X Layer	196	OKB
Fraxtal	252	FRAX
World Chain	480	ETH
Sei	1329	SEI
Story	1514	IP
Soneium	1868	ETH
Mantle	5000	MNT
Superseed	5330	ETH
Base	8453	ETH
Plasma	9745	XPL
Mode	34443	ETH
Arbitrum	42161	ETH
Celo	42220	CELO
Ink	57073	ETH
BOB	60808	ETH
Berachain	80094	BERA
Scroll	534352	ETH
Zora	7777777	ETH

Not Supported: Avalanche, Blast, Linea, Apechain (no EIP-7702)

Fees

• Service fee: 1% of balance (min $0.05, max $0.50)
• Gas costs: Paid by ZeroDust, reimbursed from sweep amount
• User receives: ~97-99% of balance

How It Works

• EIP-7702 Delegation: User temporarily delegates their EOA to the ZeroDust contract
• Sponsored Execution: ZeroDust executes the sweep, paying gas costs
• Exact Zero Balance: The contract transfers the entire balance minus fees
• Automatic Revocation: Delegation is revoked after the sweep

Important Notes

• Signatures Required: Sweeps require user wallet signatures. ZeroDust never has custody.
• EIP-7702 Only: Only works on chains that support EIP-7702 (25 chains listed above).
• Minimum Balance: $0.10 minimum per chain to sweep.

API Documentation

Full API docs: https://zerodust-backend-production.up.railway.app/docs

Support

• Issues: https://github.com/zerodustxyz/zerodust-backend/issues

License

MIT