MCPcopy Index your code
hub / github.com/aiomev/ETHEREUM-MEV-BOT

github.com/aiomev/ETHEREUM-MEV-BOT @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
19 symbols 31 edges 11 files 11 documented · 58%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Ethereum MEV Alpha Bot 🚀

Advanced MEV detection and execution system built for Ethereum and EVM chains

License: MIT Telegram Discord

📖 Overview

A high-performance Ethereum MEV bot implementing sophisticated strategies including: - 🕵️‍♂️ Real-time mempool monitoring - 🔍 Trading opportunity detection - ⚡️ Front-running protection - 📊 Gas optimization - 🔄 Cross-DEX arbitrage

✨ Features

Core Components

  • Mempool Scanner - Advanced transaction pool monitoring with semantic analysis
  • Strategy Engine - Modular architecture for different MEV approaches
  • Execution System - Optimized transaction bundling and gas management
  • Risk Management - Profitability calculators and fail-safes

Advanced Functionality

  • Multi-chain support (Ethereum, BSC, Polygon, etc.)
  • Flashloan integration
  • Sandwich attack mitigation
  • Private transaction routing
  • Historical backtesting framework

🚀 Quick Start

Prerequisites

  • Rust 1.65+ (rustup install stable)
  • Node.js 16+ (for auxiliary scripts)
  • QuickNode endpoint (or your own node)

Installation

git clone https://github.com/aiomev/mev-bot.git
cd mev-bot
cp .env.example .env
# Edit .env with your configuration
cargo build --release

Configuration

# .env
RPC_URL=wss://your-quicknode-endpoint
PRIVATE_KEY=0xYourEOAPrivateKey
GAS_CAP=150 # in gwei
MAX_SLIPPAGE=0.5 # 0.5%

Running

# Development mode (with logging)
cargo run

# Production mode
cargo run --release

📚 Documentation

Strategy Development

Create new strategies by implementing the Strategy trait:

pub trait Strategy {
    fn analyze(&mut self, tx: &Transaction) -> Vec<Action>;
    fn execute(&self, actions: Vec<Action>) -> Result<(), ExecutionError>;
}

Key Modules

Module Description
scanner/ Mempool monitoring and transaction analysis
strategies/ MEV opportunity detection logic
executor/ Transaction building and submission
utils/ Blockchain interaction helpers

Monitoring Dashboard

We provide a Python-based monitoring tool:

python3 monitor.py --strategy arbitrage --interval 5

🤝 Support & Community

For questions, support, or to report issues:

  • Telegram: @aiomev
  • Discord: [@aiomev]
  • Email: aiomev7@gmail.com

🔧 Troubleshooting

Common issues: 1. Transaction failures: Adjust gas parameters in .env 2. Connectivity issues: Verify your RPC endpoint 3. ABI errors: Re-generate bindings with cargo build --features abi-gen

📜 License

MIT License - Copyright (c) 2025 AIO MEV

Core symbols most depended-on inside this repo

address
called by 2
src/helpers.rs
create_dex
called by 1
src/lib.rs
run
called by 1
src/lib.rs
get_pairs
called by 1
src/dex.rs
loop_mempool
called by 1
src/mempool.rs
loop_blocks
called by 1
src/block_scanner.rs
setup_signer
called by 1
src/helpers.rs
get_amount_out
called by 0
src/uni.rs

Shape

Function 11
Method 6
Class 2

Languages

Rust100%

Modules by API surface

src/dex.rs5 symbols
src/lib.rs4 symbols
src/helpers.rs4 symbols
src/uni.rs2 symbols
src/mempool.rs1 symbols
src/main.rs1 symbols
src/block_scanner.rs1 symbols
src/alert.rs1 symbols

For agents

$ claude mcp add ETHEREUM-MEV-BOT \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page