Specification
The protocol, as written.
Every page below is the repository's own markdown, rendered from commit 9210d6dff166 with a sha256 per file. The URLs are stable: they name the document, not the file it happens to live in. Each page has a raw markdown twin for machines, and one manifest lists them all.
Normative
DECKs: design extensions
DECKs: Design Extension and Compatibility Kits
How the protocol is extended without changing the base specification, and the registry of DECKs.
/spec/decks · /spec/decks.md
DECK-0001: Hyperspace (Bitcoin block transit)
Long-distance transit through Bitcoin block hashes: stops, landfalls, stations and rides, and the proofs each one carries.
/spec/hyperspace · /spec/hyperspace.md
DECK-0003: SNO (Simple Nostr Objects)
The small 3D object format: an integer lattice with 1/120 ticks, indexed faces, a 256-colour palette, and hard limits. Kind 33331 standalone; the same payload inside bags and avatars.
/spec/sno · /spec/sno.md
DECK-0004: Items, Chests and Doors
It defines kind 3340, an item: a keypair hidden in a bag, where holding its secret is holding the item. It defines kind 3341, a chest: a list of entries sealed with NIP-44 v2 to an item's or a person's public key. It defines a door: a chest with a door tag, which locks a room. What a door's author hides in its room goes into a room bag, whose key needs both the place and the door's secret. It defines the look, a SNO object that a chest or a door is drawn as. It defines kind 33340, an item listing: an item's name, picture and public key in public, with a proof made by the item's own key, never its secret.
/spec/items-and-chests · /spec/items-and-chests.md
DECK-0005: Local chat
Defines kind 23330, the ephemeral chat envelope (a bag in the ephemeral range, sealed to the speaker's room), and kind 23333, the chat line inside it, an unsigned rumor bound to the envelope's signer.
/spec/local-chat · /spec/local-chat.md
DECK-0006: Sealed comments
NIP-22 kind 1111 comments on hidden things, with the words encrypted to the bag's region key as an FF-1 derived-key event.
/spec/sealed-comments · /spec/sealed-comments.md
DECK-0007: Hidden audio
Defines kind 1063 as a bag item, a NIP-94 file event naming an encrypted file on Blossom and carrying its key, written as an unsigned rumor; and how it is heard in space: full inside a sphere about its source, fading to silence at the walls of its region, looping or played once on entering the sphere.
/spec/hidden-audio · /spec/hidden-audio.md
Rationale
Design records
Territory, conflict, and the game layer
The design record separating what the base protocol guarantees from what games built on it may add: holding a region, derezz as an opt-in game, and why there is no domains DECK.
/spec/territory · /spec/territory.md
What can be sold in Cyberspace
A record of which measured limits are real and what, given them, can and cannot be sold.
/spec/what-can-be-sold · /spec/what-can-be-sold.md
Guides
Artifacts
| File | What it is | URL |
|---|---|---|
| cyberspace-neon-256 palette | The built-in 256-colour SNO palette as JSON: 24 hues by 8 steps (index = hue * 8 + step), then steels and signatures. | /spec/sno-palette.json |
| Palette sheet | The same palette as an image, one cell per index. | /spec/sno-palette.png |
| SNO reference validator | Dependency-free Python that accepts or refuses an SNO payload exactly as DECK-0003 section 1.9 says, and runs its own rejection table. | /spec/sno-reference.py |
| Landfall reference | Reference computation for DECK-0001 landfalls. | /spec/landfall-reference.py |
| Hyperjump reference | Reference for ride openings with the re-roll price (DECK-0001 sections 5.3 to 5.5) over synthetic block hashes, with golden vectors. | /spec/hyperjump-reference.py |
| Grandfathered rides | The rides without an mn tag that verifiers accept by event id (DECK-0001 section 5.8), one id per line. | /spec/grandfathered-v1-hyperjumps.txt |
| Kinds test vectors | Deterministic test vectors for DECK-0004, DECK-0005, DECK-0006 and DECK-0007. | /spec/kinds-vectors.json |
| Hint reference | Reference for bag hints (section 7.7), with golden vectors. | /spec/hint-reference.py |
| Sidestep reference | Reference for the version 3 sidestep proof (sections 6.4, 6.5, 6.10, 6.11), with golden vectors. | /spec/sidestep-reference.py |
| Grandfathered sidesteps | The version 2 sidesteps that verifiers accept by event id (section 6.16), one id per line. | /spec/grandfathered-v2-sidesteps.txt |
| Hop residue reference | Reference for residue openings, version 2 of the hop proof (sections 5.9 to 5.11, 8.4): residues of a root, the hop primes, the seal, the re-roll price, the draw, the tag encoding and both verification levels, with golden vectors and a cross-check against the section 5.7 proof_hash. | /spec/hop-residue-reference.py |
| Hop residue golden vectors | The golden vectors of residue openings as machine-readable values (sections 5.9 to 5.13, 8.4, 8.7.1, 8.8): seven hops with every intermediate value and their tags, the 16 Level 1 checks of the section 5.7 hop, tampered proofs with their verdicts, and the prices and sizes. Written from hop-residue-reference.py; not normative. | /spec/hop-residue-vectors.json |
| Grandfathered version 1 hops | The version 1 hops that verifiers accept by event id (section 5.13), one per line. The header of the file records the census that filled it. | /spec/grandfathered-v1-hops.txt |
| Chain rules golden vectors | Signed synthetic chains with their verdicts, locking chain rules revision 2026-09-28-virtual-brackets (section 8.12); copied byte for byte from the reference implementation, whose vectors/README.md describes the format. | /spec/chain-rules-2026-09-28-virtual-brackets.json |
| Chain rules golden vectors, residue openings | Signed synthetic chains with their verdicts, locking chain rules revision 2026-10-08-residue-openings (section 8.12). Every hop carries residue openings except a version 1 hop and a hop a vector damages on purpose, and the file carries a test list of version 1 hops that takes the place of grandfathered-v1-hops.txt while the vectors run; copied byte for byte from the reference implementation. | /spec/chain-rules-2026-10-08-residue-openings.json |
| Visualization vectors | Golden vectors at the Cantor Height 34 scale for renderers. | /spec/visualization_vectors.json |