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/bash or #!/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