docs: finish v2 docs

Author: david30907d

docs/faq.md

@@ -0,0 +1,283 @@
+---
+sidebar_position: 2
+---
+
+# ❓ Frequently Asked Questions
+
+Find quick answers to the most common questions about Zap Pilot.
+
+---
+
+## 🚀 Getting Started
+
+### What do I need to start using Zap Pilot?
+
+To get started, you need:
+
+- Any Web3 wallet (MetaMask, WalletConnect, etc.)
+- Minimum $100 in supported cryptocurrencies
+- 5-10 minutes for initial setup
+
+### What's the minimum investment amount?
+
+- **Stablecoin Vaults:** $50 minimum
+- **Index Funds:** $100 minimum
+- **Bitcoin/Ethereum Strategies:** $100 minimum
+- **Custom Strategies:** $200 minimum
+
+### Which crypto wallets are supported?
+
+We support all major Web3 wallets including:
+
+- **Browser Extensions:** MetaMask, Coinbase Wallet, Rainbow, Brave Wallet
+- **Mobile Wallets:** Any wallet that supports WalletConnect
+- **Hardware Wallets:** Ledger and Trezor (via MetaMask or WalletConnect)
+
+### What cryptocurrencies can I deposit?
+
+You can start with:
+
+- **Stablecoins:** USDC, USDT
+- **Major Crypto:** ETH
+- **On any supported network:** We support leading Layer 2s
+
+---
+
+## 📊 Strategy & Investment
+
+### How do I choose the right strategy for me?
+
+Consider these factors:
+
+- **Risk Tolerance:** Stablecoin (low) → Index Funds (medium) → Bitcoin/Ethereum (higher)
+- **Investment Goals:** Stable returns vs growth vs maximum control
+- **Time Horizon:** When you might need access to your funds
+
+**Take our 2-minute risk assessment** in the Getting Started guide to find your perfect match.
+
+### What returns can I expect?
+
+Expected annual returns vary by strategy:
+
+- **Stablecoin Vaults:** 15-25% APY
+- **Index Funds:** 5-15% APY
+- **Bitcoin Strategies:** 3-10% APY
+- **Ethereum Strategies:** 5-10% APY
+
+_Returns are estimates based on historical data and market conditions._
+
+### How often should I rebalance?
+
+- **Quarterly rebalancing** is recommended for most strategies
+- We'll email you personalized recommendations every quarter
+- You can rebalance anytime with one click from your dashboard
+- More frequent rebalancing = higher optimization but more gas costs
+
+### Can I change strategies after investing?
+
+Yes! You can:
+
+- **Withdraw** from your current strategy anytime (no withdrawal fees)
+- **Switch** to a different strategy by reinvesting
+- **Diversify** across multiple strategies if desired
+
+---
+
+## 🔒 Security & Safety
+
+### Is my money safe with Zap Pilot?
+
+Yes, Zap Pilot is designed for maximum security:
+
+- **Non-custodial:** Your funds never leave your wallet
+- **No custody risk:** We can't access or freeze your funds
+- **Your keys, your coins:** You maintain full ownership
+- **Transparent:** All transactions are on-chain and verifiable
+
+### What happens if Zap Pilot shuts down?
+
+Your funds remain completely safe because:
+
+- **Funds stay in your wallet:** We never hold your assets
+- **Direct protocol access:** You can interact with DeFi protocols directly
+- **No lock-in period:** Withdraw anytime without permission
+- **Full transparency:** All contract addresses are public
+
+### How is Zap Pilot different from other DeFi platforms?
+
+| Feature          | Zap Pilot           | Traditional Platforms    |
+| ---------------- | ------------------- | ------------------------ |
+| **Custody**      | ✅ Non-custodial    | ⚠️ Often custodial       |
+| **Access**       | ✅ Withdraw anytime | ❌ Lock-up periods       |
+| **Transparency** | ✅ Full on-chain    | ⚠️ Limited visibility    |
+| **Risk**         | ✅ No platform risk | ❌ Platform custody risk |
+
+### What if a protocol in my strategy gets hacked?
+
+We minimize this risk through:
+
+- **Diversification:** Funds spread across multiple protocols
+- **Curation:** Only audited, established protocols
+- **Monitoring:** Continuous security assessment
+- **Risk limits:** No overexposure to any single protocol
+
+If an incident occurs, you're only exposed to your allocation in that specific protocol, not your
+entire investment.
+
+---
+
+## 💰 Fees & Costs
+
+### What fees do I pay?
+
+Zap Pilot has a simple, transparent fee structure:
+
+- **Entry Fee:** 1% one-time when you deposit
+- **Management Fee:** 0% (no ongoing fees)
+- **Performance Fee:** 0% (we don't take a cut of profits)
+- **Withdrawal Fee:** 0% (free to exit anytime)
+
+### Are there any hidden costs?
+
+No hidden fees from Zap Pilot. You'll also pay:
+
+- **Gas fees:** Standard blockchain transaction costs
+- **Protocol fees:** Native fees from DeFi protocols (typically 0.1-0.3%)
+
+We optimize gas costs through batching and timing to minimize your expenses.
+
+### How do gas fees work?
+
+- **Shared costs:** We batch operations to reduce gas fees by 60-80%
+- **Optimal timing:** Execute during low gas periods
+- **Cross-chain optimization:** Use cheapest suitable networks
+- **Transparent tracking:** See exactly what you've paid in gas
+
+### When do I pay the 1% entry fee?
+
+- **One-time payment:** Only when you first deposit into a strategy
+- **No recurring fees:** Never pay again as long as funds remain invested
+- **Example:** $10,000 investment = $100 entry fee, then $0 forever
+
+---
+
+## 🔧 Technical
+
+### How do I withdraw my funds?
+
+1. **Go to your dashboard** and select the strategy
+2. **Click "Withdraw"** and choose the amount
+3. **Confirm the transaction** in your wallet
+4. **Funds return to your wallet** (usually within 10 seconds)
+
+No fees, no waiting periods, no permissions needed.
+
+### Why is my transaction failing?
+
+Common causes and solutions:
+
+- **Insufficient gas:** Increase gas limit in your wallet
+- **Network congestion:** Wait and try again during low usage
+- **Slippage:** Increase slippage tolerance for volatile markets
+- **Wallet issues:** Refresh page and reconnect wallet
+
+### What networks does Zap Pilot support?
+
+We operate across multiple networks:
+
+- **Base:** Maximum security and institutional trust
+- **Arbitrum:** Lower fees, mature DeFi ecosystem
+- **Optimism:** Innovation hub with unique opportunities
+
+Each operations are all multichain strategy so no matter which chain you start it would
+automatically bridge and allocate funds to other chains as well
+
+### How do I track my performance?
+
+Your dashboard shows:
+
+- **Real-time value:** Current USD value of your investment
+- **Total returns:** Profit/loss since you started
+- **APY tracking:** Annualized return rate
+- **Performance charts:** Value over time with benchmarks
+- **Allocation breakdown:** Where your money is working
+
+---
+
+## 🆘 Troubleshooting
+
+### I can't connect my wallet, what should I do?
+
+Try these steps:
+
+1. **Refresh the page** and clear browser cache
+2. **Check network:** Ensure wallet is on correct network
+3. **Update wallet:** Make sure browser extension is updated
+4. **Try different browser:** Some wallets work better on specific browsers
+5. **Disable ad blockers:** They can interfere with wallet connections
+
+### My balance isn't showing, why?
+
+This usually resolves automatically, but you can:
+
+1. **Wait 5 minutes** for network synchronization
+2. **Verify correct network** in your wallet
+3. **Check transaction status** on blockchain explorer
+4. **Refresh dashboard** or reconnect wallet
+
+### How do I contact support?
+
+**Get help fast:**
+
+- 💬 **Discord:** [Join our community server](https://discord.com/invite/sNsMmtsCCV)
+- 📱 **X/Twitter:** [Quick questions and updates](https://x.com/zapPilot)
+
+**For urgent issues:**
+
+- 🚨 **Priority Support:** Available for investments over $10k
+- 📞 **Emergency Contact:** Available during business hours
+
+---
+
+## 🎯 Advanced Topics
+
+### What is the Kelly Criterion?
+
+The Kelly Criterion is a mathematical formula we use to optimize fund allocation:
+
+- **Balances risk and return:** Higher allocation to lower-risk, higher-reward opportunities
+- **Maximizes long-term growth:** Prevents overexposure to any single protocol
+- **Dynamically adjusts:** Recalculated quarterly based on market conditions
+
+**Learn more:** [Kelly Criterion Explained](./strategies/kelly-criterion)
+
+### How does cross-chain operation work?
+
+Our cross-chain system:
+
+- **Automatic routing:** Finds best opportunities across all supported networks
+- **Bridge integration:** Uses Across Protocol for secure, fast transfers
+- **Cost optimization:** Minimizes bridge fees and gas costs
+- **Unified experience:** Appears as single portfolio despite multi-chain deployment
+
+**Learn more:** [How It Works](./how-it-works)
+
+### What is a Smart EOA wallet?
+
+Your wallet gets enhanced with smart contract capabilities through EIP-7702:
+
+- **Same wallet:** Keep using your existing MetaMask or other wallet
+- **Enhanced features:** Better transaction batching and optimization
+- **Automatic upgrades:** We handle the technical improvements
+- **No setup required:** Works seamlessly with your current wallet
+
+**Learn more:** [How It Works](./how-it-works)
+
+---
+
+## 🤔 Still Have Questions?
+
+Can't find what you're looking for? We're here to help!
+
+💬 **[Join Discord](https://discord.com/invite/sNsMmtsCCV)** | 📖
+**[Read Full Documentation](./introduction)**