The WebGL portal
index.html is the real-time 3D front door to the suite. A black
obsidian orb hovers inside a crimson-lit octagonal containment vault, wrapped in a ring of
plasma. The six apps ride a carousel round the orb; the node at the front haloes the orb and
is the selected app.
Controls
| Input | Action |
|---|---|
| Drag | Orbit the chamber |
| ‹ › arrows, ← → | Spin the carousel one app either way |
| Click a side node | Spin it to the front |
| Click the front node (the orb), Enter | Warp transition into the selected app |
| Click a card or pill, 1–5 | Spin that app to the front, then warp: DarkCircle, Circleswap, DarkSafe, Dark Questate, DarkOrder |
| Hover a node | Telemetry readout: node, route, live Cyprus-1 block height |
| Sound button | Music and synthesized cues (Web Audio, muted by default) |
| Book button | Opens this documentation |
| Phone tilt | Parallax (iOS asks for permission on first touch) |
?mode=2d | Force the 2D card portal |
It opens on Circleswap in front, DarkCircle and DarkSafe to either side, and Dark Questate and DarkOrder behind the orb. Tap the BOLTEVM logo for a new world color.
Graceful degradation
No WebGL, a failed GPU context, a missing model file or
prefers-reduced-motion all land on a working 2D portal or a calmer 3D one. The
links are plain anchors, so navigation never depends on the 3D engine. In the 2D portal the
arrows still work: they move the highlight across the cards, and Enter opens the
highlighted app.
Privacy
The portal loads nothing from a third-party host: three.js and every add-on are vendored
under assets/3d/vendor/, and there are no web fonts. The only network call is a
single read-only quai_blockNumber to rpc.quai.network, made the first
time you target a node or spin the carousel, with credentials and referrer omitted. The bottom
bar shows its state (RPC idle, querying, CYPRUS-1 #...).
Subdomain and path routing
| Host starts with | Goes to |
|---|---|
q0. circleswap. or contains q0- | /q0/ |
darksafe. safe. multisig. or contains darksafe- | /multisigows/ |
tumbler. privacy. x402. or contains tumbler- | /x402tumbler/ |
questate. darkquestate. realestate. or contains questate- | /darkquestate/ |
darkorder. guild. halls. or contains darkorder- | /darkorder/ |
404.html applies the same rules to deep links and keeps the
/<repo>/ prefix on GitHub project pages. A deep link under
/questate/ goes to /darkquestate/; a deep link under
/guildhalls/ goes to /darkorder/.
The 3D asset
| Space | Y-up, metres. Orb centre at (0, 1.7, 0), radius 0.5. Room: 14.8 m across, 4.6 m high |
| Size | about 24k triangles, 790 KB .glb, 10 PBR materials, no textures |
| Lights | 7 punctual lights, exported unitless (COMPAT) so three.js does not blow out |
| Animation | Four 5-second loop clips: orb hover, plasma spin, plasma sweep, camera push |
| Reference | Proportions measured from the QRB artwork q0/QgoGIF.gif |
| Source | Rebuilt from code by tools/build_qrb_scene.py; verified by tools/verify_qrb_assets.mjs |
Both index.html and 404.html must stay pure ASCII; CI fails on any
non-ASCII byte (the first build shipped corrupted dashes and emoji — emoji are written as
HTML entities instead).