Build

Everything an implementation needs, in one place.

The protocol lives on Nostr as a small set of event kinds. The specification is the authority on every one of them; this page is the index.

Event kinds

KindWhat it carriesRelay semanticsDefined in
3333Movement chain: spawn, hop, sidestep, the hyperspace actions, and enter-virtual and exit-virtual (the bracket around a game, §8.11), told apart by the A tagregularspec
33330A bag: content encrypted to one region at one height, addressed by its lookup idaddressable (newest per pubkey, kind, d)spec
11333An avatar: one per identity, the SNO payload plus the work it owesreplaceable (newest per pubkey, kind)spec
33331An SNO object as its own event: editable by its author, or hidden by an a or e reference tag in a bag, with a public preview and its payload encrypted to the place (FF-1, cyberspace:region)addressablespec
3330An SNO object hidden inline as an item inside a bagbag itemspec
1A message hidden as an item inside a bag: its text in content, written as an unsigned rumorbag or chest itemspec
3340An item: a keypair hidden in a bag; holding its secret is holding itbag or chest item, never published on its ownspec
3341A chest: a list of entries sealed with NIP-44 v2 to an item's or a person's public key. A door is a chest with a door tag, which locks a roombag or chest item, never published on its ownspec
33340An item listing: an item's name, picture and public key in public, with a proof by the item's own key, never its secretaddressable (newest per pubkey, kind, d)spec
23330The ephemeral chat envelope: a bag in the ephemeral range, sealed to the speaker's roomephemeralspec
23333The chat line inside the envelope: an unsigned rumor bound to the envelope's signerrumor inside an envelopespec
1111A NIP-22 comment on a hidden thing, with the words encrypted to the bag's region key as an FF-1 derived-key eventregularspec
1063Hidden audio as a bag item: a NIP-94 file event naming an encrypted file on Blossom and carrying its key, written as an unsigned rumorbag or chest item, never published on its ownspec

Palettes are read from whatever convention the network uses; today that is kind 3367 with one c tag per colour (DECK-0003). The protocol defines no palette kind of its own.

Implementations

Reference scripts and data

Mirrored from the repository at commit 9210d6dff166. The Python files are dependency free on purpose, so an agent with a sandbox can check its own output.

FileWhat it is
sno-palette.jsonThe built-in 256-colour SNO palette as JSON: 24 hues by 8 steps (index = hue * 8 + step), then steels and signatures.
sno-palette.pngThe same palette as an image, one cell per index.
sno-reference.pyDependency-free Python that accepts or refuses an SNO payload exactly as DECK-0003 section 1.9 says, and runs its own rejection table.
landfall-reference.pyReference computation for DECK-0001 landfalls.
hyperjump-reference.pyReference for ride openings with the re-roll price (DECK-0001 sections 5.3 to 5.5) over synthetic block hashes, with golden vectors.
grandfathered-v1-hyperjumps.txtThe rides without an mn tag that verifiers accept by event id (DECK-0001 section 5.8), one id per line.
kinds-vectors.jsonDeterministic test vectors for DECK-0004, DECK-0005, DECK-0006 and DECK-0007.
hint-reference.pyReference for bag hints (section 7.7), with golden vectors.
sidestep-reference.pyReference for the version 3 sidestep proof (sections 6.4, 6.5, 6.10, 6.11), with golden vectors.
grandfathered-v2-sidesteps.txtThe version 2 sidesteps that verifiers accept by event id (section 6.16), one id per line.
hop-residue-reference.pyReference 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.
hop-residue-vectors.jsonThe 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.
grandfathered-v1-hops.txtThe 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.
chain-rules-2026-09-28-virtual-brackets.jsonSigned 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.
chain-rules-2026-10-08-residue-openings.jsonSigned 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.
visualization_vectors.jsonGolden vectors at the Cantor Height 34 scale for renderers.

For agents