Skip to content

BIP-0322: name taproot upgrade mechanisms in the upgradeable rules - #2336

Merged
jonatack merged 1 commit into
bitcoin:masterfrom
fametrano:bip322-taproot-upgradeable
Oct 23, 2026
Merged

jonatack merged 1 commit into
bitcoin:masterfrom
fametrano:bip322-taproot-upgradeable

Conversation

@fametrano

@fametrano fametrano commented Oct 23, 2026 •

Copy link
Copy Markdown

BIP322's upgradeable rules do not name four taproot upgrade mechanisms, so a verifier that follows the text calls a signature using one of them valid. This adds one rule naming them: an unknown leaf version and the annex (BIP341), OP_SUCCESSx and an unknown public key type (BIP342). Such a signature then gets the inconclusive state, as reserved NOPs and segwit versions above 1 already do. The version becomes 2.1.0, as requested in review.

The BIP322 library in btcd#2521 already returns inconclusive for all four, and the gap was raised in its review. I ran its test vectors through btclib-wallet, a verifier I maintain: it agreed on three of the four and called the annex case valid, as the current text says.

cc @guggero @kallewoof

@saeidas582-lab

This comment has been minimized.

@jonatack jonatack added Proposed BIP modification PR by non-owner to update BIP content Pending acceptance This BIP modification requires sign-off by the champion of the BIP being modified labels Oct 23, 2026

@guggero guggero left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

ACK c86595b, subject to possibly changing the version bump to minor.

Comment thread bip-0322.mediawiki Outdated
@kallewoof

Copy link
Copy Markdown
Contributor

ACK. Agree on this being a minor version bump.

The upgradeable rules list the to_sign version, NOPs reserved for
upgrades and segwit versions above 1. BIP341 and BIP342 also reserve
unknown leaf versions, OP_SUCCESSx, unknown public key types and the
annex for upgrades. A verifier that follows the BIP322 text calls a
signature using any of them valid. Name them, so that these give the
inconclusive state like the other upgrade mechanisms.

Bump the version to 2.1.0 and add a changelog entry.
Add 342 to Requires.
@jonatack jonatack removed the Pending acceptance This BIP modification requires sign-off by the champion of the BIP being modified label Oct 23, 2026

@jonatack jonatack left a comment •

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.

ACK 99ece78

Edit: I deleted my inline comment; it was wrong.

@jonatack
jonatack merged commit 1fec65e into bitcoin:master Oct 23, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Proposed BIP modification PR by non-owner to update BIP content

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants