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.

56,136 bytes · SHA-256 6367a8ff8c6ab6f8… · View upstream ↗

1Bitcoin Core version 0.19.0.1 is now available from:
2
3  <https://bitcoincore.org/bin/bitcoin-core-0.19.0.1/>
4
5This release includes new features, various bug fixes and performance
6improvements, as well as updated translations.
7
8Please report bugs using the issue tracker at GitHub:
9
10  <https://github.com/bitcoin/bitcoin/issues>
11
12To receive security and update notifications, please subscribe to:
13
14  <https://bitcoincore.org/en/list/announcements/join/>
15
16How to Upgrade
17==============
18
19If you are running an older version, shut it down. Wait until it has completely
20shut down (which might take a few minutes for older versions), then run the
21installer (on Windows) or just copy over `/Applications/Bitcoin-Qt` (on Mac)
22or `bitcoind`/`bitcoin-qt` (on Linux).
23
24Upgrading directly from a version of Bitcoin Core that has reached its EOL is
25possible, but might take some time if the datadir needs to be migrated.  Old
26wallet versions of Bitcoin Core are generally supported.
27
28Compatibility
29==============
30
31Bitcoin Core is supported and extensively tested on operating systems using
32the Linux kernel, macOS 10.10+, and Windows 7 and newer. It is not recommended
33to use Bitcoin Core on unsupported systems.
34
35Bitcoin Core should also work on most other Unix-like systems but is not
36as frequently tested on them.
37
38From 0.17.0 onwards, macOS <10.10 is no longer supported. 0.17.0 is
39built using Qt 5.9.x, which doesn't support versions of macOS older than
4010.10. Additionally, Bitcoin Core does not yet change appearance when
41macOS "dark mode" is activated.
42
43Users running macOS Catalina may need to "right-click" and then choose "Open"
44to open the Bitcoin Core .dmg. This is due to new signing requirements
45imposed by Apple, which the Bitcoin Core project does not yet adhere too.
46
47Notable changes
48===============
49
50New user documentation
51----------------------
52
53- [Reduce memory](https://github.com/bitcoin/bitcoin/blob/master/doc/reduce-memory.md)
54  suggests configuration tweaks for running Bitcoin Core on systems with
55  limited memory. (#16339)
56
57New RPCs
58--------
59
60- `getbalances` returns an object with all balances (`mine`,
61  `untrusted_pending` and `immature`). Please refer to the RPC help of
62  `getbalances` for details. The new RPC is intended to replace
63  `getbalance`, `getunconfirmedbalance`, and the balance fields in
64  `getwalletinfo`.  These old calls and fields may be removed in a
65  future version. (#15930, #16239)
66
67- `setwalletflag` sets and unsets wallet flags that enable or disable
68  features specific to that existing wallet, such as the new
69  `avoid_reuse` feature documented elsewhere in these release notes.
70  (#13756)
71
72- `getblockfilter` gets the BIP158 filter for the specified block.  This
73  RPC is only enabled if block filters have been created using the
74  `-blockfilterindex` configuration option. (#14121)
75
76New settings
77------------
78
79- `-blockfilterindex` enables the creation of BIP158 block filters for
80  the entire blockchain.  Filters will be created in the background and
81  currently use about 4 GiB of space.  Note: this version of Bitcoin
82  Core does not serve block filters over the P2P network, although the
83  local user may obtain block filters using the `getblockfilter` RPC.
84  (#14121)
85
86Updated settings
87----------------
88
89- `whitebind` and `whitelist` now accept a list of permissions to
90  provide peers connecting using the indicated interfaces or IP
91  addresses.  If no permissions are specified with an address or CIDR
92  network, the implicit default permissions are the same as previous
93  releases.  See the `bitcoind -help` output for these two options for
94  details about the available permissions. (#16248)
95
96- Users setting custom `dbcache` values can increase their setting slightly
97  without using any more real memory.  Recent changes reduced the memory use
98  by about 9% and made chainstate accounting more accurate (it was underestimating
99  the use of memory before).  For example, if you set a value of "450" before, you
100  may now set a value of "500" to use about the same real amount of memory. (#16957)
101
102
103Updated RPCs
104------------
105
106Note: some low-level RPC changes mainly useful for testing are described in the
107Low-level Changes section below.
108
109- `sendmany` no longer has a `minconf` argument.  This argument was not
110  well-specified and would lead to RPC errors even when the wallet's
111  coin selection succeeded.  Users who want to influence coin selection
112  can use the existing `-spendzeroconfchange`, `-limitancestorcount`,
113  `-limitdescendantcount` and `-walletrejectlongchains` configuration
114  arguments. (#15596)
115
116- `getbalance` and `sendtoaddress`, plus the new RPCs `getbalances` and
117  `createwallet`, now accept an "avoid_reuse" parameter that controls
118  whether already used addresses should be included in the operation.
119  Additionally, `sendtoaddress` will avoid partial spends when
120  `avoid_reuse` is enabled even if this feature is not already enabled
121  via the `-avoidpartialspends` command line flag because not doing so
122  would risk using up the "wrong" UTXO for an address reuse case.
123  (#13756)
124
125- RPCs which have an `include_watchonly` argument or `includeWatching` option now default to `true` for watch-only
126  wallets. Affected RPCs are: `getbalance`, `listreceivedbyaddress`, `listreceivedbylabel`, `listtransactions`,
127  `listsinceblock`, `gettransaction`, `walletcreatefundedpsbt`, and `fundrawtransaction`. (#16383)
128
129- `listunspent` now returns a "reused" bool for each output if the
130  wallet flag "avoid_reuse" is enabled. (#13756)
131
132- `getblockstats` now uses BlockUndo data instead of the transaction
133  index, making it much faster, no longer dependent on the `-txindex`
134  configuration option, and functional for all non-pruned blocks.
135  (#14802)
136
137- `utxoupdatepsbt` now accepts a `descriptors` parameter that will fill
138  out input and output scripts and keys when known. P2SH-witness inputs
139  will be filled in from the UTXO set when a descriptor is provided that
140  shows they're spending segwit outputs.  See the RPC help text for full
141  details. (#15427)
142
143- `sendrawtransaction` and `testmempoolaccept` no longer accept a
144  `allowhighfees` parameter to fail mempool acceptance if the
145  transaction fee exceeds the value of the configuration option
146  `-maxtxfee`.  Now there is a hardcoded default maximum feerate that
147  can be changed when calling either RPC using a `maxfeerate` parameter.
148  (#15620)
149
150- `getmempoolancestors`, `getmempooldescendants`, `getmempoolentry`, and
151  `getrawmempool` no longer return a `size` field unless the
152  configuration option `-deprecatedrpc=size` is used.  Instead a new
153  `vsize` field is returned with the transaction's virtual size
154  (consistent with other RPCs such as `getrawtransaction`). (#15637)
155
156- `getwalletinfo` now includes a `scanning` field that is either `false`
157  (no scanning) or an object with information about the duration and
158  progress of the wallet's scanning historical blocks for transactions
159  affecting its balances. (#15730)
160
161- `gettransaction` now accepts a third (boolean) argument `verbose`. If
162  set to `true`, a new `decoded` field will be added to the response containing
163  the decoded transaction. This field is equivalent to RPC `decoderawtransaction`,
164  or RPC `getrawtransaction` when `verbose` is passed. (#16185, #16866, #16873)
165
166- `createwallet` accepts a new `passphrase` parameter.  If set, this
167  will create the new wallet encrypted with the given passphrase.  If
168  unset (the default) or set to an empty string, no encryption will be
169  used. (#16394)
170
171- `getchaintxstats` RPC now returns the additional key of
172  `window_final_block_height`. (#16695)
173
174- `getmempoolentry` now provides a `weight` field containing the
175  transaction weight as defined in BIP141. (#16647)
176
177- The `getnetworkinfo` and `getpeerinfo` commands now contain a new field with decoded network service flags. (#16786)
178
179- `getdescriptorinfo` now returns an additional `checksum` field
180  containing the checksum for the unmodified descriptor provided by the
181  user (that is, before the descriptor is normalized for the
182  `descriptor` field). (#15986)
183
184- `joinpsbts` now shuffles the order of the inputs and outputs of the resulting
185  joined PSBT. Previously, inputs and outputs were added in the order PSBTs were
186  provided. This made it easy to correlate inputs to outputs, representing a
187  privacy leak. (#16512)
188
189- `walletcreatefundedpsbt` now signals BIP125 Replace-by-Fee if the
190  `-walletrbf` configuration option is set to true. (#15911)
191
192GUI changes
193-----------
194
195- The GUI wallet now provides bech32 addresses by default.  The user may change the address type
196  during invoice generation using a GUI toggle, or the default address
197  type may be changed with the `-addresstype` configuration option.
198  (#15711, #16497)
199
200- In 0.18.0, a `./configure` flag was introduced to allow disabling BIP70 support in the GUI (support was enabled by default). In 0.19.0, this flag is now __disabled__ by default. If you want to compile Bitcoin Core with BIP70 support in the GUI, you can pass `--enable-bip70` to `./configure`. (#15584)
201
202Deprecated or removed configuration options
203-------------------------------------------
204
205- `-mempoolreplacement` is removed, although default node behavior
206  remains the same.  This option previously allowed the user to prevent
207  the node from accepting or relaying BIP125 transaction replacements.
208  This is different from the remaining configuration option
209  `-walletrbf`. (#16171)
210
211Deprecated or removed RPCs
212--------------------------
213
214- `bumpfee` no longer accepts a `totalFee` option unless the
215  configuration parameter `deprecatedrpc=totalFee` is specified.  This
216  parameter will be fully removed in a subsequent release. (#15996)
217
218- `bumpfee` has a new `fee_rate` option as a replacement for the deprecated `totalFee`. (#16727)
219
220- `generate` is now removed after being deprecated in Bitcoin Core 0.18.
221  Use the `generatetoaddress` RPC instead. (#15492)
222
223P2P changes
224-----------
225
226- BIP 61 reject messages were deprecated in v0.18. They are now disabled
227  by default, but can be enabled by setting the `-enablebip61` command
228  line option.  BIP 61 reject messages will be removed entirely in a
229  future version of Bitcoin Core. (#14054)
230
231- To eliminate well-known denial-of-service vectors in Bitcoin Core,
232  especially for nodes with spinning disks, the default value for the
233  `-peerbloomfilters` configuration option has been changed to false.
234  This prevents Bitcoin Core from sending the BIP111 NODE_BLOOM service
235  flag, accepting BIP37 bloom filters, or serving merkle blocks or
236  transactions matching a bloom filter.  Users who still want to provide
237  bloom filter support may either set the configuration option to true
238  to re-enable both BIP111 and BIP37 support or enable just BIP37
239  support for specific peers using the updated `-whitelist` and
240  `-whitebind` configuration options described elsewhere in these
241  release notes.  For the near future, lightweight clients using public
242  BIP111/BIP37 nodes should still be able to connect to older versions
243  of Bitcoin Core and nodes that have manually enabled BIP37 support,
244  but developers of such software should consider migrating to either
245  using specific BIP37 nodes or an alternative transaction filtering
246  system. (#16152)
247
248- By default, Bitcoin Core will now make two additional outbound connections that are exclusively used for block-relay.  No transactions or addr messages will be processed on these connections. These connections are designed to add little additional memory or bandwidth resource requirements but should make some partitioning attacks more difficult to carry out. (#15759)
249
250Miscellaneous CLI Changes

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.