v2.2 Architecture

The Nervous System of
Xandeum Pulse

Pulse is not just a UI wrapper. It is a serverless analytics engine visualizing the physical, logical, and economic topology of the network in real-time.

Interactive Walkthrough

How it Works: Flight School 🛫

Don't just read the manual. Experience the platform.
Follow the Glowing Cues to navigate the infinite ecosystem.

https://xandeum-pulse.vercel.app

DASHBOARD

TIP: Click the glowing node card to open diagnostics

NODE-01

98%

Health Score

NODE-02

50%

Health Score

NODE-03

55%

Health Score

NODE-04

60%

Health Score

NODE-05

65%

Health Score

System Access Granted

How it Works: Field Manual 📑

Pulse is not a passive display. It is an active intelligence tool. Master these 8 Protocols to achieve full network visibility.

Cyclic Metric Rotation

UX/UI

Screen real estate is war. Node Cards automatically cycle their tertiary metric every 5 seconds. Storage → Capacity → Health.

Zen Mode

OLED

Visual noise kills focus. Click the Monitor Icon to engage Zen Mode. This strips away all gradients, blurs, and animations.

The Node Inspector

DIAGNOSTICS

Clicking any node opens the Inspector. This is the source of truth for raw Uptime, Storage, and Version data.

Proof of Pulse

SOCIAL

Generates a cryptographic snapshot of a node's specific block-height and health status into a shareable PNG.

Context-Aware Tiers

DYNAMIC

The map rejects static thresholds. It uses Live Percentiles. A 'Gold' marker always represents the top 10% of nodes.

Ghost Nodes

PRIVACY

Nodes running on VPNs or private subnets are tracked in the stats but hidden from the map to prevent errors.

Crash Protocols

REDUNDANCY

Optimistic UI Architecture. If the upstream API fails, Pulse gracefully degrades. It switches to cached metrics or displays 'Offline' badges without breaking the rendering tree.

STOINC Simulator

CALCULATOR

Forecasts earnings based on hardware using Geometric Stacking—boosts compound rather than add linearly.

The Identity Bridge

BACKEND

Links anonymous wallets to physical nodes via Dual-Fetch Resolution, revealing where top earners are located.

Head-to-Head Engine

PVP

The 'Compare' button highlights differentials in green (advantage) or red (deficit) for Uptime, Version, and Yield.

Subspace Echoes

The dashboard listens to the "Gossip Protocol." Like a stethoscope, the pulsing orbs represent actual data packets traversing the network.

The Neural Core

Located in lib/xandeum-brain.ts, the backend handles deduplication, failover, and the proprietary Vitality Score algorithm.

"Hero & Race" Failover Strategy

Pulse employs a high-frequency trading strategy to ensure data availability. It races multiple RPC nodes simultaneously.

lib/xandeum-brain.ts

Client

Primary

Backups

[00:00]System Idle...

[00:01]Connecting Primary [173.x]...

[00:02]TIMEOUT (>4000ms)!

[00:03]RACE MODE: 3 Backups...

[00:04]Winner: Node 2 (80ms)

The Vitality Algorithm

We use non-linear math to calculate a fair 0-100 score. A linear scale fails because the difference between 99% and 99.9% uptime is massive.

Sigmoid Uptime

100 / (1 + e^(-0.2 * (days - 7)))

lib/xandeum-brain.ts

Vitality Engine

CLICK TO TEST FAILOVER

LIVE SCORE CALCULATION

Uptime DRAG TO SIMULATE80 pts

Storage (30%)79 pts

Credits (20%)50 pts

Version (15%)100 pts

Telemetry & UX

The interface is built for "Information Density without Clutter." It uses cyclical rotations and glassmorphism to present complex data.

View Dashboard Source

Zen Mode

Toggles a minimalist, high-contrast OLED view (`setZenMode`). Strips gradients and animations for pure data focus.

Cyclic Rotation

To save screen space, node cards automatically rotate metrics (Storage -> Uptime -> Health) every 5 seconds, synced with the user's sort preference.

Proof of Pulse

A modal that generates a verifiable PNG snapshot (`toPng`) of a node's health, ready for sharing on X (Twitter).

Spatial Intelligence

Static thresholds are obsolete. Pulse uses "Live Percentiles" to color-code the map, ensuring meaningful visualization regardless of network growth.

View Map Source

Lisbon, PT

1.2 PB

MASSIVE TIER

Avg Density

120 TB / Node

Global Share

12.5%

Context-Aware X-Ray

The map isn't just points on a grid. Clicking a region activates the Split-View Drawer. The data schema changes based on the selected mode:

Storage ModeCalculates "Avg Density" to differentiate between Community Clusters vs Datacenters.
Credits ModeDisplays total reputation earnings and "Economic Share" of the region.

The Economic Ledger

Reputation is trust. The Leaderboard combines historical trend tracking with the powerful STOINC Simulator for earnings forecasting.

STOINC Simulator Logic

It supports Geometric Stacking for Era and NFT boosts, meaning multipliers compound rather than add.

pages/leaderboard.tsx

The Identity Bridge

Pulse acts as the bridge by performing a Dual-Fetch Resolution in lib/xandeum-brain.ts. It maps the anonymous financial ledger to the physical network topology.

lib/xandeum-brain.ts

System Integrity Verified

Engineering Standards

This project is not just a UI. It operates on a CI/CD pipeline that rigorously tests financial accuracy, API failover protocols, and deep-link routing before every deployment.

Build Status

Verifies Logic, Routing & Failover

Test Coverage

Validates Economics & Math Precision

Official Documentation

Ready to Go Deeper?

Access the complete technical specifications, including full API references, vitality algorithms, and integration guides.

READ DOCUMENTATION.MD