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.

14,725 bytes · SHA-256 fecc72823e4d765c… · View upstream ↗

1Bitcoin Core version 0.9.0 is now available from:
2
3  https://bitcoin.org/bin/0.9.0/
4
5This is a new major version release, bringing both new features and
6bug fixes.
7
8Please report bugs using the issue tracker at github:
9
10  https://github.com/bitcoin/bitcoin/issues
11
12How to Upgrade
13--------------
14
15If you are running an older version, shut it down. Wait until it has completely
16shut down (which might take a few minutes for older versions), uninstall all
17earlier versions of Bitcoin, then run the installer (on Windows) or just copy
18over /Applications/Bitcoin-Qt (on Mac) or bitcoind/bitcoin-qt (on Linux).
19
20If you are upgrading from version 0.7.2 or earlier, the first time you run
210.9.0 your blockchain files will be re-indexed, which will take anywhere from 
2230 minutes to several hours, depending on the speed of your machine.
23
24On Windows, do not forget to uninstall all earlier versions of the Bitcoin
25client first, especially if you are switching to the 64-bit version.
26
27Windows 64-bit installer
28-------------------------
29
30New in 0.9.0 is the Windows 64-bit version of the client. There have been
31frequent reports of users running out of virtual memory on 32-bit systems
32during the initial sync. Because of this it is recommended to install the
3364-bit version if your system supports it.
34
35NOTE: Release candidate 2 Windows binaries are not code-signed; use PGP
36and the SHA256SUMS.asc file to make sure your binaries are correct.
37In the final 0.9.0 release, Windows setup.exe binaries will be code-signed.
38
39OSX 10.5 / 32-bit no longer supported
40-------------------------------------
41
420.9.0 drops support for older Macs. The minimum requirements are now:
43* A 64-bit-capable CPU (see http://support.apple.com/kb/ht3696);
44* Mac OS 10.6 or later (see https://support.apple.com/kb/ht1633).
45
46Downgrading warnings
47--------------------
48
49The 'chainstate' for this release is not always compatible with previous
50releases, so if you run 0.9 and then decide to switch back to a
510.8.x release you might get a blockchain validation error when starting the
52old release (due to 'pruned outputs' being omitted from the index of
53unspent transaction outputs).
54
55Running the old release with the -reindex option will rebuild the chainstate
56data structures and correct the problem.
57
58Also, the first time you run a 0.8.x release on a 0.9 wallet it will rescan
59the blockchain for missing spent coins, which will take a long time (tens
60of minutes on a typical machine).
61
62Rebranding to Bitcoin Core
63---------------------------
64
65To reduce confusion between Bitcoin-the-network and Bitcoin-the-software we
66have renamed the reference client to Bitcoin Core.
67
68
69OP_RETURN and data in the block chain
70-------------------------------------
71On OP_RETURN:  There was been some confusion and misunderstanding in
72the community, regarding the OP_RETURN feature in 0.9 and data in the
73blockchain.  This change is not an endorsement of storing data in the
74blockchain.  The OP_RETURN change creates a provably-prunable output,
75to avoid data storage schemes -- some of which were already deployed --
76that were storing arbitrary data such as images as forever-unspendable
77TX outputs, bloating bitcoin's UTXO database.
78
79Storing arbitrary data in the blockchain is still a bad idea; it is less
80costly and far more efficient to store non-currency data elsewhere.
81
82Autotools build system
83-----------------------
84
85For 0.9.0 we switched to an autotools-based build system instead of individual
86(q)makefiles.
87
88Using the standard "./autogen.sh; ./configure; make" to build Bitcoin-Qt and
89bitcoind makes it easier for experienced open source developers to contribute 
90to the project.
91
92Be sure to check doc/build-*.md for your platform before building from source.
93
94Bitcoin-cli
95-------------
96
97Another change in the 0.9 release is moving away from the bitcoind executable
98functioning both as a server and as a RPC client. The RPC client functionality
99("tell the running bitcoin daemon to do THIS") was split into a separate
100executable, 'bitcoin-cli'. The RPC client code will eventually be removed from
101bitcoind, but will be kept for backwards compatibility for a release or two.
102
103`walletpassphrase` RPC
104-----------------------
105
106The behavior of the `walletpassphrase` RPC when the wallet is already unlocked
107has changed between 0.8 and 0.9.
108
109The 0.8 behavior of `walletpassphrase` is to fail when the wallet is already unlocked:
110
111    > walletpassphrase 1000
112    walletunlocktime = now + 1000
113    > walletpassphrase 10
114    Error: Wallet is already unlocked (old unlock time stays)
115
116The new behavior of `walletpassphrase` is to set a new unlock time overriding
117the old one:
118
119    > walletpassphrase 1000
120    walletunlocktime = now + 1000
121    > walletpassphrase 10
122    walletunlocktime = now + 10 (overriding the old unlock time)
123
124Transaction malleability-related fixes
125--------------------------------------
126
127This release contains a few fixes for transaction ID (TXID) malleability 
128issues:
129
130- -nospendzeroconfchange command-line option, to avoid spending
131  zero-confirmation change
132- IsStandard() transaction rules tightened to prevent relaying and mining of
133  mutated transactions
134- Additional information in listtransactions/gettransaction output to
135  report wallet transactions that conflict with each other because
136  they spend the same outputs.
137- Bug fixes to the getbalance/listaccounts RPC commands, which would report
138  incorrect balances for double-spent (or mutated) transactions.
139- New option: -zapwallettxes to rebuild the wallet's transaction information
140
141Transaction Fees
142----------------
143
144This release drops the default fee required to relay transactions across the
145network and for miners to consider the transaction in their blocks to
1460.01mBTC per kilobyte.
147
148Note that getting a transaction relayed across the network does NOT guarantee
149that the transaction will be accepted by a miner; by default, miners fill
150their blocks with 50 kilobytes of high-priority transactions, and then with
151700 kilobytes of the highest-fee-per-kilobyte transactions.
152
153The minimum relay/mining fee-per-kilobyte may be changed with the
154minrelaytxfee option. Note that previous releases incorrectly used
155the mintxfee setting to determine which low-priority transactions should
156be considered for inclusion in blocks.
157
158The wallet code still uses a default fee for low-priority transactions of
1590.1mBTC per kilobyte. During periods of heavy transaction volume, even this
160fee may not be enough to get transactions confirmed quickly; the mintxfee
161option may be used to override the default.
162
1630.9.0 Release notes
164=======================
165
166RPC:
167
168- New notion of 'conflicted' transactions, reported as confirmations: -1
169- 'listreceivedbyaddress' now provides tx ids
170- Add raw transaction hex to 'gettransaction' output
171- Updated help and tests for 'getreceivedby(account|address)'
172- In 'getblock', accept 2nd 'verbose' parameter, similar to getrawtransaction,
173  but defaulting to 1 for backward compatibility
174- Add 'verifychain', to verify chain database at runtime
175- Add 'dumpwallet' and 'importwallet' RPCs
176- 'keypoolrefill' gains optional size parameter
177- Add 'getbestblockhash', to return tip of best chain
178- Add 'chainwork' (the total work done by all blocks since the genesis block)
179  to 'getblock' output
180- Make RPC password resistant to timing attacks
181- Clarify help messages and add examples
182- Add 'getrawchangeaddress' call for raw transaction change destinations
183- Reject insanely high fees by default in 'sendrawtransaction'
184- Add RPC call 'decodescript' to decode a hex-encoded transaction script
185- Make 'validateaddress' provide redeemScript
186- Add 'getnetworkhashps' to get the calculated network hashrate
187- New RPC 'ping' command to request ping, new 'pingtime' and 'pingwait' fields
188  in 'getpeerinfo' output
189- Adding new 'addrlocal' field to 'getpeerinfo' output
190- Add verbose boolean to 'getrawmempool'
191- Add rpc command 'getunconfirmedbalance' to obtain total unconfirmed balance
192- Explicitly ensure that wallet is unlocked in `importprivkey`
193- Add check for valid keys in `importprivkey`
194
195Command-line options:
196
197- New option: -nospendzeroconfchange to never spend unconfirmed change outputs
198- New option: -zapwallettxes to rebuild the wallet's transaction information
199- Rename option '-tor' to '-onion' to better reflect what it does
200- Add '-disablewallet' mode to let bitcoind run entirely without wallet (when
201  built with wallet)
202- Update default '-rpcsslciphers' to include TLSv1.2
203- make '-logtimestamps' default on and rework help-message
204- RPC client option: '-rpcwait', to wait for server start
205- Remove '-logtodebugger'
206- Allow `-noserver` with bitcoind
207
208Block-chain handling and storage:
209
210- Update leveldb to 1.15
211- Check for correct genesis (prevent cases where a datadir from the wrong
212  network is accidentally loaded)
213- Allow txindex to be removed and add a reindex dialog
214- Log aborted block database rebuilds
215- Store orphan blocks in serialized form, to save memory
216- Limit the number of orphan blocks in memory to 750
217- Fix non-standard disconnected transactions causing mempool orphans
218- Add a new checkpoint at block 279,000
219
220Wallet:
221
222- Bug fixes and new regression tests to correctly compute
223  the balance of wallets containing double-spent (or mutated) transactions
224- Store key creation time. Calculate whole-wallet birthday.
225- Optimize rescan to skip blocks prior to birthday
226- Let user select wallet file with -wallet=foo.dat
227- Consider generated coins mature at 101 instead of 120 blocks
228- Improve wallet load time
229- Don't count txins for priority to encourage sweeping
230- Don't create empty transactions when reading a corrupted wallet
231- Fix rescan to start from beginning after importprivkey
232- Only create signatures with low S values
233
234Mining:
235
236- Increase default -blockmaxsize/prioritysize to 750K/50K
237- 'getblocktemplate' does not require a key to create a block template
238- Mining code fee policy now matches relay fee policy
239
240Protocol and network:
241
242- Drop the fee required to relay a transaction to 0.01mBTC per kilobyte
243- Send tx relay flag with version
244- New 'reject' P2P message (BIP 0061, see
245  https://gist.github.com/gavinandresen/7079034 for draft)
246- Dump addresses every 15 minutes instead of 10 seconds
247- Relay OP_RETURN data TxOut as standard transaction type
248- Remove CENT-output free transaction rule when relaying
249- Lower maximum size for free transaction creation
250- Send multiple inv messages if mempool.size > MAX_INV_SZ

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.