doc: add non-technical one-pager for the Dilithium PSBT testnet proof - #160
Draft
Oskii wants to merge 1 commit into
Draft
doc: add non-technical one-pager for the Dilithium PSBT testnet proof#160Oskii wants to merge 1 commit into
Oskii wants to merge 1 commit into
Conversation
design/DILITHIUM_PSBT_DESIGN.md is written for implementers and assumes familiarity with BIP174, BIP341 and P2MR. There was nothing to hand to a reader who needs to understand what was demonstrated without reading a wire format specification. Adds a one-page summary of the 2-of-3 Dilithium multisig spend proven on the public testnet: what a PSBT is, what could not be done before, the two signing flows exercised, the negative tests, and why acceptance by unrelated miners makes it independent rather than self-confirming. Every claim is checkable from the block explorer links it carries. The markdown is the source of record; the PDF is the artifact for circulation and the CSS regenerates it, so the layout does not have to be rebuilt by hand.
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.
Summary
design/DILITHIUM_PSBT_PROOF.md, a one-page summary of the 2-of-3 Dilithium multisig spend proven on the public testnet, written for a reader who should not have to read a wire format specification to understand what was demonstrated.DILITHIUM_PSBT_PROOF.pdffor circulation, plus the.pdf.cssused to produce it so the layout is reproducible rather than hand-rebuilt. The markdown is the source of record.Both transactions are linked to the public explorer, so every factual claim is checkable without running anything:
6fc71b62…0bc98d31a6cf…2ff5Ordering note
Opened as a draft on purpose. The one-pager describes behaviour that is not on master yet: the implementation, the design doc's live-chain proof section, and the re-runnable proof script all arrive with the implementation pull request. The footer therefore points only at
design/DILITHIUM_PSBT_DESIGN.md, which does exist, rather than at the section and script that do not. This should merge after the implementation lands, at which point the footer can be pointed at the proof script directly.Test plan
design/DILITHIUM_PSBT_PROOF.pdfopens and is a single page