Skip to content

Commit 99a3e6f

Browse files
committed
Merge #14688: Doc: update release notes for changes since 0.17.0 branch
ba8f0c6 Release notes: integrate detached release notes (David A. Harding) 6062f0e Release notes: update notes through to 11e1ac3 (David A. Harding) Pull request description: This documents changes listed by `git log v0.17.0...11e1ac3 --merges` and integrates the existing detached release notes into the main file. My goal is to update the release notes each month in order to reduce the amount of writing and review that needs to be done all at once near the start of the RC cycle. Note: I've chosen to use fully-qualified URLs for linking to documentation, rather than shorter relative URLs that would otherwise be preferred, as the release notes are commonly copied into emails, reddit threads, and blog posts where relative URLs would be incomplete or would point to the wrong page. Tree-SHA512: a943327d48e166f4a188ab0f468972609276e9c8f0ed85513823511ed989606445bf6b0ae9dd693b5d1e13d2f98c13573acd13865c57fe9c8ee9dbd04ceeff7f
2 parents 74213fa + ba8f0c6 commit 99a3e6f

7 files changed

+137
-51
lines changed

doc/release-notes-13152.md

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

doc/release-notes-14023.md

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

doc/release-notes-14282.md

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

doc/release-notes-14296.md

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

doc/release-notes-14454.md

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

doc/release-notes-14468.md

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

doc/release-notes.md

Lines changed: 137 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -53,8 +53,14 @@ the Linux kernel, macOS 10.10+, and Windows 7 and newer (Windows XP is not suppo
5353
Bitcoin Core should also work on most other Unix-like systems but is not
5454
frequently tested on them.
5555

56-
From 0.17.0 onwards macOS <10.10 is no longer supported. 0.17.0 is built using Qt 5.9.x, which doesn't
57-
support versions of macOS older than 10.10.
56+
From 0.17.0 onwards, macOS <10.10 is no longer supported. 0.17.0 is
57+
built using Qt 5.9.x, which doesn't support versions of macOS older than
58+
10.10. Additionally, Bitcoin Core does not yet change appearance when
59+
macOS "dark mode" is activated.
60+
61+
In addition to previously-supported CPU platforms, this release's
62+
pre-compiled distribution also provides binaries for the RISC-V
63+
platform.
5864

5965
Notable changes
6066
===============
@@ -69,9 +75,137 @@ nodes. The option will now by default be off for improved privacy and security
6975
as well as reduced upload usage. The option can explicitly be turned on for
7076
local-network debugging purposes.
7177

72-
Example item
78+
Documentation
79+
-------------
80+
81+
- A new short
82+
[document](https://github.com/bitcoin/bitcoin/blob/master/doc/JSON-RPC-interface.md)
83+
about the JSON-RPC interface describes cases where the results of an
84+
RPC might contain inconsistencies between data sourced from different
85+
subsystems, such as wallet state and mempool state. A note is added
86+
to the [REST interface documentation](https://github.com/bitcoin/bitcoin/blob/master/doc/REST-interface.md)
87+
indicating that the same rules apply.
88+
89+
- A new [document](https://github.com/bitcoin/bitcoin/blob/master/doc/bitcoin-conf.md)
90+
about the `bitcoin.conf` file describes how to use it to configure
91+
Bitcoin Core.
92+
93+
- A new document introduces Bitcoin Core's BIP174
94+
[Partially-Signed Bitcoin Transactions (PSBT)](https://github.com/bitcoin/bitcoin/blob/master/doc/psbt.md)
95+
interface, which is used to allow multiple programs to collaboratively
96+
work to create, sign, and broadcast new transactions. This is useful
97+
for offline (cold storage) wallets, multisig wallets, coinjoin
98+
implementations, and many other cases where two or more programs need
99+
to interact to generate a complete transaction.
100+
101+
- The [output script descriptor](https://github.com/bitcoin/bitcoin/blob/master/doc/descriptors.md)
102+
documentation has been updated with information about new features in
103+
this still-developing language for describing the output scripts that
104+
a wallet or other program wants to receive notifications for, such as
105+
which addresses it wants to know received payments. The language is
106+
currently used in the `scantxoutset` RPC and is expected to be adapted
107+
to other RPCs and to the underlying wallet structure.
108+
109+
Build system changes
110+
--------------------
111+
112+
- A new `--disable-bip70` option may be passed to `./configure` to
113+
prevent Bitcoin-Qt from being built with support for the BIP70 payment
114+
protocol or from linking libssl. As the payment protocol has exposed
115+
Bitcoin Core to libssl vulnerabilities in the past, builders who don't
116+
need BIP70 support are encouraged to use this option to reduce their
117+
exposure to future vulnerabilities.
118+
119+
Deprecated or removed RPCs
120+
--------------------------
121+
122+
- The `signrawtransaction` RPC is removed after being deprecated and
123+
hidden behind a special configuration option in version 0.17.0.
124+
125+
- The 'account' API is removed after being deprecated in v0.17. The
126+
'label' API was introduced in v0.17 as a replacement for accounts.
127+
See the [release notes from v0.17](https://github.com/bitcoin/bitcoin/blob/master/doc/release-notes/release-notes-0.17.0.md#label-and-account-apis-for-wallet)
128+
for a full description of the changes from the 'account' API to the
129+
'label' API.
130+
131+
- The `addwitnessaddress` RPC is removed after being deprecated in
132+
version 0.13.0.
133+
134+
- The wallet's `generate` RPC method is deprecated and will be fully
135+
removed in a subsequent major version. This RPC is only used for
136+
testing, but its implementation reached across multiple subsystems
137+
(wallet and mining), so it is being deprecated to simplify the
138+
wallet-node interface. Projects that are using `generate` for testing
139+
purposes should transition to using the `generatetoaddress` RPC, which
140+
does not require or use the wallet component. Calling
141+
`generatetoaddress` with an address returned by the `getnewaddress`
142+
RPC gives the same functionality as the old `generate` RPC. To
143+
continue using `generate` in this version, restart bitcoind with the
144+
`-deprecatedrpc=generate` configuration option.
145+
146+
New RPCs
147+
--------
148+
149+
- A new `getnodeaddresses` RPC returns peer addresses known to this
150+
node. It may be used to find nodes to connect to without using a DNS
151+
seeder.
152+
153+
- A new `listwalletdir` RPC returns a list of wallets in the wallet
154+
directory (either the default wallet directory or the directory
155+
configured by the `-walletdir` parameter).
156+
157+
Updated RPCs
73158
------------
74159

160+
Note: some low-level RPC changes mainly useful for testing are described
161+
in the Low-level Changes section below.
162+
163+
- The `getpeerinfo` RPC now returns an additional "minfeefilter" field
164+
set to the peer's BIP133 fee filter. You can use this to detect that
165+
you have peers that are willing to accept transactions below the
166+
default minimum relay fee.
167+
168+
- The mempool RPCs, such as `getrawmempool` with `verbose=true`, now
169+
return an additional "bip125-replaceable" value indicating whether the
170+
transaction (or its unconfirmed ancestors) opts-in to asking nodes and
171+
miners to replace it with a higher-feerate transaction spending any of
172+
the same inputs.
173+
174+
- The `settxfee` RPC previously silently ignored attempts to set the fee
175+
below the allowed minimums. It now prints a warning. The special
176+
value of "0" may still be used to request the minimum value.
177+
178+
- The `getaddressinfo` RPC now provides an `ischange` field indicating
179+
whether the wallet used the address in a change output.
180+
181+
- The `importmulti` RPC has been updated to support P2WSH, P2WPKH,
182+
P2SH-P2WPKH, and P2SH-P2WSH. Requests for P2WSH and P2SH-P2WSH accept
183+
an additional `witnessscript` parameter.
184+
185+
Low-level changes
186+
=================
187+
188+
RPC
189+
---
190+
191+
- The `submitblock` RPC previously returned the reason a rejected block
192+
was invalid the first time it processed that block but returned a
193+
generic "duplicate" rejection message on subsequent occasions it
194+
processed the same block. It now always returns the fundamental
195+
reason for rejecting an invalid block and only returns "duplicate" for
196+
valid blocks it has already accepted.
197+
198+
- A new `submitheader` RPC allows submitting block headers independently
199+
from their block. This is likely only useful for testing.
200+
201+
Configuration
202+
-------------
203+
204+
- The `-usehd` configuration option was removed in version 0.16. From
205+
that version onwards, all new wallets created are hierarchical
206+
deterministic wallets. This release makes specifying `-usehd` an
207+
invalid configuration option.
208+
75209
Credits
76210
=======
77211

0 commit comments

Comments
 (0)