Skip to content

Commit d97d0d3

Browse files
committed
doc: Merge release notes fragment, merge taproot description from wiki
Co-authored-by: David A. Harding <dave@dtrt.org> Co-authored-by: Jon Atack <jon@atack.com> Co-authored-by: Pieter Wuille <pieter@wuille.net> Tree-SHA512: dd9ac416ff22276833111198445d76cf8417012a6faad0c3560276f1dcf24586ff41c65ac3430fbf1e840aaa563d3dd101671cff306b0fd92aa2ee03bb7f926b
1 parent 5577e0a commit d97d0d3

File tree

2 files changed

+92
-16
lines changed

2 files changed

+92
-16
lines changed

doc/release-notes-20861.md

Lines changed: 0 additions & 13 deletions
This file was deleted.

doc/release-notes.md

Lines changed: 92 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -44,9 +44,98 @@ when macOS "dark mode" is activated.
4444
Notable changes
4545
===============
4646

47-
RPC
48-
---
49-
47+
## Taproot Soft Fork
48+
49+
Included in this release are the mainnet and testnet activation
50+
parameters for the taproot soft fork (BIP341) which also adds support
51+
for schnorr signatures (BIP340) and tapscript (BIP342).
52+
53+
If activated, these improvements will allow users of single-signature
54+
scripts, multisignature scripts, and complex contracts to all use
55+
identical-appearing commitments that enhance their privacy and the
56+
fungibility of all bitcoins. Spenders will enjoy lower fees and the
57+
ability to resolve many multisig scripts and complex contracts with the
58+
same efficiency, low fees, and large anonymity set as single-sig users.
59+
Taproot and schnorr also include efficiency improvements for full nodes
60+
such as the ability to batch signature verification. Together, the
61+
improvements lay the groundwork for future potential
62+
upgrades that may improve efficiency, privacy, and fungibility further.
63+
64+
Activation for taproot is being managed using a variation of BIP9
65+
versionbits called Speedy Trial (described in BIP341). Taproot's
66+
versionbit is bit 2, and nodes will begin tracking which blocks signal
67+
support for taproot at the beginning of the first retarget period after
68+
taproot’s start date of 24 April 2021. If 90% of blocks within a
69+
2,016-block retarget period (about two weeks) signal support for taproot
70+
prior to the first retarget period beginning after the time of 11 August
71+
2021, the soft fork will be locked in, and taproot will then be active
72+
as of block 709632 (expected in early or mid November).
73+
74+
Should taproot not be locked in via Speedy Trial activation, it is
75+
expected that a follow-up activation mechanism will be deployed, with
76+
changes to address the reasons the Speedy Trial method failed.
77+
78+
This release includes the ability to pay taproot addresses, although
79+
payments to such addresses are not secure until taproot activates.
80+
It also includes the ability to relay and mine taproot transactions
81+
after activation. Beyond those two basic capabilities, this release
82+
does not include any code that allows anyone to directly use taproot.
83+
The addition of taproot-related features to Bitcoin Core's wallet is
84+
expected in later releases once taproot activation is assured.
85+
86+
All users, businesses, and miners are encouraged to upgrade to this
87+
release (or a subsequent compatible release) unless they object to
88+
activation of taproot. If taproot is locked in, then upgrading before
89+
block 709632 is highly recommended to help enforce taproot's new rules
90+
and to avoid the unlikely case of seeing falsely confirmed transactions.
91+
92+
Miners who want to activate Taproot should preferably use this release
93+
to control their signaling. The `getblocktemplate` RPC results will
94+
automatically be updated to signal once the appropriate start has been
95+
reached and continue signaling until the timeout occurs or taproot
96+
activates. Alternatively, miners may manually start signaling on bit 2
97+
at any time; if taproot activates, they will need to ensure they update
98+
their nodes before block 709632 or non-upgraded nodes could cause them to mine on
99+
an invalid chain. See the [versionbits
100+
FAQ](https://bitcoincore.org/en/2016/06/08/version-bits-miners-faq/) for
101+
details.
102+
103+
104+
For more information about taproot, please see the following resources:
105+
106+
- Technical specifications
107+
- [BIP340 Schnorr signatures for secp256k1](https://github.com/bitcoin/bips/blob/master/bip-0340.mediawiki)
108+
- [BIP341 Taproot: SegWit version 1 spending rules](https://github.com/bitcoin/bips/blob/master/bip-0341.mediawiki)
109+
- [BIP342 Validation of Taproot scripts](https://github.com/bitcoin/bips/blob/master/bip-0342.mediawiki)
110+
111+
- Popular articles;
112+
- [Taproot Is Coming: What It Is, and How It Will Benefit Bitcoin](https://bitcoinmagazine.com/technical/taproot-coming-what-it-and-how-it-will-benefit-bitcoin)
113+
- [What do Schnorr Signatures Mean for Bitcoin?](https://academy.binance.com/en/articles/what-do-schnorr-signatures-mean-for-bitcoin)
114+
- [The Schnorr Signature & Taproot Softfork Proposal](https://blog.bitmex.com/the-schnorr-signature-taproot-softfork-proposal/)
115+
116+
- Development history overview
117+
- [Taproot](https://bitcoinops.org/en/topics/taproot/)
118+
- [Schnorr signatures](https://bitcoinops.org/en/topics/schnorr-signatures/)
119+
- [Tapscript](https://bitcoinops.org/en/topics/tapscript/)
120+
- [Soft fork activation](https://bitcoinops.org/en/topics/soft-fork-activation/)
121+
122+
- Other
123+
- [Questions and answers related to taproot](https://bitcoin.stackexchange.com/questions/tagged/taproot)
124+
- [Taproot review](https://github.com/ajtowns/taproot-review)
125+
126+
Updated RPCs
127+
------------
128+
129+
- Due to [BIP 350](https://github.com/bitcoin/bips/blob/master/bip-0350.mediawiki)
130+
being implemented, behavior for all RPCs that accept addresses is changed when
131+
a native witness version 1 (or higher) is passed. These now require a Bech32m
132+
encoding instead of a Bech32 one, and Bech32m encoding will be used for such
133+
addresses in RPC output as well. No version 1 addresses should be created
134+
for mainnet until consensus rules are adopted that give them meaning
135+
(e.g. through [BIP 341](https://github.com/bitcoin/bips/blob/master/bip-0341.mediawiki)).
136+
Once that happens, Bech32m is expected to be used for them, so this shouldn't
137+
affect any production systems, but may be observed on other networks where such
138+
addresses already have meaning (like signet).
50139

51140
0.21.1 change log
52141
=================

0 commit comments

Comments
 (0)