MEV Bot

An MEV (Maximal Extractable Value) bot written in Go that monitors the Arbitrum sequencer for potential swap opportunities and identifies profitable arbitrage opportunities.

Overview

This bot monitors the Arbitrum sequencer for attempted swaps and analyzes them to determine if they are large enough to create price movements that can be exploited for arbitrage. It uses off-chain methods to calculate price movements using Uniswap V3 pricing functions.

Features

• Real-time monitoring of Arbitrum sequencer
• Detection of potential swap transactions
• Market scanning for price movement analysis
• Uniswap V3 pricing calculations (price to tick, sqrtPriceX96 to tick, etc.)
• Arbitrage opportunity identification
• Optimized mathematical functions for improved performance (see Mathematical Optimizations)

Prerequisites

• Go 1.24 or higher
• Access to Arbitrum node

Installation

go mod tidy

Usage

go run cmd/mev-bot/main.go

Configuration

Configuration files can be found in the config/ directory.

Project Structure

.
├── cmd/                 # Main applications
├── config/              # Configuration files
├── internal/            # Private application and library code
├── pkg/                 # Library code that can be used by external projects
├── @prompts/            # AI prompts for development assistance
├── docs/                # Documentation
├── scripts/             # Scripts for building, testing, and deployment
├── go.mod               # Go module definition
├── go.sum               # Go module checksums
├── README.md            # This file
├── .claude/             # Claude Code specific configuration and tools
├── .gemini/             # Gemini specific configuration and tools
├── .opencode/           # OpenCode specific configuration and tools
├── .qwen/               # Qwen Code specific configuration and tools
├── CLAUDE.md            # Complete project documentation and Claude context (comprehensive example)
├── GEMINI.md            # Gemini context (simplified, references CLAUDE.md)
├── OPENCODE.md          # OpenCode context (simplified, references CLAUDE.md)
└── QWEN.md              # Qwen Code context (simplified, references CLAUDE.md)

Development

AI Assistant CLI Configurations

This project is configured to work with multiple AI coding assistants, each with specialized expertise:

• Claude (.claude/) - System architecture, design patterns, and integration
• OpenCode (.opencode/) - Multi-language development and testing
• Qwen Code (.qwen/) - Mathematical computations and precision handling
• Gemini (.gemini/) - Performance optimization and concurrency

Git Workflow

This project follows a comprehensive Git workflow with specific branch strategies, commit conventions, and automated checks. See docs/GIT_WORKFLOW.md and docs/BRANCH_STRATEGY.md for detailed information.

Key aspects:

• Branch Strategy: main, develop, feature/*, fix/*, release/*, hotfix/*
• Commit Messages: Conventional commits format
• Git Hooks: Pre-commit and pre-push checks
• Pull Requests: Required for all merges to main and develop

Prompts Directory

The @prompts/ directory contains prompts that can be used with AI coding assistants for various development tasks.

Contributing

1. Fork the repository
2. Create a feature branch following the branch naming conventions
3. Commit your changes with conventional commit messages
4. Push to the branch
5. Create a Pull Request with detailed description

License

MIT