# Core Packages Documentation

This section provides detailed documentation for each core package in the MEV Bot system. These packages implement the primary functionality of the bot.

## Documents in this Section

- [Arbitrage Package](ARBITRAGE_PACKAGE.md) - Arbitrage detection and execution
- [Market Package](MARKET_PACKAGE.md) - Market data management and analysis
- [Monitor Package](MONITOR_PACKAGE.md) - Arbitrum sequencer monitoring
- [Scanner Package](SCANNER_PACKAGE.md) - Market scanning and opportunity detection
- [Uniswap Pricing](../7_reference/UNISWAP_PRICING.md) - Mathematical pricing functions and optimizations
- [Configuration Package](CONFIG_PACKAGE.md) - Configuration management
- [Logger Package](LOGGER_PACKAGE.md) - Structured logging system
- [Security Package](SECURITY_PACKAGE.md) - Key management and security

## Package Relationships

The core packages work together to provide the complete MEV bot functionality:

1. **Monitor** → **Events** → **Market** - Data ingestion pipeline
2. **Market** → **Scanner** - Market analysis to opportunity detection
3. **Scanner** → **Arbitrage** - Opportunity detection to execution
4. **Configuration** - Provides settings for all packages
5. **Logger** - Provides logging for all packages
6. **Security** - Provides security services for all packages

## Package Descriptions

### Monitor Package
Responsible for real-time monitoring of the Arbitrum sequencer, detecting L2 messages and transactions, and subscribing to DEX events.

### Events Package
Parses and processes DEX interaction events, converting raw blockchain data into structured information for analysis.

### Market Package
Manages market data, including pool information, token metadata, and pricing data. Implements caching and concurrent processing.

### Scanner Package
Scans the market for potential arbitrage opportunities using worker pools and sophisticated algorithms.

### Arbitrage Package
Implements the core arbitrage detection and execution logic, including profitability calculations and transaction management.

### Configuration Package
Handles configuration loading from YAML files and environment variables, with validation and security features.

### Logger Package
Provides structured logging with separation of concerns, security filtering, and performance optimization.

### Security Package
Manages private keys, transaction signing, rate limiting, and audit logging for all security-sensitive operations.

For detailed information about each package, see the individual documentation files.