Reference implementations of the Capsule Protocol Specification (CPS).
| Capability | Python | TypeScript |
|---|---|---|
| Capsule data model | ✅ | ✅ |
to_dict() / toDict() |
✅ | ✅ |
from_dict() / fromDict() |
✅ | ✅ |
canonicalize() |
✅ | ✅ |
compute_hash() |
✅ | ✅ |
seal() |
✅ | ✅ |
verify() |
✅ | ✅ |
| Chain verification | ✅ | ✅ |
| Storage (SQLite) | ✅ | — |
| Storage (PostgreSQL) | ✅ | — |
| ML-DSA-65 (post-quantum) | ✅ Optional | — |
| Conformance (16/16) | ✅ 16/16 | ✅ 16/16 |
✅ = Implemented and passing conformance — = Not applicable (storage and PQ are implementation-specific features)
Go and Rust implementations ship as separate repos, not inside this repository. Two reference implementations (Python + TypeScript) is intentional — enough to prove cross-language interoperability without turning the protocol repo into a polyglot monorepo.
| Language | Repo | Status |
|---|---|---|
| Go | quantumpipes/capsule-go | Planned |
| Rust | quantumpipes/capsule-rust | Planned |
New language implementations import conformance/fixtures.json from this repo and pass all 16 golden vectors independently.
Every reference implementation must pass all 16 golden test vectors in conformance/fixtures.json. An implementation is conformant when it produces byte-identical canonical JSON and matching SHA3-256 hashes for every fixture.
See the Implementor's Guide for step-by-step instructions.
- Create
reference/<language>/with your implementation - Pass all 16 conformance fixtures
- Include a README with install, quickstart, and conformance status
- Submit a PR — see CONTRIBUTING.md