Add optional event provenance and tamper-evidence guidance (#315) - #320
Open
MarkovianProtocol wants to merge 1 commit into
Open
Add optional event provenance and tamper-evidence guidance (#315)#320MarkovianProtocol wants to merge 1 commit into
MarkovianProtocol wants to merge 1 commit into
Conversation
Adds an informational companion document describing two distinct properties: authenticity and integrity via DSSE, and existence-over-time via an optional commitment to the event canonical hash on an external timeline. Mechanism-agnostic per the discussion in cdevents#315: the document names the class of anchors without endorsing one. No schema changes; nothing is required of an implementer. Signed-off-by: Colin H Winter <hello@markovianprotocol.com>
MarkovianProtocol
force-pushed
the
event-provenance-guidance
branch
from
July 28, 2026 20:17
c92881c to
0f085aa
Compare
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.
Adds an optional, informational companion document on event provenance, as invited in #315.
Two properties, kept distinct:
Per the discussion in #315, this is deliberately mechanism-agnostic. The document names the class of anchors — RFC 3161 timestamp authorities, append-only transparency logs, public blockchain inclusion — without endorsing one, and states explicitly that the choice of anchor is out of scope. The only thing CDEvents tooling needs to agree on is the commitment itself: RFC 8785 canonicalization plus SHA-256.
Scope of this PR
event-provenance.md(root level, matching existing document convention).README.mdunder the key assets list.spec.mdor any event definition. Nothing here is required of an implementer.Worked example. A runnable end-to-end example lives outside this repository at MarkovianProtocol/cdevents-provenance so CDEvents takes no dependency on it: a real
dev.cdevents.artifact.published.0.3.0event validated against the published v0.5.1 schema, its JCS canonical bytes, a DSSE envelope, the commitment, and a verifier demonstrating genuine artifacts passing both checks and tampered ones failing both. Happy to vendor it undertools/orconformance/instead if the group prefers it in-tree.Venue, wording, and which anchor mechanisms to list are all open to the group's preference — happy to walk through it at the SIG.
Closes #315