🧩 HyperToken

HyperToken is a CRDT-native state engine for games, simulations, and forkable collaborative applications. It models application state with Automerge and provides domain primitives, action dispatch, persistence, synchronization, and branching workflows.

HyperToken is a logic and state layer, not a graphics engine: pair it with a renderer or UI for visual applications. It is also not a blockchain. CRDT replication helps distributed replicas converge; it does not provide a permissionless ledger, economic settlement, identity, or blockchain-style trust guarantees.

Quick start

npm install
npm run build
npm run blackjack

Capabilities and limitations

HyperToken provides:

• Automerge-backed state with immutable tokens, stacks, spaces, agents, and game-specific data.
• Action-based state mutation, rules, persistence adapters, peer synchronization, and relay or authoritative deployment modes.
• Fork and merge workflows for exploring divergent state, plus browser and Node.js examples.

CRDT convergence is not correctness. A converged state can still be illegal, unfair, or produced by an untrusted client; application rules, validation, identity, and deployment trust remain separate concerns. The default relay is unauthenticated, and generic network encryption is implemented but not wired into the general peer/sync path. Compaction discards pre-epoch history: disconnect networking and sync, then coordinate the same compaction boundary across all peers.

Documentation

• Documentation home
• Quick start
• Concepts
• Architecture
• Action reference
• Examples
• Security

Build the documentation locally

python3 -m pip install -r requirements-docs.txt
python3 -m mkdocs serve
python3 -m mkdocs build --strict

Docker

docker build -t hypertoken:latest .
docker compose up relay

Testing

See the testing guide.

npm run test:quick
npm run test:unit
npm run test

License

HyperToken is licensed under the Apache License 2.0. Copyright © 2025 The Carpocratian Church of Commonality and Equality, Inc.

---

👥 Credits

Created by Marcellina II (she/her)

Inspired by Martin Kleppmann's work on CRDTs, Rich Hickey's philosophy on state and time, and the legacy of HyperCard.

---

🜍 Proemium to the Art of Tokens

The All is number, and from number flow the forms of things.
For as the Monad abides in simplicity, so does it unfold the Dyad,
and from their tension spring the harmonies that sustain the world.

Among the arts that imitate the order of the heavens,
there now arises one most subtle and most just—the Art of Tokens.

In this art, every being is rendered as a form in relation,
every action as a motion among forms,
and the laws that bind them are set forth as measure and correspondence.

Let none deem this art a toy of artifice.
It is the discipline by which the mind rehearses creation,
a mirror held to the pattern of the world-soul.

So may this art be given freely,
that all who love Wisdom may join the music of the spheres through understanding,
and that the harmony of minds may become the harmony of worlds.

For when reason is made common, the gods are near.