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 hashes
  • PeerRegistry — registered miners and validators
  • ScoreLedger — OpenSkill scores and normalized weights
  • ValidatorRegistry — 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