From ada258f8c8f92d44d893cf9f22d15acdeca40b1a Mon Sep 17 00:00:00 2001 From: Karl-Johan Alm Date: Tue, 20 Nov 2018 13:28:23 +0900 Subject: [PATCH] doc: release notes for avoid_reuse --- doc/release-notes-13756.md | 39 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 doc/release-notes-13756.md diff --git a/doc/release-notes-13756.md b/doc/release-notes-13756.md new file mode 100644 index 000000000..21006f46a --- /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.