566f3f03ca
Added comprehensive Docker support to the launcher script with: - New --docker flag to run bot in containerized environment - Docker and docker-compose availability checks - Automatic .env.docker generation with ARBITRUM_RPC_ENDPOINT - docker-compose build --no-cache for image building - docker-compose up/down for container lifecycle management - Proper error handling when Docker/docker-compose not found - Graceful container shutdown on Ctrl+C Docker execution path provides: - 3-step pre-flight verification (Docker detection, env setup, build) - Full environment variable configuration - Container health check integration - Resource limits (2 CPU, 2GB RAM limits) - Auto-restart policy for production reliability Native execution path continues unchanged: - Binary compilation if needed - Full pre-flight checks (5 steps) - Environment variable setup - Graceful startup and shutdown Testing Results: ✅ Docker path properly detected ✅ Native path executes successfully ✅ All pre-flight checks pass ✅ Bot initializes all 20+ services correctly 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
MEV Bot Scripts Directory
This directory contains all operational, utility, and development scripts for the MEV Bot project.
Core Scripts
Build & Runtime
- build.sh - Universal Go build script with configurable options
- run.sh - Main MEV bot execution script with production environment loading
- test.sh - Basic test runner
Log Management
- log-manager.sh ⭐ Production-grade log management system
- Real-time analysis and health monitoring
- Performance tracking with MEV metrics
- Corruption detection and alerting
- Background daemon and dashboard generation
- See:
./scripts/log-manager.sh --help
CI/CD & Quality Assurance
Primary CI Pipeline
- ../harness/local-ci-pipeline.sh - Comprehensive CI/CD pipeline
- ci-precommit.sh - Fast pre-commit validation (10-30s)
- ci-quick.sh - Quick CI pipeline (30-60s)
- ci-dev.sh - Development CI pipeline (1-2min)
- ci-full.sh - Full CI pipeline (3-5min)
- ci-container.sh - Containerized CI execution
- ci-watch.sh - Watch mode for continuous validation
Testing
- test-runner.sh - Configurable test execution (levels: basic, unit, integration, comprehensive, audit)
- run_audit_suite.sh - Mathematical correctness audit
- security-validation.sh - Comprehensive security validation
- quick-test.sh - Quick fix validation (30s)
- run-stress-tests.sh - Stress testing
- run-fork-tests.sh - Blockchain fork testing
Deployment & Production
Contract Deployment
- deploy-contracts.sh - Deploy smart contracts to Arbitrum
- verify-contracts.sh - Verify contracts on Arbiscan
- deploy-staging.sh - Staging environment deployment
- deploy-production.sh - Full production deployment with Docker Compose
Production Operations
- production-start.sh - Start production MEV bot
- production-validation.sh - Pre-deployment validation checks
- pre-run-validation.sh - Environment validation before startup
Wallet Management
- setup-keystore.sh - Encrypt and securely store private keys (AES-256-CBC)
- fund-bot-wallet.sh - Fund MEV bot wallet using Foundry cast
- check-wallet-balance.sh - Check wallet balance on Arbitrum One
Monitoring & Analysis
- watch-live.sh - Real-time MEV bot activity monitor
- analyze.sh - Comprehensive system analysis (tests, benchmarks, coverage, static analysis)
- performance-profile.sh - Performance profiling with pprof
Development Utilities
Environment Setup
- setup-env.sh - Environment variable setup
- setup-dev.sh - Development environment setup
- fix-rpc-config.sh - Fix RPC configuration issues
Git Workflow
- git-hooks-setup.sh - Install git hooks
- git-enhanced.sh - Enhanced git workflow commands
- git-local-server.sh - Local git server simulation
Data & Code Generation
- fetch_arbiscan_tx.sh - Fetch transaction data from Arbiscan
- extract_multicall_fixture.sh - Extract multicall fixtures for testing
- refresh-mev-datasets.sh - Update MEV research datasets
- generate-bindings.sh - Generate Go bindings for smart contracts
Other Utilities
- kill-bot.sh - Stop running MEV bot processes
- dependency-scan.sh - Scan for dependency vulnerabilities
- verify-organization.sh - Verify project organization
- 24h-validation-test.sh - 24-hour validation test
Special Directories
deprecated/
Contains scripts that have been superseded by better alternatives. See deprecated/README.md for migration guide.
Replaced by log-manager.sh:
- archive-logs.sh
- quick-archive.sh
- view-latest-archive.sh
- rotate-logs.sh
- setup-log-rotation.sh
demos/
Contains demonstration and example scripts for testing purposes only. Not for production use.
Quick Reference
Development Workflow
# Setup
./scripts/setup-dev.sh
# Quick validation
./scripts/ci-precommit.sh
# Run tests
./scripts/test-runner.sh --level comprehensive --coverage
# Security check
./scripts/security-validation.sh
# Math audit
./scripts/run_audit_suite.sh
Production Deployment
# Validate environment
./scripts/production-validation.sh
# Deploy contracts
./scripts/deploy-contracts.sh
# Setup wallet
./scripts/setup-keystore.sh
./scripts/check-wallet-balance.sh
# Deploy and start
./scripts/deploy-production.sh
./scripts/run.sh
Monitoring
# Live activity monitor
./scripts/watch-live.sh
# Log management
./scripts/log-manager.sh analyze
./scripts/log-manager.sh health
./scripts/log-manager.sh dashboard
# Performance profiling
./scripts/performance-profile.sh
Documentation
For detailed script analysis and recommendations, see:
- docs/SCRIPT_ANALYSIS_REPORT.md - Comprehensive script analysis
- Makefile - Build automation targets and workflows
Contributing
When adding new scripts:
- Make scripts executable:
chmod +x script-name.sh - Add shebang:
#!/bin/bashor#!/usr/bin/env bash - Use set -e for error handling
- Add descriptive comments
- Update this README
- Add help text (use --help flag)
Total Scripts: 80+ Active Scripts: 50+ Deprecated Scripts: 5 Demo Scripts: 1