aboutsummaryrefslogtreecommitdiff
path: root/doc/release-notes-13756.md
diff options
context:
space:
mode:
authorKarl-Johan Alm <karljohan-alm@garage.co.jp>2018-11-20 13:28:23 +0900
committerKarl-Johan Alm <karljohan-alm@garage.co.jp>2019-05-29 18:40:31 +0900
commitada258f8c8f92d44d893cf9f22d15acdeca40b1a (patch)
treec31b43d8046886591cede6c996d2e8258ae65b5b /doc/release-notes-13756.md
parent27669551da52099e4a6a401acd7aa32b32832423 (diff)
doc: release notes for avoid_reuse
Diffstat (limited to 'doc/release-notes-13756.md')
-rw-r--r--doc/release-notes-13756.md39
1 files changed, 39 insertions, 0 deletions
diff --git a/doc/release-notes-13756.md b/doc/release-notes-13756.md
new file mode 100644
index 0000000000..21006f46a0
--- /dev/null
+++ b/doc/release-notes-13756.md
@@ -0,0 +1,39 @@
+Coin selection
+--------------
+
+### Reuse Avoidance
+
+A new wallet flag `avoid_reuse` has been added (default off). When enabled,
+a wallet will distinguish between used and unused addresses, and default to not
+use the former in coin selection.
+
+(Note: rescanning the blockchain is required, to correctly mark previously
+used destinations.)
+
+Together with "avoid partial spends" (present as of Bitcoin v0.17), this
+addresses a serious privacy issue where a malicious user can track spends by
+peppering a previously paid to address with near-dust outputs, which would then
+be inadvertently included in future payments.
+
+New RPCs
+--------
+
+- A new `setwalletflag` RPC sets/unsets flags for an existing wallet.
+
+
+Updated RPCs
+------------
+
+Several RPCs have been updated to include an "avoid_reuse" flag, used to control
+whether already used addresses should be left out or included in the operation.
+These include:
+
+- createwallet
+- getbalance
+- sendtoaddress
+
+In addition, `sendtoaddress` has been changed to enable `-avoidpartialspends` when
+`avoid_reuse` is enabled.
+
+The listunspent RPC has also been updated to now include a "reused" bool, for nodes
+with "avoid_reuse" enabled.