A real-time dashboard for monitoring Xandeum pNodes — the storage nodes that power Xandeum's scalable storage layer for Solana dApps.
- pNode Directory: Browse all pNodes in a searchable, sortable table with filters for version, RPC status, and watchlist
- Node Details: Deep dive into individual pNodes with system stats (CPU, RAM, network, active streams), historical charts, endpoints, and raw data
- Compare Nodes: Side-by-side comparison of up to 4 pNodes simultaneously
- Watchlist: Save favorite pNodes to localStorage for quick access
- RPC Health Probing: Test each node's RPC endpoint for reachability and latency
- CSV Export: Export filtered pNode data to CSV for offline analysis
- Performance Charts: Version distribution, RPC distribution, endpoint distribution, and latency analysis
- Network History: Track network metrics over time (24h, 7d, 30d) with interactive charts
- Geographic Visualization: World map with node markers and country/city distribution breakdowns
- KPI Dashboard: Real-time metrics including total nodes, public nodes, storage committed, and average uptime
- Historical Data: Optional database integration for tracking network and pod stats over time
- Credits Tracking: View credits for all pods from the Xandeum Credits API
- Cron Ingestion: Automated snapshot collection for historical analysis (optional)
- Framework: Next.js 16 (App Router)
- UI: React 19, Tailwind CSS v4, shadcn/ui
- Charts: Recharts
- Validation: Zod
- Language: TypeScript
- Icons: Lucide React
- Node.js 18 or higher
- pnpm (recommended) or npm
# Clone the repository
git clone https://github.com/yourusername/xandeum-pnode-analytics.git
cd xandeum-pnode-analytics
# Install dependencies
pnpm installCreate a .env.local file in the root directory:
# Optional: Explicit pRPC URL override
# If set, this will be used instead of XANDEUM_PRPC_SEEDS
# Format: http://<host>:<port>/<path> (e.g., http://api.devnet.xandeum.com:8899/rpc)
XANDEUM_PRPC_URL=http://api.devnet.xandeum.com:8899/rpc
# Optional: Comma-separated list of seed pNode hosts/URLs
# Defaults to a list of known seed nodes if not provided
# Format: IP addresses or full URLs (e.g., 173.212.203.145 or http://173.212.203.145:6000/rpc)
# Default port is 6000, default path is /rpc
XANDEUM_PRPC_SEEDS=173.212.203.145,192.190.136.36
# Optional: Enable per-node RPC probing for health/latency checks
# Default: false
ENABLE_RPC_PROBES=false
# Optional: Timeout for pRPC calls in milliseconds
# Default: 15000
PRPC_TIMEOUT_MS=15000
# Optional: Maximum number of seed pNodes to query (for performance)
# Default: 4
PRPC_MAX_SEEDS=4
# Optional: Snapshot cache TTL in seconds
# Default: 30
SNAPSHOT_CACHE_TTL_SECONDS=30
# Optional: Database connection string for historical data
# Required only if you want to use historical tracking features
DATABASE_URL=postgresql://user:password@host:5432/dbname
# Optional: Secret for cron ingestion endpoint protection
# Required only if using the cron ingestion feature
CRON_SECRET=your-secret-key-here
# Optional: Base URL for IP geolocation service
# Default: http://ip-api.com
GEOLOOKUP_BASE_URL=http://ip-api.com# Start the development server
pnpm devOpen http://localhost:3000 to view the dashboard.
If you want to use historical data tracking:
# Run database migrations
pnpm db:setupData is fetched from Xandeum pRPC endpoints using the get-pods-with-stats method. The dashboard queries multiple seed pNodes directly (by default, individual seed nodes on port 6000) in parallel to discover all pNodes in the gossip network. Results are merged and deduplicated to provide comprehensive coverage. The data includes node identifiers, versions, endpoints, storage stats, system metrics, and credits.
├── app/
│ ├── api/
│ │ ├── pnodes/ # pNode API endpoints
│ │ │ ├── _services/ # Service layer (geo lookup, stats, probe)
│ │ │ ├── [id]/ # Individual node endpoints
│ │ │ ├── credits/ # Credits API
│ │ │ ├── geo/ # Geolocation data
│ │ │ ├── probe/ # RPC health probing
│ │ │ └── snapshot/ # Full network snapshot
│ │ ├── history/ # Historical data endpoints
│ │ │ ├── network/ # Network-wide history
│ │ │ └── pod/ # Individual pod history
│ │ └── cron/ # Cron ingestion endpoints
│ │ └── _services/ # Auth and ingestion services
│ ├── pnodes/ # pNode directory and detail pages
│ │ ├── _features/ # Feature modules (cards, charts, table, etc.)
│ │ │ ├── api/ # Client-side API clients
│ │ │ ├── cards/ # Card-based UI components
│ │ │ ├── charts/ # Chart components
│ │ │ ├── geo/ # Geographic distribution components
│ │ │ ├── hooks/ # Custom React hooks
│ │ │ ├── map/ # World map visualization
│ │ │ └── table/ # Table components
│ │ └── [id]/ # Individual node detail page
│ │ └── _features/ # Detail page features
│ ├── compare/ # Node comparison page
│ │ └── _features/ # Comparison feature components
│ └── about/ # About page
├── components/
│ ├── shared/ # Shared components (AppShell, MetricCard, etc.)
│ └── ui/ # shadcn/ui primitives
│ └── hooks/ # UI-related hooks
├── lib/
│ ├── api/ # API client utilities
│ │ └── server/ # Server-side route helpers
│ ├── cache/ # Caching utilities (TTL cache)
│ ├── config/ # Environment configuration
│ ├── db/ # Database layer
│ │ ├── queries/ # Database query functions
│ │ ├── client.ts # Database client
│ │ └── schema.ts # Drizzle schema definitions
│ ├── pnodes/ # pNode domain logic
│ │ ├── types/ # TypeScript type definitions
│ │ ├── service.ts # Core pNode service
│ │ ├── credits.ts # Credits fetching
│ │ ├── scoring.ts # Staking score calculation
│ │ └── model.ts # Data models and transformations
│ ├── prpc/ # pRPC transport layer
│ ├── query/ # React Query setup and configuration
│ ├── storage/ # Storage abstractions (KV, localStorage)
│ └── watchlist/ # Watchlist storage logic
├── drizzle/ # Database migrations
├── scripts/ # Utility scripts (migrations, etc.)
└── public/ # Static assets
Deploy to Vercel, Netlify, Railway, or any platform that supports Next.js. Set your environment variables in your deployment platform's settings.
MIT License