MantleQuest

**MantleQuest** - Gamified DeFi Onboarding Platform

---

## Tagline
*Transform DeFi complexity into game-like simplicity with natural language intents and AI-powered strategies.*

---

## Project Description

MantleQuest is a gamified DeFi onboarding platform built specifically for Mantle Network. It addresses the biggest barrier to DeFi adoption: complexity. By combining natural language processing, ERC-4337 account abstraction, and gamification mechanics, MantleQuest makes DeFi accessible to everyone.

### The Problem

Traditional DeFi has several barriers to entry:
- **Complexity**: Users must understand AMMs, liquidity pools, lending protocols
- **Gas Fees**: New users need native tokens before they can interact
- **Multiple Steps**: Simple actions require navigating complex interfaces
- **No Guidance**: No structured path for learning DeFi concepts

### Our Solution

MantleQuest solves these by:
1. **Natural Language Intents**: Type "Swap 10 MNT for USDC" instead of navigating DEX interfaces
2. **Gas Sponsorship**: First transactions are gas-free via ERC-4337 paymasters
3. **Smart Accounts**: Batch multiple operations into single transactions
4. **Gamified Learning**: Complete quests, earn XP, collect NFT badges, climb leaderboards

---

## Key Features

### 1. Natural Language Intent System
```
User types: "Swap 10 MNT for USDC"
System executes: Optimal DEX routing, slippage protection, gas estimation
```

### 2. ERC-4337 Account Abstraction
- Smart contract wallets for every user
- Gas sponsorship for onboarding
- Batch transactions for efficiency

### 3. AI Strategy Vaults
- **Conservative Vault** (8-12% APY): Stablecoin lending + blue-chip LP
- **Balanced Vault** (15-25% APY): Mixed DeFi strategies
- **Aggressive Vault** (30-50% APY): Yield optimization + arbitrage

### 4. Copy Trading System
- Follow top traders' strategies
- Proportional position mirroring
- Performance-based rankings

### 5. Quest & Gamification Engine
- Progressive quests from basics to advanced DeFi
- XP tokens (ERC-20) for achievements
- NFT badges (ERC-721) for milestones
- Real-time leaderboard competition

---

## Technical Architecture

```
+------------------------------------------------------------------+
|                         MANTLEQUEST                               |
+------------------------------------------------------------------+
|  Frontend: Next.js 14 + React 18 + TailwindCSS + RainbowKit      |
+------------------------------------------------------------------+
|  Intent Layer: NLP Parser -> Transaction Builder -> Execution     |
+------------------------------------------------------------------+
|  Smart Contracts (ERC-4337):                                      |
|  - QuestAccountFactory (Smart wallet deployment)                  |
|  - QuestAccount (User's smart wallet)                             |
|  - QuestPaymaster (Gas sponsorship)                               |
|  - IntentExecutor (DeFi operations)                               |
|  - QuestManager + ExperienceToken + QuestNFT (Gamification)       |
|  - Leaderboard + ReferralRegistry (Social)                        |
+------------------------------------------------------------------+
|  DeFi Integrations: ODOS | Merchant Moe | Lendle | Agni           |
+------------------------------------------------------------------+
```

---

## Deployed Contracts (Mantle Mainnet)

| Contract | Address |
|----------|---------|
| QuestAccountFactory | `0xEe454306eE8f32d9952166995B63E7A341777CEA` |
| QuestNFT | `0xF390b21015AaFAE6303f656260EAf395517F53F8` |
| ExperienceToken | `0xC565c3ae97fED04A8723fa694AF3fF0D2B93A476` |
| QuestManager | `0xDeF250c461C00CcBc5BC2017F9EAaCB82dD2518C` |
| QuestPaymaster | `0xcB68B53C0a3291065e0C99a4Dec1ec305cA11397` |
| Leaderboard | `0xA579D4DC3034bc502F91455d52fF090bB5d61072` |
| ReferralRegistry | `0xE85179CaEc4B9D8b8DBcC3779e1d9c65e7641ec0` |
| IntentExecutor | `0x0d276BCc0882B61Ec9dCc6eAfF3b1e72796F2284` |

---

## Technology Stack

| Layer | Technology |
|-------|------------|
| Frontend | Next.js 14, React 18, TailwindCSS |
| Web3 | wagmi v2, viem, RainbowKit |
| Contracts | Solidity 0.8.24, Hardhat |
| Standards | ERC-4337, ERC-20, ERC-721 |
| Network | Mantle Sepolia (Chain ID: 5003) |

---

## How It Works

### User Journey

1. **Connect Wallet** - User connects any EOA wallet
2. **Smart Account Created** - QuestAccountFactory deploys smart wallet
3. **Enter Intent** - User types what they want to do in plain English
4. **Preview & Confirm** - System shows expected outcome, gas cost, rewards
5. **Execute** - Transaction runs through user's smart account
6. **Earn Rewards** - Quests complete automatically, XP & NFTs minted

### Example Flow

```
User: "Swap 100 USDC for MNT"

1. Intent Parser identifies: SWAP intent
2. Router selection: ODOS (best rate)
3. Build transaction with 0.5% slippage
4. Gas estimated: ~0.002 MNT
5. User confirms -> Execute via smart account
6. Quest "First Swap" completed -> +100 XP
```

---

## Mantle-Specific Optimizations

1. **Low Gas Costs**: Leveraging Mantle's L2 efficiency for affordable transactions
2. **Native MNT Integration**: Deep integration with WMNT and Mantle DeFi protocols
3. **Protocol Partnerships**: Direct routing to Merchant Moe, Lendle, ODOS, Agni