READ THE CODE

Inside Bitcoin

The code behind the network, with room to understand it.

Stable release v32.1bitcoin/bitcoin · f0de87f04062 ↗3,020 source files · 47.5 MB stored on the server440 file guides

Release published 2026-10-28 · Snapshot fetched 2026-11-01. Latest stable release at fetch time; development branches and Git history are excluded. Only the selected code window and visible folders load here.

50,373 bytes · SHA-256 41587e699f6c2cca… · View upstream ↗

10.20.0 Release Notes
2====================
3
4Bitcoin Core version 0.20.0 is now available from:
5
6  <https://bitcoincore.org/bin/bitcoin-core-0.20.0/>
7
8This release includes new features, various bug fixes and performance
9improvements, as well as updated translations.
10
11Please report bugs using the issue tracker at GitHub:
12
13  <https://github.com/bitcoin/bitcoin/issues>
14
15To receive security and update notifications, please subscribe to:
16
17  <https://bitcoincore.org/en/list/announcements/join/>
18
19How to Upgrade
20==============
21
22If you are running an older version, shut it down. Wait until it has completely
23shut down (which might take a few minutes in some cases), then run the
24installer (on Windows) or just copy over `/Applications/Bitcoin-Qt` (on Mac)
25or `bitcoind`/`bitcoin-qt` (on Linux).
26
27Upgrading directly from a version of Bitcoin Core that has reached its EOL is
28possible, but it might take some time if the data directory needs to be migrated. Old
29wallet versions of Bitcoin Core are generally supported.
30
31Compatibility
32==============
33
34Bitcoin Core is supported and extensively tested on operating systems
35using the Linux kernel, macOS 10.12+, and Windows 7 and newer.  Bitcoin
36Core should also work on most other Unix-like systems but is not as
37frequently tested on them.  It is not recommended to use Bitcoin Core on
38unsupported systems.
39
40From Bitcoin Core 0.20.0 onwards, macOS versions earlier than 10.12 are no
41longer supported. Additionally, Bitcoin Core does not yet change appearance
42when macOS "dark mode" is activated.
43
44Known Bugs
45==========
46
47The process for generating the source code release ("tarball") has changed in an
48effort to make it more complete, however, there are a few regressions in
49this release:
50
51- The generated `configure` script is currently missing, and you will need to
52  install autotools and run `./autogen.sh` before you can run
53  `./configure`. This is the same as when checking out from git.
54
55- Instead of running `make` simply, you should instead run
56  `BITCOIN_GENBUILD_NO_GIT=1 make`.
57
58Notable changes
59===============
60
61P2P and network changes
62-----------------------
63
64#### Removal of BIP61 reject network messages from Bitcoin Core
65
66The `-enablebip61` command line option to enable BIP61 has been removed.
67(#17004)
68
69This feature has been disabled by default since Bitcoin Core version 0.18.0.
70Nodes on the network can not generally be trusted to send valid messages
71(including reject messages), so this should only ever be used when
72connected to a trusted node.  Please use the alternatives recommended
73below if you rely on this removed feature:
74
75- Testing or debugging of implementations of the Bitcoin P2P network protocol
76  should be done by inspecting the log messages that are produced by a recent
77  version of Bitcoin Core. Bitcoin Core logs debug messages
78  (`-debug=<category>`) to a stream (`-printtoconsole`) or to a file
79  (`-debuglogfile=<debug.log>`).
80
81- Testing the validity of a block can be achieved by specific RPCs:
82
83  - `submitblock`
84
85  - `getblocktemplate` with `'mode'` set to `'proposal'` for blocks with
86    potentially invalid POW
87
88- Testing the validity of a transaction can be achieved by specific RPCs:
89
90  - `sendrawtransaction`
91
92  - `testmempoolaccept`
93
94- Wallets should not assume a transaction has propagated to the network
95  just because there are no reject messages.  Instead, listen for the
96  transaction to be announced by other peers on the network.  Wallets
97  should not assume a lack of reject messages means a transaction pays
98  an appropriate fee.  Instead, set fees using fee estimation and use
99  replace-by-fee to increase a transaction's fee if it hasn't confirmed
100  within the desired amount of time.
101
102The removal of BIP61 reject message support also has the following minor RPC
103and logging implications:
104
105- `testmempoolaccept` and `sendrawtransaction` no longer return the P2P reject
106  code when a transaction is not accepted to the mempool. They still return the
107  verbal reject reason.
108
109- Log messages that previously reported the reject code when a transaction was
110  not accepted to the mempool now no longer report the reject code. The reason
111  for rejection is still reported.
112
113Updated RPCs
114------------
115
116- The RPCs which accept descriptors now accept the new `sortedmulti(...)` descriptor
117  type which supports multisig scripts where the public keys are sorted
118  lexicographically in the resulting script.  (#17056)
119
120- The `walletprocesspsbt` and `walletcreatefundedpsbt` RPCs now include
121  BIP32 derivation paths by default for public keys if we know them.
122  This can be disabled by setting the `bip32derivs` parameter to
123  `false`.  (#17264)
124
125- The `bumpfee` RPC's parameter `totalFee`, which was deprecated in
126  0.19, has been removed.  (#18312)
127
128- The `bumpfee` RPC will return a PSBT when used with wallets that have
129  private keys disabled.  (#16373)
130
131- The `getpeerinfo` RPC now includes a `mapped_as` field to indicate the
132  mapped Autonomous System used for diversifying peer selection. See the
133  `-asmap` configuration option described below in _New Settings_.  (#16702)
134
135- The `createmultisig` and `addmultisigaddress` RPCs now return an
136  output script descriptor for the newly created address.  (#18032)
137
138Build System
139------------
140
141- OpenSSL is no longer used by Bitcoin Core.  (#17265)
142
143- BIP70 support has been fully removed from Bitcoin Core. The
144  `--enable-bip70` option remains, but it will throw an error during configure.
145  (#17165)
146
147- glibc 2.17 or greater is now required to run the release binaries. This
148  retains compatibility with RHEL 7, CentOS 7, Debian 8 and Ubuntu 14.04 LTS. (#17538)
149
150- The source code archives that are provided with gitian builds no longer contain
151  any autotools artifacts. Therefore, to build from such source, a user
152  should run the `./autogen.sh` script from the root of the unpacked archive.
153  This implies that `autotools` and other required packages are installed on the
154  user's system. (#18331)
155
156New settings
157------------
158
159- New `rpcwhitelist` and `rpcwhitelistdefault` configuration parameters
160  allow giving certain RPC users permissions to only some RPC calls.
161  (#12763)
162
163- A new `-asmap` configuration option has been added to diversify the
164  node's network connections by mapping IP addresses Autonomous System
165  Numbers (ASNs) and then limiting the number of connections made to any
166  single ASN.  See [issue #16599](https://github.com/bitcoin/bitcoin/issues/16599),
167  [PR #16702](https://github.com/bitcoin/bitcoin/pull/16702), and the
168  `bitcoind help` for more information.  This option is experimental and
169  subject to removal or breaking changes in future releases, so the
170  legacy /16 prefix mapping of IP addresses remains the default.  (#16702)
171
172Updated settings
173----------------
174
175- All custom settings configured when Bitcoin Core starts are now
176  written to the `debug.log` file to assist troubleshooting.  (#16115)
177
178- Importing blocks upon startup via the `bootstrap.dat` file no longer
179  occurs by default. The file must now be specified with
180  `-loadblock=<file>`.  (#17044)
181
182- The `-debug=db` logging category has been renamed to
183  `-debug=walletdb` to distinguish it from `coindb`.  The `-debug=db`
184  option has been deprecated and will be removed in the next major
185  release.  (#17410)
186
187- The `-walletnotify` configuration parameter will now replace any `%w`
188  in its argument with the name of the wallet generating the
189  notification.  This is not supported on Windows. (#13339)
190
191Removed settings
192----------------
193
194- The `-whitelistforcerelay` configuration parameter has been removed after
195  it was discovered that it was rendered ineffective in version 0.13 and
196  hasn't actually been supported for almost four years.  (#17985)
197
198GUI changes
199-----------
200
201- The "Start Bitcoin Core on system login" option has been removed on macOS.
202  (#17567)
203
204- In the Peers window, the details for a peer now displays a `Mapped AS`
205  field to indicate the mapped Autonomous System used for diversifying
206  peer selection. See the `-asmap` configuration option in _New
207  Settings_, above.  (#18402)
208
209- A "known bug" [announced](https://bitcoincore.org/en/releases/0.18.0/#wallet-gui)
210  in the release notes of version 0.18 has been fixed.  The issue
211  affected anyone who simultaneously used multiple Bitcoin Core wallets
212  and the GUI coin control feature. (#18894)
213
214- For watch-only wallets, creating a new transaction in the Send screen
215  or fee bumping an existing transaction in the Transactions screen will
216  automatically copy a Partially-Signed Bitcoin Transaction (PSBT) to
217  the system clipboard.  This can then be pasted into an external
218  program such as [HWI](https://github.com/bitcoin-core/HWI) for
219  signing.  Future versions of Bitcoin Core should support a GUI option
220  for finalizing and broadcasting PSBTs, but for now the debug console
221  may be used with the `finalizepsbt` and `sendrawtransaction` RPCs.
222  (#16944, #17492)
223
224Wallet
225------
226
227- The wallet now by default uses bech32 addresses when using RPC, and
228  creates native segwit change outputs.  (#16884)
229
230- The way that output trust was computed has been fixed, which affects
231  confirmed/unconfirmed balance status and coin selection.  (#16766)
232
233- The `gettransaction`, `listtransactions` and `listsinceblock` RPC
234  responses now also include the height of the block that contains the
235  wallet transaction, if any.  (#17437)
236
237- The `getaddressinfo` RPC has had its `label` field deprecated
238  (re-enable for this release using the configuration parameter
239  `-deprecatedrpc=label`).  The `labels` field is altered from returning
240  JSON objects to returning a JSON array of label names (re-enable
241  previous behavior for this release using the configuration parameter
242  `-deprecatedrpc=labelspurpose`).  Backwards compatibility using the
243  deprecated configuration parameters is expected to be dropped in the
244  0.21 release.  (#17585, #17578)
245
246Documentation changes
247---------------------
248
249- Bitcoin Core's automatically-generated source code documentation is
250  now available at https://doxygen.bitcoincore.org.  (#17596)

src/wallet/receive.cpp

src/wallet/coinselection.cpp

src/consensus/validation.h

src/primitives/transaction.cpp

src/script/descriptor.cpp

src/bitcoin-cli.cpp

src/rpc/blockchain.cpp

src/rpc/rawtransaction.cpp

src/init.cpp

src/crypto/sha256.cpp

src/consensus/merkle.h

src/consensus/tx_check.h

src/consensus/tx_verify.h

src/policy/feerate.h

src/policy/feerate.cpp

src/primitives/transaction_identifier.h

src/chainparamsbase.h

src/chainparamsbase.cpp

src/util/moneystr.cpp

src/crypto/ripemd160.h

src/crypto/sha1.h

src/crypto/sha512.h

src/crypto/hmac_sha256.h

src/crypto/hmac_sha512.h

src/crypto/hmac_sha256.cpp

src/crypto/hmac_sha512.cpp

src/crypto/hkdf_sha256_32.h

src/crypto/hkdf_sha256_32.cpp

src/support/cleanse.h

src/support/cleanse.cpp

src/crypto/siphash.cpp

src/crypto/muhash.h

src/crypto/chacha20.h

src/crypto/poly1305.h

src/crypto/chacha20poly1305.h

src/crypto/chacha20poly1305.cpp

src/util/chaintype.cpp

src/util/obfuscation.h

src/util/byte_units.h

src/util/overflow.h

src/blockencodings.cpp

src/net_permissions.cpp

src/policy/packages.cpp

src/policy/rbf.cpp

src/policy/truc_policy.cpp

src/policy/ephemeral_policy.cpp

src/policy/settings.cpp

src/policy/policy.cpp

src/node/transaction.cpp

src/node/coin.cpp

src/rpc/client.cpp

src/rpc/external_signer.cpp

src/rpc/request.cpp

src/rpc/server_util.cpp

src/rpc/fees.cpp

src/rpc/output_script.cpp

src/rpc/rawtransaction_util.cpp

src/rpc/rawtransaction_util.h

src/rpc/register.h

src/rpc/request.h

src/rpc/server_util.h

src/rpc/protocol.h

src/rpc/server.h

src/rpc/signmessage.cpp

src/rpc/txoutproof.cpp

src/rpc/util.cpp

src/rpc/util.h

src/wallet/rpc/addresses.cpp

src/wallet/rpc/backup.cpp

src/wallet/rpc/coins.cpp

src/wallet/rpc/encrypt.cpp

src/wallet/rpc/signmessage.cpp

src/wallet/rpc/util.cpp

src/wallet/rpc/util.h

src/wallet/coincontrol.cpp

src/wallet/coincontrol.h

src/wallet/context.cpp

src/wallet/context.h

src/wallet/crypter.cpp

src/wallet/crypter.h

src/wallet/db.cpp

src/wallet/export.cpp

src/wallet/external_signer_scriptpubkeyman.cpp

src/wallet/rpc/spend.cpp

src/wallet/rpc/transactions.cpp

src/wallet/rpc/wallet.cpp

src/wallet/feebumper.cpp

src/wallet/feebumper.h

src/index/base.h

src/index/base.cpp

src/index/txindex.h

src/index/txindex.cpp

src/index/txindex_key.h

src/index/txospenderindex.h

src/index/txospenderindex.cpp

src/index/blockfilterindex.h

src/index/blockfilterindex.cpp

src/index/coinstatsindex.h

src/index/coinstatsindex.cpp

src/index/db_key.h

src/index/disktxpos.h

src/kernel/chain.cpp

src/kernel/chain.h

src/kernel/checks.cpp

src/kernel/checks.h

src/kernel/context.cpp

src/kernel/context.h

src/kernel/cs_main.cpp

src/kernel/cs_main.h

src/kernel/disconnected_transactions.cpp

src/kernel/disconnected_transactions.h

src/kernel/mempool_removal_reason.cpp

src/kernel/mempool_removal_reason.h

src/kernel/coinstats.cpp

src/kernel/coinstats.h

src/kernel/chainparams.cpp

src/kernel/chainparams.h

src/wallet/sqlite.cpp

src/wallet/sqlite.h

src/wallet/transaction.cpp

src/wallet/transaction.h

src/wallet/dump.cpp

src/wallet/dump.h

src/wallet/init.cpp

src/wallet/walletutil.cpp

src/wallet/walletutil.h

src/wallet/wallettool.cpp

src/wallet/wallettool.h

src/wallet/export.h

src/wallet/migrate.cpp

src/wallet/migrate.h

src/wallet/db.h

src/wallet/walletdb.cpp

src/wallet/interfaces.cpp

src/wallet/scriptpubkeyman.cpp

src/wallet/scriptpubkeyman.h

src/kernel/bitcoinkernel.cpp

src/kernel/bitcoinkernel.h

src/kernel/bitcoinkernel_wrapper.h

src/node/chainstate.cpp

src/node/chainstate.h

src/node/blockstorage.cpp

src/node/blockstorage.h

src/node/mempool_persist.cpp

src/node/mempool_persist.h

src/node/utxo_snapshot.cpp

src/node/utxo_snapshot.h

src/node/kernel_notifications.cpp

src/node/kernel_notifications.h

src/node/blockmanager_args.cpp

src/kernel/blockmanager_opts.h

src/util/expected.cpp

src/policy/settings.h

src/util/types.h

src/kernel/messagestartchars.h

src/kernel/warning.h

src/util/exception.h

src/common/license_info.h

src/node/coins_view_args.h

src/node/database_args.h

src/util/batchpriority.h

src/util/ui_change_type.h

src/node/coins_view_args.cpp

src/node/peerman_args.h

src/util/serfloat.h

src/node/blockmanager_args.h

src/node/database_args.cpp

src/util/overloaded.h

src/interfaces/types.h

src/node/chainstatemanager_args.h

src/node/minisketchwrapper.h

src/util/macros.h

src/util/syserror.h

src/common/run_command.h

src/util/bytevectorhash.cpp

src/node/mempool_persist_args.cpp

src/util/exec.h

src/util/rbf.h

src/crypto/hex_base.h

src/node/mempool_persist_args.h

src/interfaces/echo.h

src/util/any.h

src/util/batchpriority.cpp

src/util/threadnames.h

src/node/coin.h

src/node/mempool_args.h

src/util/asmap.h

src/util/bytevectorhash.h

src/node/context.cpp

src/util/insert.h

src/util/readwritefile.h

src/node/peerman_args.cpp

src/node/interface_ui.cpp

src/interfaces/handler.h

src/node/mining_args.h

src/util/hasher.cpp

src/common/init.h

src/kernel/mempool_limits.h

src/common/system.h

src/crypto/sha3.h

src/util/threadinterrupt.cpp

src/node/protocol_version.h

src/util/exception.cpp

src/common/messages.h

src/node/connection_types.cpp

src/util/bip32.h

src/common/license_info.cpp

src/util/stdmutex.h

src/common/run_command.cpp

src/util/check.cpp

src/util/golombrice.h

src/node/types.h

src/node/timeoffsets.h

src/util/readwritefile.cpp

src/util/fastrange.h

src/util/signalinterrupt.h

src/util/task_runner.h

src/util/syserror.cpp

src/common/interfaces.cpp

src/common/types.h

src/util/threadinterrupt.h

src/kernel/chainstatemanager_opts.h

src/node/psbt.h

src/policy/ephemeral_policy.h

src/util/trace.h

src/common/url.cpp

src/kernel/mempool_options.h

src/util/serfloat.cpp

src/kernel/notifications_interface.h

src/node/timeoffsets.cpp

src/node/warnings.cpp

src/util/hash_type.h

src/crypto/hex_base.cpp

src/node/eviction.h

src/util/tokenbucket.h

src/crypto/aes.h

src/common/pcp.h

src/util/feefrac.cpp

src/node/transaction.h

src/util/threadnames.cpp

src/common/signmessage.h

src/util/exec.cpp

src/util/signalinterrupt.cpp

src/clientversion.cpp

src/common/signmessage.cpp

src/compat/assumptions.h

src/compat/byteswap.h

src/deploymentinfo.cpp

src/deploymentinfo.h

src/deploymentstatus.cpp

src/deploymentstatus.h

src/dummywallet.cpp

src/external_signer.h

src/init/bitcoin-gui.cpp

src/init/bitcoin-node.cpp

src/init/bitcoin-qt.cpp

src/init/bitcoin-wallet.cpp

src/init/bitcoind.cpp

src/init/common.h

src/interfaces/init.h

src/interfaces/ipc.h

src/key_io.h

src/logging/categories.h

src/logging/timer.h

src/mapport.h

src/musig.h

src/net_permissions.h

src/netgroup.h

src/netmessagemaker.h

src/node/chainstatemanager_args.cpp

src/node/connection_types.h

src/node/context.h

src/node/interface_ui.h

src/node/mempool_args.cpp

src/node/mining_args.cpp

src/node/minisketchwrapper.cpp

src/node/txreconciliation.h

src/policy/fees/estimator_args.cpp

src/policy/fees/estimator_args.h

src/policy/fees/estimator_man.cpp

src/policy/fees/estimator_man.h

src/policy/packages.h

src/policy/rbf.h

src/policy/truc_policy.h

src/pow.h

src/primitives/block.cpp

src/randomenv.h

src/rest.h

src/script/keyorigin.h

src/script/parsing.cpp

src/script/parsing.h

src/script/script_error.h

src/script/sigcache.cpp

src/script/sigcache.h

src/script/solver.h

src/script/verify_flags.h

src/semaphore_grant.h

src/signet.h

src/span.h

src/support/allocators/secure.h

src/support/allocators/zeroafterfree.h

src/util/tokenpipe.cpp

src/util/translation.h

src/util/vector.h

src/versionbits.h

src/versionbits_impl.h

src/wallet/external_signer_scriptpubkeyman.h

src/wallet/fees.h

src/wallet/load.h

src/wallet/receive.h

src/wallet/rpc/wallet.h

src/wallet/types.h

src/walletinitinterface.h

src/zmq/zmqabstractnotifier.cpp

Independent explanations by MyBitcoinExplorer. Not affiliated with or endorsed by Bitcoin Core. Guides are educational and do not replace the source or its tests.

Bitcoin Core source © its contributors, distributed under the MIT license. Original notices and bundled third-party licenses are retained in the source tree.