docs(tutorial): the verifier checks signatures, and needs no clone - #337
Merged
Conversation
Step 4 told a reader to pip install trace-verify and run it, then the limits section said "It does not validate the signature ... Signature verification against a trusted producer key is a separate step". The tool has verified the producer's Ed25519 signature by default for as long as the signature extra has existed, and refuses rather than skipping when it cannot. A reader following this page was told exit 0 meant less than it does, which is the direction of error that matters here: it invites treating an unverified record as checked. Exit 0 now says what it covers, both halves. --no-verify-signature is named as the way to get inclusion alone, with the reason it warns. The page also said nothing about verifying without a clone, and the append-only question it raises in "what this does not prove" has had an answer since trace-verify 0.4.0: trace-verify chain. Both are now shown. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01X2GDChXjA7BAdDNzCAmBJv
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Two corrections to
docs/tutorials/anchoring-to-the-registry.md, both found by running the tool the page tells the reader to install.The one that matters
The page said:
trace-verifyhas verified the producer's Ed25519 signature by default for as long as the signature extra has existed, and refuses rather than skipping when it cannot. A reader following this page was told exit 0 meant less than it does, which is the direction of error that matters: it invites treating an unverified record as checked, or repeating a check that already ran.Exit 0 now says what it covers, both halves, and
--no-verify-signatureis named as the way to get inclusion alone, with the reason it warns.No clone needed
The page showed
--entry registry/2026/06/12.ndjson, a local path, with no mention that the registry need not be cloned. As oftrace-verify0.4.1,--entry-urlfetches both the entry and the producer key that signed the record, from an allowlisted host, and reports which key it used and where it came from. The tutorial now shows that invocation and names the minimum version.One addition
The "what this does not prove" section correctly says inclusion does not establish an append-only history. That question has had an answer since
trace-verify0.4.0, so the section now points at it:No normative text changes. Tutorial only.
🤖 Generated with Claude Code
https://claude.ai/code/session_01X2GDChXjA7BAdDNzCAmBJv