Skip to content

bip373: add hyperlinks to other BIPs#1886

Merged
murchandamus merged 5 commits intobitcoin:masterfrom
wedjob0X:master
Jul 3, 2025
Merged

bip373: add hyperlinks to other BIPs#1886
murchandamus merged 5 commits intobitcoin:masterfrom
wedjob0X:master

Conversation

@wedjob0X
Copy link
Contributor

@wedjob0X wedjob0X commented Jul 1, 2025

add hyperlinks to BIPs 327

===Motivation===

BIP 327 specifies a way to create BIP 340 compatible public keys and signatures using the MuSig2
[[bip-0327.mediawiki|BIP-327]] specifies a way to create BIP 340 compatible public keys and signatures using the MuSig2
Copy link
Member

@jonatack jonatack Jul 1, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @GuroChil, a few questions:

  • why omit the first use of "BIP 327" on lines 18-19 (and would that first one suffice)
  • why only for BIP 327
  • why change the format from "BIP 327" to "BIP-327", when the non-hyphenated version was chosen by the author of this BIP

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the detailed review! I've addressed all points:
Added the first BIP 327 reference on lines 18-19
Applied consistent formatting across other BIPs as well
Reverted back to non-hyphenated format as per original author's style

Copy link
Member

@murchandamus murchandamus left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please update all the edits to undo the unnecessary sentence shifts due to changing where the lines break.

Comment on lines +18 to +20
This document proposes additional fields for [[bip-0174.mediawiki|BIP 174]] PSBTv0 and [[bip-0370.mediawiki|BIP 370]]
PSBTv2 that allow for [[bip-0327.mediawiki|BIP 327]] MuSig2 Multi-Signature data to be included in a PSBT of any version.
These will be fields for the participants' keys, the public nonces, and the partial signatures produced with MuSig2.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please don’t change where the lines break in the sentence when you are only editing single words. Instead leave the line breaks where they are and allow longer lines to minimize visual clutter in the diff.

Suggested change
This document proposes additional fields for [[bip-0174.mediawiki|BIP 174]] PSBTv0 and [[bip-0370.mediawiki|BIP 370]]
PSBTv2 that allow for [[bip-0327.mediawiki|BIP 327]] MuSig2 Multi-Signature data to be included in a PSBT of any version.
These will be fields for the participants' keys, the public nonces, and the partial signatures produced with MuSig2.
This document proposes additional fields for [[bip-0174.mediawiki|BIP 174]] PSBTv0 and [[bip-0370.mediawiki|BIP 370]] PSBTv2 that allow for
[[bip-0327.mediawiki|BIP 327]] MuSig2 Multi-Signature data to be included in a PSBT of any version. These will be fields for
the participants' keys, the public nonces, and the partial signatures produced with MuSig2.

nonce that is added in a <tt>PSBT_IN_MUSIG2_PUB_NONCE</tt> field. However
signers must keep in mind that '''improper nonce usage can compromise private
keys.''' Please see BIP 327 for best practices on nonce generation and usage.
keys.''' Please see [[bip-0327.mediawiki|BIP-327]] for best practices on nonce generation and usage.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: Please drop the dash for consistency.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for the feedback!
I've implemented all the suggested changes. Please let me know if you have any other recommendations.

I've implemented all the suggested changes
Copy link
Member

@murchandamus murchandamus left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe I was unclear, but you overlooked a few.

Copy link
Member

@murchandamus murchandamus left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed it myself to spend less time on this.

@murchandamus murchandamus changed the title add hyperlinks to BIPs 327 bip373: add hyperlinks to other BIPs Jul 3, 2025
@murchandamus murchandamus merged commit fd19556 into bitcoin:master Jul 3, 2025
4 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.

3 participants