Expand description
The evidence bundle: a ceremony run packaged with its definition.
A bundle is a directory with a fixed layout:
bundle.json this index
transcript.jsonl the transcript, byte for byte as the run wrote it
definition/ceremony.rite.yaml the ceremony YAML the run was resolved from
artifacts/<file> artifacts the transcript records with a digestThe index locates files and says what each one is. It repeats no digest:
every file other than the transcript is bound by a digest the transcript
commits to (the template digest on CeremonyStarted, the digest on each
ArtifactWritten), so a verifier checks files against the transcript and
the index adds nothing that would need protecting or redacting on its own.
The trust anchor is the transcript fingerprint, never the index.
A disclosure bundle has the same layout. Its transcript withholds every line above the index’s threshold and folds to the same fingerprint as the complete one; it carries only the artifacts whose facts it discloses, and never the definition, which can name people.
Structs§
- Bundle
File - One file in a bundle.
- Bundle
Index - The index at the root of a bundle.
Enums§
- Bundle
Kind - What a bundle holds relative to the run.
- File
Role - What a bundle file is.
Constants§
- ARTIFACTS_
DIR - Directory holding artifacts within a bundle.
- BUNDLE_
FORMAT - Bundle format version this crate writes and reads. 0 while rite is before
1.0, like
TRANSCRIPT_FORMAT. - BUNDLE_
SCHEMA - URL of the JSON Schema for the index this release writes, which the index
names as its
$schemaso editors validate it. - DEFINITION_
FILE - Path of the ceremony definition within a bundle.
- INDEX_
FILE - Name of the index file at the bundle root.
- TRANSCRIPT_
FILE - Path of the transcript within a bundle.
Functions§
- artifact_
path - Where an artifact recorded under
fileis stored, relative to the bundle or run directory:artifacts/<file>.