Hades is a sophisticated MEV (Maximal Extractable Value) bot designed for the Binance Smart Chain (BSC). It focuses on capturing value through various strategies including arbitrage, sandwiching, and backrunning.
Multiple MEV Strategies:
- Arbitrage detection and execution
- Sandwich attacks
- Backrunning transactions
- Next block transaction bundling
Builder Integrations:
- 48.club
- Bloxroute
- Blackrazor
- TxBoost
- ArbOnly specialized builder
Pool Support:
- Uniswap V2/V3 compatible pools
- DoDo pools
- 1inch limit orders
- 0x protocol orders
Advanced Architecture:
- Real-time mempool monitoring
- Graph-based arbitrage path finding
- EVM simulation for profit calculation
- Multi-threaded transaction processing
Prerequisites
- Rust toolchain (2021 edition)
- Access to a BSC node (IPC, HTTP, and WebSocket endpoints)
- Private key for transaction signing
- Discord webhooks for notifications (optional)
Create a .env file with the following variables:
IPC_NODE_URL=path/to/bsc.ipc
HTTP_NODE_URL=https://your-bsc-node
WS_NODE_URL=wss://your-bsc-node
POOLS_DATA_DIR=./data/pools
DB_PATH_DIR=./data/db
WALLET_SIGNER=your_private_key
# Discord webhooks (optional)
DISCORD_NEW_POOL=https://discord.com/api/webhooks/...
DISCORD_DETECTED_ARB=https://discord.com/api/webhooks/...
DISCORD_DETECTED_SWAP=https://discord.com/api/webhooks/...
DISCORD_STORAGE=https://discord.com/api/webhooks/...
DISCORD_PRIVATE_FLOW=https://discord.com/api/webhooks/...
# Feature flags
ARBONLY_ENABLED=true
FAST_MEMPOOL_ENABLED=true
MERKLE_ENABLED=true
PUBLIC_MEMPOOL_ENABLED=true
NEXTBLOCK_ENABLED=true
SANDWICH_ENABLED=true
ARBITRAGE_ENABLED=true
Pool Management (src/pools.rs): Handles different pool types (V2, V3, DoDo, 1inch, 0x) Tracks reserves and calculates rates Graph System (src/graph.rs): Builds a directed graph of token pairs Finds profitable arbitrage paths Search Algorithms (src/search.rs):
- Implements sandwich attack detection
- Calculates optimal trade amounts
Transaction Flow (src/flow.rs):
- Monitors mempool for opportunities
- Connects to Bloxroute and Merkle for private transactions
Bundle Builders (src/builders.rs):
- Constructs and submits transaction bundles to various builders
- Handles backrunning and arbitrage execution
The bot initializes by loading pool data and building the token graph It connects to mempool sources to monitor transactions When opportunities are detected, it simulates the transactions to calculate profit If profitable, it constructs and submits bundles to appropriate builders
The bot will:
- Connect to the BSC node
- Load pool data and build the token graph
- Start monitoring for MEV opportunities
- Send notifications to Discord when events occur
- Execute profitable transactions automatically
This software is for educational purposes only. Using MEV bots in production requires careful risk management and may be subject to various regulations. Use at your own risk.