Dust collection

Overview

The Dust Collector is a powerful tool for cleaning up your wallet by consolidating small token balances (dust) into a single token. It helps you manage your wallet more efficiently by converting tiny, often unusable token amounts into a more useful consolidated balance.

What is Dust?

Dust refers to very small amounts of tokens in your wallet that are:

• Often too small to trade or bridge economically

• Making wallet management difficult and cluttered

• Typically resulting from:

  • Leftover amounts from trades

  • Small airdrops

  • Incomplete transactions

  • Reward distributions

How Dust Collector Works

1. Scanning Your Wallet

• Automatically checks all supported chains

• Identifies tokens below your specified threshold

• Calculates USD value of each token

• Filters out tokens worth less than $0.1

2. Smart Consolidation

• Groups dust tokens by chain

• Determines the most gas-efficient order of operations

• Handles both native tokens and ERC20 tokens (or only ERC-20 tokens depending on user input)

• Considers gas costs for each operation

3. Automated Processing

• Swaps and bridges dust tokens to your chosen target token on desired chain

• Optimizes transactions to minimize gas costs

• Handles all necessary approvals

Using the Tool

To clean dust, use the following command format:

Clean dust from my wallet with @dustcollector:
After the prompt enter:

 - Maximum dust threshold: [AMOUNT] USD
 - Target chain: [CHAIN_NAME]
 - Target token: [TOKEN_ADDRESS]
 - Include native tokens: [true/false]

Example:

Clean dust from my wallet with @dustcollector:
 - Maximum dust threshold: 5 USD
 - Target chain: BSC
 - Target token: 0x...[USDT contract address]
 - Include native tokens: false

Token Types

1. ERC20 Tokens

• Always included in dust collection

• Includes all standard token contracts

2. Native Tokens

• Optional inclusion via 'Include native tokens' parameter

• Examples: ETH, BNB, SONIC, etc.

• Keep enough for gas fees if including native tokens

Important Considerations

1. Gas Costs

• Some operations might be skipped if not economical

2. Token Support

• Not all tokens can be swapped directly

• Some tokens might require multiple swap steps

• Certain tokens might be unsupported on DEXes

3. Chain Support

• Works across multiple EVM-compatible chains

• Bridge operations support varies by chain

4. Safety Features

• Validates token addresses

• Checks bridge support for chosen chain

• Verifies token support for bridging

• Ensures threshold is reasonable (>$1)

Available Functions

• cleanDust: Cleans dust from a wallet by consolidating them into a single token

• getDustCollectorDescription: Get detailed information about Dust Collector features

• getDustSuportedChains: Returns information about supported chains for dust collection

Parameters for cleanDust

Parameter	Type	Description
account	string	Wallet address to clean dust from
dustThreshold	number	USD value threshold below which tokens are considered dust
dstChain	string	Destination chain for bridging dust tokens
tokenAddress	string	Destination token address to consolidate dust into
isNativeInclude	boolean	Whether to include native tokens in dust collection

Example Prompts:

• "HeyAnon, please collect all of my dust with total value less than <$50, into USDT on Base"