VRAMScan — Block Explorer
VRAMScan is the official block explorer for the VRAM Network. It displays real-time training windows, miner scores, validator submissions, and run history from both the live Sui testnet and the local demo.
Running VRAMScan
cd vramscan
npm install
npm run dev # http://localhost:4322
Pages
| Page | Description |
|---|---|
/ |
Network overview — current window, live stats, latest transactions, top miners |
/miners |
All registered miners with OpenSkill weights and scores |
/validators |
All validators with submission counts |
/windows |
Training window list with status and checkpoint hashes |
/window/[id] |
Window detail — checkpoint, Top-G miners, validator score submissions |
/runs |
Local demo run history — all runs with miner weight bars |
/runs/[runId] |
Per-run detail — weight progression chart, snapshot table, final standings |
/wallet/[address] |
Per-address activity across windows |
/training |
Training guide — pricing vs Lambda/Vast/CoreWeave, earnings calculator, quick-start steps, adapter docs |
/join |
Step-by-step onboarding guide for miners and validators |
Training Page
/training is a public-facing page for prospective miners showing:
- Pricing comparison — VRAM vs Lambda Labs, Vast.ai, CoreWeave (per-GPU hourly rates)
- Earnings calculator — estimated VRAM tokens/day by GPU type (RTX 3080 → H100)
- Training backends — Candle/CUDA/Metal/Sidecar feature flags with one-liner install commands
- Architecture overview — windowed training, gradient compression, TEE scoring, OpenSkill, token emission
Theme
VRAMScan ships with dark mode (default) and light mode. The toggle is in the Navbar (before the testnet indicator). Selection is persisted to localStorage. Colors are fully governed by CSS custom properties (--vram-bg, --vram-acc, --vram-muted, etc.).
Data Sources
VRAMScan reads from three sources:
1. Sui Testnet RPC (USE_MOCK_DATA=false)
Connects to https://fullnode.testnet.sui.io:443 and reads:
RoundState— current window number, checkpoint hashesPeerRegistry— registered miners and validatorsScoreLedger— OpenSkill scores and normalized weightsValidatorRegistry— validator stake and activity- Recent transactions filtered by
MoveFunction: { package: PACKAGE_ID }
2. Local Demo Feed
Proxies http://127.0.0.1:13001/api/data via /api/demo-data. Shows live miner weights as the demo runs. Falls back gracefully if demo is not running.
3. Run History
Reads .vramhub-runs/run_history.jsonl (written by vramhub-local-demo every 10 windows) via /api/run-history. Grouped by run_id (millisecond timestamp at demo start).
Configuration
| Variable | Default | Description |
|---|---|---|
USE_MOCK_DATA |
true |
Use mock data instead of live Sui RPC |
SUI_NETWORK |
testnet |
Sui network to connect to |
NEXT_PUBLIC_BASE_URL |
http://localhost:4322 |
Base URL for API calls |
Create vramscan/.env.local to override:
USE_MOCK_DATA=false
SUI_NETWORK=testnet
Testnet Object IDs (2026-03-30)
| Object | ID |
|---|---|
| Package | 0x5c1d404ea378840dacf426275d01827bbc89de2b23861208c8a8afb180b063a6 |
| PeerRegistry | 0x8c8d41bade57edeb82f08063c1eeaa68297f87bb06ed177a10f947455cc8a009 |
| ValidatorRegistry | 0x438d0ce63d40210d4e621cca6aaaf5d5438adaa54dfd71383fe41a82692a2561 |
| ScoreLedger | 0x47e4d18ddb3b05cbf70228813b80f7880fd43e3d6887822654a8787c64494bde |
| RoundState | 0x34d5c4037d238ac03758a930dbd997682ad2d1498e2ec11e8022010262ea0046 |