https://github.com/0xdeval/dust
Dust is a Web3 tool that converts spam tokens and airdropped scams into real value. Clean up your wallet and get rewarded for crypto dust
https://github.com/0xdeval/dust
defi web3
Last synced: 3 months ago
JSON representation
Dust is a Web3 tool that converts spam tokens and airdropped scams into real value. Clean up your wallet and get rewarded for crypto dust
- Host: GitHub
- URL: https://github.com/0xdeval/dust
- Owner: 0xdeval
- Created: 2025-03-31T19:04:22.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-28T16:28:08.000Z (about 1 year ago)
- Last Synced: 2025-05-28T17:41:39.037Z (about 1 year ago)
- Topics: defi, web3
- Language: TypeScript
- Homepage: https://dustoff.fun
- Size: 2.93 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Dust
[](https://opensource.org/licenses/MIT) [](https://nextjs.org/) [](https://vercel.com/) [](https://github.com/prettier/prettier) [](https://eslint.org/) [](https://github.com/sweeetio/eslint-plugin-unused-imports) [](https://vitest.dev/)
> **The fastest way to sell multiple tokens across EVM chains.**
> 🚨 **Important**: The official project URL is [https://dustoff.fun](https://dustoff.fun). Do not trust other clones — they may be scams!
**Dust** is a lightweight Next.js-based dApp designed to streamline multi-token sales across EVM-compatible chains. It supports up to six tokens in one transaction, filters burn-only assets, and routes transactions using ODOS and The Graph, with token data fetched via Blockscout APIs.
## Table of contents
- [Features](#features)
- [Project Structure](#project-structure)
- [Getting Started](#getting-started)
- [Testing](#testing)
- [Linting](#linting)
- [Contributing](#contributing)
- [Feedback](#feedback)
- [License](#license)
- [Support this project](#support-this-project)
## Features
- 🔄 **Sell up to 6 tokens simultaneously** — batch sales for efficiency and lower gas fees _(more tokens coming soon)_
- 🌙 **Direct Lite Mode** — clean UI optimized for speed and low-cost operations
- 🔎 **Smart token filtering** — separates sellable tokens from burn-only ones _(burn feature coming soon)_
- 🔗 **Multi-chain EVM support** — compatible with major EVM networks out of the box
- 🧠 **Subgraph integration** — fast, spam-resistant token pair indexing using The Graph
- 📦 **ODOS aggregator support** — get the best prices via quote and route optimization
- 🔍 **Blockscout API integration** — real-time token metadata, balances, and contract info
- ⚙️ **Developer-focused** — TypeScript-first, modular architecture, linting, and formatting built-in
## Project Structure
To run the project locally:
### 1. Clone and configure
```bash
cp .env.example .env
# then edit `.env` to provide necessary values
```
### 2. Install dependencies
```bash
bun install
```
### 3. Start the dev server
```bash
bun run dev
```
Then open [http://localhost:3000](http://localhost:3000) in your browser.
## Testing
Dust uses **Vitest** for testing core logic and components.
To run tests:
```bash
bun run test
```
All test files are named using the `.test.ts` convention.
## Linting
Ensure code quality by running:
```bash
bun run lint
```
To fix common issues automatically:
```bash
bun run lint --fix
```
## Contributing
We welcome contributions! Here’s how to get started:
1. Fork the repository
2. Create a branch:
```bash
git checkout -b feature/my-feature
# or
git checkout -b fix/my-bug
```
3. Make and commit your changes
4. Push to your fork:
```bash
git push origin feature/my-feature
```
5. Open a pull request with a clear description
> ✅ Before submitting, run `bun run lint` and `bun run test` to ensure everything passes.
For detailed guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md)
## Feedback
We would love to hear your thoughts, suggestions, and any issues you encounter while using **Dust**
> 📢 Send your feedback via our official Telegram support group: https://t.me/+0j9GpMQpGsU5MWQy
Your feedback helps us improve!
## License
This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details.
## Support this project
If you find this project useful, consider donating:
- EVM chains: `0xdeval.eth`
- TON: `UQBbNb-uvZw-kTzwXmflzMOLG8y38y9YtXiiE4MJAKuFxf71`
- Solana: `6i554tryeKSktWCyKqyRwYnaGcByaNp4zs7pifHoTmj9`
- Bitcoin: `bc1pc75tm7a5khf5cfnww80grl3lzpqwjcy8v7a65rkzq4aafyvrkw8sxspltj`