Skip to content

feat: prove an inclusion of one sidecar path - #12

Merged
HaoZeke merged 2 commits into
mainfrom
feat/input-attestation
Nov 18, 2026
Merged

HaoZeke merged 2 commits into
mainfrom
feat/input-attestation

Conversation

@HaoZeke

@HaoZeke HaoZeke commented Nov 17, 2026

Copy link
Copy Markdown
Contributor

Write an inclusion receipt for one path in a Request for Comments (RFC) 9162 sidecar log, and check that receipt without the log.

rfc9162-sidecar prove --dir DIR --path PATH writes one JSON object: the checkpoint note, the exact entry, the inclusion path, and the blob hash of a put. verify-proof --proof FILE --trusted KEYLINE checks the note and the inclusion path. --blob-file checks that the file's SHA-256 is the object's blob hash. verify-proof does not open the pack. A later snapshot replaces pack/checkpoint. The stored object still verifies, because it keeps the note it was issued against.

A consumer that keeps a record outside the log needs that receipt to stay valid after the next snapshot. The checkpoint file alone does not.

rfc9162-sidecar init --dir "$DIR"
rfc9162-sidecar sync --dir "$DIR"
rfc9162-sidecar snapshot --dir "$DIR" --key key.pem --origin example.org
rfc9162-sidecar prove --dir "$DIR" --path inputs/record.json > proof.json
rfc9162-sidecar verify-proof --proof proof.json --trusted "$LINE" --blob-file "$DIR/inputs/record.json"

verify-proof prints verified proof and the path, index, size, and root. The reference is docs/src/reference/sidecar.md.

`rfc9162-sidecar prove` writes a checkpoint and an inclusion proof for one path. `verify-proof` checks that proof, and an optional blob file, without opening the log.
The sidecar reference and the log how-to cover prove and verify-proof, and the install page lists both commands.
@HaoZeke
HaoZeke merged commit efb0c13 into main Nov 18, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant