feat(safety): add comprehensive production safety documentation
- Created .env.production.safe with all safety settings - Conservative profit thresholds (0.05 ETH min) - Strict risk limits (1 ETH max position, 10 ETH daily) - Circuit breaker configuration - Emergency stop mechanisms - Dry-run mode for testing - Created PRODUCTION_DEPLOYMENT_GUIDE.md (20+ pages) - 4-phase deployment sequence (dry-run → testnet → micro-test → scale-up) - Safety mechanisms documentation - Monitoring requirements - Infrastructure requirements - Troubleshooting guide - Legal/compliance warnings - Created SAFETY_CHECKLIST.md (quick reference) - Pre-deployment checklist - Daily/weekly monitoring tasks - Emergency procedures - Capital scale-up guidelines - Red flags and stop criteria Safety Features: ✅ Dry-run mode (simulation only) ✅ Circuit breaker (3 consecutive losses / hourly loss limits) ✅ Emergency stop file-based kill switch ✅ Position size limits ✅ Daily volume limits ✅ Slippage protection (1% max) ✅ Gas price limits (50 gwei max) ✅ Rate limiting (max trades per hour) Production Status: TESTING PHASE - Safe for small-scale testing only Next Steps: 1. Follow deployment guide Phase 1 (dry-run for 24+ hours) 2. Validate profit calculations 3. Test circuit breaker 4. Test on testnet before mainnet 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Administrator
205
.env.production.safe
Normal file
205
.env.production.safe
Normal file
@@ -0,0 +1,205 @@
|
||||
# MEV Bot V2 - Production Safety Configuration
|
||||
# ================================================
|
||||
# DO NOT deploy without reviewing ALL settings below
|
||||
# This configuration prioritizes safety over profitability
|
||||
|
||||
# ================================
|
||||
# BLOCKCHAIN CONNECTION
|
||||
# ================================
|
||||
# CRITICAL: Use archive RPC provider for production
|
||||
RPC_URL=https://arb-mainnet.g.alchemy.com/v2/YOUR_ALCHEMY_KEY
|
||||
WS_URL=wss://arb-mainnet.g.alchemy.com/v2/YOUR_ALCHEMY_KEY
|
||||
SEQUENCER_WS_URL=wss://arb1.arbitrum.io/ws
|
||||
CHAIN_ID=42161
|
||||
|
||||
# ================================
|
||||
# WALLET CONFIGURATION
|
||||
# ================================
|
||||
# WARNING: Protect this key - use hardware wallet for large funds
|
||||
PRIVATE_KEY=your_private_key_here
|
||||
|
||||
# EXECUTOR CONTRACT: Set to your deployed flashloan contract address
|
||||
# Leave as 0x0 if not using flashloans
|
||||
EXECUTOR_CONTRACT=0x0000000000000000000000000000000000000000
|
||||
|
||||
# ================================
|
||||
# SAFETY MODE
|
||||
# ================================
|
||||
# DRY RUN: Set to "true" for simulation-only (NO REAL TRANSACTIONS)
|
||||
# ONLY set to "false" after thorough testing
|
||||
DRY_RUN_MODE=true
|
||||
|
||||
# EXECUTION: Disable actual execution until validated
|
||||
ENABLE_EXECUTION=false
|
||||
|
||||
# SIMULATION: Always keep enabled for safety checks
|
||||
ENABLE_SIMULATION=true
|
||||
|
||||
# FRONT-RUNNING: Disable until profit calculations validated
|
||||
ENABLE_FRONT_RUNNING=false
|
||||
|
||||
# ================================
|
||||
# PROFIT THRESHOLDS (Conservative)
|
||||
# ================================
|
||||
# Minimum profit required (in wei): 0.05 ETH = very conservative
|
||||
MIN_PROFIT_WEI=50000000000000000
|
||||
|
||||
# Minimum ROI: 5% = conservative (rejects marginal opportunities)
|
||||
MIN_ROI=0.05
|
||||
|
||||
# Minimum swap amount to consider (in wei): 0.1 ETH
|
||||
MIN_SWAP_AMOUNT=100000000000000000
|
||||
|
||||
# Minimum pool liquidity (in wei): $50,000 equivalent
|
||||
MIN_POOL_LIQUIDITY=50000000000000000000000
|
||||
|
||||
# ================================
|
||||
# RISK LIMITS (Strict)
|
||||
# ================================
|
||||
# Maximum position size per trade: 1 ETH = very conservative
|
||||
MAX_POSITION_SIZE=1000000000000000000
|
||||
|
||||
# Maximum daily trading volume: 10 ETH = strict daily limit
|
||||
MAX_DAILY_VOLUME=10000000000000000000
|
||||
|
||||
# Maximum slippage tolerance: 1% = strict (prevents sandwich attacks)
|
||||
MAX_SLIPPAGE_BPS=100
|
||||
|
||||
# Maximum gas limit per transaction: 1.5M gas
|
||||
MAX_GAS_LIMIT=1500000
|
||||
|
||||
# Maximum gas price: 50 gwei (prevents overpaying during spikes)
|
||||
MAX_GAS_PRICE_GWEI=50
|
||||
|
||||
# ================================
|
||||
# CIRCUIT BREAKER THRESHOLDS
|
||||
# ================================
|
||||
# Stop trading after this many consecutive losses
|
||||
MAX_CONSECUTIVE_LOSSES=3
|
||||
|
||||
# Stop trading if hourly loss exceeds this (in wei): 0.1 ETH
|
||||
MAX_HOURLY_LOSS=100000000000000000
|
||||
|
||||
# Stop trading if daily loss exceeds this (in wei): 0.5 ETH
|
||||
MAX_DAILY_LOSS=500000000000000000
|
||||
|
||||
# Cooldown period after circuit breaker trips (seconds): 1 hour
|
||||
CIRCUIT_BREAKER_COOLDOWN=3600
|
||||
|
||||
# ================================
|
||||
# GAS STRATEGY (Conservative)
|
||||
# ================================
|
||||
# Gas price strategy: "safe" = lower gas, slower inclusion
|
||||
# Options: safe, standard, fast, ultra
|
||||
GAS_PRICE_STRATEGY=safe
|
||||
|
||||
# Gas price multiplier: 1.0 = no markup (safer)
|
||||
GAS_PRICE_MULTIPLIER=1.0
|
||||
|
||||
# ================================
|
||||
# EXECUTION SETTINGS
|
||||
# ================================
|
||||
# Use private RPC for transaction submission (reduces MEV risk)
|
||||
USE_PRIVATE_RPC=false
|
||||
PRIVATE_RPC_URL=
|
||||
|
||||
# Transaction confirmation blocks: 1 for Arbitrum
|
||||
CONFIRMATION_BLOCKS=1
|
||||
|
||||
# Transaction timeout: 2 minutes
|
||||
TX_TIMEOUT_SECONDS=120
|
||||
|
||||
# Maximum retries for failed transactions
|
||||
MAX_TX_RETRIES=2
|
||||
|
||||
# ================================
|
||||
# ARBITRAGE DETECTION
|
||||
# ================================
|
||||
# Maximum hops in arbitrage path: 2 = simple, safer
|
||||
MAX_HOPS=2
|
||||
|
||||
# Maximum paths to evaluate per opportunity: 50 = focused
|
||||
MAX_PATHS=50
|
||||
|
||||
# Maximum concurrent opportunity evaluations: 5 = conservative
|
||||
MAX_CONCURRENT_DETECTION=5
|
||||
|
||||
# ================================
|
||||
# POOL DISCOVERY
|
||||
# ================================
|
||||
# Maximum pools to discover and monitor: 100 = focused set
|
||||
MAX_POOLS_TO_DISCOVER=100
|
||||
|
||||
# Pool discovery interval (seconds): 5 minutes
|
||||
POOL_DISCOVERY_INTERVAL=300
|
||||
|
||||
# ================================
|
||||
# PERFORMANCE
|
||||
# ================================
|
||||
# Worker count for parallel processing: 4 = moderate
|
||||
WORKER_COUNT=4
|
||||
|
||||
# Buffer size for event processing: 100
|
||||
BUFFER_SIZE=100
|
||||
|
||||
# ================================
|
||||
# MONITORING & ALERTS
|
||||
# ================================
|
||||
# Metrics server port
|
||||
METRICS_PORT=9090
|
||||
|
||||
# Enable detailed logging
|
||||
LOG_LEVEL=info
|
||||
|
||||
# Alert webhook URL (for Slack/Discord/Telegram)
|
||||
ALERT_WEBHOOK_URL=
|
||||
|
||||
# Alert on circuit breaker trip
|
||||
ALERT_ON_CIRCUIT_BREAKER=true
|
||||
|
||||
# Alert on large loss (threshold in wei): 0.05 ETH
|
||||
ALERT_LOSS_THRESHOLD=50000000000000000
|
||||
|
||||
# ================================
|
||||
# EMERGENCY CONTROLS
|
||||
# ================================
|
||||
# Emergency stop file path - create this file to stop bot immediately
|
||||
EMERGENCY_STOP_FILE=/tmp/mev-bot-emergency-stop
|
||||
|
||||
# Auto-restart after emergency stop (dangerous - keep false)
|
||||
AUTO_RESTART_AFTER_EMERGENCY_STOP=false
|
||||
|
||||
# ================================
|
||||
# ADDITIONAL SAFETY FEATURES
|
||||
# ================================
|
||||
# Require manual confirmation for each trade (testing only)
|
||||
REQUIRE_MANUAL_CONFIRMATION=true
|
||||
|
||||
# Maximum trades per hour: 10 = rate limiting
|
||||
MAX_TRADES_PER_HOUR=10
|
||||
|
||||
# Blacklist pools (comma-separated addresses of problematic pools)
|
||||
BLACKLISTED_POOLS=
|
||||
|
||||
# Whitelist tokens only (comma-separated addresses - empty = allow all)
|
||||
WHITELISTED_TOKENS=
|
||||
|
||||
# ================================
|
||||
# NOTES FOR PRODUCTION
|
||||
# ================================
|
||||
# Before deploying to production:
|
||||
#
|
||||
# 1. Set DRY_RUN_MODE=true initially and monitor for 24+ hours
|
||||
# 2. Verify profit calculations match expected values
|
||||
# 3. Ensure circuit breaker triggers correctly
|
||||
# 4. Test emergency stop mechanism
|
||||
# 5. Set up monitoring/alerting
|
||||
# 6. Start with minimal position sizes
|
||||
# 7. Gradually increase limits after validating profitability
|
||||
# 8. NEVER set ENABLE_EXECUTION=true without thorough testing
|
||||
#
|
||||
# Recommended deployment sequence:
|
||||
# Day 1: DRY_RUN_MODE=true (monitor only)
|
||||
# Day 2-3: If stable, test with ENABLE_EXECUTION=true but MAX_POSITION_SIZE=0.1 ETH
|
||||
# Day 4-7: If profitable, increase to MAX_POSITION_SIZE=0.5 ETH
|
||||
# Week 2+: If consistently profitable, gradually increase limits
|
||||
561
PRODUCTION_DEPLOYMENT_GUIDE.md
Normal file
561
PRODUCTION_DEPLOYMENT_GUIDE.md
Normal file
@@ -0,0 +1,561 @@
|
||||
# MEV Bot V2 - Production Deployment Safety Guide
|
||||
|
||||
**STATUS:** ⚠️ **PRE-PRODUCTION - NOT SAFE FOR LARGE CAPITAL YET**
|
||||
|
||||
---
|
||||
|
||||
## 🚨 CRITICAL: Read This First
|
||||
|
||||
**DO NOT deploy to production with significant capital until:**
|
||||
1. ✅ All safety mechanisms are tested
|
||||
2. ✅ Profit calculations validated with known scenarios
|
||||
3. ✅ 24+ hours of dry-run monitoring completed
|
||||
4. ✅ Emergency stop tested and working
|
||||
5. ✅ Monitoring/alerting configured and tested
|
||||
|
||||
**Current Status:** Bot is in TESTING phase. Suitable for small-scale testing only.
|
||||
|
||||
---
|
||||
|
||||
## Safety-First Deployment Sequence
|
||||
|
||||
### Phase 1: Dry-Run Validation (Days 1-3)
|
||||
|
||||
**Objective:** Validate detection without risking capital
|
||||
|
||||
**Configuration:**
|
||||
```bash
|
||||
DRY_RUN_MODE=true
|
||||
ENABLE_EXECUTION=false
|
||||
ENABLE_SIMULATION=true
|
||||
MIN_PROFIT_WEI=50000000000000000 # 0.05 ETH - conservative
|
||||
```
|
||||
|
||||
**Actions:**
|
||||
1. Deploy with `.env.production.safe` configuration
|
||||
2. Monitor logs for 24+ hours continuously
|
||||
3. Verify opportunities are detected correctly
|
||||
4. Check profit calculations match expected values
|
||||
5. Ensure no false positives
|
||||
|
||||
**Success Criteria:**
|
||||
- ✅ Bot runs stable for 24+ hours
|
||||
- ✅ No crashes or errors
|
||||
- ✅ Profit calculations look reasonable
|
||||
- ✅ Pool data updates correctly
|
||||
|
||||
**DO NOT PROCEED** if success criteria not met.
|
||||
|
||||
---
|
||||
|
||||
### Phase 2: Testnet Validation (Days 4-7)
|
||||
|
||||
**Objective:** Test execution logic without real money
|
||||
|
||||
**Configuration:**
|
||||
```bash
|
||||
# Use Arbitrum Sepolia/Goerli testnet
|
||||
CHAIN_ID=421614 # Arbitrum Sepolia
|
||||
RPC_URL=https://sepolia-rollup.arbitrum.io/rpc
|
||||
ENABLE_EXECUTION=true
|
||||
MAX_POSITION_SIZE=100000000000000000 # 0.1 ETH testnet funds
|
||||
```
|
||||
|
||||
**Actions:**
|
||||
1. Get testnet ETH from faucet
|
||||
2. Deploy on testnet
|
||||
3. Execute actual transactions
|
||||
4. Monitor profit/loss carefully
|
||||
5. Test circuit breaker triggers
|
||||
6. Test emergency stop
|
||||
|
||||
**Success Criteria:**
|
||||
- ✅ Transactions execute successfully
|
||||
- ✅ Profit calculations accurate (compare pre/post trade)
|
||||
- ✅ Circuit breaker stops trading after losses
|
||||
- ✅ Emergency stop works immediately
|
||||
- ✅ No unexpected behavior
|
||||
|
||||
**DO NOT PROCEED** to mainnet if any failures.
|
||||
|
||||
---
|
||||
|
||||
### Phase 3: Mainnet Micro-Testing (Days 8-14)
|
||||
|
||||
**Objective:** Validate on mainnet with minimal capital
|
||||
|
||||
**Configuration:**
|
||||
```bash
|
||||
# Mainnet with strict safety limits
|
||||
CHAIN_ID=42161
|
||||
RPC_URL=https://arb-mainnet.g.alchemy.com/v2/YOUR_KEY # Archive RPC required!
|
||||
ENABLE_EXECUTION=true
|
||||
MAX_POSITION_SIZE=100000000000000000 # 0.1 ETH - TINY positions
|
||||
MAX_DAILY_VOLUME=500000000000000000 # 0.5 ETH daily max
|
||||
MAX_TRADES_PER_HOUR=5 # Rate limit
|
||||
```
|
||||
|
||||
**Capital Required:** 0.5-1 ETH (amount you're willing to lose)
|
||||
|
||||
**Actions:**
|
||||
1. Fund wallet with SMALL amount only
|
||||
2. Enable execution with strict limits
|
||||
3. Monitor CONTINUOUSLY for first 24 hours
|
||||
4. Track every trade manually
|
||||
5. Calculate actual profit/loss
|
||||
6. Verify gas costs match predictions
|
||||
|
||||
**Success Criteria:**
|
||||
- ✅ Net profitable over 7 days (including gas)
|
||||
- ✅ No unexpected losses
|
||||
- ✅ Circuit breaker triggers appropriately
|
||||
- ✅ Monitoring/alerts working
|
||||
|
||||
**IF UNPROFITABLE:** Stop immediately, debug issues
|
||||
|
||||
---
|
||||
|
||||
### Phase 4: Gradual Scale-Up (Weeks 3-8)
|
||||
|
||||
**Objective:** Slowly increase capital if consistently profitable
|
||||
|
||||
**Only if Phase 3 was net profitable:**
|
||||
|
||||
| Week | Max Position | Max Daily Volume | Notes |
|
||||
|------|--------------|------------------|-------|
|
||||
| 3 | 0.25 ETH | 1 ETH | Still testing |
|
||||
| 4 | 0.5 ETH | 2 ETH | Monitor closely |
|
||||
| 5 | 1 ETH | 5 ETH | If profitable, continue |
|
||||
| 6 | 2 ETH | 10 ETH | Standard operation |
|
||||
| 7-8 | 3-5 ETH | 20 ETH | Mature operation |
|
||||
|
||||
**Rules:**
|
||||
- If ANY week is unprofitable, revert to previous week's limits
|
||||
- Track ROI weekly - stop if declining
|
||||
- Monitor gas costs - stop if eating profits
|
||||
|
||||
---
|
||||
|
||||
## 🛡️ Safety Mechanisms
|
||||
|
||||
### 1. Circuit Breaker
|
||||
|
||||
**Triggers:**
|
||||
- 3 consecutive losing trades
|
||||
- Hourly loss > 0.1 ETH
|
||||
- Daily loss > 0.5 ETH
|
||||
|
||||
**Action:** Immediately stop trading for 1 hour cooldown
|
||||
|
||||
**Testing:**
|
||||
```bash
|
||||
# Manually trigger by creating test scenario
|
||||
# Verify bot stops and doesn't restart automatically
|
||||
```
|
||||
|
||||
### 2. Emergency Stop
|
||||
|
||||
**File-based kill switch:**
|
||||
```bash
|
||||
# Create this file to stop bot immediately
|
||||
touch /tmp/mev-bot-emergency-stop
|
||||
|
||||
# Bot checks this file every 10 seconds
|
||||
# Gracefully stops all operations
|
||||
```
|
||||
|
||||
**Testing:**
|
||||
```bash
|
||||
# While bot running in testnet:
|
||||
touch /tmp/mev-bot-emergency-stop
|
||||
# Bot should log "Emergency stop detected" and exit within 10s
|
||||
```
|
||||
|
||||
### 3. Position Size Limits
|
||||
|
||||
**Prevents large losses from single trade:**
|
||||
- MAX_POSITION_SIZE enforced before execution
|
||||
- MAX_DAILY_VOLUME enforced cumulatively
|
||||
- Transactions rejected if limits exceeded
|
||||
|
||||
### 4. Slippage Protection
|
||||
|
||||
**Prevents sandwich attacks and price manipulation:**
|
||||
- MAX_SLIPPAGE_BPS: 100 (1%) - very strict
|
||||
- Simulation runs before every trade
|
||||
- Trade rejected if simulated output < expected
|
||||
|
||||
### 5. Gas Price Limits
|
||||
|
||||
**Prevents overpaying during network congestion:**
|
||||
- MAX_GAS_PRICE_GWEI: 50 gwei
|
||||
- Transactions rejected if gas price higher
|
||||
- Use GAS_PRICE_STRATEGY=safe for lower gas
|
||||
|
||||
---
|
||||
|
||||
## 📊 Monitoring Requirements
|
||||
|
||||
### Essential Metrics to Track
|
||||
|
||||
**1. Profitability Metrics**
|
||||
- Gross profit per trade
|
||||
- Net profit after gas
|
||||
- ROI percentage
|
||||
- Win rate (profitable trades / total trades)
|
||||
|
||||
**2. Execution Metrics**
|
||||
- Trade execution latency
|
||||
- Gas costs per trade
|
||||
- Failed transactions
|
||||
- Successful vs failed trade ratio
|
||||
|
||||
**3. Safety Metrics**
|
||||
- Circuit breaker triggers
|
||||
- Emergency stops
|
||||
- Position size violations
|
||||
- Daily volume tracking
|
||||
|
||||
**4. System Health**
|
||||
- RPC connection status
|
||||
- WebSocket connection status
|
||||
- Pool cache size
|
||||
- Memory/CPU usage
|
||||
|
||||
### Monitoring Tools
|
||||
|
||||
**Prometheus + Grafana** (included in repo):
|
||||
```bash
|
||||
docker-compose up -d prometheus grafana
|
||||
# Access Grafana at http://localhost:3000
|
||||
```
|
||||
|
||||
**Log Monitoring:**
|
||||
```bash
|
||||
# Tail logs in real-time
|
||||
docker logs -f mev-bot-v2
|
||||
|
||||
# Filter for profits
|
||||
docker logs mev-bot-v2 | grep "profit"
|
||||
|
||||
# Filter for errors
|
||||
docker logs mev-bot-v2 | grep "ERROR\|WARN"
|
||||
```
|
||||
|
||||
**Alerting** (recommended):
|
||||
- Set up Slack/Discord/Telegram webhook
|
||||
- Alert on circuit breaker triggers
|
||||
- Alert on large losses (> 0.05 ETH)
|
||||
- Alert on system errors
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Production Infrastructure
|
||||
|
||||
### Required Infrastructure
|
||||
|
||||
**1. Archive RPC Provider** (CRITICAL)
|
||||
- ❌ Public RPC insufficient
|
||||
- ✅ Use: Alchemy, QuickNode, or Infura
|
||||
- Cost: ~$200-500/month for archive access
|
||||
- Required for pool discovery and state queries
|
||||
|
||||
**2. Private RPC (Recommended)**
|
||||
- Reduces MEV risk on transaction submission
|
||||
- Flashbots Protect or private mempool
|
||||
- Cost: Free (Flashbots) or ~$100/month
|
||||
|
||||
**3. Dedicated Server**
|
||||
- Minimum: 4 CPU cores, 8GB RAM
|
||||
- Recommended: 8 CPU cores, 16GB RAM
|
||||
- Low latency network connection to RPC
|
||||
- Uptime: 99.9%+
|
||||
|
||||
**4. Monitoring Stack**
|
||||
- Prometheus for metrics
|
||||
- Grafana for visualization
|
||||
- Alerting service (PagerDuty, Slack, etc.)
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Known Limitations & Risks
|
||||
|
||||
### Technical Limitations
|
||||
|
||||
1. **WebSocket Sequencer Connection**
|
||||
- Status: Not fully stable on Anvil fork
|
||||
- Impact: May miss some pending transactions
|
||||
- Mitigation: Test on live testnet/mainnet
|
||||
|
||||
2. **Pool Discovery**
|
||||
- Currently uses hardcoded pools for testing
|
||||
- Production needs archive RPC for discovery
|
||||
- May miss new pools initially
|
||||
|
||||
3. **Gas Estimation**
|
||||
- Estimates may be inaccurate under high load
|
||||
- May overpay or fail transactions
|
||||
- Needs more testing
|
||||
|
||||
4. **Profit Calculations**
|
||||
- Not validated against known scenarios yet
|
||||
- Risk of calculation errors
|
||||
- MUST test extensively before large capital
|
||||
|
||||
### Market Risks
|
||||
|
||||
1. **Competition**
|
||||
- Other MEV bots may front-run
|
||||
- Profits may be lower than expected
|
||||
- Need low latency connection
|
||||
|
||||
2. **Gas Price Volatility**
|
||||
- Network congestion can spike gas
|
||||
- May eat into profits
|
||||
- Circuit breaker helps limit damage
|
||||
|
||||
3. **Smart Contract Risks**
|
||||
- DEX contracts could have bugs
|
||||
- Pools could be manipulated
|
||||
- Use whitelisted pools only initially
|
||||
|
||||
4. **Slippage & Sandwich Attacks**
|
||||
- Larger trades more susceptible
|
||||
- Strict slippage limits help
|
||||
- Consider splitting large trades
|
||||
|
||||
---
|
||||
|
||||
## 📋 Pre-Deployment Checklist
|
||||
|
||||
### Infrastructure
|
||||
|
||||
- [ ] Archive RPC provider configured and tested
|
||||
- [ ] Private RPC configured (optional but recommended)
|
||||
- [ ] Server meets minimum specs
|
||||
- [ ] Monitoring stack deployed (Prometheus + Grafana)
|
||||
- [ ] Alerting configured and tested
|
||||
- [ ] Backup wallet key secured (hardware wallet recommended)
|
||||
|
||||
### Configuration
|
||||
|
||||
- [ ] `.env.production.safe` reviewed and customized
|
||||
- [ ] All safety limits set conservatively
|
||||
- [ ] DRY_RUN_MODE=true initially
|
||||
- [ ] ENABLE_EXECUTION=false initially
|
||||
- [ ] Gas limits appropriate
|
||||
- [ ] Slippage tolerance conservative
|
||||
|
||||
### Testing
|
||||
|
||||
- [ ] Dry-run completed (24+ hours)
|
||||
- [ ] Profit calculations validated
|
||||
- [ ] Circuit breaker tested
|
||||
- [ ] Emergency stop tested
|
||||
- [ ] Testnet deployment successful
|
||||
- [ ] Manual trades verified profitable
|
||||
|
||||
### Monitoring
|
||||
|
||||
- [ ] Grafana dashboards configured
|
||||
- [ ] Alerts set up for losses
|
||||
- [ ] Alerts set up for circuit breaker
|
||||
- [ ] Alerts set up for system errors
|
||||
- [ ] Log rotation configured
|
||||
- [ ] Backup/restore tested
|
||||
|
||||
### Safety
|
||||
|
||||
- [ ] Emergency stop file path configured
|
||||
- [ ] Circuit breaker thresholds set
|
||||
- [ ] Position limits conservative
|
||||
- [ ] Daily volume limits set
|
||||
- [ ] Gas price limits set
|
||||
- [ ] Whitelist/blacklist configured (if needed)
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Deployment Commands
|
||||
|
||||
### Step 1: Build Docker Image
|
||||
|
||||
```bash
|
||||
docker build -t mev-bot-v2:production .
|
||||
```
|
||||
|
||||
### Step 2: Configure Environment
|
||||
|
||||
```bash
|
||||
# Copy safe configuration
|
||||
cp .env.production.safe .env.production
|
||||
|
||||
# Edit with your keys and RPC endpoints
|
||||
nano .env.production
|
||||
|
||||
# CRITICAL: Verify DRY_RUN_MODE=true for first deployment
|
||||
grep DRY_RUN_MODE .env.production
|
||||
```
|
||||
|
||||
### Step 3: Deploy with Docker
|
||||
|
||||
```bash
|
||||
# Start in dry-run mode
|
||||
docker run -d \
|
||||
--name mev-bot-v2-production \
|
||||
--restart unless-stopped \
|
||||
--env-file .env.production \
|
||||
-v $(pwd)/logs:/app/logs \
|
||||
-p 9090:9090 \
|
||||
mev-bot-v2:production
|
||||
|
||||
# Monitor logs in real-time
|
||||
docker logs -f mev-bot-v2-production
|
||||
```
|
||||
|
||||
### Step 4: Monitor & Validate
|
||||
|
||||
```bash
|
||||
# Check status
|
||||
docker ps | grep mev-bot
|
||||
|
||||
# View metrics
|
||||
curl http://localhost:9090/metrics
|
||||
|
||||
# Check for errors
|
||||
docker logs mev-bot-v2-production | grep ERROR | tail -50
|
||||
|
||||
# Monitor circuit breaker status
|
||||
docker logs mev-bot-v2-production | grep "circuit_breaker"
|
||||
```
|
||||
|
||||
### Step 5: Emergency Stop (if needed)
|
||||
|
||||
```bash
|
||||
# Method 1: File-based stop
|
||||
docker exec mev-bot-v2-production touch /tmp/mev-bot-emergency-stop
|
||||
|
||||
# Method 2: Graceful stop
|
||||
docker stop mev-bot-v2-production
|
||||
|
||||
# Method 3: Immediate stop
|
||||
docker kill mev-bot-v2-production
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📞 Support & Troubleshooting
|
||||
|
||||
### Common Issues
|
||||
|
||||
**Issue: Bot not finding opportunities**
|
||||
- Check RPC connection is working
|
||||
- Verify pool discovery running
|
||||
- Check MIN_PROFIT_WEI isn't too high
|
||||
- Review MIN_POOL_LIQUIDITY setting
|
||||
|
||||
**Issue: High gas costs eating profits**
|
||||
- Lower MAX_GAS_PRICE_GWEI
|
||||
- Use GAS_PRICE_STRATEGY=safe
|
||||
- Increase MIN_PROFIT_WEI threshold
|
||||
|
||||
**Issue: Circuit breaker triggering frequently**
|
||||
- Review trade profitability
|
||||
- Check profit calculations
|
||||
- Verify gas estimation accurate
|
||||
- May need to adjust MIN_PROFIT_WEI higher
|
||||
|
||||
**Issue: Missing transactions**
|
||||
- Check WebSocket connection stable
|
||||
- Verify archive RPC working
|
||||
- Review worker count settings
|
||||
- Check buffer size adequate
|
||||
|
||||
### Logs to Check
|
||||
|
||||
```bash
|
||||
# All errors
|
||||
docker logs mev-bot-v2-production 2>&1 | grep "ERROR"
|
||||
|
||||
# Profitable trades
|
||||
docker logs mev-bot-v2-production | grep "profit.*ETH"
|
||||
|
||||
# Circuit breaker events
|
||||
docker logs mev-bot-v2-production | grep "circuit_breaker"
|
||||
|
||||
# RPC issues
|
||||
docker logs mev-bot-v2-production | grep "RPC\|connection"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚖️ Legal & Compliance
|
||||
|
||||
**DISCLAIMER:**
|
||||
- MEV trading may be considered front-running in some jurisdictions
|
||||
- Ensure compliance with local regulations
|
||||
- This software is provided AS-IS with no warranties
|
||||
- Use at your own risk
|
||||
- Author not responsible for losses
|
||||
|
||||
**Recommendations:**
|
||||
- Consult legal counsel before deployment
|
||||
- Understand local securities/trading laws
|
||||
- Consider tax implications of trading
|
||||
- Maintain detailed trade records
|
||||
|
||||
---
|
||||
|
||||
## 📝 Post-Deployment Monitoring
|
||||
|
||||
### Daily Checks (First Week)
|
||||
|
||||
- [ ] Review all trades from last 24 hours
|
||||
- [ ] Calculate net profit/loss (including gas)
|
||||
- [ ] Check circuit breaker events
|
||||
- [ ] Review error logs
|
||||
- [ ] Verify RPC connection stable
|
||||
- [ ] Check wallet balance
|
||||
|
||||
### Weekly Checks (Ongoing)
|
||||
|
||||
- [ ] Calculate weekly ROI
|
||||
- [ ] Review most/least profitable pools
|
||||
- [ ] Analyze gas cost trends
|
||||
- [ ] Review system resource usage
|
||||
- [ ] Update pool blacklist if needed
|
||||
- [ ] Adjust parameters based on performance
|
||||
|
||||
### Monthly Reviews
|
||||
|
||||
- [ ] Comprehensive profit/loss analysis
|
||||
- [ ] Compare to market conditions
|
||||
- [ ] Review and update safety limits
|
||||
- [ ] Update dependencies/security patches
|
||||
- [ ] Backup configuration and logs
|
||||
- [ ] Review and optimize strategies
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Success Criteria
|
||||
|
||||
**Minimum viable production deployment:**
|
||||
- ✅ Profitable for 7+ consecutive days
|
||||
- ✅ ROI > 5% after gas costs
|
||||
- ✅ Win rate > 60%
|
||||
- ✅ No circuit breaker triggers from bugs
|
||||
- ✅ Emergency stop tested and working
|
||||
- ✅ Monitoring functional and alerting
|
||||
|
||||
**Ready for capital scale-up:**
|
||||
- ✅ Profitable for 30+ days
|
||||
- ✅ ROI > 10% monthly
|
||||
- ✅ Win rate > 70%
|
||||
- ✅ All safety mechanisms tested
|
||||
- ✅ No unexpected losses
|
||||
- ✅ Stable system performance
|
||||
|
||||
---
|
||||
|
||||
**Last Updated:** 2025-11-10
|
||||
**Version:** 1.0.0-rc1
|
||||
**Status:** Pre-Production
|
||||
179
SAFETY_CHECKLIST.md
Normal file
179
SAFETY_CHECKLIST.md
Normal file
@@ -0,0 +1,179 @@
|
||||
# MEV Bot V2 - Production Safety Checklist
|
||||
|
||||
⚠️ **DO NOT SKIP ANY ITEMS** - Each one prevents potential losses
|
||||
|
||||
---
|
||||
|
||||
## Pre-Deployment (MANDATORY)
|
||||
|
||||
### Configuration
|
||||
- [ ] `.env.production.safe` copied and customized
|
||||
- [ ] `DRY_RUN_MODE=true` initially
|
||||
- [ ] `ENABLE_EXECUTION=false` initially
|
||||
- [ ] Archive RPC provider configured (Alchemy/QuickNode)
|
||||
- [ ] Private key stored securely (hardware wallet recommended)
|
||||
- [ ] All safety limits set conservatively
|
||||
|
||||
### Testing
|
||||
- [ ] 24+ hours dry-run monitoring completed
|
||||
- [ ] Profit calculations manually verified
|
||||
- [ ] Circuit breaker tested (triggers on losses)
|
||||
- [ ] Emergency stop tested (creates file successfully)
|
||||
- [ ] Testnet deployment successful (if applicable)
|
||||
|
||||
### Infrastructure
|
||||
- [ ] Monitoring stack deployed (Prometheus + Grafana)
|
||||
- [ ] Alerting configured (Slack/Discord/Telegram)
|
||||
- [ ] Server meets minimum specs (4 CPU, 8GB RAM)
|
||||
- [ ] Low latency RPC connection verified (<100ms)
|
||||
|
||||
---
|
||||
|
||||
## Deployment Day
|
||||
|
||||
### Initial Launch (Dry-Run)
|
||||
- [ ] Deploy with `DRY_RUN_MODE=true`
|
||||
- [ ] Monitor logs continuously for 24 hours
|
||||
- [ ] Verify opportunities detected correctly
|
||||
- [ ] Check profit estimates look reasonable
|
||||
- [ ] No errors or warnings in logs
|
||||
|
||||
### Switch to Live Trading (If Dry-Run Successful)
|
||||
- [ ] Start with `MAX_POSITION_SIZE=0.1` ETH
|
||||
- [ ] Fund wallet with SMALL amount (0.5-1 ETH max)
|
||||
- [ ] Set `ENABLE_EXECUTION=true`
|
||||
- [ ] Monitor EVERY trade for first hour
|
||||
- [ ] Manually calculate profit/loss for first 10 trades
|
||||
|
||||
---
|
||||
|
||||
## Daily Monitoring (First Week)
|
||||
|
||||
- [ ] Check bot still running
|
||||
- [ ] Review all trades from last 24 hours
|
||||
- [ ] Calculate net P/L (including gas costs)
|
||||
- [ ] Check circuit breaker events
|
||||
- [ ] Review error logs
|
||||
- [ ] Verify wallet balance matches expectations
|
||||
|
||||
**If ANY day shows net loss: STOP and investigate**
|
||||
|
||||
---
|
||||
|
||||
## Weekly Review
|
||||
|
||||
- [ ] Calculate weekly ROI
|
||||
- [ ] Win rate > 60%?
|
||||
- [ ] Gas costs < 30% of profits?
|
||||
- [ ] No unexpected circuit breaker triggers?
|
||||
- [ ] System stable (no crashes)?
|
||||
- [ ] Adjust parameters if needed
|
||||
|
||||
**If unprofitable: DO NOT increase limits**
|
||||
|
||||
---
|
||||
|
||||
## Red Flags - STOP IMMEDIATELY If:
|
||||
|
||||
🚨 **Circuit breaker triggering frequently** (>3 times/day)
|
||||
🚨 **Consecutive losing days** (2+ days)
|
||||
🚨 **Gas costs exceeding profits**
|
||||
🚨 **Unexpected large losses** (>0.1 ETH single trade)
|
||||
🚨 **System errors or crashes**
|
||||
🚨 **RPC connection issues**
|
||||
|
||||
---
|
||||
|
||||
## Emergency Procedures
|
||||
|
||||
### Immediate Stop
|
||||
```bash
|
||||
# Method 1: Emergency file
|
||||
docker exec mev-bot-v2-production touch /tmp/mev-bot-emergency-stop
|
||||
|
||||
# Method 2: Container stop
|
||||
docker stop mev-bot-v2-production
|
||||
|
||||
# Method 3: Kill immediately
|
||||
docker kill mev-bot-v2-production
|
||||
```
|
||||
|
||||
### Post-Stop Actions
|
||||
1. Export all logs for analysis
|
||||
2. Calculate total P/L
|
||||
3. Identify root cause
|
||||
4. Fix issues before restart
|
||||
5. Test fixes on testnet
|
||||
6. Only restart if confident in fix
|
||||
|
||||
---
|
||||
|
||||
## Capital Scale-Up (ONLY if Profitable)
|
||||
|
||||
| Week | Condition | Max Position | Max Daily Volume |
|
||||
|------|-----------|--------------|------------------|
|
||||
| 1 | Testing | 0.1 ETH | 0.5 ETH |
|
||||
| 2 | Profitable Week 1 | 0.25 ETH | 1 ETH |
|
||||
| 3 | Profitable Week 2 | 0.5 ETH | 2 ETH |
|
||||
| 4+ | Profitable Week 3 | 1 ETH+ | 5 ETH+ |
|
||||
|
||||
**Rules:**
|
||||
- Each week must be NET profitable before increasing
|
||||
- ANY losing week = revert to previous limits
|
||||
- NEVER increase >2x in single week
|
||||
|
||||
---
|
||||
|
||||
## Safety Limits (NEVER Exceed Without Testing)
|
||||
|
||||
| Parameter | Conservative | Moderate | Aggressive |
|
||||
|-----------|--------------|----------|------------|
|
||||
| MAX_POSITION_SIZE | 0.1 ETH | 1 ETH | 5 ETH |
|
||||
| MAX_DAILY_VOLUME | 0.5 ETH | 5 ETH | 20 ETH |
|
||||
| MIN_PROFIT_WEI | 0.05 ETH | 0.02 ETH | 0.01 ETH |
|
||||
| MIN_ROI | 5% | 2% | 1% |
|
||||
| MAX_SLIPPAGE_BPS | 100 (1%) | 200 (2%) | 300 (3%) |
|
||||
| MAX_GAS_PRICE_GWEI | 25 | 50 | 100 |
|
||||
|
||||
**Start conservative, increase gradually ONLY if profitable**
|
||||
|
||||
---
|
||||
|
||||
## Required Metrics Tracking
|
||||
|
||||
### Profitability
|
||||
- [ ] Gross profit per trade
|
||||
- [ ] Net profit after gas
|
||||
- [ ] ROI percentage
|
||||
- [ ] Win rate
|
||||
- [ ] Largest win/loss
|
||||
|
||||
### Safety
|
||||
- [ ] Circuit breaker triggers
|
||||
- [ ] Emergency stops
|
||||
- [ ] Daily volume used
|
||||
- [ ] Position size violations
|
||||
|
||||
### Performance
|
||||
- [ ] Trade execution latency
|
||||
- [ ] Gas cost per trade
|
||||
- [ ] Failed transaction rate
|
||||
- [ ] Opportunities detected vs executed
|
||||
|
||||
---
|
||||
|
||||
## Contact & Support
|
||||
|
||||
**Before reaching out:**
|
||||
1. Export logs: `docker logs mev-bot-v2-production > debug.log`
|
||||
2. Calculate exact P/L
|
||||
3. Note specific error messages
|
||||
4. Check this checklist for missed items
|
||||
|
||||
**GitHub Issues:** https://github.com/your-org/mev-bot-v2/issues
|
||||
|
||||
---
|
||||
|
||||
**Remember: It's better to miss opportunities than lose capital**
|
||||
|
||||
**Start small, scale slowly, stop quickly if problems occur**
|
||||
Reference in New Issue
Block a user