learn-unicity

One page that teaches how Unicity works, for people who have never touched any of this.

Two ideas, told in plain words: money you can hold in your own wallet instead of a balance in somebody's ledger, and an operating system where an AI agent starts with no powers and gets handed keys one at a time. Part one covers the Unicity network, part two covers Unicity AOS. Ten minutes, eight things to press.

The demos are real. The long numbers on screen are computed in your browser while you watch: SHA-256 over a strict CBOR encoding for the state identifiers, a sparse merkle tree with working inclusion proofs, and a hash-linked audit log you can tamper with and get caught. When a demo fails, it fails for the true reason, not a scripted one. The double spend produces a byte-identical key because the derivation really runs twice from the same state.

Files

index.html   the guide
story.html   the same story as a two minute animation, single screen
deep.html    the version with the actual byte encodings, for implementers
404.html     not-found page
fonts/       self hosted woff2, nothing loads from a CDN
og.png       link preview image
vercel.json  cache and security headers

No build step, no dependencies, no analytics, no external requests.

Run it

Open index.html in a browser, or serve the folder:

npx serve .

Deploy

vercel deploy --prod

or drag the folder onto vercel.com/new. The included vercel.json sets long cache for the fonts and a strict Content-Security-Policy for everything else.

og:image is root-relative. If a link preview does not render on some platform, replace it with the absolute URL once you know the domain.

Accuracy

Everything is told in easy words, and each section carries a short note with the real term so you can check the claims against the sources:

• state identifiers, re-masking, and the registry: the Unicity yellowpaper (unicitynetwork/unicity-yellowpaper-tex, execution layer)
• ALPHA chain parameters: unicitynetwork/alpha
• the six enforcement gates, capability tokens, capsules, the audit chain: astrid-runtime/astrid and unicity-aos/aos-ce
• the build-and-approve flow for new capsules: aos.unicity.ai/developers

This is an independent teaching page, not affiliated with Unicity Labs.

License

MIT