fix(multicall): resolve critical multicall parsing corruption issues

- Added comprehensive bounds checking to prevent buffer overruns in multicall parsing
- Implemented graduated validation system (Strict/Moderate/Permissive) to reduce false positives
- Added LRU caching system for address validation with 10-minute TTL
- Enhanced ABI decoder with missing Universal Router and Arbitrum-specific DEX signatures
- Fixed duplicate function declarations and import conflicts across multiple files
- Added error recovery mechanisms with multiple fallback strategies
- Updated tests to handle new validation behavior for suspicious addresses
- Fixed parser test expectations for improved validation system
- Applied gofmt formatting fixes to ensure code style compliance
- Fixed mutex copying issues in monitoring package by introducing MetricsSnapshot
- Resolved critical security vulnerabilities in heuristic address extraction
- Progress: Updated TODO audit from 10% to 35% complete

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

docs/master-plan/01-overview.md

@@ -0,0 +1,51 @@
+# MEV Bot Master Plan - Exchange Integration
+
+## Project Overview
+
+This document outlines the master plan for implementing exchange-specific helper/util/lib modules for the MEV bot. Each exchange will have its own set of functionality covering swaps, liquidity operations, and pricing mechanisms.
+
+## Objectives
+
+- Create exchange-specific helper libraries
+- Implement swap functionality for each exchange
+- Implement add/remove liquidity operations
+- Implement pricing mechanisms
+- Ensure consistent interfaces across exchanges
+
+## Supported Exchanges
+
+1. Uniswap V2/V3/V4
+2. SushiSwap
+3. Curve
+4. Balancer
+5. PancakeSwap
+6. Kyber (Elastic)
+7. Camelot
+8. Trader Joe
+9. Ramses
+10. Other DEX aggregators (1inch, ParaSwap, etc.)
+
+## Core Components
+
+Each exchange module will contain:
+
+- **Swap Operations**: Functions to execute token swaps
+- **Liquidity Operations**: Functions to add/remove liquidity from pools
+- **Pricing Functions**: Functions to calculate prices and slippage
+- **Pool Management**: Functions to interact with liquidity pools
+- **Arbitrage Detection**: Functions to identify profitable opportunities
+
+## Implementation Strategy
+
+1. Define common interfaces
+2. Implement exchange-specific modules
+3. Create unified abstraction layer
+4. Test functionality with real data
+5. Integrate with main bot logic
+
+## Success Metrics
+
+- Consistent API across all exchange modules
+- Performance benchmarks met
+- Successful execution of swaps and liquidity operations
+- Accurate pricing calculations