A unified monitoring dashboard for the SRI stack.

This UI provides real-time monitoring for SV2 mining deployments:

• Translator Proxy - Translates SV1 miners to SV2
• JD Client - Enables Job Declaration Protocol with custom block templates

Non-JD Mode (Translator Only)

Pool ── Translator ── SV1 Clients (legacy miners)

JD Mode (JDC + Translator)

Pool ── JDC ── Translator ── SV1 Clients
            ↖── Native SV2 miners (optional)

The UI automatically detects which mode is active.

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

Then open http://localhost:5173

Configure where JDC and Translator are running:

URL Parameters (runtime):

http://localhost:5173/?jdc_url=http://192.168.1.10:9091&translator_url=http://192.168.1.10:9092

Environment Variables (build time):

VITE_JDC_URL=http://localhost:9091 \
VITE_TRANSLATOR_URL=http://localhost:9092 \
npm run build

Defaults:

• JDC: http://localhost:9091
• Translator: http://localhost:9092

The monitoring APIs must be enabled in your SV2 applications:

# translator-config.toml
monitoring_address = "0.0.0.0:9092"

# jdc-config.toml (if using JD mode)
monitoring_address = "0.0.0.0:9091"

• Total Hashrate - Combined hashrate from all connected clients
• Active Workers - Number of SV1 clients connected
• Shares to Pool - Accepted/submitted shares with acceptance rate
• Best Difficulty - Highest difficulty share submitted
• Hashrate Chart - Real-time hashrate history

• Detailed upstream connection information
• Channel-level statistics
• Share work sum and acceptance metrics

• Connection status for all services
• Endpoint configuration display
• API documentation links

• Node.js 18+
• npm 9+

sv2-ui/
├── src/
│   ├── components/
│   │   ├── ui/              # Base UI primitives
│   │   ├── data/            # Data display components
│   │   └── layout/          # Shell, navigation
│   ├── hooks/
│   │   ├── usePoolData.ts   # Main data hook (auto-detects mode)
│   │   └── useHashrateHistory.ts
│   ├── pages/
│   │   ├── UnifiedDashboard.tsx
│   │   ├── PoolStats.tsx
│   │   └── Settings.tsx
│   ├── types/
│   │   └── api.ts           # TypeScript types matching Rust API
│   └── lib/
│       └── utils.ts         # Formatting utilities
├── public/
├── package.json
├── vite.config.ts
├── tailwind.config.js
└── tsconfig.json

1. Start your SV2 applications with monitoring enabled
2. Run npm run dev
3. The UI auto-detects available services

The Vite dev server proxies API requests to avoid CORS issues:

• /jdc-api/* → http://localhost:9091/api/*
• /translator-api/* → http://localhost:9092/api/*

The built UI can be embedded directly into Rust binaries:

npm run build
# Output in dist/

See stratum-apps for embedding instructions.

• React 18 - UI framework
• TypeScript - Type safety
• Vite - Build tool
• Tailwind CSS - Styling
• React Query - Data fetching with auto-refresh
• Recharts - Charts
• wouter - Lightweight routing

• stratum-mining/sv2-apps - Translator Proxy, JD Client, Pool, JDS
• stratum-mining/stratum - SV2 protocol implementation

MIT OR Apache-2.0