Skip to content

README.md

Latest commit

 

History

History
96 lines (67 loc) · 3.51 KB

README.md

File metadata and controls

96 lines (67 loc) · 3.51 KB

mempool-vortex

Rust License: MIT

🚀 A modular Rust pipeline for simulating MEV strategies via Ethereum mempool observation.

Built for educational, research, and prototyping use cases — showcasing high-performance mempool processing, strategy detection, and bundle orchestration.

✨ Features

  • 📡 Listens to real-time Ethereum mempool (pending txs) via WebSocket
  • 🧠 Detects MEV opportunities:
    • Arbitrage across AMMs (Uniswap V2/V3)
    • Sandwich attacks
    • Liquidation opportunities
  • 📦 Builds and simulates bundles for submission to MEV relays (Flashbots, bloXroute, Eden)
  • 🧪 Simulation-first: run full strategy logic without executing on-chain
  • 🖥️ Rich CLI with colorized logs, address formatting, and tx limits
  • 🛠️ Extensible design for new strategies, relays, and config systems

🚀 Usage

cargo run --release -- [OPTIONS]

⚙️ Command Line Options

Flag / Option Description Default
--verbose Enable verbose logging (DEBUG level) false
--simulate Enable simulation mode (no actual relay submission) false
--max-tx <N> Stop after processing N transactions Unlimited
--rpc-url <URL> Ethereum RPC WebSocket endpoint (ETH_RPC_URL env fallback) .env or none
--color <auto|always|never> Control ANSI color output in logs auto
--addr-style <short|full> Address display:
• short: checksummed, middle elided
• full: full checksummed		 short
-h, --help Show help message —

🧪 Example: Simulated Run

cargo run -- --simulate --verbose --addr-style full --max-tx 25

⚙️ Setup

  1. Get a free WebSocket RPC URL from Alchemy or Infura.

  2. Create a .env file:

    ETH_RPC_URL=wss://eth-sepolia.g.alchemy.com/v2/your_api_key

  3. Run the MEV pipeline:

    cargo run --release -- --simulate

🧪 Example Output (Simulation Mode)

📡 Listening to pending transactions...
🔍 tx: from=0xabc…1234 → to=0xdef…5678, value=0.42 ETH, gas_price=10.2 gwei
📦 [Sim] MEV opportunity detected: arbitrage between UniswapV2 <-> UniswapV3
⏱️ Bundle created: UUID=123e4567-e89b-12d3-a456-426614174000
✅ Simulated submission to relays [Flashbots, bloXroute]

🔭 Roadmap

Planned for future versions:

  • ✅ Integration test harness for strategy simulation
  • 📊 Metrics system with Prometheus-compatible MEVMetrics
  • ⚙️ Config loading from JSON / .env
  • 🛠️ Live relay auth and real bundle submission
  • 🧠 Strategy evaluation cost/profit/risk thresholds

📜 License

MIT