c54c569f30
Completed clean root directory structure: - Root now contains only: .git, .env, docs/, orig/ - Moved all remaining files and directories to orig/: - Config files (.claude, .dockerignore, .drone.yml, etc.) - All .env variants (except active .env) - Git config (.gitconfig, .github, .gitignore, etc.) - Tool configs (.golangci.yml, .revive.toml, etc.) - Documentation (*.md files, @prompts) - Build files (Dockerfiles, Makefile, go.mod, go.sum) - Docker compose files - All source directories (scripts, tests, tools, etc.) - Runtime directories (logs, monitoring, reports) - Dependency files (node_modules, lib, cache) - Special files (--delete) - Removed empty runtime directories (bin/, data/) V2 structure is now clean: - docs/planning/ - V2 planning documents - orig/ - Complete V1 codebase preserved - .env - Active environment config (not in git) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
176 lines
5.1 KiB
Markdown
176 lines
5.1 KiB
Markdown
# 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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# 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:
|
|
1. Make scripts executable: `chmod +x script-name.sh`
|
|
2. Add shebang: `#!/bin/bash` or `#!/usr/bin/env bash`
|
|
3. Use set -e for error handling
|
|
4. Add descriptive comments
|
|
5. Update this README
|
|
6. Add help text (use --help flag)
|
|
|
|
---
|
|
|
|
**Total Scripts:** 80+
|
|
**Active Scripts:** 50+
|
|
**Deprecated Scripts:** 5
|
|
**Demo Scripts:** 1
|