# MEV Bot Project - Qwen Code Context

This file contains context information for Qwen Code about the MEV Bot project.

## Project Overview
This is an MEV (Maximal Extractable Value) bot written in Go 1.24+ that monitors the Arbitrum sequencer for potential swap opportunities. When a potential swap is detected, the bot scans the market to determine if the swap is large enough to move the price using off-chain methods.

## Project Structure
- `cmd/` - Main applications
- `internal/` - Private application and library code
- `pkg/` - Library code that can be used by external projects
- `config/` - Configuration files
- `@prompts/` - AI prompts for development assistance
- `docs/` - Documentation
- `scripts/` - Scripts for building, testing, and deployment

## Technologies
- Go 1.24+
- Arbitrum sequencer monitoring
- Uniswap V3 pricing functions (price to tick, sqrtPriceX96 to tick, etc.)
- Multiple transport mechanisms (shared memory, Unix sockets, TCP, WebSockets, gRPC)
- Concurrency patterns (worker pools, pipelines, fan-in/fan-out)

## Development Notes
- Focus on off-chain price movement calculations
- Refer to official Uniswap V3 documentation for pricing functions
- Implement market scanning functionality for potential arbitrage opportunities
- Follow the modular architecture with independent components
- Use the universal message bus for inter-module communication
- Adhere to the standards defined in @prompts/COMMON.md

## Integration Points
- Configuration management via `internal/config`
- Event processing through `pkg/events` and `pkg/market`
- Communication layer via the universal message bus
- Data persistence through the data store module
- Monitoring and metrics collection