|
| 1 | +--- |
| 2 | +title: Bitcoin Core 28.1 |
| 3 | +id: en-release-28.1 |
| 4 | +name: release-28.1 |
| 5 | +permalink: /en/releases/28.1/ |
| 6 | +excerpt: Bitcoin Core version 28.1 is now available |
| 7 | +date: 2025-01-09 |
| 8 | + |
| 9 | +## Use a YAML array for the version number to allow other parts of the |
| 10 | +## site to correctly sort in "natural sort of version numbers". |
| 11 | +## Use the same number of elements as decimal places, e.g. "0.1.2 => [0, |
| 12 | +## 1, 2]" versus "1.2 => [1, 2]" |
| 13 | +release: [28, 1] |
| 14 | + |
| 15 | +## Optional magnet link. To get it, open the torrent in a good BitTorrent client |
| 16 | +## and View Details, or install the transmission-cli Debian/Ubuntu package |
| 17 | +## and run: transmission-show -m <torrent file> |
| 18 | +# |
| 19 | +## Link should be enclosed in quotes and start with: "magnet:? |
| 20 | +optional_magnetlink: "magnet:?xt=urn:btih:60837ded9c7e11b2a44f2ae7bc8e6fe3a3d7ee5c&dn=bitcoin-core-28.1&tr=udp%3A%2F%2Ftracker.openbittorrent.com%3A80&tr=udp%3A%2F%2Ftracker.coppersurfer.tk%3A6969%2Fannounce&tr=udp%3A%2F%2Ftracker.opentrackr.org%3A1337%2Fannounce&tr=udp%3A%2F%2Fexplodie.org%3A6969%2Fannounce&tr=udp%3A%2F%2Ftracker.leechers-paradise.org%3A6969%2Fannounce&tr=udp%3A%2F%2Ftracker.torrent.eu.org%3A451%2Fannounce&tr=udp%3A%2F%2Ftracker.bitcoin.sprovoost.nl%3A6969&ws=http://bitcoincore.org/bin/" |
| 21 | + |
| 22 | +# Note: it is recommended to check all links to ensure they use |
| 23 | +# absolute urls (https://github.com/bitcoin/bitcoin/doc/foo) |
| 24 | +# rather than relative urls (/bitcoin/bitcoin/doc/foo). |
| 25 | +--- |
| 26 | +{% include download.html %} |
| 27 | +{% githubify https://github.com/bitcoin/bitcoin %} |
| 28 | +28.1 Release Notes |
| 29 | +===================== |
| 30 | + |
| 31 | +Bitcoin Core version 28.1 is now available from: |
| 32 | + |
| 33 | + <https://bitcoincore.org/bin/bitcoin-core-28.1> |
| 34 | + |
| 35 | +This release includes new features, various bug fixes and performance |
| 36 | +improvements, as well as updated translations. |
| 37 | + |
| 38 | +Please report bugs using the issue tracker at GitHub: |
| 39 | + |
| 40 | + <https://github.com/bitcoin/bitcoin/issues> |
| 41 | + |
| 42 | +To receive security and update notifications, please subscribe to: |
| 43 | + |
| 44 | + <https://bitcoincore.org/en/list/announcements/join/> |
| 45 | + |
| 46 | +How to Upgrade |
| 47 | +============== |
| 48 | + |
| 49 | +If you are running an older version, shut it down. Wait until it has completely |
| 50 | +shut down (which might take a few minutes in some cases), then run the |
| 51 | +installer (on Windows) or just copy over `/Applications/Bitcoin-Qt` (on macOS) |
| 52 | +or `bitcoind`/`bitcoin-qt` (on Linux). |
| 53 | + |
| 54 | +Upgrading directly from a version of Bitcoin Core that has reached its EOL is |
| 55 | +possible, but it might take some time if the data directory needs to be migrated. Old |
| 56 | +wallet versions of Bitcoin Core are generally supported. |
| 57 | + |
| 58 | +Running Bitcoin Core binaries on macOS requires self signing. |
| 59 | +``` |
| 60 | +cd /path/to/bitcoin-28.x/bin |
| 61 | +xattr -d com.apple.quarantine bitcoin-cli bitcoin-qt bitcoin-tx bitcoin-util bitcoin-wallet bitcoind test_bitcoin |
| 62 | +codesign -s - bitcoin-cli bitcoin-qt bitcoin-tx bitcoin-util bitcoin-wallet bitcoind test_bitcoin |
| 63 | +``` |
| 64 | + |
| 65 | +Compatibility |
| 66 | +============== |
| 67 | + |
| 68 | +Bitcoin Core is supported and extensively tested on operating systems |
| 69 | +using the Linux Kernel 3.17+, macOS 11.0+, and Windows 7 and newer. Bitcoin |
| 70 | +Core should also work on most other UNIX-like systems but is not as |
| 71 | +frequently tested on them. It is not recommended to use Bitcoin Core on |
| 72 | +unsupported systems. |
| 73 | + |
| 74 | +Notable changes |
| 75 | +=============== |
| 76 | + |
| 77 | +### P2P |
| 78 | + |
| 79 | +- When the `-port` configuration option is used, the default onion listening port will now |
| 80 | + be derived to be that port + 1 instead of being set to a fixed value (8334 on mainnet). |
| 81 | + This re-allows setups with multiple local nodes using different `-port` and not using `-bind`, |
| 82 | + which would lead to a startup failure in v28.0 due to a port collision. |
| 83 | + |
| 84 | + Note that a `HiddenServicePort` manually configured in `torrc` may need adjustment if used in |
| 85 | + connection with the `-port` option. |
| 86 | + For example, if you are using `-port=5555` with a non-standard value and not using `-bind=...=onion`, |
| 87 | + previously Bitcoin Core would listen for incoming Tor connections on `127.0.0.1:8334`. |
| 88 | + Now it would listen on `127.0.0.1:5556` (`-port` plus one). If you configured the hidden service manually |
| 89 | + in torrc now you have to change it from `HiddenServicePort 8333 127.0.0.1:8334` to `HiddenServicePort 8333 |
| 90 | + 127.0.0.1:5556`, or configure bitcoind with `-bind=127.0.0.1:8334=onion` to get the previous behavior. |
| 91 | + (#31223) |
| 92 | +- #30568 addrman: change internal id counting to int64_t |
| 93 | + |
| 94 | +### Key |
| 95 | + |
| 96 | +- #31166 key: clear out secret data in DecodeExtKey |
| 97 | + |
| 98 | +### Build |
| 99 | + |
| 100 | +- #31013 depends: For mingw cross compile use `-gcc-posix` to prevent library conflict |
| 101 | +- #31502 depends: Fix CXXFLAGS on NetBSD |
| 102 | + |
| 103 | +### Test |
| 104 | + |
| 105 | +- #31016 test: add missing sync to feature_fee_estimation.py |
| 106 | +- #31448 fuzz: add cstdlib to FuzzedDataProvider |
| 107 | +- #31419 test: fix MIN macro redefinition |
| 108 | +- #31563 rpc: Extend scope of validation mutex in generateblock |
| 109 | + |
| 110 | +### Doc |
| 111 | + |
| 112 | +- #31007 doc: add testnet4 section header for config file |
| 113 | + |
| 114 | +### CI |
| 115 | + |
| 116 | +- #30961 ci: add LLVM_SYMBOLIZER_PATH to Valgrind fuzz job |
| 117 | + |
| 118 | +### Misc |
| 119 | + |
| 120 | +- #31267 refactor: Drop deprecated space in `operator""_mst` |
| 121 | +- #31431 util: use explicit cast in MultiIntBitSet::Fill() |
| 122 | + |
| 123 | +Credits |
| 124 | +======= |
| 125 | + |
| 126 | +Thanks to everyone who directly contributed to this release: |
| 127 | + |
| 128 | +- fanquake |
| 129 | +- Hennadii Stepanov |
| 130 | +- laanwj |
| 131 | +- MarcoFalke |
| 132 | +- Martin Zumsande |
| 133 | +- Marnix |
| 134 | +- Sebastian Falbesoner |
| 135 | + |
| 136 | +As well as to everyone that helped with translations on |
| 137 | +[Transifex](https://www.transifex.com/bitcoin/bitcoin/). |
| 138 | +{% endgithubify %} |
0 commit comments