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.
npm install
npm run build
npm run blackjackHyperToken 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.
python3 -m pip install -r requirements-docs.txt
python3 -m mkdocs serve
python3 -m mkdocs build --strictdocker build -t hypertoken:latest .
docker compose up relaySee the testing guide.
npm run test:quick
npm run test:unit
npm run testHyperToken is licensed under the Apache License 2.0. Copyright © 2025 The Carpocratian Church of Commonality and Equality, Inc.
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.
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.