M-OBS (Mantle Observability Stack)

M-OBS is a comprehensive observability and transaction triage console specifically designed for the Mantle Network. It serves both developers and non-technical stakeholders by providing real-time insights into network health, transaction performance, and contract monitoring.

🚀 Overview

M-OBS addresses the need for a dedicated monitoring tool within the Mantle ecosystem. It focuses on identifying transaction failures, monitoring RPC provider performance, and setting up proactive alerts to ensure seamless dApp operations.

Key Features

• Real-time Dashboard: Visualize key metrics including failure rates, gas price trends, and network throughput using high-performance charts.

• Transaction Explorer: Deep-dive into transactions with advanced filtering by status (success/failed), contract address, or specific error signatures.

• Provider Health: Monitor and compare multiple RPC providers with real-time latency tracking, uptime metrics, and automated failover scoring.

• Smart Alerting: Configurable rules for proactive monitoring, such as spikes in failure rates, gas price surges, or provider downtime.

• Error Decoding: Automatic extraction and decoding of EVM errors (Standard Error, Panic codes, and custom signatures) to speed up debugging.

• Contract Watchlist: Track specific smart contracts with ABI-based decoding capabilities.

🏗️ Architecture & Stack

M-OBS follows a robust, decoupled architecture to ensure scalability and reliability:

• Frontend: Built with SvelteKit, Tailwind CSS, and DaisyUI. It utilizes uPlot for lightweight, fast data visualization.

• Backend API: Powered by Python (FastAPI), providing a high-performance asynchronous REST interface.

• Worker: An asynchronous Python worker manages data ingestion (block scanning), provider probing, metrics aggregation, and alert evaluation.

• Database: Supabase (PostgreSQL) serves as the central data store, featuring optimized schemas for time-series health data and transaction records.

Deployment

• Frontend: Vercel

• Backend/Worker: Render.com

• Database: Supabase

📂 Repository Structure

The project is organized into a coordinated multi-repo structure:

• Main Repo: Coordination, documentation, and database migrations.

• Backend Repo: Contains the FastAPI application and the background worker pipelines.

• Frontend Repo: The SvelteKit web application.

🛠️ Implementation Status (Phase 1 Complete)

M-OBS has reached its MVP (Minimum Viable Product) stage with the following components fully operational:

• ✅ 11 SQL Migrations: Complete database schema with retention policies.

• ✅ 4 Worker Pipelines: Block scanning, provider probing, metrics rollup, and alert evaluation.

• ✅ 11 API Endpoints: Full coverage for transactions, providers, metrics, and alerts.

• ✅ 6 Frontend Pages: Fully functional UI including Dashboard, Explorer, and Alert Management.

👥 Team: HackOn Team Vietnam

Developed by HackOn Team Vietnam in collaboration with Phu Nhuan Builder.

• Bernie Nguyen: Founder & Main Developer

• Thien Vo: Frontend Developer

• Canh Trinh: Backend Developer & Researcher

• Sharkyz Duong Pham: Business Development Lead

• Hieu Tran: Business Developer

📄 License

This project is licensed under the MIT License.