Xandeum LATTICE
Xandeum LATTICE is a professional-grade analytics dashboard for monitoring Xandeum pNodes. It features a clean, modern design with real-time data visualization and comprehensive metric transparency.
Every score shows WHY it has that value with detailed formula explanations
24-hour health trend visualization with annotations
Per-node risk assessment with warning/critical badges and detailed reasons
Persistent tracking of when offline nodes were last online
Real-time feed of node online/offline/version events
Showcase features with simulated data (?demo=true)
The dashboard includes a demo mode for showcasing features to judges and stakeholders. Demo mode loads synthetic data that demonstrates all analytics capabilities.
Add ?demo=true to the URL
Example: https://your-domain.com/?demo=true
Demo includes:
The dashboard uses a 3-column responsive layout that adapts to different screen sizes:
┌─────────────────────────────────────────────────────────┐ │ HEADER: Logo | Network Selector | Refresh | Theme │ ├─────────────────────────────────────────────────────────┤ │ OVERVIEW: Health Gauge | Metric Cards (4 stats) │ ├─────────────────────────────────────────────────────────┤ │ Column 1 │ Column 2 │ Column 3 │ │ Node List │ World Map │ Node Details │ │ (cards) │ Version Chart │ Events Feed │ │ │ │ │ └─────────────────────────────────────────────────────────┘
Desktop: 3 columns side by side
Tablet: 2 columns, details below
Mobile: Single column, stacked vertically
The circular health gauge displays a composite score (0-100) based on three weighted factors. Hover over any breakdown bar to see the exact formula and current values.
Availability
Formula: (online nodes / total nodes) × 100
Version Health
Formula: (% on latest version) - fragmentation penalty
Distribution
Formula: 100 - (max regional concentration × 100)
Click "View Score Details" below the gauge to see the full breakdown including exact formulas, current values, and contribution to the total score.
Healthy
≥ 80
Warning
50-79
Critical
< 50
Every threshold in the dashboard is carefully chosen based on industry best practices for distributed systems monitoring. Here's the complete reference with rationale.
| Status | Score Range | Rationale |
|---|---|---|
| Healthy | ≥ 80 | Network meets or exceeds production standards. High availability, good version adoption, reasonable geographic distribution. |
| Warning | 50-79 | Network functional but has issues requiring attention. May have degraded availability, version fragmentation, or concentration risks. |
| Critical | < 50 | Network has significant issues. Multiple nodes offline, severe version fragmentation, or single point of failure risks. |
Latest version is determined by majority consensus (most nodes = current version). This prevents a single node on a newer version from falsely flagging the entire network.
| Condition | Risk Level | Rationale |
|---|---|---|
| On current version | Healthy | No version-related risk |
| 1 minor version behind | Warning (Old Ver) | May miss bug fixes or optimizations. Operator should plan upgrade. |
| 2+ minor or 1+ major behind | Critical | Potentially incompatible. May have security issues. Urgent upgrade needed. |
Risk scores are cumulative. Each issue adds points. Multiple issues compound.
| Risk Level | Score Range | Typical Causes |
|---|---|---|
| Healthy | 0-24 | Online, current version, stable uptime. May have minor low-severity issues. |
| Warning | 25-49 | Outdated version (+25), low uptime 50-80% (+25), or recent offline event (+25). |
| Critical | 50+ | Offline (+30), very outdated (+40), very low uptime <50% (+40), or flapping (+40). |
| Uptime % | Status | Rationale |
|---|---|---|
| ≥ 90% | Excellent | Meets production SLA standards (allows for brief maintenance windows) |
| 80-89% | Good | Acceptable for non-critical infrastructure |
| 50-79% | Low | Node is unreliable. Adds +25 risk points (medium severity) |
| < 50% | Very Low | Node is more offline than online. Adds +40 risk points (high severity) |
The "Network Health Over Time" chart shows how health scores and online node counts change throughout the day. This helps identify patterns, incidents, and recovery trends.
Chart Features:
Data Retention: Historical data is stored in localStorage and persists across page refreshes (24-hour retention). New data points are added every minute.
Nodes are displayed as interactive cards (not a table) showing:
A colored bar on the left edge indicates status (green=online, red=offline).
The analytics engine assesses each node for potential issues. Risk badges show detailed tooltips explaining exactly why a node is flagged.
Very Outdated Version
2+ minor versions behind the latest (high severity)
Very Low Uptime
Session uptime below 50% (high severity)
Long Offline
Node offline for more than 1 hour (high severity)
Flapping
3+ state changes in the last hour (high severity)
Outdated Version
Not on the latest version (medium severity)
Low Uptime
Session uptime between 50-80% (medium severity)
Recent Offline
Went offline in the last hour (medium severity)
Currently Offline
Node is currently not responding
Risk scores are cumulative. A node with multiple issues will have a higher score.
Healthy
0-24 points
Warning
25-49 points
Critical
50+ points
The dashboard generates actionable insights based on network state:
Insights are prioritized by importance and include specific actions operators can take.
Real-time tracking of node status changes with a dedicated Events tab in the Insights panel:
Switch between "Insights" and "Events" tabs in the Insights card to see the last 5 node events with timestamps. Events are used for flapping detection and risk analysis.
Toast notifications appear for important events. Events persist during the session and contribute to risk scoring.
The dashboard tracks when each node was first observed and last seen online. This enables "last seen" indicators for offline nodes.
Tracking Data (per node):
Persistence: Tracking data is stored in localStorage with 24-hour retention. Nodes not seen for 24+ hours are automatically removed.
Offline nodes show "seen Xh ago" in the node list. Nodes offline for more than 1 hour trigger the "long_offline" risk factor.
The dashboard defaults to a light "observatory" theme but includes a dark mode toggle in the header. Your preference is saved.
Clean, professional look with subtle shadows
Reduced eye strain for extended monitoring
The "Compare Networks" view shows Xandeum alongside Solana statistics for context. Xandeum data is live; Solana data is static (approximate).
Note: The comparison helps visualize growth potential. As Xandeum matures, these metrics will show network progress.
Use the dropdown in the header. Currently active: Devnet. Testnet and Mainnet will be enabled when available.
Choose 15s, 30s, 60s, or Manual. Settings persist in localStorage.
# .env.local
XANDEUM_RPC_ENDPOINT=https://your-endpoint.com
# Clone & install
git clone https://github.com/tanayyo1/Xandeum-LATTICE.git
cd Xandeum-LATTICE && bun install
# Development
bun dev
# Production
bun run build && bun start
Next.js 16
Framework
React 19
UI
TypeScript
Language
Tailwind CSS
Styling
Recharts
Charts
react-simple-maps
Maps
Sonner
Toasts
Bun
Runtime
Monitor cluster health and quickly identify issues
Geographic distribution helps assess network resilience
Track uptime and version adoption across nodes
Compare with established networks to show progress