Skip to content

kairos1205/sniper-bundler-volume-bot-evm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚡ BNB Chain Trading Bot — Multi-EVM Sniper, Bundler & Volume Automation

Professional sniper, bundler & volume automation infrastructure for PancakeSwap V3 and Four.meme. A high-performance toolkit built for the BNB Smart Chain that automates token deployment, LP creation, bundled execution (MEV protection), and trading strategies — designed for reliability, speed, and extensibility.


🚀 Overview

This project automates token lifecycle and trading flows on BSC (and other EVM chains). It supports:

  • Token deployment & factory integration
  • Instant liquidity provisioning on PancakeSwap V3
  • Sniper, bundler, copy-trader, and volume-generation strategies
  • Atomic bundles via bloXroute for front-run/MEV protection
  • Fork testing, multi-wallet orchestration, and exportable audit logs

🧭 Core Flows

Sniper

  1. Load target(s) from config
  2. Query router for expected out / price estimate
  3. Apply slippage & execution parameters
  4. Swap WBNB → TOKEN and return tx hash/receipt
  5. Optional: Telegram / webhook notifications

Copy-Trader

  1. Subscribe to mempool / pending transactions
  2. Filter by target leader wallets / swap intents
  3. Mirror transaction with configurable size/caps
  4. Optional notification & rate limits

Bundler

  1. Read ordered route sequence from config
  2. Execute each step respecting slippage / deadlines
  3. Bundle transactions atomically (via bloXroute) for MEV protection
  4. Extensible to multicall patterns

Volume Bot

  1. Loop on configured interval
  2. Execute small buys, approve when needed, partial/full sells
  3. Built-in rate limiting and randomized timing (future)
  4. Log all activity to JSON for analytics

✨ Key Features

  • Token Deployment — Auto-deploy ERC-20 tokens via Four.meme factory
  • Liquidity Management — Create & initialize PancakeSwap V3 pools programmatically
  • Transaction Bundling — Atomic execution through bloXroute API
  • Trading Strategies — Sniper, bundler, copy-trader, volume generator
  • Security — Uses OpenZeppelin contracts + local test suites / audits
  • Fork Testing — Mainnet forking for realistic simulations before live runs
  • Multi-Wallet Orchestration — Generate & fund many sub-wallets from one master key
  • Exported Records — Wallet & tx data saved as JSON for traceability

🏗 Architecture

Layer Responsibility
Smart Contracts ERC20 token, factory & LP helpers (Solidity)
Bundler Integrates with bloXroute for atomic multi-tx bundles
DEX Integration PancakeSwap V3 (Uniswap V3 SDK compatibility)
Orchestration Node.js scripts / services (wallet management, distribution, execution)
Testing Hardhat + forking / local test suites

🧰 Tech Stack

  • Smart Contracts: Solidity ^0.8.x (OpenZeppelin)
  • Framework: Hardhat (testing, deploys, forking)
  • DEX SDK: Uniswap V3 SDK (for PancakeSwap V3)
  • MEV / Bundling: bloXroute integration
  • RPC Providers: QuickNode or similar
  • Runtime: Node.js (scripts for orchestration)
  • Data: JSON export for wallets & transactions

⚙️ Core Modules

  • Wallet Generation — Deterministic generation & management of sub-wallets
  • BNB Distribution — Batch funding of sub-wallets from master wallet
  • Token Deployment — Factory integration (Four.meme) & token metadata handling
  • Auto-Buy Execution — Coordinated buys across wallets (parallelized)
  • Balance Tracking — Periodic balance checks and logging
  • Data Exportwallet_details.json, token_details.json, and transaction logs

▶️ Quick Start (development)

git clone https://github.com/0xopsdev/bnb-chain-trading-bot.git
cd bnb-chain-trading-bot
npm install
cp .env.example .env         # add RPC, private key, bloXroute creds
node bundler.js              # run the orchestration script

node bundler.js performs: wallet generation, BNB distribution, token deployment, buy execution, and JSON export.


📁 Example Output

wallet_details.json

[
  {
    "index": 0,
    "address": "0xabc123...",
    "privateKey": "0xdef456..."
  }
]

token_details.json

{
  "address": "0x987654...",
  "name": "TestMeme",
  "symbol": "TME",
  "supply": "1000000",
  "transactions": [
    { "hash": "0x123...", "blockNumber": 38192612 }
  ]
}

🪙 Contract & Network Info

Item Value
Network Binance Smart Chain (Mainnet / Testnet)
Factory Contract 0x5c952063c7fc8610FFDB798152D69F0B9550762b
Estimated Launch Cost ~0.005 BNB
Liquidity Threshold (example) 24 BNB
Explorer https://bscscan.com/address/0x5c952063c7fc8610FFDB798152D69F0B9550762b

🔗 Working Tx Samples (Volume Bot)


⚠️ Security & Best Practices

  • Never commit .env or private keys to source control.
  • Use separate wallets for testing and production.
  • Run extensive tests on forked networks before mainnet usage.
  • Audit contracts and logic before production deployment.
  • Monitor gas & bundler costs; verify slippage/timeouts.
  • Understand legal and regulatory responsibilities in your jurisdiction.
  • This repository is for research / educational purposes only — use at your own risk.

🧪 Recommended Testing Workflow

  1. Run Hardhat with mainnet forking and simulate full flows.
  2. Verify bundle consistency in local anvil / forked environment.
  3. Dry-run transactions on testnet (BSC testnet) with non-valuable funds.
  4. Review bloXroute bundle behavior in staging mode.

🔮 Roadmap / Future Enhancements

  • AI-driven strategy optimization and hyperparameter tuning
  • Cross-chain support (ETH, Base, Arbitrum)
  • Real-time Telegram / Discord alerts & dashboard
  • Advanced PnL and analytics dashboard (per-wallet breakdown)
  • Improved randomization (amount, frequency, pool selection)
  • Plugin architecture for custom strategies

🧾 License

MIT — free for development, research, and customization. See LICENSE for details.


🧠 Disclaimer

This software is provided as-is for educational and research purposes. Authors and maintainers assume no responsibility for financial loss, legal exposure, or other consequences from use. Always perform your own due diligence and comply with applicable laws and exchange/platform rules.

About

EVM Trading Bots - Sniper, Bundler, Volume, boosting

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors