Expand description
Artifact files: JSON wrappers around canonical CBOR bytes (hex). JSON is transport-only; the canonical CBOR is the artifact of record (FORMAT §7). Every load re-verifies bytes against schema and recomputes the id — a file whose bytes do not match its id is rejected, never used.
Functions§
- cbor_
to_ hex - hash_
ref_ from_ hex - Digest hex (64 chars = SHA-256, 96 = SHA-384) → HashRef.
- input_
list - Comma/colon list helper for
buildinputs. - load_
attestation - Load + fully re-verify a signed attestation artifact: COSE envelope, issuer binding, canonical bytes, payload agreement, and id binding.
- load_
event - Load + fully re-verify an event artifact. The file’s
id, if present, must match the id recomputed from the bytes. - load_
evidence - Load + fully re-verify an evidence artifact.
- load_
relationship - Load + fully re-verify a relationship artifact.
- load_
status - Load a status artifact as a signed object (signature is verified here; authority/trust decisions happen later in the pipeline).
- write_
attestation attest: bind issuer to the signing key, sign, write attestation artifact.- write_
event create-event: validate, canonicalize, id, write event artifact.- write_
evidence add-evidence: evidence is id-bound only (no signature of its own).- write_
proof_ file - Write a proof artifact: the whole canonical proof CBOR plus its id.
- write_
relationship relate: bind a relationship edge to its id (grounding is checked later, at proof build time, by proof-graph).- write_
status_ object revoke/supersede: signed lifecycle status objects.