diff --git a/_autocrossref.yaml b/_autocrossref.yaml index 64dd8e44..82623ffa 100644 --- a/_autocrossref.yaml +++ b/_autocrossref.yaml @@ -421,6 +421,8 @@ DIP8: '`getpeerinfo` RPC': rpc getpeerinfo '`getpoolinfo`': rpc getpoolinfo '`getpoolinfo` RPC': rpc getpoolinfo +'`getprivatesendinfo`': rpc getprivatesendinfo +'`getprivatesendinfo` RPC': rpc getprivatesendinfo '`getrawchangeaddress`': rpc getrawchangeaddress '`getrawchangeaddress` RPC': rpc getrawchangeaddress '`getrawmempool`': rpc getrawmempool diff --git a/_config.yml b/_config.yml index d991f44a..8724336d 100644 --- a/_config.yml +++ b/_config.yml @@ -232,6 +232,7 @@ devsearches: - 'GetNewAddress': "/en/developer-reference#getnewaddress" - 'GetPeerInfo': "/en/developer-reference#getpeerinfo" - 'GetPoolInfo': "/en/developer-reference#getpoolinfo" + - 'GetPrivateSendInfo': "/en/developer-reference#getprivatesendinfo" - 'GetRawChangeAddress': "/en/developer-reference#getrawchangeaddress" - 'GetRawMempool': "/en/developer-reference#getrawmempool" - 'GetRawTransaction': "/en/developer-reference#getrawtransaction" diff --git a/_includes/devdoc/dash-core/rpcs/quick-reference.md b/_includes/devdoc/dash-core/rpcs/quick-reference.md index 73040edd..a80dddfe 100644 --- a/_includes/devdoc/dash-core/rpcs/quick-reference.md +++ b/_includes/devdoc/dash-core/rpcs/quick-reference.md @@ -170,7 +170,8 @@ These RPCs are all Dash-specific and not found in Bitcoin Core {% autocrossref %} * [GetGovernanceInfo][rpc getgovernanceinfo]: {{summary_getGovernanceInfo}} {{DASH_UPDATED0_14_0}} -* [GetPoolInfo][rpc getpoolinfo]: {{summary_getPoolInfo}} +* [GetPoolInfo][rpc getpoolinfo]: {{summary_getPoolInfo}} {{DEPRECATED}} +* [GetPrivateSendInfo][rpc getprivatesendinfo]: {{summary_getPrivateSend}} {{DASH_NEW0_14_1}} * [GetSuperblockBudget][rpc getsuperblockbudget]: {{summary_getSuperblockBudget}} * [GObject][rpc gobject]: {{summary_gObject}} {{DASH_UPDATED0_14_1}} * [Masternode][rpc masternode]: {{summary_masternode}} {{DASH_UPDATED0_14_0}} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getprivatesendinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getprivatesendinfo.md new file mode 100644 index 00000000..5bf7bd8a --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getprivatesendinfo.md @@ -0,0 +1,197 @@ +{% comment %} +This file is licensed under the MIT License (MIT) available on +http://opensource.org/licenses/MIT. +{% endcomment %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getprivatesendinfo.md" %} + + + +##### GetPrivateSendInfo +{% include helpers/subhead-links.md %} + +{% assign summary_getPrivateSendInfo="returns an object containing an information about PrivateSend settings and state." %} + +{% autocrossref %} + +The `getprivatesendinfo` RPC {{summary_getPrivateSendInfo}} + +*Parameters: none* + +*Result---(for regular nodes) information about the mixing pool* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "object" + p: "Required
(exactly 1)" + d: "Information about the mixing pool" + +- n: "→
`enabled`" + t: "bool" + p: "Required
(exactly 1)" + d: "Whether mixing functionality is enabled" + +- n: "→
`running`" + t: "bool" + p: "Required
(exactly 1)" + d: "Whether mixing is currently running" + +- n: "→
`multisession`" + t: "bool" + p: "Required
(exactly 1)" + d: "Whether PrivateSend Multisession option is enabled" + +- n: "→
`max_sessions`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "How many parallel mixing sessions can there be at once" + +- n: "→
`max_rounds`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "How many rounds to mix" + +- n: "→
`max_amount`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "How many DASH to keep anonymized" + +- n: "→
`max_denoms`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "How many inputs of each denominated amount to create" + +- n: "→
`queue_size`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "How many queues there are currently on the network" + +- n: "→
`sessions`" + t: "array of json objects" + p: "Required
(exactly 1)" + d: "Information about session(s)" + +- n: "→ →
Session" + t: "object" + p: "Optional
(1 or more)" + d: "Information for a session" + +- n: "→ → →
`protxhash`" + t: "string" + p: "Required
(exactly 1)" + d: "The ProTxHash of the masternode" + +- n: "→ → →
`outpoint`" + t: "string (txid-index)" + p: "Required
(exactly 1)" + d: "The outpoint of the masternode" + +- n: "→ → →
`service`" + t: "string (host:port)" + p: "Required
(exactly 1)" + d: "The IP address and port of the masternode" + +- n: "→ → →
`denomination`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The denomination of the mixing session in DASH" + +- n: "→ → →
`state`" + t: "string" + p: "Required
(exactly 1)" + d: "Current state of the mixing session" + +- n: "→ → →
`entries_count`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The number of entries in the mixing session" + +- n: "→
`keys_left`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "How many new keys are left since last automatic backup" + +- n: "→
`warnings`" + t: "string" + p: "Optional
(exactly 1)" + d: "Any warnings" +{% enditemplate %} + +*Result---(for masternodes) information about the mixing pool* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "object" + p: "Required
(exactly 1)" + d: "Information about the mixing pool" + +- n: "→
`queue_size`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "How many queues there are currently on the network" + +- n: "→
`denomination`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The denomination of the mixing session in DASH" + +- n: "→
`state`" + t: "string" + p: "Required
(exactly 1)" + d: "Current state of the mixing session" + +- n: "→
`entries_count`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The number of entries in the mixing session" + +{% enditemplate %} + + +*Example from Dash Core 0.14.1* + +{% highlight bash %} +dash-cli -testnet getprivatesendinfo +{% endhighlight %} + +Result: +{% highlight json %} +{ + "enabled": true, + "running": true, + "multisession": true, + "max_sessions": 4, + "max_rounds": 4, + "max_amount": 2000, + "max_denoms": 300, + "queue_size": 2, + "sessions": [ + { + "denomination": 0.00000000, + "state": "ERROR", + "entries_count": 0 + }, + { + "protxhash": "7d336336b7e8910f518b2b270c6d72a2d7fc05aec3c6720108da80805ffc3aab", + "outpoint": "7d336336b7e8910f518b2b270c6d72a2d7fc05aec3c6720108da80805ffc3aab-1", + "service": "34.241.93.160:26039", + "denomination": 0.10000100, + "state": "QUEUE", + "entries_count": 0 + }, + { + "protxhash": "11eabc1e72394af02bbe86815975d054816fe69006fdc64c6d7a06b585e5c311", + "outpoint": "ee7741bac62cb468c09c00e7a78148064db9da781d183a8f23c7beef9ed569d6-0", + "service": "95.183.53.17:10004", + "denomination": 10.00010000, + "state": "QUEUE", + "entries_count": 0 + } + ], + "keys_left": 996, + "warnings": "" +} +{% endhighlight %} + +*See also: none* + +{% endautocrossref %} diff --git a/_includes/helpers/summaries.md b/_includes/helpers/summaries.md index 52cfbbb6..ebcf37f0 100644 --- a/_includes/helpers/summaries.md +++ b/_includes/helpers/summaries.md @@ -68,6 +68,7 @@ This file is licensed under the terms of its source texts{%endcomment%} {% assign summary_getNewAddress="returns a new Dash address for receiving payments. If an account is specified, payments received with the address will be credited to that account." %} {% assign summary_getPeerInfo="returns data about each connected network node." %} {% assign summary_getPoolInfo="returns an object containing mixing pool related information." %} +{% assign summary_getPrivateSendInfo="returns an object containing an information about PrivateSend settings and state." %} {% assign summary_getRawChangeAddress="returns a new Dash address for receiving change. This is for use with raw transactions, not normal use." %} {% assign summary_getRawMemPool="returns all transaction identifiers (TXIDs) in the memory pool as a JSON array, or detailed information about each transaction in the memory pool as a JSON object." %} {% assign summary_getRawTransaction="gets a hex-encoded serialized transaction or a JSON object describing the transaction. By default, Dash Core only stores complete transaction data for UTXOs and your own transactions, so the RPC may fail on historic transactions unless you use the non-default `txindex=1` in your Dash Core startup settings." %} diff --git a/_includes/layout/base/rpc-table.html b/_includes/layout/base/rpc-table.html index d27f26b9..6628c0e9 100644 --- a/_includes/layout/base/rpc-table.html +++ b/_includes/layout/base/rpc-table.html @@ -277,6 +277,12 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header:: Y + + Dash + GetPrivateSendInfo + Y + Added in 0.14.1 + Dash GetSuperblockBudget diff --git a/_includes/references.md b/_includes/references.md index c9c2edcb..014455d5 100644 --- a/_includes/references.md +++ b/_includes/references.md @@ -135,6 +135,7 @@ http://opensource.org/licenses/MIT. [rpc getnewaddress]: /en/developer-reference#getnewaddress [rpc getpeerinfo]: /en/developer-reference#getpeerinfo [rpc getpoolinfo]: /en/developer-reference#getpoolinfo +[rpc getprivatesendinfo]: /en/developer-reference#getprivatesendinfo [rpc getrawchangeaddress]: /en/developer-reference#getrawchangeaddress [rpc getrawmempool]: /en/developer-reference#getrawmempool [rpc getrawtransaction]: /en/developer-reference#getrawtransaction diff --git a/en/developer-reference.md b/en/developer-reference.md index e96aa590..7487ffda 100644 --- a/en/developer-reference.md +++ b/en/developer-reference.md @@ -204,6 +204,8 @@ untrusted source. {% include devdoc/dash-core/rpcs/rpcs/getpoolinfo.md %} +{% include devdoc/dash-core/rpcs/rpcs/getprivatesendinfo.md %} + {% include devdoc/dash-core/rpcs/rpcs/getrawchangeaddress.md %} {% include devdoc/dash-core/rpcs/rpcs/getrawmempool.md %}