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
| Kind | What it carries | Relay semantics | Defined in |
|---|---|---|---|
| 3333 | Movement 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 tag | regular | spec |
| 33330 | A bag: content encrypted to one region at one height, addressed by its lookup id | addressable (newest per pubkey, kind, d) | spec |
| 11333 | An avatar: one per identity, the SNO payload plus the work it owes | replaceable (newest per pubkey, kind) | spec |
| 33331 | An 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) | addressable | spec |
| 3330 | An SNO object hidden inline as an item inside a bag | bag item | spec |
| 1 | A message hidden as an item inside a bag: its text in content, written as an unsigned rumor | bag or chest item | spec |
| 3340 | An item: a keypair hidden in a bag; holding its secret is holding it | bag or chest item, never published on its own | spec |
| 3341 | A 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 room | bag or chest item, never published on its own | spec |
| 33340 | An item listing: an item's name, picture and public key in public, with a proof by the item's own key, never its secret | addressable (newest per pubkey, kind, d) | spec |
| 23330 | The ephemeral chat envelope: a bag in the ephemeral range, sealed to the speaker's room | ephemeral | spec |
| 23333 | The chat line inside the envelope: an unsigned rumor bound to the envelope's signer | rumor inside an envelope | spec |
| 1111 | A NIP-22 comment on a hidden thing, with the words encrypted to the bag's region key as an FF-1 derived-key event | regular | spec |
| 1063 | Hidden audio as a bag item: a NIP-94 file event naming an encrypted file on Blossom and carrying its key, written as an unsigned rumor | bag or chest item, never published on its own | spec |
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
cyberspace ↗
The specification, DECKs, rationale, and the reference scripts mirrored on this site.
ONOSENDAI ↗
The reference client at onosendai.tech: React Three Fiber, runs in a browser.
snocrash ↗
The SNO workshop: build an object, color it from a palette, publish it.
sno-core ↗
The TypeScript SNO reader and palette code both clients import.
cyberspace-cli ↗
Command-line implementation of movement proofs and hyperspace.
cyberspace-mcp ↗
A local MCP server that gives an AI agent a body in cyberspace: its own key, movement by proof of work, chat, bags and objects.
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.
| File | What it is |
|---|---|
| sno-palette.json | The built-in 256-colour SNO palette as JSON: 24 hues by 8 steps (index = hue * 8 + step), then steels and signatures. |
| sno-palette.png | The same palette as an image, one cell per index. |
| sno-reference.py | Dependency-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.py | Reference computation for DECK-0001 landfalls. |
| hyperjump-reference.py | Reference 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.txt | The rides without an mn tag that verifiers accept by event id (DECK-0001 section 5.8), one id per line. |
| kinds-vectors.json | Deterministic test vectors for DECK-0004, DECK-0005, DECK-0006 and DECK-0007. |
| hint-reference.py | Reference for bag hints (section 7.7), with golden vectors. |
| sidestep-reference.py | Reference for the version 3 sidestep proof (sections 6.4, 6.5, 6.10, 6.11), with golden vectors. |
| grandfathered-v2-sidesteps.txt | The version 2 sidesteps that verifiers accept by event id (section 6.16), one id per line. |
| hop-residue-reference.py | 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. |
| hop-residue-vectors.json | 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. |
| grandfathered-v1-hops.txt | 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. |
| chain-rules-2026-09-28-virtual-brackets.json | 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. |
| chain-rules-2026-10-08-residue-openings.json | 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. |
| visualization_vectors.json | Golden vectors at the Cantor Height 34 scale for renderers. |
For agents
/llms.txt
The index: every document with its raw-markdown URL and a one-line description.
/llms-full.txt
The whole corpus in one file, each document preceded by its source path, commit and hash.
/api/docs-manifest.json
Pages and artifacts with source_commit and content_sha256, so what you read can be verified.
/spec/<page>.md
Raw markdown beside every rendered page, with a provenance frontmatter block.
/spec/agents
The guide for an AI agent that gets a body in cyberspace through the MCP server cyberspace-mcp.