X-Aegis Frontend & Dashboard 🛡️📊

╔════════════════════════════════════════════════════════════════════╗
║                                                                    ║
║           X - A E G I S   F R O N T E N D   &   D A P P            ║
║                                                                    ║
║               The Volatility Shield Dashboard                      ║
║           Decentralized Asset Management on Stellar                ║
║                                                                    ║
╚════════════════════════════════════════════════════════════════════╝

A Stablecoin Volatility Shield for Weak Currencies.

💡 The Idea

Even stablecoins expose users in emerging economies (like Nigeria) to FX timing risk, dollar volatility relative to local inflation, and entry/exit rate manipulation. Stable ≠ Stable relative to local purchasing power.

X-Aegis acts as a "Micro hedge fund for everyday Africans."

• User Action: Users deposit stablecoins.
• AI Engine: Predicts FX volatility and local inflation trends.
• Smart Allocation: Contract automatically allocates funds into:
  • Stablecoins (Safety)
  • Synthetic inflation hedges (Growth)
  • Liquidity pools (Yield)

This is a rare narrative with a strong technical moat.

---

🏗️ Architecture

graph TD
    User((User)) -->|Deposit USDC| UI[X-Aegis Dashboard]
    UI -->|Invoke| Vault[Soroban Vault Contract]
    
    subgraph "AI Engine (Backend)"
        Data[Central Bank/FX APIs] -->|Feed| Model[FX Forecast Model]
        Model -->|Signal| Oracle[Rebalance Oracle]
    end

    subgraph "On-Chain Strategy (Soroban)"
        Oracle -->|Trigger| Vault
        Vault -->|Alloc 40%| USDC[USDC Reserves]
        Vault -->|Alloc 30%| LP[Stellar LP Positions]
        Vault -->|Alloc 30%| Synth[Synthetic Hedges]
    end
    
    Vault -->|Yield/Protection| User

Loading

---

🛠 Tech Stack

Blockchain:

• Soroban asset management contract
• Yield allocation logic
• Stellar liquidity integration

AI/Backend:

• Time-series FX forecasting (Python/FastAPI)
• Inflation modeling
• Risk scoring engine

Data Sources:

• Central bank APIs
• FX feeds
• Market price feeds

Frontend:

• Next.js 14: App Router dashboard
• Tailwind CSS: Institutional styling
• Freighter Wallet: Stellar connectivity
• Shadcn/UI: Data visualization components

---

🚀 Getting Started

1. Prerequisites

• Node.js v18+
• Freighter Wallet extension

2. Local Setup

Important

This repository contains the Frontend & Integration logic. For the core protocol contracts, see Aegis-contract. For the AI forecasting engine, see aegis-backend-ai.

Setup Dashboard:

cd frontend
npm install
npm run dev

---

📚 Documentation & Trackers

• 🎨 Frontend Issues
• 🏛️ Smart Contract Issues (External)
• 🤖 Backend & AI Roadmap

Guides:

• 📘 Frontend Integration Guide
• 🌐 Smart Contract Integration

---

🤝 Contributing

See CONTRIBUTING.md.

---

Project maintained by @bbkenny.