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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.heyanon.ai/heyanon.ai/hey-anon/protocols-and-functions-supported/utility/dust-collection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.