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 server340 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.

7,386 bytes · SHA-256 842a703cf4886a54… · View upstream ↗

1Bitcoin Core version 0.17.1 is now available from:
2
3  <https://bitcoincore.org/bin/bitcoin-core-0.17.1/>
4
5or through BitTorrent:
6
7    magnet:?xt=urn:btih:c56c87ccfaa8e6fbccc90d549121e61efd97cb6f&dn=bitcoin-core-0.17.1&tr=udp%3A%2F%2Ftracker.openbittorrent.com%3A80&tr=udp%3A%2F%2Ftracker.opentrackr.org%3A1337&tr=udp%3A%2F%2Ftracker.coppersurfer.tk%3A6969&tr=udp%3A%2F%2Ftracker.leechers-paradise.org%3A6969&tr=udp%3A%2F%2Fzer0day.ch%3A1337&tr=udp%3A%2F%2Fexplodie.org%3A6969    
8
9This is a new minor version release, with various bugfixes
10and performance improvements, as well as updated translations.
11
12Please report bugs using the issue tracker at GitHub:
13
14  <https://github.com/bitcoin/bitcoin/issues>
15
16To receive security and update notifications, please subscribe to:
17
18  <https://bitcoincore.org/en/list/announcements/join/>
19
20How to Upgrade
21==============
22
23If you are running an older version, shut it down. Wait until it has completely
24shut down (which might take a few minutes for older versions), then run the
25installer (on Windows) or just copy over `/Applications/Bitcoin-Qt` (on Mac)
26or `bitcoind`/`bitcoin-qt` (on Linux).
27
28If your node has a txindex, the txindex db will be migrated the first time you run 0.17.0 or newer, which may take up to a few hours. Your node will not be functional until this migration completes.
29
30The first time you run version 0.15.0 or newer, your chainstate database will be converted to a
31new format, which will take anywhere from a few minutes to half an hour,
32depending on the speed of your machine.
33
34Note that the block database format also changed in version 0.8.0 and there is no
35automatic upgrade code from before version 0.8 to version 0.15.0. Upgrading
36directly from 0.7.x and earlier without redownloading the blockchain is not supported.
37However, as usual, old wallet versions are still supported.
38
39Downgrading warning
40-------------------
41
42The chainstate database for this release is not compatible with previous
43releases, so if you run 0.15 and then decide to switch back to any
44older version, you will need to run the old release with the `-reindex-chainstate`
45option to rebuild the chainstate data structures in the old format.
46
47If your node has pruning enabled, this will entail re-downloading and
48processing the entire blockchain.
49
50Compatibility
51==============
52
53Bitcoin Core is extensively tested on multiple operating systems using
54the Linux kernel, macOS 10.10+, and Windows 7 and newer (Windows XP is not supported).
55
56Bitcoin Core should also work on most other Unix-like systems but is not
57frequently tested on them.
58
59From 0.17.0 onwards macOS <10.10 is no longer supported. 0.17.0 is built using Qt 5.9.x, which doesn't
60support versions of macOS older than 10.10.
61
62Notable changes
63===============
64
65`listtransactions` label support
66--------------------------------
67
68The `listtransactions` RPC `account` parameter which was deprecated in 0.17.0
69and renamed to `dummy` has been un-deprecated and renamed again to `label`.
70
71When bitcoin is configured with the `-deprecatedrpc=accounts` setting, specifying
72a label/account/dummy argument will return both outgoing and incoming
73transactions. Without the `-deprecatedrpc=accounts` setting, it will only return
74incoming transactions (because it used to be possible to create transactions
75spending from specific accounts, but this is no longer possible with labels).
76
77When `-deprecatedrpc=accounts` is set, it's possible to pass the empty string ""
78to list transactions that don't have any label. Without
79`-deprecatedrpc=accounts`, passing the empty string is an error because returning
80only non-labeled transactions is not generally useful behavior and can cause
81confusion.
82
830.17.1 change log
84=================
85
86### P2P protocol and network code
87- #14685 `9406502` Fix a deserialization overflow edge case (kazcw)
88- #14728 `b901578` Fix uninitialized read when stringifying an addrLocal (kazcw)
89
90### Wallet
91- #14441 `5150acc` Restore ability to list incoming transactions by label (jnewbery)
92- #13546 `91fa15a` Fix use of uninitialized value `bnb_used` in CWallet::CreateTransaction(…) (practicalswift)
93- #14310 `bb90695` Ensure wallet is unlocked before signing (gustavonalle)
94- #14690 `5782fdc` Throw error if CPubKey is invalid during PSBT keypath serialization (instagibbs)
95- #14852 `2528443` backport: [tests] Add `wallet_balance.py` (MarcoFalke)
96- #14196 `3362a95` psbt: always drop the unnecessary utxo and convert non-witness utxo to witness when necessary (achow101)
97- #14588 `70ee1f8` Refactor PSBT signing logic to enforce invariant and fix signing bug (gwillen)
98- #14424 `89a9a9d` Stop requiring imported pubkey to sign non-PKH schemes (sipa, MeshCollider)
99
100### RPC and other APIs
101- #14417 `fb9ad04` Fix listreceivedbyaddress not taking address as a string (etscrivner)
102- #14596 `de5e48a` Bugfix: RPC: Add `address_type` named param for createmultisig (luke-jr)
103- #14618 `9666dba` Make HTTP RPC debug logging more informative (practicalswift)
104- #14197 `7bee414` [psbt] Convert non-witness UTXOs to witness if witness sig created (achow101)
105- #14377 `a3fe125` Check that a separator is found for psbt inputs, outputs, and global map (achow101)
106- #14356 `7a590d8` Fix converttopsbt permitsigdata arg, add basic test (instagibbs)
107- #14453 `75b5d8c` Fix wallet unload during walletpassphrase timeout (promag)
108
109### GUI
110- #14403 `0242b5a` Revert "Force TLS1.0+ for SSL connections" (real-or-random)
111- #14593 `df5131b` Explicitly disable "Dark Mode" appearance on macOS (fanquake)
112
113### Build system
114- #14647 `7edebed` Remove illegal spacing in darwin.mk (ch4ot1c)
115- #14698 `ec71f06` Add bitcoin-tx.exe into Windows installer (ken2812221)
116
117### Tests and QA
118- #13965 `29899ec` Fix extended functional tests fail (ken2812221)
119- #14011 `9461f98` Disable wallet and address book Qt tests on macOS minimal platform (ryanofsky)
120- #14180 `86fadee` Run all tests even if wallet is not compiled (MarcoFalke)
121- #14122 `8bc1bad` Test `rpc_help.py` failed: Check whether ZMQ is enabled or not (Kvaciral)
122- #14101 `96dc936` Use named args in validation acceptance tests (MarcoFalke)
123- #14020 `24d796a` Add tests for RPC help (promag)
124- #14052 `7ff32a6` Add some actual witness in `rpc_rawtransaction` (MarcoFalke)
125- #14215 `b72fbab` Use correct python index slices in example test (sdaftuar)
126- #14024 `06544fa` Add `TestNode::assert_debug_log` (MarcoFalke)
127- #14658 `60f7a97` Add test to ensure node can generate all rpc help texts at runtime (MarcoFalke)
128- #14632 `96f15e8` Fix a comment (fridokus)
129- #14700 `f9db08e` Avoid race in `p2p_invalid_block` by waiting for the block request (MarcoFalke)
130- #14845 `67225e2` Add `wallet_balance.py` (jnewbery)
131
132### Documentation
133- #14161 `5f51fd6` doc/descriptors.md tweaks (ryanofsky)
134- #14276 `85aacc4` Add autogen.sh in ARM Cross-compilation (walterwhite81)
135
136Credits
137=======
138
139Thanks to everyone who directly contributed to this release:
140
141- Andrew Chow
142- Chun Kuan Lee
143- David A. Harding
144- Eric Scrivner
145- fanquake
146- fridokus
147- Glenn Willen
148- Gregory Sanders
149- gustavonalle
150- John Newbery
151- Jon Layton
152- Jonas Schnelli
153- João Barbosa
154- Kaz Wesley
155- Kvaciral
156- Luke Dashjr
157- MarcoFalke
158- MeshCollider
159- Pieter Wuille
160- practicalswift
161- Russell Yanofsky
162- Sjors Provoost
163- Suhas Daftuar
164- Tim Ruffing
165- Walter
166- Wladimir J. van der Laan
167
168As well as everyone that helped translating on [Transifex](https://www.transifex.com/projects/p/bitcoin/).
169

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

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.