> ## Documentation Index
> Fetch the complete documentation index at: https://docs.predictaa.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Roadmap

# Predicta Strategic Roadmap 🗺️

**Vision**: A fully autonomous, AI-driven trading agent that adapts to its user's personality, combined with a gamified social prediction platform.

***

## 🧩 Feature Status Matrix

### 1. Core Trading Engine

| Feature             | Status     | Notes                                                                         |
| :------------------ | :--------- | :---------------------------------------------------------------------------- |
| **Market Data**     | ⚠️ Partial | `marketService.ts` fetching is robust but 24h Volume is stubbed.              |
| **Execution**       | ✅ Mature   | Gasless transactions via Privy MPC signers and Pimlico/CDP working perfectly. |
| **Portfolio**       | ✅ Good     | Syncs On-Chain and Off-Chain states correctly.                                |
| **Smart Contracts** | ✅ Live     | All core contracts deployed (`PredictaCoreV2`, `YieldGateway`).               |

### 2. Autonomous Trading (Cortex)

| Feature          | Status         | Notes                                                                                      |
| :--------------- | :------------- | :----------------------------------------------------------------------------------------- |
| **Logic**        | ✅ Active       | `alpha.py` decision engine is operational.                                                 |
| **Safety**       | ✅ Secured      | **Kill Switch, Daily Budget, User Toggle** implemented.                                    |
| **Intelligence** | ✅ Domain-Aware | Cortex V2 Architecture Deployed. **Domain Router** + **Specialized Features** implemented. |
| **Co-Pilot**     | ✅ Live         | **Shadow Mode**, **Adaptive Persona**, and **Debate Engine** active.                       |

### 3. Social & Gamification

| Feature            | Status     | Notes                                                                               |
| :----------------- | :--------- | :---------------------------------------------------------------------------------- |
| **Social Graph**   | ✅ Complete | Follow/Unfollow, Feed available.                                                    |
| **Preon Identity** | ✅ Live     | **Metrics A, C, D** (including Nansen tags) are implemented.                        |
| **Rivalries**      | ⚠️ Beta    | UI & Backend functional (Simulated). Smart Contract exists but not fully connected. |
| **Arena**          | ✅ Live     | **Factions** (Bull/Bear) and **Raid Bosses** (PvE) implemented.                     |

***

## 🚦 Phased Progress

### Phase 1-5: Base Architecture (✅ Complete)

* **Market Brain**: 7-factor metric analysis (E1-E7).
* **Engagement**: XP, Achievement, and Faction layers.
* **Co-Pilot**: Shadow Mode and Adaptive Personas.
* **Arena**: Factions and PvE events.

### Phase 6: Yield Gateway (✅ Complete)

* **Yield Gateway**: `YieldGateway.sol` + Moonwell integration.
* **Self-Funding**: Idle USDC to yield vault to power risk-free bets.

### Phase 7: Defi Integration (Hedgehog) (✅ Complete)

* **Delta Hedging**: Automated exposure management via `hedge_adapter.py`.
* **Protocol Support**: SynFutures V3 (Mainnet ready) and ZEUS (Testnet).

### Phase 8: Mimic Mode (Copy Trading) (✅ Complete)

* **Discovery**: `TraderSearch` UI for finding top-performing legends.
* **Relay**: `mimic_relay.py` automated mirror-trade orchestrator.
* **V2 Auth**: Integrated with Privy for non-custodial copy-execution.

### Phase 12: Identity Migration (✅ Complete)

* **Unified Auth**: Unified social/email/wallet login via Privy.
* **Deterministic Smart Wallets**: Removed custodial keys; accounts derived from Privy EOAs.
* **Simulation Auth**: Headless bypass for persona agents.

### Phase 13: Brand Refresh & Polish (✅ Complete)

* **Neon Intelligence V2**: Fluid, AI-centric brand identity with adaptive light/dark themes.
* **Smart Launchpad**: Integrated, interactive landing page with mouse-parallax backgrounds.
* **Tiered Achievements**: Professional gamification system with Bronze, Silver, Gold, and Emerald badges.

***

## 🔮 Future Vision

### Phase 9: Governance & Scaling

* [ ] **PRED Governance**: Community voting on Cortex risk parameters (E5/E6 thresholds).
* [ ] **Mainnet Transition**: Migrate all testnet components to Base Mainnet.

### Phase 10: Production Hardening (🛠️ Active)

* [ ] **JWT Verification**: Implement server-side Privy token validation for all API routes.
* [ ] **Farcaster Security**: Full signature verification for Frame-based interactions.
* [ ] **Real Wallet Scanning**: Replace historical stubs with real on-chain transaction analysis.

***

## 📝 Technical Debt & Maintenance

1. **Farcaster Security**: Full signature verification in Frame routes.
2. **Data Fidelity**: Replace remains of volume stubs with real-time API feeds.
3. **Testing**: Increase unit test coverage for `mimic_relay.py` and `hedge_adapter.py`.