mev-beta/docs/QUICK_DEPLOYMENT.md

Quick Deployment Guide

TL;DR: Deploy MEV Bot smart contracts to Arbitrum in 5 minutes.

🚀 Prerequisites (2 minutes)

1. Install Foundry:

curl -L https://foundry.paradigm.xyz | bash
foundryup

2. Get ETH on Arbitrum:

   • Testnet: Get free ETH from Arbitrum Goerli Faucet
   • Mainnet: Bridge ETH to Arbitrum (need ~0.01 ETH)

3. Get RPC Endpoint (optional, but recommended):

   • Free: https://arb1.arbitrum.io/rpc
   • Premium: Alchemy or Chainstack

---

⚡ Quick Deploy (3 minutes)

Step 1: Configure Environment

# Copy deployment config template
cp .env.deployment.example .env.deployment

# Edit with your values
nano .env.deployment

Minimum required:

DEPLOYER_PRIVATE_KEY="0xYOUR_PRIVATE_KEY"
ARBITRUM_RPC_ENDPOINT="https://arb1.arbitrum.io/rpc"

Step 2: Load Configuration

source .env.deployment

Step 3: Deploy!

./scripts/deploy-contracts.sh

That's it! The script will:

• ✅ Validate your environment
• ✅ Compile contracts
• ✅ Deploy both contracts
• ✅ Update configuration files
• ✅ Save deployment addresses

---

📋 What Gets Deployed

Contract	Purpose	Gas Cost
ProductionArbitrageExecutor	Main arbitrage executor	~0.003 ETH
FlashLoanReceiver	Balancer flash loan integration	~0.002 ETH

Total deployment cost: 0.005 ETH ($10-15 at current prices)

---

✅ Post-Deployment

After deployment completes:

1. Verify Addresses Updated:

grep CONTRACT_ARBITRAGE_EXECUTOR .env.production
# Should show: CONTRACT_ARBITRAGE_EXECUTOR="0x..."

2. Test the Bot:

./scripts/run.sh

3. Check Logs:

tail -f logs/mev_bot.log
# Should show: "Flash swap executor initialized with KeyManager and contract addresses"

---

🧪 Test on Testnet First (Recommended)

# Set testnet config
export NETWORK="arbitrum-goerli"
export ARBITRUM_RPC_ENDPOINT="https://goerli-rollup.arbitrum.io/rpc"

# Deploy to testnet
./scripts/deploy-contracts.sh

# Test with bot
LOG_LEVEL=debug timeout 60 ./bin/mev-beta start

---

🔍 Verify Contracts (Optional)

Enable automatic verification:

# Get API key from https://arbiscan.io/myapikey
export ARBISCAN_API_KEY="YOUR_KEY"
export VERIFY="true"

# Deploy with verification
./scripts/deploy-contracts.sh

Or verify manually after deployment:

./scripts/verify-contracts.sh <contract_address> ProductionArbitrageExecutor
./scripts/verify-contracts.sh <contract_address> FlashLoanReceiver

---

🆘 Troubleshooting

"insufficient funds for gas"

# Check deployer balance
cast balance <your_deployer_address> --rpc-url "$ARBITRUM_RPC_ENDPOINT"

# Need at least 0.01 ETH

"compilation failed"

# Install dependencies
forge install OpenZeppelin/openzeppelin-contracts --no-commit

# Retry deployment
./scripts/deploy-contracts.sh

"RPC connection failed"

# Test RPC
cast client --rpc-url "$ARBITRUM_RPC_ENDPOINT"

# Try alternative RPC
export ARBITRUM_RPC_ENDPOINT="https://arbitrum.llamarpc.com"

---

📝 Deployment Checklist

• Foundry installed (forge --version)
• Deployer wallet has ETH (>0.01 ETH)
• .env.deployment configured
• Tested on testnet first
• Deployment script executed
• Both contracts deployed
• Addresses saved in deployments/
• Configuration files updated
• Bot tested with new contracts

---

📚 Full Documentation

For detailed deployment instructions, see:

• Full Deployment Guide - Comprehensive guide
• Deployment Logs - Check deployment logs
• Contract Source - Review contract code

---

🎯 Next Steps

After successful deployment:

1. Test Integration:

LOG_LEVEL=debug timeout 60 ./bin/mev-beta start
grep "initialized with KeyManager" logs/mev_bot.log

2. Grant Permissions:

# Grant EXECUTOR_ROLE to your bot wallet
cast send <arbitrage_contract> "grantRole(bytes32,address)" \
    $(cast keccak "EXECUTOR_ROLE") \
    <bot_wallet_address> \
    --rpc-url "$ARBITRUM_RPC_ENDPOINT" \
    --private-key "$DEPLOYER_PRIVATE_KEY"

3. Start Production Bot:

./scripts/run.sh

4. Monitor:

tail -f logs/mev_bot.log

---

💡 Tips

• Use Testnet First: Always test on Arbitrum Goerli before mainnet
• Backup Keys: Save deployment addresses and private keys securely
• Monitor Gas: Deployment costs ~0.005 ETH on Arbitrum
• Verify Contracts: Verified contracts build trust and allow interaction on Arbiscan
• Use Premium RPC: Free RPCs may have rate limits

---

Need help? Check the Full Deployment Guide or review Troubleshooting.