380 lines
9.6 KiB
Markdown
380 lines
9.6 KiB
Markdown
# MEV Bot V2 - Production Deployment Guide
|
|
|
|
**Last Updated:** 2025-11-11
|
|
**Status:** Ready for Mainnet Dry-Run Testing
|
|
**Test Results:** 12/12 Passing (100%)
|
|
|
|
---
|
|
|
|
## ⚠️ **Pre-Deployment Checklist**
|
|
|
|
### Critical Requirements
|
|
- [ ] Private key configured and secured
|
|
- [ ] Wallet funded (minimum 0.1 ETH for gas)
|
|
- [ ] RPC endpoints verified (mainnet Arbitrum)
|
|
- [ ] Emergency stop procedure documented and tested
|
|
- [ ] Monitoring alerts configured
|
|
- [ ] Team member available for 24h monitoring
|
|
|
|
### Safety Verification
|
|
- [x] All 12 safety tests passing
|
|
- [x] Emergency stop mechanism tested (8s detection)
|
|
- [x] Configuration values correct (no negative values)
|
|
- [x] Dry-run mode verified (0 transactions executed)
|
|
- [x] Circuit breaker configured (3 losses, 0.1 ETH hourly)
|
|
- [x] Position limits set (10 ETH max position, 100 ETH daily volume)
|
|
|
|
---
|
|
|
|
## 📋 **Deployment Phases**
|
|
|
|
### Phase 1: Mainnet Dry-Run (48 hours)
|
|
**Goal:** Validate arbitrage detection without executing trades
|
|
|
|
**Configuration:**
|
|
```bash
|
|
# .env settings for Phase 1
|
|
ENABLE_EXECUTION=false
|
|
DRY_RUN_MODE=true
|
|
ENABLE_SIMULATION=true
|
|
MIN_PROFIT_THRESHOLD=0.001 # 0.1%
|
|
```
|
|
|
|
**Success Criteria:**
|
|
- Bot runs stable for 48 hours
|
|
- Arbitrage opportunities detected
|
|
- No crashes or errors
|
|
- Profit calculations appear reasonable
|
|
|
|
**Monitoring:**
|
|
- Check logs every 4 hours
|
|
- Verify opportunities being detected
|
|
- Monitor resource usage (CPU, memory)
|
|
|
|
### Phase 2: Testnet Deployment (7 days)
|
|
**Status:** NOT READY - User requested Anvil fork only
|
|
|
|
**Note:** User specified deployments will be on Anvil fork of Arbitrum mainnet, not testnet.
|
|
|
|
### Phase 3: Minimal Capital Test (24-48 hours)
|
|
**Goal:** Execute real trades with minimal risk
|
|
|
|
**Configuration:**
|
|
```bash
|
|
# .env settings for Phase 3
|
|
ENABLE_EXECUTION=true
|
|
DRY_RUN_MODE=false
|
|
ENABLE_SIMULATION=true
|
|
|
|
# ULTRA-CONSERVATIVE LIMITS
|
|
MIN_PROFIT_THRESHOLD=0.01 # 1% minimum profit
|
|
MAX_POSITION_SIZE_ETH=0.01 # 0.01 ETH maximum
|
|
MAX_DAILY_VOLUME_ETH=0.1 # 0.1 ETH daily limit
|
|
MAX_CONSECUTIVE_LOSSES=1 # Stop after 1 loss
|
|
MAX_HOURLY_LOSS_ETH=0.01 # 0.01 ETH hourly loss limit
|
|
```
|
|
|
|
**Wallet Setup:**
|
|
- Use dedicated wallet (not primary funds)
|
|
- Fund with 0.1 ETH only
|
|
- Monitor balance every hour
|
|
|
|
**Success Criteria:**
|
|
- First trade executes successfully
|
|
- Profit/loss calculations accurate
|
|
- Circuit breaker triggers correctly if loss occurs
|
|
- Gas estimation within 10% of actual
|
|
|
|
### Phase 4: Gradual Scale-Up (1-2 weeks)
|
|
**Only proceed if Phase 3 succeeds**
|
|
|
|
**Week 1 Limits:**
|
|
```bash
|
|
MAX_POSITION_SIZE_ETH=0.1 # 0.1 ETH
|
|
MAX_DAILY_VOLUME_ETH=1.0 # 1.0 ETH
|
|
MAX_CONSECUTIVE_LOSSES=2 # 2 losses
|
|
```
|
|
|
|
**Week 2 Limits (if profitable):**
|
|
```bash
|
|
MAX_POSITION_SIZE_ETH=1.0 # 1 ETH
|
|
MAX_DAILY_VOLUME_ETH=10.0 # 10 ETH
|
|
MAX_CONSECUTIVE_LOSSES=3 # 3 losses
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 **Production Configuration**
|
|
|
|
### Environment Variables
|
|
|
|
**Required:**
|
|
```bash
|
|
# Wallet
|
|
PRIVATE_KEY=<your_private_key_hex> # 64-character hex (no 0x prefix)
|
|
|
|
# Arbitrum Mainnet RPC
|
|
ARBITRUM_RPC_ENDPOINT=wss://arbitrum-mainnet.core.chainstack.com/YOUR_KEY
|
|
ARBITRUM_WS_ENDPOINT=wss://arbitrum-mainnet.core.chainstack.com/YOUR_KEY
|
|
|
|
# Smart Contracts (Deployed)
|
|
CONTRACT_ARBITRAGE_EXECUTOR=0xec2a16d5f8ac850d08c4c7f67efd50051e7cfc0b
|
|
CONTRACT_FLASH_SWAPPER=0x5801ee5c2f6069e0f11cce7c0f27c2ef88e79a95
|
|
CONTRACT_UNISWAP_V2_FLASH_SWAPPER=0xc0b8c3e9a976ec67d182d7cb0283fb4496692593
|
|
|
|
# Arbiscan API
|
|
ARBISCAN_API_KEY=H8PEIY79385F4UKYU7MRV5IAT1BI1WYIVY
|
|
```
|
|
|
|
**Safety Settings:**
|
|
```bash
|
|
# Execution Control
|
|
ENABLE_EXECUTION=false # Start with false (dry-run)
|
|
DRY_RUN_MODE=true # Start with true
|
|
ENABLE_SIMULATION=true
|
|
ENABLE_FRONT_RUNNING=false
|
|
|
|
# Risk Limits (Conservative for Phase 1)
|
|
MIN_PROFIT_THRESHOLD=0.01 # 1% minimum
|
|
MAX_POSITION_SIZE_ETH=0.01 # 0.01 ETH
|
|
MAX_DAILY_VOLUME_ETH=0.1 # 0.1 ETH
|
|
MAX_SLIPPAGE_TOLERANCE=0.005 # 0.5%
|
|
|
|
# Circuit Breaker
|
|
MAX_CONSECUTIVE_LOSSES=1 # Stop after 1 loss
|
|
MAX_HOURLY_LOSS_ETH=0.01 # 0.01 ETH hourly
|
|
MAX_DAILY_LOSS_ETH=0.05 # 0.05 ETH daily
|
|
|
|
# Emergency Stop
|
|
EMERGENCY_STOP_FILE=/tmp/mev-bot-emergency-stop
|
|
```
|
|
|
|
---
|
|
|
|
## 🚀 **Deployment Commands**
|
|
|
|
### Build Production Image
|
|
```bash
|
|
podman build -t mev-bot-v2:production -f Dockerfile .
|
|
```
|
|
|
|
### Run with Production Config
|
|
```bash
|
|
podman run -d \
|
|
--name mev-bot-v2-prod \
|
|
--network host \
|
|
--restart unless-stopped \
|
|
--env-file .env \
|
|
-v $(pwd)/logs:/app/logs:z \
|
|
mev-bot-v2:production
|
|
```
|
|
|
|
### Monitor Logs
|
|
```bash
|
|
# Real-time logs
|
|
podman logs -f mev-bot-v2-prod
|
|
|
|
# Filter for opportunities
|
|
podman logs mev-bot-v2-prod 2>&1 | grep -i "opportunity"
|
|
|
|
# Filter for errors
|
|
podman logs mev-bot-v2-prod 2>&1 | grep -i "error"
|
|
|
|
# Check safety configuration
|
|
podman logs mev-bot-v2-prod 2>&1 | grep -A10 "SAFETY CONFIGURATION"
|
|
```
|
|
|
|
---
|
|
|
|
## 🚨 **Emergency Procedures**
|
|
|
|
### Immediate Stop
|
|
```bash
|
|
# Method 1: Emergency stop file (graceful, 10-second detection)
|
|
podman exec mev-bot-v2-prod touch /tmp/mev-bot-emergency-stop
|
|
|
|
# Method 2: Container stop (immediate)
|
|
podman stop mev-bot-v2-prod
|
|
|
|
# Method 3: Force kill (if unresponsive)
|
|
podman kill mev-bot-v2-prod
|
|
```
|
|
|
|
### Verification
|
|
```bash
|
|
# Check bot stopped
|
|
podman ps | grep mev-bot-v2-prod
|
|
|
|
# Check last logs
|
|
podman logs --tail 50 mev-bot-v2-prod
|
|
|
|
# Check wallet balance
|
|
cast balance <YOUR_WALLET_ADDRESS> --rpc-url https://arb1.arbitrum.io/rpc
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 **Monitoring Checklist**
|
|
|
|
### Every 4 Hours
|
|
- [ ] Check bot is running: `podman ps`
|
|
- [ ] Review recent logs for errors
|
|
- [ ] Verify opportunities being detected
|
|
- [ ] Check wallet balance hasn't decreased unexpectedly
|
|
|
|
### Daily
|
|
- [ ] Review full logs: `podman logs mev-bot-v2-prod > daily_$(date +%Y%m%d).log`
|
|
- [ ] Analyze profit/loss
|
|
- [ ] Check gas usage vs profit
|
|
- [ ] Verify circuit breaker hasn't triggered
|
|
- [ ] Review arbitrage opportunity quality
|
|
|
|
### Weekly
|
|
- [ ] Full system health check
|
|
- [ ] Update RPC endpoints if needed
|
|
- [ ] Review and adjust risk parameters
|
|
- [ ] Backup logs and configuration
|
|
- [ ] Test emergency stop procedure
|
|
|
|
---
|
|
|
|
## ⚡ **Performance Metrics**
|
|
|
|
### Expected Behavior
|
|
- **Opportunities detected:** 1-10 per hour (highly variable)
|
|
- **Profitable opportunities:** 0.1-1% of all opportunities
|
|
- **Execution success rate:** >95% (when enabled)
|
|
- **Average profit per trade:** 0.01-0.1 ETH
|
|
- **Gas cost per trade:** 0.001-0.01 ETH
|
|
|
|
### Red Flags
|
|
- ⚠️ No opportunities detected for >6 hours
|
|
- ⚠️ Execution success rate <80%
|
|
- ⚠️ Average gas cost > average profit
|
|
- ⚠️ Circuit breaker triggering repeatedly
|
|
- ⚠️ Memory usage increasing over time
|
|
|
|
---
|
|
|
|
## 🔐 **Security Best Practices**
|
|
|
|
### Wallet Security
|
|
- Use dedicated wallet (not primary funds)
|
|
- Never expose private key in logs
|
|
- Store private key in secure vault
|
|
- Limit wallet balance to maximum daily volume + 10%
|
|
- Use hardware wallet for large deployments
|
|
|
|
### RPC Security
|
|
- Use private RPC endpoints (not public)
|
|
- Rotate API keys periodically
|
|
- Monitor RPC usage and rate limits
|
|
- Have backup RPC endpoints configured
|
|
|
|
### Container Security
|
|
- Run as non-root user (already configured)
|
|
- Limit container resources:
|
|
```bash
|
|
podman run --memory=2g --cpus=2 ...
|
|
```
|
|
- Mount logs as read-only from host
|
|
- Regular security updates
|
|
|
|
---
|
|
|
|
## 📝 **Troubleshooting**
|
|
|
|
### Bot Not Starting
|
|
```bash
|
|
# Check logs
|
|
podman logs mev-bot-v2-prod
|
|
|
|
# Common issues:
|
|
# 1. Missing PRIVATE_KEY → Add to .env
|
|
# 2. Invalid RPC endpoint → Test with: wscat -c wss://...
|
|
# 3. Port conflict → Check: netstat -tlnp | grep 9090
|
|
```
|
|
|
|
### No Opportunities Detected
|
|
```bash
|
|
# Verify RPC connection
|
|
cast block-number --rpc-url $ARBITRUM_RPC_ENDPOINT
|
|
|
|
# Check pool discovery
|
|
podman logs mev-bot-v2-prod 2>&1 | grep "pools_discovered"
|
|
|
|
# Lower profit threshold temporarily for testing
|
|
# Edit .env: MIN_PROFIT_THRESHOLD=0.001
|
|
```
|
|
|
|
### Circuit Breaker Triggered
|
|
```bash
|
|
# Check recent trades
|
|
podman logs mev-bot-v2-prod 2>&1 | grep -A5 "circuit breaker"
|
|
|
|
# Analyze why:
|
|
# 1. Real market losses → Normal, bot protecting you
|
|
# 2. Gas estimation errors → Adjust MAX_GAS_PRICE
|
|
# 3. Slippage issues → Increase MAX_SLIPPAGE_TOLERANCE slightly
|
|
|
|
# Reset circuit breaker by restarting:
|
|
podman restart mev-bot-v2-prod
|
|
```
|
|
|
|
---
|
|
|
|
## 📈 **Success Criteria**
|
|
|
|
### Phase 1 Success (Dry-Run)
|
|
- ✅ 48 hours of stable operation
|
|
- ✅ 10+ opportunities detected
|
|
- ✅ No crashes or errors
|
|
- ✅ Reasonable profit calculations
|
|
|
|
### Phase 3 Success (Live Trading)
|
|
- ✅ First trade profitable or break-even
|
|
- ✅ Circuit breaker working correctly
|
|
- ✅ Gas costs < 50% of gross profit
|
|
- ✅ No unexpected losses
|
|
|
|
### Long-term Success (1 month)
|
|
- ✅ Net positive profit after gas
|
|
- ✅ <5% of trades result in loss
|
|
- ✅ No emergency stops triggered
|
|
- ✅ Stable performance over time
|
|
|
|
---
|
|
|
|
## 🎯 **Current Status: Phase 1 Ready**
|
|
|
|
**What's Working:**
|
|
- ✅ All safety mechanisms tested (12/12 tests)
|
|
- ✅ Emergency stop verified (8-second detection)
|
|
- ✅ Configuration values correct
|
|
- ✅ Dry-run mode confirmed working
|
|
|
|
**Blockers to Production:**
|
|
- ⚠️ Need to configure production wallet (PRIVATE_KEY)
|
|
- ⚠️ Need to verify RPC endpoint connectivity
|
|
- ⚠️ Need 48h dry-run validation on mainnet
|
|
- ⚠️ Need to verify arbitrage opportunities exist
|
|
|
|
**Next Steps:**
|
|
1. Configure production wallet in .env
|
|
2. Start Phase 1 (48h dry-run on mainnet)
|
|
3. Monitor and validate opportunity detection
|
|
4. If successful, proceed to Phase 3 (minimal capital test)
|
|
|
|
---
|
|
|
|
## 📞 **Support & Resources**
|
|
|
|
- **Emergency Contact:** [Your contact info]
|
|
- **Logs Location:** `/docker/mev-beta/logs/`
|
|
- **Documentation:** `README.md`, `SAFETY_TEST_RESULTS.md`
|
|
- **Test Scripts:** `scripts/test_safety_mechanisms.sh`
|
|
|
|
---
|
|
|
|
**⚠️ WARNING: DO NOT deploy to mainnet with ENABLE_EXECUTION=true until Phase 1 dry-run is complete and validated.**
|