> For the complete documentation index, see [llms.txt](https://docs.heyanon.ai/heyanon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.heyanon.ai/heyanon.ai/hey-anon/protocols-and-functions-supported/utility/dust-collection.md).

# 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"