mev-beta/OPENCODE.md

MEV Bot Project - OpenCode Context

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

Note: For a comprehensive understanding of the project structure, development guidelines, and AI assistant configuration, please refer to CLAUDE.md, which contains the complete project documentation.

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 (specifically cmd/mev-bot/main.go)
• internal/ - Private application and library code
  • internal/config - Configuration management
  • internal/logger - Logging functionality
  • internal/ratelimit - Rate limiting implementations
  • internal/utils - Utility functions
• pkg/ - Library code that can be used by external projects
  • pkg/events - Event processing system
  • pkg/market - Market data handling
  • pkg/monitor - Arbitrum sequencer monitoring
  • pkg/scanner - Market scanning functionality
  • pkg/test - Test utilities and helpers
  • pkg/uniswap - Uniswap V3 specific implementations
• config/ - Configuration files
• @prompts/ - AI prompts for development assistance
• docs/ - Documentation
• scripts/ - Scripts for building, testing, and deployment

OpenCode's Primary Focus Areas

As OpenCode, you're particularly skilled at:

1. Writing and Debugging Go Code

   • Implementing clean, idiomatic Go code
   • Following established patterns and conventions
   • Debugging complex concurrency issues

2. Implementing Test Cases and Ensuring Code Quality

   • Writing comprehensive unit and integration tests
   • Implementing property-based tests for mathematical functions
   • Creating performance benchmarks for critical paths

When working on this project, please focus on these areas where your strengths will be most beneficial.

For complete development guidelines, system architecture details, and comprehensive configuration information, please refer to CLAUDE.md.