Skip to content

BIP 54: improve and deduplicate parts of rationale and motivation#2170

Merged
murchandamus merged 4 commits into
bitcoin:masterfrom
darosior:bip54_rationale_additions
May 21, 2026
Merged

BIP 54: improve and deduplicate parts of rationale and motivation#2170
murchandamus merged 4 commits into
bitcoin:masterfrom
darosior:bip54_rationale_additions

Conversation

@darosior
Copy link
Copy Markdown
Member

As i'm finalizing the document, i noticed a few places that could be improved:

  • Rephrase some paragraphs for better flow
  • Link to new posts (for instance the Utreexo BIP)
  • De-duplicate content between motivation and rationale: stick to motivating the concept in the motivation, and justifying the approach taken in rationale
  • Similarly to BIP 54: clarify 64-byte transactions item description and rationale #2159, link to an objection about using nLockTime and explain why this approach was taken nonetheless
  • Minor improvements (duplicate references, English wording, etc.)

darosior added 2 commits May 20, 2026 16:43
The sentence was misleading, with 'lower end devices' potentially applying to the whole range, and the range itself being understated.
@murchandamus murchandamus added the BIP Update by Owner PR by Author or Deputy to modify their own BIP label May 21, 2026
Copy link
Copy Markdown
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.

Changes look good to me. Nice clean-up of the descriptions. No nits.

Copy link
Copy Markdown
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.

Clicked through the commits now that CI has run and came up with a nit. ;)

Comment thread bip-0054.md
darosior added 2 commits May 21, 2026 14:49
The rationale was duplicating some of the motivation. The motivation had a sentence that read weird.
While rephrasing the sentence, take the opportunity to link to the now-proposed Utreexo BIP. Also
remove a duplicate link reference.
@darosior darosior force-pushed the bip54_rationale_additions branch from 72928b4 to 6c61126 Compare May 21, 2026 18:49
Copy link
Copy Markdown
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.

This is mainly an improvement of the phrasing and collects resolutions on some remarks. There are no changes to the meaning of the specification.

LGTM.

@murchandamus murchandamus merged commit a766a6e into bitcoin:master May 21, 2026
4 checks passed
Comment thread bip-0054.md
the same coinbase transaction cannot have been valid in a previous block[^11]. This simplifies both
reasoning and client implementation, since the [bip-0030][BIP30] check can be skipped entirely past
Consensus Cleanup activation, regardless of the [bip-0034][BIP34] activation status[^12]. One person
[raised the concern][miningdev nLockTime] that the `nLockTime` field would be an ideal extranonce
Copy link
Copy Markdown
Member

@jonatack jonatack May 21, 2026

Choose a reason for hiding this comment

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

Should this miningdev nLockTime link be different from the identical one 2 lines below in line 124?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Initially i was linking exactly to the two posts, but decided in favour of linking to the thread instead, as this gives a better overview of the discussion. Both Luke's and AJ's points are easy to spot from this link. So this was intentional, it just means "in the same thread".

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Ah, ok. From the way it reads, it appears like the intention is to link to each post and as a reader I reckon it would be better, but no big deal.

Copy link
Copy Markdown
Member

@jonatack jonatack left a comment

Choose a reason for hiding this comment

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

Good improvements

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

BIP Update by Owner PR by Author or Deputy to modify their own BIP

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants