How omasim/klm works
KLM is an open standard and stdlib-only Python reference toolchain for validating epistemic records, producing verifiable signed attestations, maintaining tamper-evident logs, and creating visibility-tiered disclosures. The main workflow is an emitter or record author supplies a record; validators check its attestation and γ contracts; signing and logging support independent verification; disclosure produces user, auditor, or operator views. The graph also captures canonicalization support and conformance tooling. Some source was sampled only partially, so unsampled implementation links are omitted rather than inferred.
Main entry points: validate_attestation.py Attestation validator · validate_gamma.py Gamma validator · sign_attestation.py Signing and verification · disclosure.py Disclosure views
Components 17
Record contracts
- Attestation schema
schema/klm-attestation.schema.json - Gamma schema
schema/klm-gamma.schema.json
Validation
- Attestation validator
schema/validate_attestation.py - Gamma validator
schema/validate_gamma.py
Proof and history
- Signing and verification
schema/sign_attestation.py - Ed25519 reference
schema/ed25519_ref.py - JCS reference
schema/conformance/canonical/jcs_reference.mjs - Hash-chained log
schema/attestation_log.py
Disclosure
- Disclosure views
schema/disclosure.py
Conformance
- Attestation conformance
schema/conformance/attestation-0.2/run_conformance.py - Honest-null conformance
schema/conformance/honest-null/run_conformance.py - Canonical vector generator
schema/conformance/canonical/gen_vectors.mjs - Canonical conformance runner
schema/conformance/canonical/run_conformance.py
Other components
- Record author
- User
- Auditor
- Operator
Connections 15
- Record author → Attestation validator: submits record
README.md - Attestation validator → Attestation schema: checks contract
README.md - Record author → Gamma validator: submits γ record
README.md - Gamma validator → Gamma schema: checks contract
README.md - Attestation validator → Gamma validator: validates γ
schema/validate_attestation.py - Signing and verification → Ed25519 reference: uses fallback
schema/sign_attestation.py - Hash-chained log → Signing and verification: verifies envelopes
schema/attestation_log.py - Disclosure views → Signing and verification: uses record hashes
schema/disclosure.py - User → Disclosure views: requests view
README.md - Auditor → Disclosure views: requests view
README.md - Operator → Disclosure views: requests view
README.md - Attestation conformance → Attestation validator: grades vectors
schema/conformance/attestation-0.2/run_conformance.py - Honest-null conformance → Gamma validator: cross-checks γ
schema/conformance/honest-null/run_conformance.py - Canonical vector generator → JCS reference: generates vectors
schema/conformance/canonical/gen_vectors.mjs - Canonical conformance runner → Signing and verification: checks behavior
schema/conformance/canonical/run_conformance.py