doc/release-notes/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/).