refactor: move all remaining files to orig/ directory
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>
This commit is contained in:
175
orig/scripts/README.md
Normal file
175
orig/scripts/README.md
Normal file
@@ -0,0 +1,175 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user