Documentation

Everything you need to know about Xandeum Pulse

What is Xandeum Pulse?

Xandeum Pulse is a real-time monitoring dashboard for the Xandeum network. It shows you the health and performance of all pNodes (storage nodes) across the globe, helping you understand how the network is performing at any moment.

Dashboard Overview

The main dashboard displays key metrics about the network. Here's what each card means:

Network Health

Shows the percentage of nodes that are online. A higher percentage means a healthier network.

Active Nodes

The number of pNodes currently online and responding. This shows how many nodes are actively participating in the network.

Storage Committed

Total storage space that nodes have made available to the network. The utilization shows how much is actually being used.

Total Credits

The total rewards earned by all nodes on the network. Credits are earned by providing reliable storage and uptime.

Understanding pNodes

pNodes (storage nodes) are computers that contribute storage space to the Xandeum network. Each pNode stores data and helps keep the network running.

Online - The node is connected and actively serving the network

Offline - The node is not currently responding (may be temporarily unavailable)

Network Performance

The Performance tab in Analytics shows real-time resource usage across all active nodes:

CPU Usage

How much processing power nodes are using. Lower is better for efficiency.

RAM Usage

Memory being used by nodes. Shows total used vs total available across the network.

Active Streams

Number of active data connections. More streams indicate higher network activity.

Deployment

Deploy your own instance of Xandeum Pulse in a few simple steps.

Requirements

Node.js 20 or higher
npm or yarn package manager

Quick Start

Clone the repository

git clone https://github.com/piyushjha0409/xandeum-pulse.git

Install dependencies

cd xandeum-pulse && npm install

Start development server

npm run dev

Build for production

npm run build && npm start

Configuration

Update the pNode endpoint URLs in lib/prpc-client.ts to connect to your network:

export const DEFAULT_PNODE_ENDPOINTS = [
  "http://your-pnode-ip:6000",
  // Add more endpoints for redundancy
];

The dashboard connects to these endpoints to fetch network data. Multiple endpoints provide failover support.

Hosting: Deploy to Vercel, Netlify, or any platform that supports Next.js. Simply connect your repository and deploy with zero configuration.

Features

Real-time Monitoring

All data updates automatically every few seconds, showing you the latest network state.

Node Explorer

Browse all pNodes in a searchable table. Filter by status or region to find specific nodes.

Analytics Charts

Visual breakdowns of node versions, uptime distribution, storage providers, and more.

Leaderboard

See which nodes have earned the most credits, rewarding reliable performance.

Global Map

Interactive globe showing node locations around the world with country-level details.

← Back to Dashboard