release-notes-0.10.4.md
1 Bitcoin Core version 0.10.4 is now available from: 2 3 <https://bitcoin.org/bin/bitcoin-core-0.10.4/> 4 5 This is a new minor version release, bringing bug fixes, the BIP65 6 (CLTV) consensus change, and relay policy preparation for BIP113. It is 7 recommended to upgrade to this version as soon as possible. 8 9 Please report bugs using the issue tracker at github: 10 11 <https://github.com/bitcoin/bitcoin/issues> 12 13 Upgrading and downgrading 14 ========================= 15 16 How to Upgrade 17 -------------- 18 19 If you are running an older version, shut it down. Wait until it has completely 20 shut down (which might take a few minutes for older versions), then run the 21 installer (on Windows) or just copy over /Applications/Bitcoin-Qt (on Mac) or 22 bitcoind/bitcoin-qt (on Linux). 23 24 Downgrade warning 25 ------------------ 26 27 Because release 0.10.0 and later makes use of headers-first synchronization and 28 parallel block download (see further), the block files and databases are not 29 backwards-compatible with pre-0.10 versions of Bitcoin Core or other software: 30 31 * Blocks will be stored on disk out of order (in the order they are 32 received, really), which makes it incompatible with some tools or 33 other programs. Reindexing using earlier versions will also not work 34 anymore as a result of this. 35 36 * The block index database will now hold headers for which no block is 37 stored on disk, which earlier versions won't support. 38 39 If you want to be able to downgrade smoothly, make a backup of your entire data 40 directory. Without this your node will need start syncing (or importing from 41 bootstrap.dat) anew afterwards. It is possible that the data from a completely 42 synchronised 0.10 node may be usable in older versions as-is, but this is not 43 supported and may break as soon as the older version attempts to reindex. 44 45 This does not affect wallet forward or backward compatibility. There are no 46 known problems when downgrading from 0.11.x to 0.10.x. 47 48 Notable changes since 0.10.3 49 ============================ 50 51 BIP65 soft fork to enforce OP_CHECKLOCKTIMEVERIFY opcode 52 -------------------------------------------------------- 53 54 This release includes several changes related to the [BIP65][] soft fork 55 which redefines the existing OP_NOP2 opcode as OP_CHECKLOCKTIMEVERIFY 56 (CLTV) so that a transaction output can be made unspendable until a 57 specified point in the future. 58 59 1. This release will only relay and mine transactions spending a CLTV 60 output if they comply with the BIP65 rules as provided in code. 61 62 2. This release will produce version 4 blocks by default. Please see the 63 *notice to miners* below. 64 65 3. Once 951 out of a sequence of 1,001 blocks on the local node's best block 66 chain contain version 4 (or higher) blocks, this release will no 67 longer accept new version 3 blocks and it will only accept version 4 68 blocks if they comply with the BIP65 rules for CLTV. 69 70 For more information about the soft-forking change, please see 71 <https://github.com/bitcoin/bitcoin/pull/6351> 72 73 Graphs showing the progress towards block version 4 adoption may be 74 found at the URLs below: 75 76 - Block versions over the last 50,000 blocks as progress towards BIP65 77 consensus enforcement: <http://bitcoin.sipa.be/ver-50k.png> 78 79 - Block versions over the last 2,000 blocks showing the days to the 80 earliest possible BIP65 consensus-enforced block: <http://bitcoin.sipa.be/ver-2k.png> 81 82 **Notice to miners:** Bitcoin Core’s block templates are now for 83 version 4 blocks only, and any mining software relying on its 84 getblocktemplate must be updated in parallel to use libblkmaker either 85 version FIXME or any version from FIXME onward. 86 87 - If you are solo mining, this will affect you the moment you upgrade 88 Bitcoin Core, which must be done prior to BIP65 achieving its 951/1001 89 status. 90 91 - If you are mining with the stratum mining protocol: this does not 92 affect you. 93 94 - If you are mining with the getblocktemplate protocol to a pool: this 95 will affect you at the pool operator’s discretion, which must be no 96 later than BIP65 achieving its 951/1001 status. 97 98 [BIP65]: https://github.com/bitcoin/bips/blob/master/bip-0065.mediawiki 99 100 Windows bug fix for corrupted UTXO database on unclean shutdowns 101 ---------------------------------------------------------------- 102 103 Several Windows users reported that they often need to reindex the 104 entire blockchain after an unclean shutdown of Bitcoin Core on Windows 105 (or an unclean shutdown of Windows itself). Although unclean shutdowns 106 remain unsafe, this release no longer relies on memory-mapped files for 107 the UTXO database, which significantly reduced the frequency of unclean 108 shutdowns leading to required reindexes during testing. 109 110 For more information, see: <https://github.com/bitcoin/bitcoin/pull/6917> 111 112 Other fixes for database corruption on Windows are expected in the 113 next major release. 114 115 0.10.4 Change log 116 ================= 117 118 Detailed release notes follow. This overview includes changes that affect 119 behavior, not code moves, refactors and string updates. For convenience in locating 120 the code changes and accompanying discussion, both the pull request and 121 git merge commit are mentioned. 122 123 - #6953 `8b3311f` alias -h for --help 124 - #6953 `97546fc` Change URLs to https in debian/control 125 - #6953 `38671bf` Update debian/changelog and slight tweak to debian/control 126 - #6953 `256321e` Correct spelling mistakes in doc folder 127 - #6953 `eae0350` Clarification of unit test build instructions 128 - #6953 `90897ab` Update bluematt-key, the old one is long-since revoked 129 - #6953 `a2f2fb6` build: disable -Wself-assign 130 - #6953 `cf67d8b` Bugfix: Allow mining on top of old tip blocks for testnet (fixes testnet-in-a-box use case) 131 - #6953 `b3964e3` Drop "with minimal dependencies" from description 132 - #6953 `43c2789` Split bitcoin-tx into its own package 133 - #6953 `dfe0d4d` Include bitcoin-tx binary on Debian/Ubuntu 134 - #6953 `612efe8` [Qt] Raise debug window when requested 135 - #6953 `3ad96bd` Fix locking in GetTransaction 136 - #6953 `9c81005` Fix spelling of Qt 137 - #6946 `94b67e5` Update LevelDB 138 - #6706 `5dc72f8` CLTV: Add more tests to improve coverage 139 - #6706 `6a1343b` Add RPC tests for the CHECKLOCKTIMEVERIFY (BIP65) soft-fork 140 - #6706 `4137248` Add CHECKLOCKTIMEVERIFY (BIP65) soft-fork logic 141 - #6706 `0e01d0f` Enable CHECKLOCKTIMEVERIFY as a standard script verify flag 142 - #6706 `6d01325` Replace NOP2 with CHECKLOCKTIMEVERIFY (BIP65) 143 - #6706 `750d54f` Move LOCKTIME_THRESHOLD to src/script/script.h 144 - #6706 `6897468` Make CScriptNum() take nMaxNumSize as an argument 145 - #6867 `5297194` Set TCP_NODELAY on P2P sockets 146 - #6836 `fb818b6` Bring historical release notes up to date 147 - #6852 `0b3fd07` build: make sure OpenSSL heeds noexecstack 148 149 Credits 150 ======= 151 152 Thanks to everyone who directly contributed to this release: 153 154 - Alex Morcos 155 - Daniel Cousens 156 - Diego Viola 157 - Eric Lombrozo 158 - Esteban Ordano 159 - Gregory Maxwell 160 - Luke Dashjr 161 - MarcoFalke 162 - Matt Corallo 163 - Micha 164 - Mitchell Cash 165 - Peter Todd 166 - Pieter Wuille 167 - Wladimir J. van der Laan 168 - Zak Wilcox 169 170 And those who contributed additional code review and/or security research. 171 172 As well as everyone that helped translating on [Transifex](https://www.transifex.com/projects/p/bitcoin/).