Dust Sweeper v2

Identify and swap low-value tokens ("dust") to ETH, USDC, USDT, or SOL — across EVM chains and Solana. Uses Odos for EVM (batch-optimized, better execution than 1inch for multi-token sweeps) and Jupiter for Solana. No middlemen, no discount haircut, no 24h wait.

Prerequisites — Wallet Policy

Before executing any swaps or approvals, the wallet policy must be active.
Load the wallet-policy skill and propose the standard wildcard policy
(deny key export + allow *). This covers all Odos approvals and swaps.

Supported Chains

Chain	Aggregator	Native Output
Ethereum mainnet	Odos	ETH
Base	Odos	ETH
Arbitrum	Odos	ETH
Solana	Jupiter	SOL

Ask the user which chain(s) to scan. Default: all chains (scan everything, sweep what's profitable).

Workflow

Phase 1 — Discovery

EVM chains (Ethereum, Base, Arbitrum):

Call wallet_balance(chain=<chain>) without an asset filter for each chain — returns ALL tokens with non-zero balances.
For each token, get a USD value:
- Use cg_token_price(platform=<chain>, contract_addresses=<address>) for price.
- Fallback: Odos quote with full balance to probe the market.
Flag tokens as dust if their USD value is below the dust threshold (default: $50).

Solana:

Call wallet_sol_balance() without an asset filter — returns ALL SPL tokens.
Price each SPL token via cg_token_price(platform="solana", contract_addresses=<mint_address>).
Flag as dust if below threshold.

Show the user the full dust inventory before executing anything.
Format: chain | token symbol | balance | USD value

Phase 2 — Profitability Filter

For each dust token:

Quote the full balance via the appropriate aggregator:
- EVM: Odos quote, dst = native ETH (0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE) or USDC/USDT if user prefers.
- Solana: Jupiter quote, outputMint = SOL or USDC.
Estimate gas cost:
- EVM: approve (~~$1–3) + swap (~~$3–8 mainnet, ~$0.10–0.50 Base/Arbitrum). Assume $10 on mainnet, $1 on L2s if no live data.
- Solana: ~$0.001 per transaction.
Skip if: quoted_output_usd < gas_cost_usd + MIN_PROFIT_USD (default MIN_PROFIT = $2).
Report skipped tokens with reason ("gas would eat the value").

L2 advantage: On Base and Arbitrum, gas is cheap enough ($0.10–0.50) that tokens as small as ~$3–5 can be worth sweeping.

Phase 3 — Execution

EVM (Odos):

Check allowance: skip approval if already approved for Odos router.
odos_approve(chain=<chain>, token_address=...) — approve Odos router.
odos_swap(chain=<chain>, input_token=token_address, output_token=0xEeee..., amount=..., slippage=2.0).
Odos supports multi-token batch swaps — if multiple tokens need sweeping on the same chain, batch them into a single transaction where possible. This cuts gas vs. one-by-one.
After each swap/batch: report tokens swept, ETH/USDC received, tx hash.

Solana (Jupiter):

Use Jupiter swap route for each SPL token → SOL (or USDC).
Sign and send via wallet_sol_transfer.
Report: token name, amount swapped, SOL/USDC received, tx signature.

Phase 4 — Summary

Report per chain:

Tokens swept, total USD recovered
Tokens skipped (unpriced, unprofitable, errored)
Net ETH/SOL received

Final line: "Swept N tokens across X chains, recovered ~$Y in ETH/SOL."

Key Parameters (ask user if not specified)

Parameter	Default	Notes
Dust threshold	$50 USD	Tokens above this are NOT dust
Min profit after gas	$2 USD	Skip swaps that barely cover gas
Slippage	2%	Dust tokens often have thin liquidity
Output token (EVM)	Native ETH	Or USDC/USDT if user prefers
Output token (Solana)	SOL	Or USDC
Chains to scan	All (ETH + Base + ARB + SOL)	User can narrow to specific chains

Token Addresses

Native ETH (all EVM chains): 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE

Ethereum mainnet:

WETH: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
USDC: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
USDT: 0xdAC17F958D2ee523a2206206994597C13D831ec7

Base:

USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Arbitrum:

USDC: 0xaf88d065e77c8cC2239327C5EDb3A432268e5831

Solana:

USDC mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
SOL mint (native): So11111111111111111111111111111111111111112

Gotchas

Odos vs 1inch: Odos is optimized for multi-token routing and typically gives better execution on dust sweeps with thin liquidity. Prefer Odos for EVM. If Odos is unavailable, fall back to 1inch with same parameters.

Unpriced tokens: If CoinGecko returns no price and Odos/Jupiter return no quote, skip — don't waste gas on un-routable tokens.

Fee-on-transfer tokens: If a swap fails, log the error and move on. Don't abort the whole sweep.

Batch vs single: Odos PathFinder can handle multi-input single-output routes (many tokens → ETH in one tx). Use this when available — it's significantly cheaper on mainnet.

Approvals are permanent. Unlimited approvals to Odos router are standard practice. Offer exact-amount approvals if user is security-conscious.

Gas spikes (mainnet): If ETH gas > 30 gwei, warn the user. L2 sweeps (Base, Arbitrum) are almost always worth it regardless. Offer to schedule mainnet sweep for off-peak hours.

Don't touch tokens the user might want. Always confirm the sweep list before Phase 3. Never auto-execute without showing the inventory first.

Solana dust is cheap to sweep. At ~$0.001/tx, even $1 tokens can be worth sweeping on Solana. Lower the MIN_PROFIT threshold to $0.50 for Solana by default.

Dry Run Mode

If the user says "what dust do I have?" or "show me my dust" without asking to sweep — run Phase 1 + Phase 2 only. Show the inventory and what would be profitable to sweep, but don't execute Phase 3.

Scheduling

For recurring sweeps (e.g. "sweep my dust every Sunday"), use schedule_task with cron 0 10 * * 0 (Sunday 10am UTC). Note: wallet policy must be persistent. L2 chains are good candidates for frequent scheduled sweeps given low gas costs.

@1458/dust-sweeper