evm-multiwallet-volume-booster-bot-

KO | EN

gitlite — search

#hacktoberfest #ai #llm #go #golang #android #rust #deep-learning #linux #docker #windows #kubernetes #awesome-list #mcp

evm-multiwallet-volume-booster-bot-

(★ 16)

Multi-wallet EVM bot for EVM Blockchain (ETH,BNB,BASE) : automated buys, per-wallet randomized profit-target sells, and auto-sweep back to a funding wallet.

evm-multiwallet-volume-booster-bot- 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# EVM Volume Booster Bot 🚀

<br />

An ultra-fast, highly concurrent TypeScript Node.js EVM trading bot designed to generate authentic trading volume and spread activity for any ERC-20 token on EVM-compatible networks.

**⭐️ If you find this project useful or educational, please consider giving it a star! ⭐️**

**Disclaimer**: This project is open-sourced purely for **educational and learning purposes**. It demonstrates advanced EVM interaction, deterministic wallet generation, asynchronous concurrency with `ethers.js`, and SQLite state persistence.

## 🚀 Features

- **Infinite Deterministic Sub-Wallets**: Generates hundreds or thousands of temporary sub-wallets from a single master funding key using an HD-like derivation path. It never runs out of wallets.
- **Single Funding Wallet Architecture**: Operates using ONE master funding wallet. The master wallet automatically drips native gas/tokens to batches of sub-wallets just in time for trading.
- **High Concurrency**: Leverages `Promise.all` throughout the stack to execute massive parallel batches of buys and sells without nonce collisions.
- **Randomized Profit Targets**: Each sub-wallet is assigned a randomized profit target (e.g., between 3% and 11%) to ensure sells look organic and uncoordinated.
- **Out of Gas Protection**: Built specifically with elevated, hardcoded gas limits for Uniswap V2 router interactions (`swapExactTokensForETH`) to perfectly bypass common node under-estimation and out-of-gas reverts.
- **SQLite State Persistence**: Safely records the exact state of every single generated sub-wallet (`idle`, `buying`, `holding`, `selling`, `depleted`) in a local `bot.db`. If the bot crashes or restarts, it seamlessly recovers and resumes where it left off without orphaned funds.
- **100% Automated Sweeping**: When a sub-wallet hits its profit target, it sells its tokens and sweeps 100% of the resulting native balance back to the master funding wallet, calculating precise gas costs to leave zero dust behind.
- **External Activity Monitor**: Actively listens to the token's smart contract and visually alerts you in the console when external users (non-bot wallets) buy or sell the token.

## 🛠 Prerequisites

- Node.js (v18+)
- npm or yarn
- An EVM RPC URL

## ⚙️ Configuration

1. Clone the repository.
2. Install dependencies:
   ```bash
   npm install
   ```
3. Copy `.env.example` to `.env`:
   ```bash
   cp .env.example .env
   ```
4. Configure your `.env` variables:

```env
# RPC & Core Setup
RPC_URL=https://your-evm-rpc-url.com
FUNDING_PRIVATE_KEY=your_master_private_key_here

# DEX & Token Addresses
ROUTER_ADDRESS=0x... (e.g., Uniswap V2 Router)
WETH_ADDRESS=0x... (Native Wrapped Coin)
TOKEN_ADDRESS=0x... (The ERC20 Token to boost)

# Wallet Batching Settings
BATCH_SIZE_MIN=2
BATCH_SIZE_MAX=6
FUND_AMOUNT_MIN=5540
FUND_AMOUNT_MAX=12394

# Trading Strategy
BUY_PERCENTAGE=0.75 # Uses 75% of the sub-wallet's balance to buy
MIN_BUY_INTERVAL_MS=6000
MAX_BUY_INTERVAL_MS=10000
MONITOR_INTERVAL_MS=2000

# Profit Strategy
PROFIT_TARGET_MIN=0.03 # 3%
PROFIT_TARGET_MAX=0.11 # 11%
```

## 💻 Usage

### Start the Bot
Starts the main daemon. It will automatically initialize the database, derive the first batch of wallets, fund them, and begin the concurrent buy/sell loops.
```bash
npm run dev
```

### Check Balances
Scans the database and queries the blockchain to give you a summary of exactly how much native currency and tokens are locked in active sub-wallets vs the master funding wallet.
```bash
npm run check-balance
```

### Emergency Force Sell
Bypasses all profit targets and instantly force-sells all tokens held by all active sub-wallets, then sweeps the native currency back to the master funding wallet.
```bash
npm run force-sell
```

### Reset State
Deletes the local SQLite database (`bot.db`). The bot will forget all previously derived wallets and start fresh from index 0 on the next run. **Ensure all sub-wallets are swept using `force-sell` before doing this!**
```bash
npm run reset-db
```

## 🏗 Architecture Overview

The bot runs on three concurrent, non-blocking asynchronous loops:
1. **Batch Replenisher (`index.ts`)**: Monitors the active pool of sub-wallets. When the count of `idle` wallets drops below `BATCH_SIZE_MIN`, it derives a fresh batch, explicitly sequences the funding wallet's nonces, sends native currency to them, and injects them into the pool.
2. **Scheduler (`scheduler.ts`)**: Continuously loops through `idle` wallets and executes buy orders using a randomized percentage of their balance.
3. **Monitor (`monitor.ts`)**: Constantly checks the DEX for the live price of the token. When a holding wallet's token value exceeds its unique randomized profit target, it triggers a sell, sweeps the balance to the master wallet, and marks the sub-wallet as `depleted`.

## 📜 License
Released open-source for educational purposes only. You are solely responsible for any usage of this software.

---

## 📬 Contact & Support

Created by **Mir Hamza Hasan**. Feel free to reach out if you have any questions, want to discuss blockchain development, or need enterprise trading solutions.

- 🌐 **Website**: [mirhamzahasan.com](https://mirhamzahasan.com)
- 💼 **LinkedIn**: [linkedin.com/in/mirhamzahasan](https://www.linkedin.com/in/mirhamzahasan/)
- ✈️ **Telegram**: [@mirhamzahasan](https://t.me/mirhamzahasan)

*If this repository helped you understand EVM concurrency or trading bot architecture, don't forget to drop a ⭐ on your way out!*

evm-multiwallet-volume-booster-bot-

evm-multiwallet-volume-booster-bot- 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

evm-multiwallet-volume-booster-bot-

evm-multiwallet-volume-booster-bot- 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README