Skip to content

Commit fa8c497

Browse files
author
MarcoFalke
committed
[doc] backwards-compatibility issues due to chainstate obfuscation
1 parent 82667af commit fa8c497

File tree

1 file changed

+13
-2
lines changed

1 file changed

+13
-2
lines changed

doc/release-notes.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ bitcoind/bitcoin-qt (on Linux).
2222
Downgrade warning
2323
------------------
2424

25+
### Downgrade to a version < 0.10.0
26+
2527
Because release 0.10.0 and later makes use of headers-first synchronization and
2628
parallel block download (see further), the block files and databases are not
2729
backwards-compatible with pre-0.10 versions of Bitcoin Core or other software:
@@ -40,8 +42,17 @@ bootstrap.dat) anew afterwards. It is possible that the data from a completely
4042
synchronised 0.10 node may be usable in older versions as-is, but this is not
4143
supported and may break as soon as the older version attempts to reindex.
4244

43-
This does not affect wallet forward or backward compatibility. There are no
44-
known problems when downgrading from 0.12.x to a version >= 0.10.0.
45+
This does not affect wallet forward or backward compatibility.
46+
47+
### Downgrade to a version < 0.12.0
48+
49+
Because release 0.12.0 and later will obfuscate the chainstate on every
50+
fresh sync or reindex, the chainstate is not backwards-compatible with
51+
pre-0.12 versions of Bitcoin Core or other software.
52+
53+
If you want to downgrade after you have done a reindex with 0.12.0 or later,
54+
you will need to reindex when you first start Bitcoin Core version 0.11 or
55+
earlier.
4556

4657
Notable changes
4758
===============

0 commit comments

Comments
 (0)