🛡️ Mantle Sentinel

RWA Operations Monitoring Stack for Mantle Network

Mantle Sentinel is a comprehensive monitoring solution designed specifically for Real World Asset (RWA) protocols on Mantle Network. It provides early detection of the most common operational risks in RWA vaults: NAV drift, oracle price mismatches, and yield leakage.

🎯 Overview

Mantle Sentinel v0.1 is a hackathon MVP that focuses purely on monitoring & alerting (read-only operations). The project:

• ❌ Does NOT issue tokens
• ❌ Does NOT tokenize real assets
• ❌ Does NOT handle KYC
• ✅ Provides infrastructure-grade monitoring
• ✅ Detects operational risks early
• ✅ Works at the infrastructure layer

🏗️ Architecture

┌────────────────────┐
│  MockRWAVault      │  (Mantle Sepolia)
│  - Deposits        │
│  - Assets          │
│  - Reported NAV    │
│  - Oracle A Price  │
└─────────┬──────────┘
          │ (RPC Read)
          ▼
┌────────────────────┐
│ Monitoring Engine  │
│ - NAV Detector     │
│ - Oracle Detector  │
│ - Yield Detector   │
│ - Risk Engine      │
└─────────┬──────────┘
          │
          ▼
┌────────────────────┐
│ Frontend Dashboard │
│ - Metrics          │
│ - Health Status    │
│ - Explorer Links   │
└────────────────────┘

┌────────────────────┐
│ Off-chain Oracle B │
│ (JSON Endpoint)    │
└────────────────────┘

🚀 Key Features

Risk Detection

• NAV Drift Detection: Identifies discrepancies between reported and computed NAV
• Oracle Price Mismatch: Compares on-chain vs off-chain oracle prices
• Yield Leakage Detection: Monitors actual vs expected yield performance

Health Status Engine

• 🟢 SAFE: No drift or leakage detected
• 🟡 WATCH: Minor drift detected (warning level)
• 🔴 RISK: Significant drift or leakage detected (alert level)

Real-time Monitoring

• Single-page dashboard with auto-refresh
• Real-time polling from Mantle Sepolia
• Graceful error handling and recovery
• Explorer integration for verification

📁 Project Structure

mantle-sentinel/
├── contracts/          # Smart contracts (Foundry)
│   ├── src/            # MockRWAVault.sol
│   ├── test/           # Comprehensive test suite
│   └── script/         # Deployment scripts
├── frontend/           # React dashboard (Lovable)
│   ├── src/            # Components, hooks, services
│   └── public/         # Static assets
└── .kiro/              # Specifications and documentation
    └── specs/          # Requirements, design, tasks

🛠️ Technology Stack

• Smart Contracts: Solidity + Foundry
• Frontend: React + TypeScript + Tailwind CSS
• Blockchain: Mantle Sepolia Testnet
• Testing: Property-based testing with Foundry fuzzing
• Deployment: Foundry scripts + Lovable platform

🎯 Mantle-Native Design

Mantle Sentinel is designed exclusively for Mantle Network:

• Low-cost execution → Continuous monitoring is economically viable
• Modular architecture → Perfect for batch NAV reporting
• DA layer potential → Future monitoring snapshot storage
• EVM compatibility → Easy integration with existing RWA vaults

🚦 Getting Started

Prerequisites

• Node.js 18+
• Foundry
• Git

Quick Start

1. Clone the repository

git clone https://github.com/hackonteam/mantle-sentinel.git
cd mantle-sentinel

2. Set up smart contracts

cd contracts
forge install
forge test

3. Set up frontend

cd ../frontend
npm install
npm run dev

4. Deploy to Mantle Sepolia

cd contracts
# Configure .env with your keys
forge script script/Deploy.s.sol --rpc-url $MANTLE_SEPOLIA_RPC_URL --broadcast --verify

📊 Demo

Live Demo

🌐 Frontend Dashboard: https://mantle-sentinel.netlify.app/

The system is designed to be demoable in 3-5 minutes:

1. Deploy MockRWAVault to Mantle Sepolia
2. Launch frontend dashboard
3. Simulate deposits, oracle drift, and yield scenarios
4. Observe real-time risk detection and health status changes

Demo Environment

• Network: Mantle Sepolia Testnet
• Explorer: https://sepolia.mantlescan.xyz
• RPC: https://rpc.sepolia.mantle.xyz

🔒 Security & Compliance

• Demo purposes only - Does not handle real assets
• No PII/KYC processing
• Read-only operations (except mock contract)
• Suitable for internal tooling/ops layer

🎯 Limitations (MVP)

• Single vault monitoring only
• Mock vault for demonstration
• Static Oracle B feed
• No alert delivery channels
• No historical data storage

These limitations are intentional to keep the hackathon scope manageable.

🗺️ Roadmap

Post-Hackathon Features

• Multi-vault monitoring
• Real issuer/custodian integration
• Alert channels (Slack, PagerDuty)
• DAO/protocol risk dashboards
• Compliance reporting exports

👥 Team

HackOn Team & Phu Nhuan Builder

Core Team:

• Bernie Nguyen - Founder/Leader HackOn Team, Co-founder Phu Nhuan Builder, Lead Developer
• Canh Trinh - Dev Intern
• Thien Vo - Frontend Dev Intern
• Hieu Tran - Business Developer
• "Sharkyz" Duong Pham - Business Developer

📞 Contact

HackOn Team

• Email: work.hackonteam@gmail.com
• Website: https://hackon.team
• Telegram: @hackonteam

Phu Nhuan Builder

• Email: phunhuanbuilder@gmail.com
• Website: https://phunhuanbuilder.com

Lead Developer

• Email: bernie.web3@gmail.com
• Telegram: @bernieio

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Mantle Network for providing the infrastructure
• The RWA community for highlighting operational risk challenges
• All contributors and supporters of the project

---

Mantle Sentinel - The monitoring tool that every serious RWA protocol needs before scaling.