zecfoundation
/
zcashd
mirror of https://github.com/ZcashFoundation/zcashd.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Add z_mergetoaddress to release notes

This commit is contained in:
Jack Grigg 2019-12-11 23:41:53 +00:00
parent a96942e809
commit 5746704b4b
No known key found for this signature in database
GPG Key ID: 9E8255172BBF9898
1 changed files with 21 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
doc/release-notes.md
View File

@ -4,6 +4,27 @@ release-notes at release time)
Notable changes
===============
`z_mergetoaddress` promoted out of experimental status
------------------------------------------------------
The `z_mergetoaddress` API merges funds from t-addresses, z-addresses, or both,
and sends them to a single t-address or z-address. It was added in v1.0.15 as an
experimental feature, to simplify the process of combining many small UTXOs and
notes into a few larger ones.
In this release we are promoting `z_mergetoaddress` out of experimental status.
It is now a stable RPC, and any future changes to it will only be additive. See
`zcash-cli help z_mergetoaddress` for API details and usage.
Unlike most other RPC methods, `z_mergetoaddress` operates over a particular
quantity of UTXOs and notes, instead of a particular amount of ZEC. By default,
it will merge 50 UTXOs and 10 notes at a time; these limits can be adjusted with
the parameters `transparent_limit` and `shielded_limit`.
`z_mergetoaddress` also returns the number of UTXOs and notes remaining in the
given addresses, which can be used to automate the merging process (for example,
merging until the number of UTXOs falls below some value).
Option parsing behavior
-----------------------