zec
/
zcash-rpc.github.io
mirror of https://github.com/zcash/zcash-rpc.github.io.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
zcash-rpc.github.io/z_sendmany.html

589 lines
23 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=1200px, shrink-to-fit=yes">
<meta name="description" content="Zcash 5.5.0 RPC Docs - z_sendmany">
<meta name="author" content="">
<title>z_sendmany - Zcash 5.5.0 RPC Docs</title>
<link href="./bootstrap.min.css" rel="stylesheet">
</head>
<style>
.card-body {
font-size:80%;
padding-top: 0.5em;
}
pre {
word-break: break-word;
white-space: pre-wrap;
}
</style>
<body>
<nav class="navbar navbar-dark bg-dark ">
<a class="navbar-brand" href="/">Zcash 5.5.0 RPC Docs</a>
</nav>
<main role="main" class="container-fluid" style="margin-top: 1pc;">
<div class="row">
<div class="col-8 col-lg-9 col-xl-10">
<h1>z_sendmany - Zcash 5.5.0 RPC</h1>
<pre>z_sendmany &#34;fromaddress&#34; [{&#34;address&#34;:... ,&#34;amount&#34;:...},...] ( minconf ) ( fee ) ( privacyPolicy )
Send a transaction with multiple recipients. Amounts are decimal numbers with at
most 8 digits of precision. Change generated from one or more transparent
addresses flows to a new transparent address, while change generated from a
legacy Sapling address returns to itself. When sending from a unified address,
change is returned to the internal-only address for the associated unified account.
When spending coinbase UTXOs, only shielded recipients are permitted and change is not allowed;
the entire value of the coinbase UTXO(s) must be consumed.
Arguments:
1. &#34;fromaddress&#34; (string, required) The transparent or shielded address to send the funds from.
The following special strings are also accepted:
- &#34;ANY_TADDR&#34;: Select non-coinbase UTXOs from any transparent addresses belonging to the wallet.
Use z_shieldcoinbase to shield coinbase UTXOs from multiple transparent addresses.
If a unified address is provided for this argument, the TXOs to be spent will be selected from those
associated with the account corresponding to that unified address, from value pools corresponding
to the receivers included in the UA.
2. &#34;amounts&#34; (array, required) An array of json objects representing the amounts to send.
[{
&#34;address&#34;:address (string, required) The address is a taddr, zaddr, or Unified Address
&#34;amount&#34;:amount (numeric, required) The numeric amount in ZEC is the value
&#34;memo&#34;:memo (string, optional) If the address is a zaddr, raw data represented in hexadecimal string format. If
the output is being sent to a transparent address, it’s an error to include this field.
}, ... ]
3. minconf (numeric, optional, default=10) Only use funds confirmed at least this many times.
4. fee (numeric, optional, default=null) The fee amount in ZEC to attach to this transaction. The default behavior
is to use a fee calculated according to ZIP 317.
5. privacyPolicy (string, optional, default=&#34;LegacyCompat&#34;) Policy for what information leakage is acceptable.
One of the following strings:
- &#34;FullPrivacy&#34;: Only allow fully-shielded transactions (involving a single shielded value pool).
- &#34;LegacyCompat&#34;: If the transaction involves any Unified Addresses, this is equivalent to
&#34;FullPrivacy&#34;. Otherwise, this is equivalent to &#34;AllowFullyTransparent&#34;.
- &#34;AllowRevealedAmounts&#34;: Allow funds to cross between shielded value pools, revealing the amount
that crosses pools.
- &#34;AllowRevealedRecipients&#34;: Allow transparent recipients. This also implies revealing
information described under &#34;AllowRevealedAmounts&#34;.
- &#34;AllowRevealedSenders&#34;: Allow transparent funds to be spent, revealing the sending
addresses and amounts. This implies revealing information described under &#34;AllowRevealedAmounts&#34;.
- &#34;AllowFullyTransparent&#34;: Allow transaction to both spend transparent funds and have
transparent recipients. This implies revealing information described under &#34;AllowRevealedSenders&#34;
and &#34;AllowRevealedRecipients&#34;.
- &#34;AllowLinkingAccountAddresses&#34;: Allow selecting transparent coins from the full account,
rather than just the funds sent to the transparent receiver in the provided Unified Address.
This implies revealing information described under &#34;AllowRevealedSenders&#34;.
- &#34;NoPrivacy&#34;: Allow the transaction to reveal any information necessary to create it.
This implies revealing information described under &#34;AllowFullyTransparent&#34; and
&#34;AllowLinkingAccountAddresses&#34;.
Result:
&#34;operationid&#34; (string) An operationid to pass to z_getoperationstatus to get the result of the operation.
Examples:
&gt; zcash-cli z_sendmany &#34;t1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd&#34; &#39;[{&#34;address&#34;: &#34;ztfaW34Gj9FrnGUEf833ywDVL62NWXBM81u6EQnM6VR45eYnXhwztecW1SjxA7JrmAXKJhxhj3vDNEpVCQoSvVoSpmbhtjf&#34;, &#34;amount&#34;: 5.0}]&#39;
&gt; zcash-cli z_sendmany &#34;ANY_TADDR&#34; &#39;[{&#34;address&#34;: &#34;t1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd&#34;, &#34;amount&#34;: 2.0}]&#39;
&gt; zcash-cli z_sendmany &#34;ANY_TADDR&#34; &#39;[{&#34;address&#34;: &#34;t1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd&#34;, &#34;amount&#34;: 2.0}]&#39; 1 null &#39;AllowFullyTransparent&#39;
&gt; zcash-cli z_sendmany &#34;ANY_TADDR&#34; &#39;[{&#34;address&#34;: &#34;t1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd&#34;, &#34;amount&#34;: 2.0}]&#39; 1 5000
&gt; curl --user myusername --data-binary &#39;{&#34;jsonrpc&#34;: &#34;1.0&#34;, &#34;id&#34;:&#34;curltest&#34;, &#34;method&#34;: &#34;z_sendmany&#34;, &#34;params&#34;: [&#34;t1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd&#34;, [{&#34;address&#34;: &#34;ztfaW34Gj9FrnGUEf833ywDVL62NWXBM81u6EQnM6VR45eYnXhwztecW1SjxA7JrmAXKJhxhj3vDNEpVCQoSvVoSpmbhtjf&#34;, &#34;amount&#34;: 5.0}]] }&#39; -H &#39;content-type: text/plain;&#39; http://127.0.0.1:8232/
</pre>
<hr>
<p>
Maintained by <a href="https://twitter.com/_garethtdavies">@_garethtdavies</a>; modified by: <a href="https://github.com/mdr0id">mdr0id</a>;license of the docs is MIT (see <a href="https://github.com/zcash/zcash">zcash repo</a>), license of the scripts and webpage is also MIT (<a href="https://github.com/zcash-rpc/zcash-rpc.github.io">github repo</a>)
</p>
<p>
Note it uses a mainnet zcash node
</p>
</div>
<div class="col-4 col-lg-3 col-xl-2">
<div class="card">
<div class="card-header">
Addressindex
</div>
<div class="card-body">
<a href="getaddressbalance.html">getaddressbalance</a>
<br>
<a href="getaddressdeltas.html">getaddressdeltas</a>
<br>
<a href="getaddressmempool.html">getaddressmempool</a>
<br>
<a href="getaddresstxids.html">getaddresstxids</a>
<br>
<a href="getaddressutxos.html">getaddressutxos</a>
<br>
</div>
</div>
<br>
<div class="card">
<div class="card-header">
Blockchain
</div>
<div class="card-body">
<a href="getbestblockhash.html">getbestblockhash</a>
<br>
<a href="getblock.html">getblock</a>
<br>
<a href="getblockchaininfo.html">getblockchaininfo</a>
<br>
<a href="getblockcount.html">getblockcount</a>
<br>
<a href="getblockdeltas.html">getblockdeltas</a>
<br>
<a href="getblockhash.html">getblockhash</a>
<br>
<a href="getblockhashes.html">getblockhashes</a>
<br>
<a href="getblockheader.html">getblockheader</a>
<br>
<a href="getchaintips.html">getchaintips</a>
<br>
<a href="getdifficulty.html">getdifficulty</a>
<br>
<a href="getmempoolinfo.html">getmempoolinfo</a>
<br>
<a href="getrawmempool.html">getrawmempool</a>
<br>
<a href="getspentinfo.html">getspentinfo</a>
<br>
<a href="gettxout.html">gettxout</a>
<br>
<a href="gettxoutproof.html">gettxoutproof</a>
<br>
<a href="gettxoutsetinfo.html">gettxoutsetinfo</a>
<br>
<a href="verifychain.html">verifychain</a>
<br>
<a href="verifytxoutproof.html">verifytxoutproof</a>
<br>
<a href="z_gettreestate.html">z_gettreestate</a>
<br>
</div>
</div>
<br>
<div class="card">
<div class="card-header">
Control
</div>
<div class="card-body">
<a href="getexperimentalfeatures.html">getexperimentalfeatures</a>
<br>
<a href="getinfo.html">getinfo</a>
<br>
<a href="getmemoryinfo.html">getmemoryinfo</a>
<br>
<a href="help.html">help</a>
<br>
<a href="setlogfilter.html">setlogfilter</a>
<br>
<a href="stop.html">stop</a>
<br>
</div>
</div>
<br>
<div class="card">
<div class="card-header">
Disclosure
</div>
<div class="card-body">
<a href="z_getpaymentdisclosure.html">z_getpaymentdisclosure</a>
<br>
<a href="z_validatepaymentdisclosure.html">z_validatepaymentdisclosure</a>
<br>
</div>
</div>
<br>
<div class="card">
<div class="card-header">
Generating
</div>
<div class="card-body">
<a href="generate.html">generate</a>
<br>
<a href="getgenerate.html">getgenerate</a>
<br>
<a href="setgenerate.html">setgenerate</a>
<br>
</div>
</div>
<br>
<div class="card">
<div class="card-header">
Mining
</div>
<div class="card-body">
<a href="getblocksubsidy.html">getblocksubsidy</a>
<br>
<a href="getblocktemplate.html">getblocktemplate</a>
<br>
<a href="getlocalsolps.html">getlocalsolps</a>
<br>
<a href="getmininginfo.html">getmininginfo</a>
<br>
<a href="getnetworkhashps.html">getnetworkhashps</a>
<br>
<a href="getnetworksolps.html">getnetworksolps</a>
<br>
<a href="prioritisetransaction.html">prioritisetransaction</a>
<br>
<a href="submitblock.html">submitblock</a>
<br>
</div>
</div>
<br>
<div class="card">
<div class="card-header">
Network
</div>
<div class="card-body">
<a href="addnode.html">addnode</a>
<br>
<a href="clearbanned.html">clearbanned</a>
<br>
<a href="disconnectnode.html">disconnectnode</a>
<br>
<a href="getaddednodeinfo.html">getaddednodeinfo</a>
<br>
<a href="getconnectioncount.html">getconnectioncount</a>
<br>
<a href="getdeprecationinfo.html">getdeprecationinfo</a>
<br>
<a href="getnettotals.html">getnettotals</a>
<br>
<a href="getnetworkinfo.html">getnetworkinfo</a>
<br>
<a href="getpeerinfo.html">getpeerinfo</a>
<br>
<a href="listbanned.html">listbanned</a>
<br>
<a href="ping.html">ping</a>
<br>
<a href="setban.html">setban</a>
<br>
</div>
</div>
<br>
<div class="card">
<div class="card-header">
Rawtransactions
</div>
<div class="card-body">
<a href="createrawtransaction.html">createrawtransaction</a>
<br>
<a href="decoderawtransaction.html">decoderawtransaction</a>
<br>
<a href="decodescript.html">decodescript</a>
<br>
<a href="fundrawtransaction.html">fundrawtransaction</a>
<br>
<a href="getrawtransaction.html">getrawtransaction</a>
<br>
<a href="sendrawtransaction.html">sendrawtransaction</a>
<br>
<a href="signrawtransaction.html">signrawtransaction</a>
<br>
</div>
</div>
<br>
<div class="card">
<div class="card-header">
Util
</div>
<div class="card-body">
<a href="createmultisig.html">createmultisig</a>
<br>
<a href="estimatefee.html">estimatefee</a>
<br>
<a href="validateaddress.html">validateaddress</a>
<br>
<a href="verifymessage.html">verifymessage</a>
<br>
<a href="z_validateaddress.html">z_validateaddress</a>
<br>
</div>
</div>
<br>
<div class="card">
<div class="card-header">
Wallet
</div>
<div class="card-body">
<a href="addmultisigaddress.html">addmultisigaddress</a>
<br>
<a href="backupwallet.html">backupwallet</a>
<br>
<a href="dumpprivkey.html">dumpprivkey</a>
<br>
<a href="encryptwallet.html">encryptwallet</a>
<br>
<a href="getbalance.html">getbalance</a>
<br>
<a href="getnewaddress.html">getnewaddress</a>
<br>
<a href="getrawchangeaddress.html">getrawchangeaddress</a>
<br>
<a href="getreceivedbyaddress.html">getreceivedbyaddress</a>
<br>
<a href="gettransaction.html">gettransaction</a>
<br>
<a href="getunconfirmedbalance.html">getunconfirmedbalance</a>
<br>
<a href="getwalletinfo.html">getwalletinfo</a>
<br>
<a href="importaddress.html">importaddress</a>
<br>
<a href="importprivkey.html">importprivkey</a>
<br>
<a href="importpubkey.html">importpubkey</a>
<br>
<a href="importwallet.html">importwallet</a>
<br>
<a href="keypoolrefill.html">keypoolrefill</a>
<br>
<a href="listaddresses.html">listaddresses</a>
<br>
<a href="listaddressgroupings.html">listaddressgroupings</a>
<br>
<a href="listlockunspent.html">listlockunspent</a>
<br>
<a href="listreceivedbyaddress.html">listreceivedbyaddress</a>
<br>
<a href="listsinceblock.html">listsinceblock</a>
<br>
<a href="listtransactions.html">listtransactions</a>
<br>
<a href="listunspent.html">listunspent</a>
<br>
<a href="lockunspent.html">lockunspent</a>
<br>
<a href="sendmany.html">sendmany</a>
<br>
<a href="sendtoaddress.html">sendtoaddress</a>
<br>
<a href="settxfee.html">settxfee</a>
<br>
<a href="signmessage.html">signmessage</a>
<br>
<a href="walletconfirmbackup.html">walletconfirmbackup</a>
<br>
<a href="z_exportkey.html">z_exportkey</a>
<br>
<a href="z_exportviewingkey.html">z_exportviewingkey</a>
<br>
<a href="z_exportwallet.html">z_exportwallet</a>
<br>
<a href="z_getaddressforaccount.html">z_getaddressforaccount</a>
<br>
<a href="z_getbalance.html">z_getbalance</a>
<br>
<a href="z_getbalanceforaccount.html">z_getbalanceforaccount</a>
<br>
<a href="z_getbalanceforviewingkey.html">z_getbalanceforviewingkey</a>
<br>
<a href="z_getmigrationstatus.html">z_getmigrationstatus</a>
<br>
<a href="z_getnewaccount.html">z_getnewaccount</a>
<br>
<a href="z_getnewaddress.html">z_getnewaddress</a>
<br>
<a href="z_getnotescount.html">z_getnotescount</a>
<br>
<a href="z_getoperationresult.html">z_getoperationresult</a>
<br>
<a href="z_getoperationstatus.html">z_getoperationstatus</a>
<br>
<a href="z_gettotalbalance.html">z_gettotalbalance</a>
<br>
<a href="z_importkey.html">z_importkey</a>
<br>
<a href="z_importviewingkey.html">z_importviewingkey</a>
<br>
<a href="z_importwallet.html">z_importwallet</a>
<br>
<a href="z_listaccounts.html">z_listaccounts</a>
<br>
<a href="z_listaddresses.html">z_listaddresses</a>
<br>
<a href="z_listoperationids.html">z_listoperationids</a>
<br>
<a href="z_listreceivedbyaddress.html">z_listreceivedbyaddress</a>
<br>
<a href="z_listunifiedreceivers.html">z_listunifiedreceivers</a>
<br>
<a href="z_listunspent.html">z_listunspent</a>
<br>
<a href="z_mergetoaddress.html">z_mergetoaddress</a>
<br>
<a href="z_sendmany.html">z_sendmany</a>
<br>
<a href="z_setmigration.html">z_setmigration</a>
<br>
<a href="z_shieldcoinbase.html">z_shieldcoinbase</a>
<br>
<a href="z_viewtransaction.html">z_viewtransaction</a>
<br>
<a href="zcbenchmark.html">zcbenchmark</a>
<br>
<a href="zcsamplejoinsplit.html">zcsamplejoinsplit</a>
<br>
</div>
</div>
<br>
</div>
</div>
</main>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink