# · fanquake · #1 · 08 Jul 2026, 14:33 UTC

Bitcoin Core version 31.1 is now available from:

https://bitcoincore.org/bin/bitcoin-core-31.1/

This release includes various bug fixes and performance improvements, as well as updated translations.

Please report bugs using the issue tracker at GitHub:

https://github.com/bitcoin/bitcoin/issues

To receive security and update notifications, please subscribe to:

https://bitcoincore.org/en/list/announcements/join/

How to Upgrade

If you are running an older version, shut it down. Wait until it has completely shut down (which might take a few minutes in some cases), then run the installer (on Windows) or just copy over /Applications/Bitcoin-Qt (on macOS) or bitcoind/bitcoin-qt (on Linux).

Upgrading directly from a version of Bitcoin Core that has reached its EOL is possible, but it might take some time if the data directory needs to be migrated. Old wallet versions of Bitcoin Core are generally supported.

Compatibility

Bitcoin Core is supported and tested on the following operating systems or newer: Linux Kernel 3.17, macOS 14, and Windows 10 (version 1903). Bitcoin Core should also work on most other Unix-like systems but is not as frequently tested on them. It is not recommended to use Bitcoin Core on unsupported systems.

Notable changes

This release fixes an issue where the chainstate database would repeatedly rewrite large portions of itself, causing excessive disk reads and writes during normal operation.

PrivateBroadcast

This release fixes an ip address leak when using the -privatebroadcast feature. Under certain circumstances connections were being made over clearnet rather than the enabled privacy network.

Validation

• #35209 validation: correct lifetime of precomputed tx data
• #35465 coins: compact chainstate regularly

Leveldb

• #61(bitcoin-core/leveldb): Disable seek compaction

P2P

• #35032 net_processing: don’t modify addrman for private broadcast connections
• #35410 net: use the proxy if overriden when doing v2->v1 reconnections

Wallet

• #35227 wallet: check the final BDB page LSN during migration
• #35228 wallet: use outpoint when estimating input size

Musig

• #35316 musig: Reject empty pubkey list in GetMuSig2KeyAggCache

Build

• #34228 depends: Unset SOURCE_DATE_EPOCH in gen_id script

Test

• #34425 test: Fix all races after a socket is closed gracefully
• #34863 test: Clean shutdown in Socks5Server
• #34991 test: fix feature_index_prune.py bug when using --usecli
• #35080 test: Add missing self.options.timeout_factor scale in tool_bitcoin_chainstate.py
• #35218 test: fix P2SH script in coins cache fuzz target
• #35279 psbt, test: remove address type restrictions in test

Fuzz

• #35289 fuzz: Fix timeout in txorphan

Util

• #35384 util: Check write failures before renaming settings.json

Docs

• #35283 doc: mention -DWITH_ZMQ=ON in BSD build guides

CI

• #35202 ci: restore sockets in i686, no IPC job
• #35230 ci: Move --usecli --extended from i386 task to alpine task
• #35348 ci: switch to GitHub cache for all runners
• #35378 ci: switch runners from cirrus to warpbuild
• #35408 ci: 35378 followups
• #35430 ci: use warp caching on warp runners
• #35447 ci: use warpbuild cache for docker buildkit cache

Misc

• #35044 contrib: Fix NameError in signet miner gbt()
• #35175 multi_index: fix compilation failure with boost >= 1.91
• #34953 crypto: disable ASan instrumentation of SSE4 SHA256 for GCC

Credits

Thanks to everyone who directly contributed to this release:

• andrewtoth
• Cory Fields
• Crypt-iQ
• darosior
• deadmanoz
• fanquake
• Greg Sanders
• Hennadii Stepanov
• junbyjun1238
• Lőrinc
• MarcoFalke
• marcofleon
• nervana21
• optout21
• Pol Espinasa
• rkrux
• Shrey
• Torkel Rogstad
• Vasil Dimov
• willcl-ark

As well as to everyone that helped with translations on Transifex.