content - Added and update RPCs

- Debug, estimatepriority, estimatesmartpriority, listunspent, signmessagewithprivkey, validateaddress - Update Ref and Table
2025-07-27 09:46:12 +00:00 · 2018-02-22 12:59:09 -05:00 · 2018-02-22 12:59:09 -05:00 · 6fd303cd3d
commit 6fd303cd3d
parent c242090504
8 changed files with 61 additions and 42 deletions
--- a/_includes/devdoc/dash-core/rpcs/quick-reference.md
+++ b/_includes/devdoc/dash-core/rpcs/quick-reference.md
@ -234,10 +234,11 @@ These RPCs are all Dash-specific and not found in Bitcoin Core

 * [CreateMultiSig][rpc createmultisig]: {{summary_createMultiSig}}
 * [EstimateFee][rpc estimatefee]: {{summary_estimateFee}}
-* [EstimatePriority][rpc estimatepriority]: {{summary_estimatePriority}}
+* [EstimatePriority][rpc estimatepriority]: {{summary_estimatePriority}} {{DEPRECATED}}
 * [EstimateSmartFee][rpc estimatesmartfee]: {{summary_estimateSmartFee}} {{DEPRECATED}}
 * [EstimateSmartPriority][rpc estimatesmartpriority]: {{summary_estimateSmartPriority}} {{DEPRECATED}}
-* [ValidateAddress][rpc validateaddress]: {{summary_validateAddress}} {{UPDATED0_13_0}}
+* [SignMessageWithPrivKey][rpc signmessagewithprivkey]: {{summary_signMessageWithPrivKey}}  {{DASH_NEW0_12_3}} {{NEW0_13_0}}
+* [ValidateAddress][rpc validateaddress]: {{summary_validateAddress}} {{DASH_UPDATED0_12_3}} {{UPDATED0_13_0}}
 * [VerifyMessage][rpc verifymessage]: {{summary_verifyMessage}}

 {% endautocrossref %}
@ -285,7 +286,7 @@ default.
 * [ListReceivedByAddress][rpc listreceivedbyaddress]: {{summary_listReceivedByAddress}}
 * [ListSinceBlock][rpc listsinceblock]: {{summary_listSinceBlock}}
 * [ListTransactions][rpc listtransactions]: {{summary_listTransactions}} {{UPDATED0_12_1}}
-* [ListUnspent][rpc listunspent]: {{summary_listUnspent}} {{UPDATED0_13_0}}
+* [ListUnspent][rpc listunspent]: {{summary_listUnspent}} {{DASH_UPDATED0_12_3}} {{UPDATED0_13_0}}
 * [LockUnspent][rpc lockunspent]: {{summary_lockUnspent}}
 * [Move][rpc move]: {{summary_move}} {{DEPRECATED}}
 * [SendFrom][rpc sendfrom]: {{summary_sendFrom}} {{DEPRECATED}}
@ -303,7 +304,6 @@ default.
 * {{DASH_NOT_IMPLEMENTED}}  [ImportMulti][rpc importmulti]: {{summary_importMulti}} {{NEW0_14_0}}
 * {{DASH_NOT_IMPLEMENTED}}  [ImportPrunedFunds][rpc importprunedfunds]: {{summary_importPrunedFunds}} {{NEW0_13_0}}
 * {{DASH_NOT_IMPLEMENTED}}  [RemovePrunedFunds][rpc removeprunedfunds]: {{summary_removePrunedFunds}} {{NEW0_13_0}}
-* {{DASH_NOT_IMPLEMENTED}}  [SignMessageWithPrivKey][rpc signmessagewithprivkey]: {{summary_signMessageWithPrivKey}}  {{NEW0_13_0}}

 {% endautocrossref %}

--- a/_includes/devdoc/dash-core/rpcs/rpcs/debug.md
+++ b/_includes/devdoc/dash-core/rpcs/rpcs/debug.md
@ -19,7 +19,7 @@ The `debug` RPC {{summary_debug}}
 - n: "Debug category"
  t: "string"
  p: "Required<br>(1 or more)"
-  d: "The debug category to activate. Use a comma to specify multiple categories. Categories will be one of the following:<br>• `0` - Disables all categories <br>• `1` - Enables all categories <br>• `addrman` <br>• `alert` <br>• `bench` <br>• `coindb` <br>• `db` <br>• `lock` <br>• `rand` <br>• `rpc` <br>• `selectcoins` <br>• `mempool` <br>• `mempoolrej` <br>• `net` <br>• `proxy` <br>• `prune` <br>• `http` <br>• `libevent` <br>• `tor` <br>• `zmq` <br>• `dash` <br>• `privatesend` <br>• `instantsend` <br>• `masternode` <br>• `spork` <br>• `keepass` <br>• `mnpayments` <br>• `gobject` <br>"
+  d: "The debug category to activate. Use a `+` to specify multiple categories. Categories will be one of the following:<br>• `0` - Disables all categories <br>• `1` - Enables all categories <br>• `addrman` <br>• `alert` <br>• `bench` <br>• `coindb` <br>• `db` <br>• `lock` <br>• `rand` <br>• `rpc` <br>• `selectcoins` <br>• `mempool` <br>• `mempoolrej` <br>• `net` <br>• `proxy` <br>• `prune` <br>• `http` <br>• `libevent` <br>• `tor` <br>• `zmq` <br>• `dash` <br>• `privatesend` <br>• `instantsend` <br>• `masternode` <br>• `spork` <br>• `keepass` <br>• `mnpayments` <br>• `gobject` <br>"

 {% enditemplate %}

--- a/_includes/devdoc/dash-core/rpcs/rpcs/estimatepriority.md
+++ b/_includes/devdoc/dash-core/rpcs/rpcs/estimatepriority.md
@ -7,6 +7,8 @@ http://opensource.org/licenses/MIT.
 ##### EstimatePriority
 {% include helpers/subhead-links.md %}

+<!-- __ -->
+
 {% autocrossref %}

 {% assign summary_estimatePriority="estimates the priority that a transaction needs in order to be included within a certain number of blocks as a free high-priority transaction." %}
@ -15,7 +17,7 @@ http://opensource.org/licenses/MIT.

 The `estimatepriority` RPC {{summary_estimatePriority}} This should not to be confused with the `prioritisetransaction` RPC which will remain supported for adding fee deltas to transactions.

-{{WARNING}} `estimatepriority` has been [removed from Bitcoin](https://github.com/bitcoin/bitcoin/commit/fe282acd7604b5265762b24e531bdf1ebb1f009b) and will no longer be available in the next major release (planned for Bitcoin Core 0.15.0). Still present in Dash Core.
+{{WARNING}} `estimatepriority` has been [removed from Bitcoin](https://github.com/bitcoin/bitcoin/commit/fe282acd7604b5265762b24e531bdf1ebb1f009b). While still present in Dash Core, it is deprecated as of 0.12.3 (should be considered unstable and will disappear in the future). Use the RPC listed in the "See Also" subsection below instead.

 Transaction priority is relative to a transaction's byte size.

--- a/_includes/devdoc/dash-core/rpcs/rpcs/estimatesmartpriority.md
+++ b/_includes/devdoc/dash-core/rpcs/rpcs/estimatesmartpriority.md
@ -7,13 +7,15 @@ http://opensource.org/licenses/MIT.
 ##### EstimateSmartPriority
 {% include helpers/subhead-links.md %}

+<!-- __ -->
+
 {% autocrossref %}

 {% assign summary_estimateSmartPriority="estimates the priority that a transaction needs in order to be included within a certain number of blocks as a free high-priority transaction and returns the number of blocks for which the estimate is valid." %}

 The `estimatesmartpriority` RPC {{summary_estimateSmartPriority}} This should not to be confused with the `prioritisetransaction` RPC which will remain supported for adding fee deltas to transactions.

-{{WARNING}} `estimatesmartpriority` has been [removed from Bitcoin](https://github.com/bitcoin/bitcoin/commit/fe282acd7604b5265762b24e531bdf1ebb1f009b) and will no longer be available in the next major release (planned for Bitcoin Core 0.15.0). While still present in Dash Core, the interface should be considered unstable and may disappear or change. Use the RPC listed in the "See Also" subsection below instead.
+{{WARNING}} `estimatesmartpriority` has been [removed from Bitcoin](https://github.com/bitcoin/bitcoin/commit/fe282acd7604b5265762b24e531bdf1ebb1f009b). While still present in Dash Core, it is deprecated as of 0.12.3 (should be considered unstable and will disappear in the future). Use the RPC listed in the "See Also" subsection below instead.

 Transaction priority is relative to a transaction's byte size.

--- a/_includes/devdoc/dash-core/rpcs/rpcs/listunspent.md
+++ b/_includes/devdoc/dash-core/rpcs/rpcs/listunspent.md
@ -54,6 +54,17 @@ the *spendable* field in the results described below.

 {% enditemplate %}

+*Parameter #4---include unsafe outputs*
+
+{% itemplate ntpd1 %}
+- n: "Include Unsafe"
+  t: "bool"
+  p: "Optional<br>(false or true)"
+  d: "Include outputs that are not safe to spend because they come from unconfirmed untrusted transactions or unconfirmed replacement transactions (cases where we are less sure that a conflicting transaction won't be mined).  Default is `true`"
+
+{% enditemplate %}
+
+
 *Result---the list of unspent outputs*

 {% itemplate ntpd1 %}
@ -107,11 +118,6 @@ the *spendable* field in the results described below.
  p: "Required<br>(exactly 1)"
  d: "The number of confirmations received for the transaction containing this output"

- n: "→ →<br>`ps_rounds`"
-  t: "number (int)"
-  p: "Required<br>(exactly 1)"
-  d: "The number of PrivateSend rounds"
-
 - n: "→ →<br>`spendable`"
  t: "bool"
  p: "Required<br>(exactly 1)"
@ -122,9 +128,14 @@ the *spendable* field in the results described below.
  p: "Required<br>(exactly 1)"
  d: "*Added in Bitcoin Core 0.13.0*<br><br>Set to `true` if the wallet knows how to spend this output.  Set to `false` if the wallet does not know how to spend the output.  It is ignored if the private keys are available "

+- n: "→ →<br>`ps_rounds`"
+  t: "number (int)"
+  p: "Required<br>(exactly 1)"
+  d: "The number of PrivateSend rounds"
+
 {% enditemplate %}

-*Example from Dash Core 0.12.2*
+*Example from Dash Core 0.12.3*

 Get all outputs confirmed at least 6 times for a particular
 address:
@ -132,7 +143,7 @@ address:
 {% highlight bash %}
 dash-cli -testnet listunspent 6 99999999 '''
  [
-    "yTQNnbby2yhxoK1UtL9E5J9epGtkAoFWSm"
+    "yXGNabkdQ3JZ7LZ9RCnFe5dqhtBA3hVmU8"
  ]
 '''
 {% endhighlight %}
@ -142,15 +153,15 @@ Result:
 {% highlight json %}
 [
  {
-    "txid": "52e34eec71a4cf95c043b76567f55cec1bc293c444810d454a2d05f2a819b5ed",
-    "vout": 3,
-    "address": "yTQNnbby2yhxoK1UtL9E5J9epGtkAoFWSm",
-    "scriptPubKey": "76a9144db791c2388be4716f048be2648bafe1944f787688ac",
+    "txid": "0e86f58c56648175362443c1ef28e473acb4c4adc1b3f7983deaddfa3a61a4d7",
+    "vout": 4,
+    "address": "yXGNabkdQ3JZ7LZ9RCnFe5dqhtBA3hVmU8",
+    "scriptPubKey": "76a91478149277b5d820b04e60cbf96ff81fd1ccc6533388ac",
    "amount": 0.01000010,
-    "confirmations": 113,
-    "ps_rounds": 4,
+    "confirmations": 609,
    "spendable": true,
-    "solvable": true
+    "solvable": true,
+    "ps_rounds": 5
  }
 ]
 {% endhighlight %}
--- a/_includes/devdoc/dash-core/rpcs/rpcs/signmessagewithprivkey.md
+++ b/_includes/devdoc/dash-core/rpcs/rpcs/signmessagewithprivkey.md
@ -9,19 +9,18 @@ http://opensource.org/licenses/MIT.

 {% assign summary_signMessageWithPrivKey="signs a message with a given private key." %}

+<!-- __ -->
+
 {% autocrossref %}

-*Added in Bitcoin Core 0.13.0*
+*Added in Dash Core 0.12.3 / Bitcoin Core 0.13.0*

-{{WARNING_ICON}} **_Not implemented in Dash Core (as of 0.12.2)_**
-
-{% comment %}
 The `signmessagewithprivkey` RPC {{summary_signMessageWithPrivKey}}

 *Parameter #1---the private key to sign with*

 {% itemplate ntpd1 %}
- n: "Privat Key"
+- n: "Private Key"
  t: "string (base58)"
  p: "Required<br>(exactly 1)"
  d: "The private key to sign the message with encoded in base58check using wallet import format (WIF)"
@ -44,23 +43,23 @@ The `signmessagewithprivkey` RPC {{summary_signMessageWithPrivKey}}
 - n: "`result`"
  t: "string (base64)"
  p: "Required<br>(exactly 1)"
-  d: "The signature of the message, encoded in base64.  Note that Bitcoin Core before 0.10.0 creates signatures with random *k* values, so each time you sign the same message, it will create a different signature"
+  d: "The signature of the message, encoded in base64."

 {% enditemplate %}

-*Example from Bitcoin Core 0.13.1*
+*Example from Dash Core 0.12.3*

 Sign a the message "Hello, World!" using the following private key:

 {% highlight bash %}
-bitcoin-cli signmessagewithprivkey 5HpHagT65TZzG1PH3CSu63k8DbpvD\
-8s5ip4nEB3kEsreKamq6aB "Hello, World!"
+dash-cli signmessagewithprivkey cNKbZBqUCjuBRSnAJWwFWxKESJ5Lw\
+G4uxBSJ1UeBNBGVRupFKr6S "Hello, World!"
 {% endhighlight %}

 Result:

 {% highlight text %}
-G+ZauMFgQExAJRKZSldbAVEaZo4i0p2AVivbFASo50PkUnynAMDUiNMVdXDlpYMWvatxCmYmLn8C9zygPRn3Y1c=
+IBx8jxFjutPlcZcFdQPlA2n/B4yTrYhH43qYJURKRj7LWhSD0ERE/nnRLOnXi/gwULUcqfqOKqnqkSvuJjlgEvc=
 {% endhighlight %}

 *See also*
@ -68,6 +67,4 @@ G+ZauMFgQExAJRKZSldbAVEaZo4i0p2AVivbFASo50PkUnynAMDUiNMVdXDlpYMWvatxCmYmLn8C9zyg
 * [SignMessage][rpc signmessage]: {{summary_signMessage}}
 * [VerifyMessage][rpc verifymessage]: {{summary_verifyMessage}}

-{% endcomment %}
-
 {% endautocrossref %}
--- a/_includes/devdoc/dash-core/rpcs/rpcs/validateaddress.md
+++ b/_includes/devdoc/dash-core/rpcs/rpcs/validateaddress.md
@ -101,6 +101,11 @@ The `validateaddress` RPC {{summary_validateAddress}}
  p: "Optional<br>(0 or 1)"
  d: "*Deprecated: will be removed in a later version of Bitcoin Core*<br><br>The account this address belong to.  May be an empty string for the default account.  Only returned if the address belongs to the wallet"

+- n: "→<br>`timestamp`"
+  t: "number (int)"
+  p: "Optional<br>(0 or 1)"
+  d: "*Added in Dash Core 0.12.3*<br><br>The creation time of the key if available in seconds since epoch (Jan 1 1970 GMT)"
+
 - n: "→<br>`hdkeypath`"
  t: "string"
  p: "Optional<br>(0 or 1)"
@ -113,7 +118,7 @@ The `validateaddress` RPC {{summary_validateAddress}}

 {% enditemplate %}

-*Example from Dash Core 0.12.2*
+*Example from Dash Core 0.12.3*

 Validate the following P2PKH address from the wallet:

@ -133,7 +138,8 @@ Result:
  "isscript": false,
  "pubkey": "02eacba539d92eb88d4e73bb32749d79f53f6e8d7947ac40a71bd4b26c13b6ec29",
  "iscompressed": true,
-  "account": "Test"
+  "account": "Msig 1",
+  "timestamp": 0
 }
 {% endhighlight %}

@ -162,6 +168,7 @@ Result:
  ],
  "sigsrequired": 2,
  "account": "test account"
+  "timestamp": 0  
 }
 {% endhighlight %}

--- a/_includes/layout/base/rpc-table.html
+++ b/_includes/layout/base/rpc-table.html
@ -389,7 +389,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::
    <td class="tg-yw4l">Network</td>
    <td class="tg-yw4l"><a href="#getnetworkinfo">GetNetworkInfo</a></td>
    <td class="tg-baqh">Y</td>
-    <td class="tg-baqh"></td>
+    <td class="tg-baqh">Updated in 0.12.3.0</td>
  </tr>
  <tr>
    <td class="tg-b7b8">Network</td>
@ -491,7 +491,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::
    <td class="tg-b7b8">Util</td>
    <td class="tg-b7b8"><a href="#estimatepriority">EstimatePriority</a></td>
    <td class="tg-dzk6">Y</td>
-    <td class="tg-dzk6"></td>
+    <td class="tg-dzk6">Deprecated in 0.12.3.0</td>
  </tr>
  <tr>
    <td class="tg-yw4l">Util</td>
@ -503,7 +503,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::
    <td class="tg-b7b8">Util</td>
    <td class="tg-b7b8"><a href="#estimatesmartpriority">EstimateSmartPriority</a></td>
    <td class="tg-dzk6">Y</td>
-    <td class="tg-dzk6"></td>
+    <td class="tg-dzk6">Deprecated in 0.12.3.0</td>
  </tr>
  <tr>
    <td class="tg-yw4l">Util</td>
@ -515,7 +515,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::
    <td class="tg-b7b8">Util</td>
    <td class="tg-b7b8"><a href="#validateaddress">ValidateAddress</a></td>
    <td class="tg-dzk6">Y</td>
-    <td class="tg-dzk6"></td>
+    <td class="tg-dzk6">Updated in 0.12.3.0</td>
  </tr>
  <tr>
    <td class="tg-yw4l">Util</td>
@ -749,7 +749,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::
    <td class="tg-yw4l">Wallet</td>
    <td class="tg-yw4l"><a href="#listunspent">ListUnspent</a></td>
    <td class="tg-baqh">Y</td>
-    <td class="tg-baqh"></td>
+    <td class="tg-baqh">Updated in 0.12.3.0</td>
  </tr>
  <tr>
    <td class="tg-b7b8">Wallet</td>
@ -808,8 +808,8 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::
  <tr>
    <td class="tg-yw4l">Wallet</td>
    <td class="tg-yw4l"><a href="#signmessagewithprivkey">SignMessageWithPrivKey</a></td>
-    <td class="tg-baqh">N</td>
-    <td class="tg-baqh">N/A</td>
+    <td class="tg-baqh">Y</td>
+    <td class="tg-baqh">0.12.3.0+</td>
  </tr>
  <tr>
    <td class="tg-b7b8">Wallet</td>