Skip to content

Update text of Commitment Schemes, DBC, Opret and Tapret pages - #27

Open
MariJJhodl wants to merge 2 commits into
rgb-protocol:masterfrom
MariJJhodl:docs-commitment-layer
Open

MariJJhodl wants to merge 2 commits into
rgb-protocol:masterfrom
MariJJhodl:docs-commitment-layer

Conversation

@MariJJhodl

Copy link
Copy Markdown
Member

I revised the prose of the Commitment Schemes, Deterministic Bitcoin Commitments, Opret and Tapret pages, keeping the original structure.

Please check the second commit (52ba4f9) in particular. The pages hashed the Tapret commitment with the TapBranch tag (tH_BRANCH). In rgb-consensus, the commitment script is hashed as a tapscript leaf, both with and without a pre-existing script tree (TapNodeHash::from_script(&script_commitment, LeafVersion::TapScript) in src/dbc/tapret/xonlypk.rs). The commit replaces tH_BRANCH/TapBranch with tH_LEAF/TapLeaf, including leaf version and size, in the formula and in the five diagrams. The note in case b1 (branches and leaves use different tags) also relies on the commitment being a leaf.

@St333p could you confirm the TapLeaf change? Let me know if everything is okay, thanks!

Mari added 2 commits November 3, 2026 13:12
Revise wording, grammar and collocations across the commitment layer pages.
Use BIP-341 terminology consistently (Key Path Spend, Script Path Spend),
fix opcode names (OP_PUSHBYTES_32, OP_PUSHBYTES_33), correct the tweak
symbol in the first Tapret diagram, and update the anchor link in anchors.md
to the renamed Tapret heading.
rgb-consensus hashes the 64-byte Tapret commitment script as a tapscript
leaf (TapNodeHash::from_script with LeafVersion::TapScript in
src/dbc/tapret/xonlypk.rs), both with and without a pre-existing script
tree. Replace tH_BRANCH/TapBranch with tH_LEAF/TapLeaf, including leaf
version and size, wherever the commitment itself is hashed.
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