288 lines
8.2 KiB
Markdown
288 lines
8.2 KiB
Markdown
# MEV Bot Contract Funding Guide
|
|
**Date:** October 29, 2025
|
|
**Status:** Contracts Deployed, Wallet Setup Required
|
|
|
|
---
|
|
|
|
## 🎯 Executive Summary
|
|
|
|
**Good News:** Your contracts use **flash loans**, which means **NO CAPITAL REQUIRED** for trading!
|
|
|
|
### Current Status Check
|
|
|
|
**Deployed Contracts:**
|
|
- ✅ ArbitrageExecutor: `0x6C2B1c6Eb0e5aB73d8C60944c74A62bfE629c418` - Balance: **0 ETH** ✅
|
|
- ✅ FlashSwapper: `0x7Cc97259cBe0D02Cd0b8A80c2E1f79C7265808b4` - Balance: **0 ETH** ✅
|
|
- ✅ DataFetcher: `0xC6BD82306943c0F3104296a46113ca0863723cBD` - Balance: **0 ETH** ✅
|
|
|
|
**Why 0 ETH is CORRECT:**
|
|
These contracts use flash loans (borrow → arbitrage → repay in single transaction), so they don't need pre-funded capital!
|
|
|
|
---
|
|
|
|
## 💰 What Actually Needs Funding?
|
|
|
|
### ❌ Contracts DON'T Need Funding
|
|
Your contracts are **flash loan enabled**, which means:
|
|
- ✅ Borrow funds from Balancer/Uniswap during execution
|
|
- ✅ Execute arbitrage
|
|
- ✅ Repay loan + profit
|
|
- ✅ All in 1 atomic transaction
|
|
|
|
**Result:** Zero capital required for trading!
|
|
|
|
### ✅ Executor Wallet DOES Need Gas
|
|
|
|
You need a **wallet with ~0.01-0.05 ETH** on Arbitrum for:
|
|
- Gas to submit transactions (~$0.10-$0.50 per trade)
|
|
- Contract interaction costs
|
|
- Emergency operations
|
|
|
|
**Current Wallet Status:** ⚠️ **NOT CONFIGURED**
|
|
- Keystore path: `keystore/production/`
|
|
- Status: Empty (no wallet file found)
|
|
|
|
---
|
|
|
|
## 🚀 Two Options to Enable Execution
|
|
|
|
### Option 1: Monitoring Only (Current Mode) ✅
|
|
|
|
**What it does:**
|
|
- ✅ Detects arbitrage opportunities
|
|
- ✅ Calculates profitability
|
|
- ✅ Logs opportunities to console
|
|
- ❌ Cannot execute trades (no wallet)
|
|
|
|
**Benefits:**
|
|
- No funding required
|
|
- No risk
|
|
- Learn and test before going live
|
|
|
|
**Current Status:** This is what you're running now!
|
|
|
|
### Option 2: Live Execution Mode (Requires Wallet)
|
|
|
|
**What it does:**
|
|
- ✅ Detects opportunities
|
|
- ✅ Automatically executes profitable trades
|
|
- ✅ Captures MEV profits
|
|
- ✅ Uses flash loans (no capital needed)
|
|
|
|
**Requirements:**
|
|
1. **Wallet with 0.01-0.05 ETH** on Arbitrum (for gas only)
|
|
2. Wallet private key configured in keystore
|
|
3. Execution mode enabled in config
|
|
|
|
---
|
|
|
|
## 📊 Cost Breakdown
|
|
|
|
### One-Time Setup Costs
|
|
- ✅ Contract deployment: **DONE** (contracts already deployed)
|
|
- ⏳ Wallet gas funding: **~$20-100 USD** (0.01-0.05 ETH on Arbitrum)
|
|
|
|
### Per-Trade Costs (Ongoing)
|
|
- Gas per arbitrage: **~$0.10-0.50** (Arbitrum is cheap!)
|
|
- Flash loan fees: **0.09%** of borrowed amount (Uniswap V3) or **0%** (Balancer)
|
|
|
|
### Example Trade Economics
|
|
```
|
|
Opportunity: WETH/USDC arbitrage
|
|
- Flash loan: Borrow 10 ETH (~$20,000)
|
|
- Execute arbitrage: Net profit $50
|
|
- Gas cost: $0.30
|
|
- Flash loan fee: $18 (0.09% of $20,000)
|
|
- Net profit: $50 - $0.30 - $18 = $31.70 ✅
|
|
|
|
Your wallet only spends: $0.30 for gas
|
|
Contract borrows and repays: $20,000
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 How to Set Up Wallet for Execution
|
|
|
|
### Step 1: Get ETH on Arbitrum
|
|
|
|
**Option A: Bridge from Ethereum** (if you have ETH on mainnet)
|
|
```bash
|
|
# Use official Arbitrum bridge
|
|
open https://bridge.arbitrum.io/
|
|
|
|
# Bridge 0.02-0.05 ETH from Ethereum → Arbitrum
|
|
# Takes 7-15 minutes
|
|
```
|
|
|
|
**Option B: Buy directly on exchange**
|
|
1. Buy ETH on Coinbase/Binance/Kraken
|
|
2. Withdraw to **Arbitrum One network** (important!)
|
|
3. Minimum: 0.01 ETH (~$20), Recommended: 0.05 ETH (~$100)
|
|
|
|
**Option C: Use existing Arbitrum wallet**
|
|
```bash
|
|
# If you already have ETH on Arbitrum, export private key
|
|
# WARNING: Never share private keys!
|
|
```
|
|
|
|
### Step 2: Create or Import Wallet
|
|
|
|
**Option A: Create new wallet (recommended)**
|
|
```bash
|
|
# Generate new wallet (I can help with this)
|
|
# Store private key securely
|
|
# Fund with 0.01-0.05 ETH on Arbitrum
|
|
```
|
|
|
|
**Option B: Import existing wallet**
|
|
```bash
|
|
# If you have existing Arbitrum wallet with funds
|
|
# Export private key (keep it SECRET!)
|
|
# Configure in keystore
|
|
```
|
|
|
|
### Step 3: Configure Keystore
|
|
|
|
Once you have a funded wallet:
|
|
|
|
```bash
|
|
# I can help configure the keystore with your wallet
|
|
# Will encrypt private key with your MEV_BOT_ENCRYPTION_KEY
|
|
# Stored securely in keystore/production/
|
|
```
|
|
|
|
### Step 4: Enable Execution Mode
|
|
|
|
```bash
|
|
# Update config to enable execution
|
|
# Bot will start executing profitable trades automatically
|
|
# Restart bot with new configuration
|
|
```
|
|
|
|
---
|
|
|
|
## 🔒 Security Best Practices
|
|
|
|
### Wallet Security
|
|
1. ✅ **Use dedicated wallet** - Don't use your main wallet
|
|
2. ✅ **Fund minimum amount** - Start with 0.01-0.02 ETH
|
|
3. ✅ **Monitor regularly** - Check balance doesn't deplete
|
|
4. ✅ **Backup private key** - Store encrypted backup
|
|
5. ✅ **Never commit to git** - Keystore is in .gitignore
|
|
|
|
### Execution Safety
|
|
1. ✅ **Start small** - Test with min profitable threshold
|
|
2. ✅ **Monitor first 24h** - Watch for issues
|
|
3. ✅ **Set max gas price** - Prevent overspending on gas
|
|
4. ✅ **Enable alerts** - Get notified of executions
|
|
5. ✅ **Emergency stop** - Can pause execution anytime
|
|
|
|
---
|
|
|
|
## 📈 Expected Returns
|
|
|
|
### Conservative Estimate (0.01 ETH gas budget)
|
|
- Gas per trade: $0.30
|
|
- Trades per day: 5-20 (depending on opportunities)
|
|
- Gas budget: ~30-60 trades before refill needed
|
|
- Expected profit: $20-100/day (after gas)
|
|
- ROI: 10-50x gas investment per week
|
|
|
|
### Aggressive Estimate (0.05 ETH gas budget)
|
|
- Gas per trade: $0.30
|
|
- Trades per day: 20-50
|
|
- Gas budget: ~150-300 trades before refill
|
|
- Expected profit: $100-500/day
|
|
- ROI: 20-100x gas investment per week
|
|
|
|
**Note:** These are estimates based on current market conditions. Actual results vary.
|
|
|
|
---
|
|
|
|
## 🎯 Recommended Next Steps
|
|
|
|
### Path A: Stay in Monitoring Mode (No funding needed)
|
|
✅ Continue monitoring opportunities
|
|
✅ Analyze profitability data
|
|
✅ Wait for optimal market conditions
|
|
✅ No risk, no investment needed
|
|
|
|
**Current Status:** You're here! Bot is detecting opportunities but not executing.
|
|
|
|
### Path B: Enable Execution (Requires 0.01-0.05 ETH)
|
|
|
|
**Steps:**
|
|
1. ⏳ **Fund wallet** - Get 0.01-0.05 ETH on Arbitrum
|
|
2. ⏳ **Configure keystore** - Set up wallet in bot
|
|
3. ⏳ **Enable execution** - Update config
|
|
4. ⏳ **Monitor results** - Watch profits come in
|
|
|
|
**Would you like me to help with this?** I can:
|
|
- Help create a new wallet
|
|
- Configure the keystore
|
|
- Enable execution mode
|
|
- Set up monitoring and alerts
|
|
|
|
---
|
|
|
|
## ❓ FAQ
|
|
|
|
**Q: Do I need to fund the contracts?**
|
|
A: **No!** Contracts use flash loans - zero capital required for trading.
|
|
|
|
**Q: What about the 0 ETH balance in contracts?**
|
|
A: **This is correct!** Flash loans borrow funds during execution, no pre-funding needed.
|
|
|
|
**Q: How much ETH do I actually need?**
|
|
A: **0.01-0.05 ETH** in executor wallet for gas only (~$20-100).
|
|
|
|
**Q: Can I test without real money?**
|
|
A: **Yes!** You're currently in monitoring-only mode (no execution).
|
|
|
|
**Q: What if I run out of gas?**
|
|
A: Bot will stop executing trades. Just add more ETH to wallet and restart.
|
|
|
|
**Q: Is this risky?**
|
|
A: **Low risk** - Flash loans are atomic (succeed or revert), worst case is wasted gas (~$0.30).
|
|
|
|
**Q: Can I withdraw profits?**
|
|
A: **Yes!** Profits accumulate in executor wallet, withdraw anytime.
|
|
|
|
**Q: What if a trade fails?**
|
|
A: Flash loan reverts entire transaction, no funds lost (only gas ~$0.30).
|
|
|
|
---
|
|
|
|
## 📊 Summary Table
|
|
|
|
| Component | Status | Funding Required | Amount | Purpose |
|
|
|-----------|--------|------------------|--------|---------|
|
|
| ArbitrageExecutor | ✅ Deployed | ❌ No | 0 ETH | Uses flash loans |
|
|
| FlashSwapper | ✅ Deployed | ❌ No | 0 ETH | Uses flash loans |
|
|
| DataFetcher | ✅ Deployed | ❌ No | 0 ETH | Read-only queries |
|
|
| Executor Wallet | ⚠️ Not Set Up | ✅ **Yes** | **0.01-0.05 ETH** | **Gas for transactions** |
|
|
|
|
**Total Required:** 0.01-0.05 ETH on Arbitrum (~$20-100 USD)
|
|
|
|
---
|
|
|
|
## 🚀 Ready to Enable Execution?
|
|
|
|
If you want to enable live trading, let me know and I can help you:
|
|
|
|
1. **Set up a wallet** (create new or import existing)
|
|
2. **Configure keystore** (encrypt and store private key)
|
|
3. **Enable execution mode** (update config)
|
|
4. **Test with small trade** (verify everything works)
|
|
5. **Monitor results** (watch profits accumulate)
|
|
|
|
**Or continue monitoring** - The bot is fully functional in detection mode, no funding needed!
|
|
|
|
---
|
|
|
|
**Report Status:** Complete
|
|
**Contracts:** ✅ Deployed and ready
|
|
**Funding:** ❌ Contracts don't need funds (flash loans)
|
|
**Wallet:** ⏳ Needs 0.01-0.05 ETH for gas (optional, only for execution)
|
|
**Current Mode:** Monitoring only (safe, no risk)
|