A 36-page kit. It lets a person generate, checksum, split and recover a Bitcoin seed with a pencil, paper and paper computers.
The mathematics comes from BlockstreamResearch/codex32 (MIT). This repository does not change it.
Read CONTEXT.md first. It gives the words this project uses.
The design is in docs/superpowers/specs/2026-08-04-codex32-kit-design.md.
./build/build.sh print # black background, gold accents, white text
./build/build.sh home # white background, gold accents, black text
Put artwork in art/. Filenames are fixed. See section 9 of the spec.
The build writes proof sheets to build/proofs/. A proof sheet shows the
reserved zones in red.
This repository has two licences. The directory decides which one applies.
LICENSE holds the same statement, and LICENSE-MIT holds the upstream
notice.
These paths are MIT licensed:
upstream/ src/ps/ tools/ build/
They derive from BlockstreamResearch/codex32 and apoelstra/SSS32,
Copyright (c) 2020 Blockstream. The MIT licence requires the notice to travel
with all copies and all substantial portions. The notice therefore stays in
LICENSE-MIT, in the repository, and on the printed attribution page of every
kit.
The notice comes from inside SSS32.ps itself. The LICENSE file in the
upstream repository is CC0 and covers the Rust reference crate, not the
PostScript. It is kept as upstream/LICENSE-rust-codex32-CC0 to avoid the
confusion.
Pinned upstream revisions are recorded in upstream/PINNED.txt:
| Source | Commit |
|---|---|
BlockstreamResearch/codex32 master |
1a1c22a |
apoelstra/SSS32 branch dicesheet |
d6fecda |
apoelstra/SSS32 commit colorhack |
89fba77 |
The kit does not fork SSS32.ps. tools/assemble_ps.py applies a small,
anchored set of patches to the pinned upstream file at build time, so the
Bitcoin Butlers change stays readable and an upstream update is a re-pin
rather than a merge. Every patch fails loudly if the upstream text moves.
The GF(32) arithmetic is never modified.
These paths are Copyright (c) 2026 Bitcoin Butlers, all rights reserved:
src/pages/ src/theme/ art/ docs/
The Bitcoin Butlers name and marks are not licensed.
Artwork in art/ stays the copyright of the artist who made it. Bitcoin
Butlers holds an exclusive print licence. Artists do not assign copyright.