Inferstructor Dashboard & Analytics
Relevant source files
The following files were used as context for generating this wiki page:
The Inferstructor Dashboard is a comprehensive validator infrastructure monitoring and orchestration tool. It provides real-time visualization of network health, validator performance metrics, and administrative controls for the X3 Chain ecosystem. Built as a Tauri-based desktop application, it integrates directly with Substrate-based RPC endpoints to stream live telemetry and manage validator states.
The analytics component focuses on performance tracking, specifically focusing on Transactions Per Second (TPS), latency, uptime, and gas efficiency. This data is surfaced through high-level dashboards and detailed leaderboards, allowing both operators and administrators to monitor the health of the atomic exchange infrastructure.
Sources: plans/PHASE_5_IMPLEMENTATION_PLAN.md:14-25, apps/inferstructor-dashboard/ADMIN_WORKFLOWS.md:3-7
System Architecture
The system utilizes a multi-layered architecture where a Substrate-based live node serves as the primary data source, accessed via a custom RPC layer. The frontend dashboard consumes this data for real-time visualization and administrative orchestration.
Data Flow and Integration
The dashboard connects to live node RPCs to retrieve validator sets, session information, and chain state. It also features a 3D visualization component called ValidatorGlobe which maps validator nodes and their connection topology.
The diagram represents the flow from the raw blockchain state through custom RPC modules to specialized dashboard components.
Sources: plans/PHASE_5_IMPLEMENTATION_PLAN.md:183-207
Component Interaction
Administrative actions follow a request-response pattern where commands are dispatched through the RPC layer to be executed by the node.
This sequence illustrates the flow of an administrative command like an emergency pause.
Sources: plans/PHASE_5_IMPLEMENTATION_PLAN.md:210-230, apps/inferstructor-dashboard/ADMIN_WORKFLOWS.md:68-87
Administrative Workflows
The dashboard provides a centralized interface for sensitive network operations, requiring specific authentication and Role-Based Access Control (RBAC).
Role-Based Access Control (RBAC)
Permissions are categorized into distinct roles to ensure secure operation of the network infrastructure.
| Role | Permissions | Primary Use Case |
|---|---|---|
| Administrator | validator_approval, emergency_pause, audit_view, settings_modify | Senior operations and incident response |
| Operator | validator_view, metrics_view, audit_view | Daily monitoring and maintenance |
| Viewer | metrics_view, leaderboard_view | Executives and external stakeholders |
Sources: apps/inferstructor-dashboard/ADMIN_WORKFLOWS.md:100-130
Core Admin Operations
- Validator Management: Admins can Approve, Suspend, or Unlock validators. Approved validators are fully operational, while Suspended validators are halted.
- Emergency Controls: A global "Emergency Pause" toggle halts all network operations (validators and swaps) during security breaches or critical bugs.
- Faucet Configuration: Controls testnet token distribution, including rate limits and per-address maximums.
- RPC Management: Configuration of primary and backup endpoints for Ethereum, Solana, and X3 chains to ensure redundancy.
Sources: apps/inferstructor-dashboard/ADMIN_WORKFLOWS.md:17-87
Analytics and Performance Monitoring
Analytics are derived from hourly snapshots and real-time streams, providing a quantitative view of the network's health.
Key Performance Indicators (KPIs)
The system tracks four primary metrics to evaluate validator and network performance:
- TPS (Transactions Per Second): Throughput measurement.
- Latency: Time for block propagation and finality.
- Uptime: Percentage of time a validator or service is available.
- Gas Efficiency: Scoring of gas optimization across transactions.
Sources: apps/inferstructor-dashboard/ADMIN_WORKFLOWS.md:162-171, crates/x3-relayer/PHASE_13F_DAILY_STATUS_TEMPLATE.md:83-115
Performance Baselines
Expected performance targets are used to generate alerts and status reports.
| Metric | Target (Good) | Warning | Alert (Critical) |
|---|---|---|---|
| EVM Blocks | 4-5 / min | 2-3 / min | < 2 / min |
| SVM Slots | 8-10 / min | 6-7 / min | < 5 / min |
| Proof Submission | 2-4 / min | 0.5-1 / min | < 0.5 / min |
| CPU Usage | < 70% | 70-80% | > 80% |
Sources: crates/x3-relayer/PHASE_13F_MASTER_INDEX.md:175-185, crates/x3-relayer/PHASE_13F_DAILY_STATUS_TEMPLATE.md:83-95
Technical Implementation Details
Configuration and Deployment
The dashboard utilizes environment variables to manage infrastructure endpoints, particularly for GPU lane health checks.
// Example Configuration Keys
VITE_GPU_LANE_BASE // Default base URL for lane health checks
VITE_GPU_LANE_1_URL // Explicit override for GPU Lane 1
VITE_GPU_LANE_2_URL // Explicit override for GPU Lane 2
VITE_GPU_LANE_3_URL // Explicit override for GPU Lane 3
Sources: apps/inferstructor-dashboard/ADMIN_WORKFLOWS.md:9-15
Data Persistence
Metric snapshots and administrative configurations persist using a combination of local browser storage and backend databases. Hourly snapshots are cached locally to support offline analysis and CSV export functionality.
Sources: apps/inferstructor-dashboard/TESTING.md:100-105, apps/inferstructor-dashboard/ADMIN_WORKFLOWS.md:173-180
Conclusion
The Inferstructor Dashboard & Analytics module serves as the command center for the X3 Atomic Star project. By combining real-time 3D visualization, detailed performance analytics, and critical administrative overrides, it provides the necessary transparency and control required to maintain a high-throughput, cross-chain validator network. The integration of RBAC and audit logging ensures that all infrastructure management remains secure and auditable.