Documentation

Xandeum PNode Network Intelligence Platform

An enterprise-grade distributed network monitoring platform designed for the Xandeum Protocol ecosystem. This production-ready dashboard provides real-time visibility into a global network of Proof Nodes (PNodes), featuring advanced analytics, predictive monitoring, and comprehensive performance metrics at scale.

Xandeum Protocol: Distributed Infrastructure Revolution

Xandeum represents a fundamental evolution in decentralized infrastructure architecture. Unlike traditional blockchain networks that focus primarily on transaction validation, Xandeum implements a multi-dimensional approach combining computational resources, distributed storage, and network validation services.

The protocol introduces Proof Nodes (PNodes) as sovereign economic actors that participate in a sophisticated marketplace for computational resources. Each PNode contributes storage capacity, processing power, and network bandwidth while receiving rewards based on performance metrics and market demand.

200+
Active PNodes
127
Countries
340TB+
Storage
99.9%
Uptime SLA
Real-time Monitoring

Sub-second latency monitoring across all PNodes with predictive anomaly detection and automated alerting systems for network-wide observability.

Advanced Analytics

Multi-dimensional performance analysis with XDN scoring algorithms, geographic distribution insights, and capacity planning metrics.

Intelligent Alerting

ML-powered anomaly detection with severity-based notifications, automated escalation, and incident response workflows.

Distributed Architecture

Distributed Systems Architecture

Multi-Layer Caching Strategy

Enterprise-grade caching with Redis for API responses, SWR for client-side state, and PostgreSQL optimization. TTL-based invalidation with intelligent cache warming.

Real-time Data Pipeline

Asynchronous synchronization between pRPC calls, PostgreSQL persistence, and Redis caching. Circuit breaker patterns and graceful degradation.

Enterprise Data Architecture

Sophisticated pipeline with PostgreSQL persistence, Redis caching, and pRPC communication. ACID transactions with optimistic concurrency control.

Real-time Monitoring Infrastructure

<100ms

Real-time Data Latency

Sub-second data freshness across all PNode metrics with Redis-backed caching and optimized PostgreSQL queries. P95 latency < 200ms under full network load.

99.9%

Network Observability

Continuous monitoring of 200+ PNodes with automated health checks, performance degradation alerts, and predictive failure detection.

340TB+

Network Storage Capacity

Distributed storage infrastructure across global PNode network with real-time capacity monitoring and utilization analytics.

Enterprise Features

API Key Authentication

Secure API access with configurable authentication keys. Implements HMAC-based request signing with salted hash storage and configurable rate limiting per API key.

Advanced Rate Limiting

Multi-dimensional rate limiting with per-key, per-IP, and per-endpoint controls. Implements sliding window algorithms to prevent burst attacks while maintaining fair resource distribution.

Type-Safe Data Validation

Comprehensive input validation using Zod schemas at all API boundaries. Prevents injection attacks, ensures data integrity, and provides compile-time type safety across the entire application stack.

Features

Node Monitoring

Real-time monitoring of Xandeum network nodes with detailed metrics

  • Live uptime tracking
  • Latency monitoring
  • Performance metrics
  • Storage usage analysis
  • Geographic distribution

Alert System

Proactive alerting for node issues and network anomalies

  • Critical/warning/info alerts
  • Auto-resolution tracking
  • Severity-based notifications
  • Historical alert logs

Analytics Dashboard

Comprehensive charts and visualizations for network insights

  • Interactive charts with Recharts
  • Network health metrics
  • Performance trends
  • Geographic heatmaps

Network Overview

Bird's eye view of the entire Xandeum network

  • Total active nodes
  • Network health score
  • Reward distribution
  • Validation rates

API Ecosystem

Core Dashboard APIs

GET /api/dashboard/stats - Network-wide statistics and KPIs
GET /api/leaderboard - PNode performance ranking with sorting
GET /api/health - System health and connectivity status
GET /api/Pnode - Complete PNode directory with filtering
GET /api/Pnode/[id] - Individual PNode detailed metrics
GET /api/Pnode/[id]/metrics - Real-time performance data
GET /api/Pnode/[id]/history - Historical performance trends

Node APIs

GET /api/Pnode - List all nodes
GET /api/Pnode/[id] - Node details
GET /api/Pnode/[id]/history - Node history
GET /api/Pnode/[id]/alerts - Node alerts
GET /api/Pnode/[id]/metrics - Node metrics

Database Schema

PNode (Proof Node)

Core node representation with real-time status

Identity: id (CUID), externalId, name
Status: status, lastSeen, uptime
Performance: latency, performance, xdnScore
Location: location, region, lat/lng

Technical Implementation

Enterprise Technology Stack

Next.js 16 + React 19

App Router with Server Components, concurrent features, and optimized rendering for enterprise-scale dashboards.

PostgreSQL + Prisma

Type-safe ORM with ACID transactions, complex queries, and optimized indexing for time-series PNode data.

Redis Cache Layer

High-performance caching with TTL-based expiration, intelligent cache warming, and sub-millisecond access.

SWR Data Fetching

Stale-while-revalidate pattern with automatic background updates, error handling, and optimistic UI updates.

pRPC Client

Custom RPC client for Xandeum Protocol network communication with retry logic and exponential backoff.

TypeScript + Zod

End-to-end type safety with runtime validation, preventing data corruption and runtime errors.

Key Architectural Decisions

Multi-Layer Caching Strategy

Sophisticated four-layer caching architecture achieving sub-100ms response times across 200+ PNodes while maintaining data consistency and freshness.

  • Browser Cache (SWR): 30-60s TTL for instant UI updates
  • Redis Application Cache: 5-minute TTL for API responses
  • Database Query Cache: Connection pooling with prepared statements

Real-time Data Pipeline

Asynchronous data synchronization pipeline ensuring real-time visibility into network state with intelligent error handling and graceful degradation.

  • pRPC Network Calls: Direct communication with PNodes
  • PostgreSQL Persistence: ACID-compliant data storage
  • Circuit Breaker Pattern: Automatic failure isolation

Enterprise UI/UX Architecture

Dark-themed Solana-style interface with advanced data visualization, implementing complex sorting, filtering, and real-time updates for network operators.

  • Solana-inspired Design: Industry-standard blockchain dashboard UI
  • Advanced Table Sorting: Multi-column sorting with performance metrics
  • Real-time Charts: Interactive performance and storage visualizations
  • Responsive Design: Mobile-optimized for field operations

XDN Scoring Algorithm

Proprietary performance scoring system combining multiple weighted metrics to provide comprehensive PNode health assessment and ranking.

  • Performance Weight: 40% - Uptime, latency, responsiveness
  • Storage Weight: 30% - Capacity utilization, data integrity
  • Network Weight: 20% - Connectivity, geographic distribution
  • Risk Weight: 10% - Stability, error rates, anomaly detection