{% translate getstarted layout %}*Updated in Bitcoin Core 0.14.1*" diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/estimatepriority.md b/_includes/devdoc/dash-core/rpcs/rpcs/estimatepriority.md index 570d3243..9f5522d8 100644 --- 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. diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/estimatesmartpriority.md b/_includes/devdoc/dash-core/rpcs/rpcs/estimatesmartpriority.md index be63e1c4..8ac27612 100644 --- 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. diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/fundrawtransaction.md b/_includes/devdoc/dash-core/rpcs/rpcs/fundrawtransaction.md index 7c490135..e233500c 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/fundrawtransaction.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/fundrawtransaction.md @@ -7,6 +7,8 @@ http://opensource.org/licenses/MIT. ##### FundRawTransaction {% include helpers/subhead-links.md %} + + {% assign summary_fundRawTransaction="adds inputs to a transaction until it has enough in value to meet its out value." %} {% autocrossref %} @@ -29,15 +31,7 @@ All existing inputs must have their previous output transaction be in the wallet *Parameter #2---Additional options* -{% itemplate ntpd1 %} -- n: "`includeWatching`" - t: "bool" - p: "Optional
(0 or 1)" - d: "Inputs from watch-only addresses are also considered. The default is `false`" - -{% enditemplate %} - -The following options from Bitcoin are not implemented in Dash Core. +Note: For backwards compatibility, passing in a `true` instead of an object will result in {\"includeWatching\":true}\n" {% itemplate ntpd1 %} - n: "Options" @@ -55,6 +49,11 @@ The following options from Bitcoin are not implemented in Dash Core. p: "Optional
(0 or 1)" d: "The index of the change output. If not set, the change position is randomly chosen" +- n: "`includeWatching`" + t: "bool" + p: "Optional
(0 or 1)" + d: "Inputs from watch-only addresses are also considered. The default is `false`" + - n: "→
`lockUnspent`" t: "bool" p: "Optional
(0 or 1)" diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/generate.md b/_includes/devdoc/dash-core/rpcs/rpcs/generate.md index b9291881..165de423 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/generate.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/generate.md @@ -7,6 +7,8 @@ http://opensource.org/licenses/MIT. ##### Generate {% include helpers/subhead-links.md %} + + {% assign summary_generate="mines blocks immediately (before the RPC call returns)." %} {% autocrossref %} @@ -25,6 +27,17 @@ The `generate` RPC {{summary_generate}} {% enditemplate %} +*Parameter #2---the number of iterations* + +{% itemplate ntpd1 %} +- n: "`numblocks`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The number of iterations to try (default = 1000000)." + +{% enditemplate %} + + *Result---the generated block header hashes* {% itemplate ntpd1 %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/generatetoaddress.md b/_includes/devdoc/dash-core/rpcs/rpcs/generatetoaddress.md index 9375c9fb..09b0c07f 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/generatetoaddress.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/generatetoaddress.md @@ -9,13 +9,12 @@ http://opensource.org/licenses/MIT. {% assign summary_generateToAddress="mines blocks immediately to a specified address." %} + + {% autocrossref %} -*Added in Bitcoin Core 0.13.0* +*Added in Dash Core 0.12.3 / Bitcoin Core 0.13.0* -**_Not implemented in Dash Core (as of 0.12.2)_** - -{% comment %} *Requires wallet support.* The `generatetoaddress` RPC {{summary_generateToAddress}} @@ -26,7 +25,7 @@ The `generatetoaddress` RPC {{summary_generateToAddress}} - n: "Blocks" t: "number (int)" p: "Required
(exactly 1)" - d: "The number of blocks to generate. The RPC call will not return until all blocks have been generated or the maxium number of iterations has been reached" + d: "The number of blocks to generate. The RPC call will not return until all blocks have been generated or the maximum number of iterations has been reached" {% enditemplate %} @@ -36,7 +35,7 @@ The `generatetoaddress` RPC {{summary_generateToAddress}} - n: "Address" t: "string (base58)" p: "Required
(exactly 1)" - d: "The address to send the newly generated Bitcoin to" + d: "The address that will receive the newly generated Dash" {% enditemplate %} @@ -64,21 +63,21 @@ The `generatetoaddress` RPC {{summary_generateToAddress}} d: "The hashes of the headers of the blocks generated, as hex in RPC byte order" {% enditemplate %} -*Example from Bitcoin Core 0.13.1* +*Example from Dash Core 0.12.3* Using regtest mode, generate 2 blocks with maximal 500000 iterations: {% highlight bash %} -bitcoin-cli -regtest generatetoaddress 2 "1BRo7qrYHMPrzdBDzfjmzt\ -eBdYAyTMXW75" 500000 +dash-cli -regtest generatetoaddress 2 "yaQzdWrDVYGncLKSKG4bHQ\ +ML9UdAe726QN" 500000 {% endhighlight %} Result: {% highlight json %} [ - "36252b5852a5921bdfca8701f936b39edeb1f8c39fffe73b0d8437921401f9af", - "5f2956817db1e386759aa5794285977c70596b39ea093b9eab0aa4ba8cd50c06" + "34726c518d1688a9c56b3399e892089d3a639b43de194517c07da2b168a3a89c", + "1f030abe2bb323b8895542e3a85ed8386bd92c67af9d19fe9c163a4c5f5ef149" ] {% endhighlight %} @@ -88,6 +87,4 @@ Result: * [GetMiningInfo][rpc getmininginfo]: {{summary_getMiningInfo}} * [GetBlockTemplate][rpc getblocktemplate]: {{summary_getBlockTemplate}} -{% endcomment %} - {% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getaddednodeinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getaddednodeinfo.md index ca655507..bc61e79b 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/getaddednodeinfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getaddednodeinfo.md @@ -7,23 +7,29 @@ http://opensource.org/licenses/MIT. ##### GetAddedNodeInfo {% include helpers/subhead-links.md %} + + {% assign summary_getAddedNodeInfo="returns information about the given added node, or all added nodes (except onetry nodes). Only nodes which have been manually added using the `addnode` RPC will have their information displayed." %} {% autocrossref %} The `getaddednodeinfo` RPC {{summary_getAddedNodeInfo}} -*Parameter #1---whether to display connection information* +Prior to Dash Core 0.12.3, this dummy parameter was required for historical purposes but not used: + +*DEPRECATED Parameter #1---whether to display connection information* {% itemplate ntpd1 %} -- n: "Dummy" - t: "bool" - p: "Required
(exactly 1)" - d: "Kept for historical purposes but ignored
*Removed in Bitcoin Core 0.14.0*" +- n: "_Dummy_" + t: "_bool_" + p: "_Required
(exactly 1)_" + d: "_Removed in Dash Core 0.12.3_" {% enditemplate %} -*Parameter #2---what node to display information about* +Beginning with Dash Core 0.12.3, this is the single (optional) parameter: + +*Parameter #1---what node to display information about* {% itemplate ntpd1 %} - n: "`node`" @@ -78,10 +84,10 @@ The `getaddednodeinfo` RPC {{summary_getAddedNodeInfo}} {% enditemplate %} -*Example from Dash Core 0.12.2* +*Example from Dash Core 0.12.3* {% highlight bash %} -dash-cli getaddednodeinfo true +dash-cli getaddednodeinfo {% endhighlight %} Result (real hostname and IP address replaced with [RFC5737][] reserved address): diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getblockchaininfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getblockchaininfo.md index 9c34de4a..4e90fc8b 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/getblockchaininfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getblockchaininfo.md @@ -7,6 +7,8 @@ http://opensource.org/licenses/MIT. ##### GetBlockChainInfo {% include helpers/subhead-links.md %} + + {% assign summary_getBlockChainInfo="provides information about the current state of the block chain." %} {% autocrossref %} @@ -163,9 +165,23 @@ The `getblockchaininfo` RPC {{summary_getBlockChainInfo}} p: "Optional
(0 or 1)" d: "The bit (0-28) in the block version field used to signal this softfork. Field is only shown when status is `started`" +- n: "→ → →
`startTime`" + t: "numeric
(int)" + p: "Required
(exactly 1)" + d: "The Unix epoch time when the softfork voting begins" + +- n: "→ → →
`timeout`" + t: "numeric
(int)" + p: "Required
(exactly 1)" + d: "The Unix epoch time at which the deployment is considered failed if not yet locked in" + +- n: "→ → →
`since`" + t: "numeric
(int)" + p: "Required
(exactly 1)" + d: "*Added in Bitcoin Core 0.14.0*
The height of the first block to which the status applies" {% enditemplate %} -*Example from Dash Core 0.12.2* +*Example from Dash Core 0.12.3* {% highlight bash %} dash-cli -testnet getblockchaininfo @@ -176,74 +192,57 @@ Result: {% highlight json %} { "chain": "test", - "blocks": 4622, - "headers": 4622, - "bestblockhash": "000000007f4141e557309da09911b1c3c65b8e9eed3f5e940f7083aec8999ac7", - "difficulty": 1.380236305048335, - "mediantime": 1507209819, - "verificationprogress": 0.9999053826626874, - "chainwork": "000000000000000000000000000000000000000000000000000001d17aeaf58b", + "blocks": 82244, + "headers": 82244, + "bestblockhash": "0000000004efcadbdb9d8b524e5ab982af3db039fdb585c2f1c1df56d42d4492", + "difficulty": 47.4955836390814, + "mediantime": 1519662782, + "verificationprogress": 0.9999999483744162, + "chainwork": "0000000000000000000000000000000000000000000000000021adf3af961831", "pruned": false, "softforks": [ { "id": "bip34", "version": 2, - "enforce": { - "status": true, - "found": 100, - "required": 51, - "window": 100 - }, "reject": { - "status": true, - "found": 100, - "required": 75, - "window": 100 + "status": true } }, { "id": "bip66", "version": 3, - "enforce": { - "status": true, - "found": 100, - "required": 51, - "window": 100 - }, "reject": { - "status": true, - "found": 100, - "required": 75, - "window": 100 + "status": true } }, { "id": "bip65", "version": 4, - "enforce": { - "status": true, - "found": 100, - "required": 51, - "window": 100 - }, "reject": { - "status": true, - "found": 100, - "required": 75, - "window": 100 + "status": true } } ], - "bip9_softforks": [ - { - "id": "csv", - "status": "started" + "bip9_softforks": { + "csv": { + "status": "active", + "startTime": 1506556800, + "timeout": 1538092800, + "since": 8064 }, - { - "id": "dip0001", - "status": "started" + "dip0001": { + "status": "active", + "startTime": 1505692800, + "timeout": 1537228800, + "since": 5600 + }, + "bip147": { + "status": "active", + "startTime": 1517792400, + "timeout": 1549328400, + "since": 78800 } - ] + } } {% endhighlight %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getblocktemplate.md b/_includes/devdoc/dash-core/rpcs/rpcs/getblocktemplate.md index 891f25fc..7cf947f9 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/getblocktemplate.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getblocktemplate.md @@ -7,6 +7,8 @@ http://opensource.org/licenses/MIT. ##### GetBlockTemplate {% include helpers/subhead-links.md %} + + {% assign summary_getBlockTemplate="gets a block template or proposal for use with mining software." %} {% autocrossref %} @@ -41,6 +43,16 @@ information, please see the following resources: p: "Optional
(exactly 1)" d: "Client side supported feature, `longpoll`, `coinbasetxn`, `coinbasevalue`, `proposal`, `serverlist`, `workid`" +- n: "→
`rules`" + t: "array (string)" + p: "Optional
(0 or more)" + d: "A list of strings" + +- n: "→ →
Rules" + t: "string" + p: "Optional
(exactly 1)" + d: "Client side supported softfork deployment, `csv`, `dip0001`, etc." + {% enditemplate %} *Result---block template* diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getchaintips.md b/_includes/devdoc/dash-core/rpcs/rpcs/getchaintips.md index 5da84f0d..3c5dbc57 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/getchaintips.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getchaintips.md @@ -53,6 +53,11 @@ The `getchaintips` RPC {{summary_getChainTips}} p: "Required
(exactly 1)" d: "The number of blocks that are on this chain but not on the main chain. For the local best block chain, this will be `0`; for all other chains, it will be at least `1`" +- n: "→ →
`forkpoint`" + t: "string (hex)" + p: "Required
(exactly 1)" + d: "*Added in Dash Core 0.12.3*
Block hash of the last common block between this tip and the main chain" + - n: "→ →
`status`" t: "string" p: "Required
(exactly 1)" @@ -60,7 +65,7 @@ The `getchaintips` RPC {{summary_getChainTips}} {% enditemplate %} -*Example from Dash Core 0.12.2* +*Example from Dash Core 0.12.3* {% highlight bash %} dash-cli -testnet getchaintips @@ -69,11 +74,12 @@ dash-cli -testnet getchaintips {% highlight json %} [ { - "height": 4655, - "hash": "00000000629c276241d9526d85297f2675d6edebcc7fd0c39e8f4263d729b8c1", - "difficulty": 0.9622782802772231, - "chainwork": "000000000000000000000000000000000000000000000000000001f1e286e12a", + "height": 110192, + "hash": "000000000c6007f40c3b68a77b0e1319a89c0504ae1b391d071cf49fa7591dee", + "difficulty": 18.38631407059958, + "chainwork": "000000000000000000000000000000000000000000000000002cbd2546718747", "branchlen": 0, + "forkpoint": "000000000c6007f40c3b68a77b0e1319a89c0504ae1b391d071cf49fa7591dee", "status": "active" } ] diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getgenerate.md b/_includes/devdoc/dash-core/rpcs/rpcs/getgenerate.md index 7692a574..42860925 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/getgenerate.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getgenerate.md @@ -7,13 +7,15 @@ http://opensource.org/licenses/MIT. ##### GetGenerate {% include helpers/subhead-links.md %} -{% assign summary_getGenerate="returns if the server is set to generate coins or not." %} + + +{% assign summary_getGenerate="was removed in Dash Core 0.12.3." %} {% autocrossref %} *Requires wallet support.* -*Removed in Bitcoin Core 0.13.0.* +**_Removed in Dash Core 0.12.3 / Bitcoin Core 0.13.0._** The `getgenerate` RPC {{summary_getGenerate}} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getgovernanceinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getgovernanceinfo.md index 5e86da6a..feebc2de 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/getgovernanceinfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getgovernanceinfo.md @@ -7,6 +7,8 @@ http://opensource.org/licenses/MIT. ##### GetGovernanceInfo {% include helpers/subhead-links.md %} + + {% assign summary_getGovernanceInfo="returns an object containing governance parameters." %} {% autocrossref %} @@ -31,7 +33,12 @@ The `getgovernanceinfo` RPC {{summary_getGovernanceInfo}} - n: "→
`masternodewatchdogmaxseconds`" t: "number (int)" p: "Required
(exactly 1)" - d: "Sentinel watchdog expiration time in seconds" + d: "*DEPRECATED in Dash Core 0.12.3*
Sentinel watchdog expiration time in seconds" + +- n: "→
`sentinelpingmaxseconds`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "*Added in Dash Core 0.12.3.0*
Sentinel ping expiration time in seconds" - n: "→
`proposalfee`" t: "number (int)" @@ -60,7 +67,7 @@ The `getgovernanceinfo` RPC {{summary_getGovernanceInfo}} {% enditemplate %} -*Example from Dash Core 0.12.2.2* +*Example from Dash Core 0.12.3.0* {% highlight bash %} dash-cli -testnet getgovernanceinfo @@ -71,10 +78,11 @@ Result: { "governanceminquorum": 1, "masternodewatchdogmaxseconds": 7200, + "sentinelpingmaxseconds": 7200, "proposalfee": 5.00000000, "superblockcycle": 24, - "lastsuperblock": 52872, - "nextsuperblock": 52896, + "lastsuperblock": 82704, + "nextsuperblock": 82728, "maxgovobjdatasize": 16384 } {% endhighlight %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getmemoryinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getmemoryinfo.md index 534464c9..2321a4d1 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/getmemoryinfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getmemoryinfo.md @@ -13,11 +13,8 @@ http://opensource.org/licenses/MIT. {% autocrossref %} -*Added in Bitcoin Core 0.14.0* +*Added in Dash Core 0.12.3 / Bitcoin Core 0.14.0* -**_Not implemented in Dash Core (as of 0.12.2)_** - -{% comment %} The `getmemoryinfo` RPC {{summary_getMemoryInfo}} *Parameters: none* @@ -67,10 +64,10 @@ The `getmemoryinfo` RPC {{summary_getMemoryInfo}} {% enditemplate %} -*Example from Bitcoin Core 0.14.1* +*Example from Dash Core 0.12.3* {% highlight bash %} -bitcoin-cli getmemoryinfo +dash-cli getmemoryinfo {% endhighlight %} Result: @@ -78,11 +75,11 @@ Result: {% highlight json %} { "locked": { - "used": 0, - "free": 65536, + "used": 32, + "free": 65504, "total": 65536, "locked": 65536, - "chunks_used": 0, + "chunks_used": 1, "chunks_free": 1 } } @@ -93,6 +90,4 @@ Result: * [GetMemPoolInfo][rpc getmempoolinfo]: {{summary_getMemPoolInfo}} -{% endcomment %} - {% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getmempoolancestors.md b/_includes/devdoc/dash-core/rpcs/rpcs/getmempoolancestors.md index 2a4fd641..84099efd 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/getmempoolancestors.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getmempoolancestors.md @@ -9,22 +9,21 @@ http://opensource.org/licenses/MIT. {% assign summary_getMemPoolAncestors="returns all in-mempool ancestors for a transaction in the mempool." %} + + {% autocrossref %} -*Added in Bitcoin Core 0.13.0* +*Added in Dash Core 0.12.3* -**_Not implemented in Dash Core (as of 0.12.2)_** - -{% comment %} The `getmempoolancestors` RPC {{summary_getMemPoolAncestors}} *Parameter #1---a transaction identifier (TXID)* {% itemplate ntpd1 %} -- n: "Address" - t: "string" +- n: "TXID" + t: "string (hex)" p: "Required
(exactly 1)" - d: "The address whose transactions should be tallied" + d: "The TXID of a transaction in the memory pool, encoded as hex in RPC byte order" {% enditemplate %} @@ -143,66 +142,48 @@ The `getmempoolancestors` RPC {{summary_getMemPoolAncestors}} {% enditemplate %} -*Examples from Bitcoin Core 0.13.1* +*Examples from Dash Core 0.12.3* The default (`false`): {% highlight bash %} -bitcoin-cli getmempoolancestors 52273e0ce6cf3452932cfbc1c517c0ce\ -1af1d255fda67a6e3bd63ba1d908c8c2 +dash-cli getmempoolancestors 49a512c3d567effd4f605a6023df8b4b523\ +ac0ae7bccbaeed1c8a7db1e05e15a {% endhighlight %} Result: {% highlight json %} [ - "b104586f229e330caf42c475fd52684e9eb5e2d02f0fcd216d9554c5347b0873", - "094f7dcbc7494510d4daeceb2941ed73b1bd011bf527f6c3b7c897fee85c11d4" + "d1eefe8a006e2c21b55bc97c1f5b10000d63aa6a777bb11abc0daf62e4296660" ] {% endhighlight %} Verbose output (`true`): {% highlight bash %} -bitcoin-cli getmempoolancestors 52273e0ce6cf3452932cfbc1c517c0ce\ -1af1d255fda67a6e3bd63ba1d908c8c2 true +dash-cli getmempoolancestors 49a512c3d567effd4f605a6023df8b4b523\ +ac0ae7bccbaeed1c8a7db1e05e15a true {% endhighlight %} Result: {% highlight json %} { - "b104586f229e330caf42c475fd52684e9eb5e2d02f0fcd216d9554c5347b0873": { - "size": 485, - "fee": 0.00009700, - "modifiedfee": 0.00009700, - "time": 1479423635, - "height": 439431, - "startingpriority": 15327081.81818182, - "currentpriority": 21536936.36363636, - "descendantcount": 1, - "descendantsize": 485, - "descendantfees": 9700, + "d1eefe8a006e2c21b55bc97c1f5b10000d63aa6a777bb11abc0daf62e4296660": { + "size": 963, + "fee": 0.00000966, + "modifiedfee": 0.00000966, + "time": 1519160516, + "height": 79045, + "startingpriority": 4514051697.115385, + "currentpriority": 4520474899.74359, + "descendantcount": 2, + "descendantsize": 1189, + "descendantfees": 1192, "ancestorcount": 1, - "ancestorsize": 485, - "ancestorfees": 9700, - "depends": [ - ] - }, - "094f7dcbc7494510d4daeceb2941ed73b1bd011bf527f6c3b7c897fee85c11d4": { - "size": 554, - "fee": 0.00005540, - "modifiedfee": 0.00005540, - "time": 1479423327, - "height": 439430, - "startingpriority": 85074.91071428571, - "currentpriority": 3497174.4375, - "descendantcount": 1, - "descendantsize": 554, - "descendantfees": 5540, - "ancestorcount": 1, - "ancestorsize": 554, - "ancestorfees": 5540, + "ancestorsize": 963, + "ancestorfees": 966, "depends": [ ] } @@ -214,6 +195,4 @@ Result: * [GetMemPoolDescendants][rpc getmempooldescendants]: {{summary_getMemPoolDescendants}} * [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}} -{% endcomment %} - {% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getmempooldescendants.md b/_includes/devdoc/dash-core/rpcs/rpcs/getmempooldescendants.md index d430b6e0..c2d8c671 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/getmempooldescendants.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getmempooldescendants.md @@ -9,23 +9,21 @@ http://opensource.org/licenses/MIT. {% assign summary_getMemPoolDescendants="returns all in-mempool descendants for a transaction in the mempool." %} + + {% autocrossref %} -*Added in Bitcoin Core 0.13.0* - -**_Not implemented in Dash Core (as of 0.12.2)_** - -{% comment %} +*Added in Dash Core 0.12.3* The `getmempooldescendants` RPC {{summary_getMemPoolDescendants}} *Parameter #1---a transaction identifier (TXID)* {% itemplate ntpd1 %} -- n: "Address" - t: "string" +- n: "TXID" + t: "string (hex)" p: "Required
(exactly 1)" - d: "The address whose transactions should be tallied" + d: "The TXID of a transaction in the memory pool, encoded as hex in RPC byte order" {% enditemplate %} @@ -144,67 +142,50 @@ The `getmempooldescendants` RPC {{summary_getMemPoolDescendants}} {% enditemplate %} -*Examples from Bitcoin Core 0.13.1* +*Examples from Dash Core 0.12.3* The default (`false`): {% highlight bash %} -bitcoin-cli getmempooldescendants 52273e0ce6cf3452932cfbc1c517c0\ -ce1af1d255fda67a6e3bd63ba1d908c8c2 +dash-cli getmempooldescendants 49a512c3d567effd4f605a6023df8b4b5\ +23ac0ae7bccbaeed1c8a7db1e05e15a {% endhighlight %} Result: {% highlight json %} [ - "b104586f229e330caf42c475fd52684e9eb5e2d02f0fcd216d9554c5347b0873", - "094f7dcbc7494510d4daeceb2941ed73b1bd011bf527f6c3b7c897fee85c11d4" + "49a512c3d567effd4f605a6023df8b4b523ac0ae7bccbaeed1c8a7db1e05e15a" ] {% endhighlight %} Verbose output (`true`): {% highlight bash %} -bitcoin-cli getmempooldescendants 52273e0ce6cf3452932cfbc1c517c0\ -ce1af1d255fda67a6e3bd63ba1d908c8c2 true +dash-cli getmempooldescendants 49a512c3d567effd4f605a6023df8b4b5\ +23ac0ae7bccbaeed1c8a7db1e05e15a true {% endhighlight %} Result: {% highlight json %} { - "b104586f229e330caf42c475fd52684e9eb5e2d02f0fcd216d9554c5347b0873": { - "size": 485, - "fee": 0.00009700, - "modifiedfee": 0.00009700, - "time": 1479423635, - "height": 439431, - "startingpriority": 15327081.81818182, - "currentpriority": 21536936.36363636, + "49a512c3d567effd4f605a6023df8b4b523ac0ae7bccbaeed1c8a7db1e05e15a": { + "size": 226, + "fee": 0.00000226, + "modifiedfee": 0.00000226, + "time": 1519160551, + "height": 79046, + "startingpriority": 0, + "currentpriority": 0, "descendantcount": 1, - "descendantsize": 485, - "descendantfees": 9700, - "ancestorcount": 1, - "ancestorsize": 485, - "ancestorfees": 9700, - "depends": [ - ] - }, - "094f7dcbc7494510d4daeceb2941ed73b1bd011bf527f6c3b7c897fee85c11d4": { - "size": 554, - "fee": 0.00005540, - "modifiedfee": 0.00005540, - "time": 1479423327, - "height": 439430, - "startingpriority": 85074.91071428571, - "currentpriority": 3497174.4375, - "descendantcount": 1, - "descendantsize": 554, - "descendantfees": 5540, - "ancestorcount": 1, - "ancestorsize": 554, - "ancestorfees": 5540, + "descendantsize": 226, + "descendantfees": 226, + "ancestorcount": 2, + "ancestorsize": 1189, + "ancestorfees": 1192, "depends": [ + "d1eefe8a006e2c21b55bc97c1f5b10000d63aa6a777bb11abc0daf62e4296660" ] } } @@ -215,6 +196,4 @@ Result: * [GetMemPoolAncestors][rpc getmempoolancestors]: {{summary_getMemPoolAncestors}} * [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}} -{% endcomment %} - {% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getmempoolentry.md b/_includes/devdoc/dash-core/rpcs/rpcs/getmempoolentry.md index b62b7679..62154513 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/getmempoolentry.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getmempoolentry.md @@ -9,23 +9,21 @@ http://opensource.org/licenses/MIT. {% assign summary_getMemPoolEntry="returns mempool data for given transaction (must be in mempool)." %} + + {% autocrossref %} -*Added in Bitcoin Core 0.13.0* - -**_Not implemented in Dash Core (as of 0.12.2)_** - -{% comment %} +*Added in Dash Core 0.12.3* The `getmempoolentry` RPC {{summary_getMemPoolEntry}} *Parameter #1---a transaction identifier (TXID)* {% itemplate ntpd1 %} -- n: "Address" - t: "string" +- n: "TXID" + t: "string (hex)" p: "Required
(exactly 1)" - d: "The address whose transactions should be tallied" + d: "The TXID of a transaction in the memory pool, encoded as hex in RPC byte order" {% enditemplate %} @@ -112,34 +110,46 @@ The `getmempoolentry` RPC {{summary_getMemPoolEntry}} p: "Optional (0 or more)" d: "The TXIDs of any unconfirmed transactions this transaction depends upon, encoded as hex in RPC byte order" +- n: "→
`instantsend`" + t: "bool" + p: "Required
(exactly 1)" + d: "True if this transaction was sent as an InstantSend one" + +- n: "→
`instantlock`" + t: "bool" + p: "Required
(exactly 1)" + d: "True if this transaction was locked via InstantSend" + {% enditemplate %} -*Examples from Bitcoin Core 0.13.1* +*Examples from Dash Core 0.12.3* {% highlight bash %} -bitcoin-cli getmempoolentry 52273e0ce6cf3452932cfbc1c517c0ce1af1\ -d255fda67a6e3bd63ba1d908c8c2 +dash-cli getmempoolentry d1eefe8a006e2c21b55bc97c1f5b10000d63aa6\ +a777bb11abc0daf62e4296660 {% endhighlight %} Result: {% highlight json %} { - "size": 485, - "fee": 0.00009700, - "modifiedfee": 0.00009700, - "time": 1479423635, - "height": 439431, - "startingpriority": 15327081.81818182, - "currentpriority": 21536936.36363636, - "descendantcount": 1, - "descendantsize": 485, - "descendantfees": 9700, - "ancestorcount": 1, - "ancestorsize": 485, - "ancestorfees": 9700, - "depends": [ - ] + "size": 226, + "fee": 0.00000226, + "modifiedfee": 0.00000226, + "time": 1519159538, + "height": 79036, + "startingpriority": 0, + "currentpriority": 0, + "descendantcount": 2, + "descendantsize": 452, + "descendantfees": 452, + "ancestorcount": 1, + "ancestorsize": 226, + "ancestorfees": 226, + "depends": [ + ], + "instantsend": false, + "instantlock": false } {% endhighlight %} @@ -149,6 +159,4 @@ Result: * [GetMemPoolDescendants][rpc getmempooldescendants]: {{summary_getMemPoolDescendants}} * [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}} -{% endcomment %} - {% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getnetworkinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getnetworkinfo.md index e905e6e2..1f25f110 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/getnetworkinfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getnetworkinfo.md @@ -7,6 +7,8 @@ http://opensource.org/licenses/MIT. ##### GetNetworkInfo {% include helpers/subhead-links.md %} + + {% assign summary_getNetworkInfo="returns information about the node's connection to the network." %} {% autocrossref %} @@ -94,10 +96,15 @@ The `getnetworkinfo` RPC {{summary_getNetworkInfo}} d: "*Added in Bitcoin Core 0.11.0*
Set to `true` if randomized credentials are set for this proxy. Otherwise set to `false`" - n: "→
`relayfee`" - t: "number (Dash)" + t: "number (DASH)" p: "Required
(exactly 1)" d: "The minimum relay fee for non-free transactions in order for this node to accept it into its memory pool" +- n: "→
`incrementalfee`" + t: "number (DASH)" + p: "Required
(exactly 1)" + d: "*Added in Dash Core 0.12.3*
The minimum fee increment for mempool limiting or BIP 125 replacement in DASH/kB" + - n: "→
`localaddresses`" t: "array" p: "Required
(exactly 1)" @@ -130,7 +137,7 @@ The `getnetworkinfo` RPC {{summary_getNetworkInfo}} {% enditemplate %} -*Example from Dash Core 0.12.2* +*Example from Dash Core 0.12.3* {% highlight bash %} dash-cli getnetworkinfo @@ -140,8 +147,8 @@ Result (actual addresses have been replaced with [RFC5737][] reserve {% highlight json %} { - "version": 120200, - "subversion": "/Dash Core:0.12.2/", + "version": 120300, + "subversion": "/Dash Core:0.12.3/", "protocolversion": 70208, "localservices": "0000000000000005", "localrelay": true, @@ -172,6 +179,7 @@ Result (actual addresses have been replaced with [RFC5737][] reserve } ], "relayfee": 0.00001000, + "incrementalfee": 0.00001000, "localaddresses": [ { "address": "192.0.2.113", diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getrawmempool.md b/_includes/devdoc/dash-core/rpcs/rpcs/getrawmempool.md index a95dc1f7..e5224288 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/getrawmempool.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getrawmempool.md @@ -9,6 +9,8 @@ http://opensource.org/licenses/MIT. {% 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." %} + + {% autocrossref %} The `getrawmempool` RPC {{summary_getRawMemPool}} @@ -101,6 +103,21 @@ The `getrawmempool` RPC {{summary_getRawMemPool}} p: "Required
(exactly 1)" d: "*Added in Bitcoin Core 0.12.0*
The modified fees (see `modifiedfee` above) of in-mempool descendants (including this one)" +- n: "→ →
`ancestorcount`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "*Added in Dash Core 0.12.3 / Bitcoin Core 0.13.0*
The number of in-mempool ancestor transactions (including this one)" + +- n: "→ →
`ancestorsize`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "*Added in Dash Core 0.12.3 / Bitcoin Core 0.13.0*
The size of in-mempool ancestors (including this one)" + +- n: "→ →
`ancestorfees`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "*Added in Dash Core 0.12.3 / Bitcoin Core 0.13.0*
The modified fees (see `modifiedfee` above) of in-mempool ancestors (including this one)" + - n: "→ →
`depends`" t: "array" p: "Required
(exactly 1)" @@ -111,28 +128,19 @@ The `getrawmempool` RPC {{summary_getRawMemPool}} p: "Optional (0 or more)" d: "The TXIDs of any unconfirmed transactions this transaction depends upon, encoded as hex in RPC byte order" +- n: "→ →
`instantsend`" + t: "bool" + p: "Required
(exactly 1)" + d: "*Added in Dash Core 0.12.3*
Set to `true` for transactions broadcast via the `ix` message (InstantSend lock requested). Set to `false` for standard (non-InstantSend) transactions" + +- n: "→ →
`instantlock`" + t: "bool" + p: "Required
(exactly 1)" + d: "*Added in Dash Core 0.12.3*
Set to `true` for locked InstantSend transactions (masternode quorum has locked the transaction inputs via `txlvote` messages). Set to `false` if the masternodes have not approved the InstantSend transaction" + {% enditemplate %} -*Changes from Bitcoin - Following items not present in Dash result* - -{% itemplate ntpd1 %} -- n: "→ TXID→
`ancestorcount`" - t: "number (int)" - p: "Required
(exactly 1)" - d: "*Added in Bitcoin Core 0.13.0*
The number of in-mempool ancestor transactions (including this one)" - -- n: "→ TXID→
`ancestorsize`" - t: "number (int)" - p: "Required
(exactly 1)" - d: "*Added in Bitcoin Core 0.13.0*
The size of in-mempool ancestors (including this one)" - -- n: "→ TXID→
`ancestorfees`" - t: "number (int)" - p: "Required
(exactly 1)" - d: "*Added in Bitcoin Core 0.13.0*
The modified fees (see `modifiedfee` above) of in-mempool ancestors (including this one)" -{% enditemplate %} - -*Examples from Dash Core 0.12.2* +*Examples from Dash Core 0.12.3* The default (`false`): @@ -158,20 +166,44 @@ Result: {% highlight json %} { - "286b3ec21e6ce5463fc712c98d86e02353525e09452113836651f3f91e562354": { - "size": 225, - "fee": 0.00000225, - "modifiedfee": 0.00000225, - "time": 1507735322, - "height": 7940, + "8fd1440ed74d3739aa4e1700e9b2fdb32bc5c138fe79dd319f965f67339eb1ce": { + "size": 372, + "fee": 0.00020000, + "modifiedfee": 0.00020000, + "time": 1519928121, + "height": 83907, + "startingpriority": 2224190635.564103, + "currentpriority": 2224190635.564103, + "descendantcount": 2, + "descendantsize": 598, + "descendantfees": 20226, + "ancestorcount": 1, + "ancestorsize": 372, + "ancestorfees": 20000, + "depends": [ + ], + "instantsend": true, + "instantlock": true + }, + "2d914d77305dd968bbd67aeb8604cf7e9d66a7df58bf5216724db69a54000f40": { + "size": 226, + "fee": 0.00000226, + "modifiedfee": 0.00000226, + "time": 1519928256, + "height": 83907, "startingpriority": 0, "currentpriority": 0, - "descendantcount": 4, - "descendantsize": 901, - "descendantfees": 902, + "descendantcount": 1, + "descendantsize": 226, + "descendantfees": 226, + "ancestorcount": 2, + "ancestorsize": 598, + "ancestorfees": 20226, "depends": [ - "2aacf53e0e15d3b4d778837792c7b6bd298edd3c41a0608586bdec41adcfe7c4" - ] + "8fd1440ed74d3739aa4e1700e9b2fdb32bc5c138fe79dd319f965f67339eb1ce" + ], + "instantsend": false, + "instantlock": false } } {% endhighlight %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getrawtransaction.md b/_includes/devdoc/dash-core/rpcs/rpcs/getrawtransaction.md index 39fabadc..77d85687 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/getrawtransaction.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getrawtransaction.md @@ -7,12 +7,19 @@ http://opensource.org/licenses/MIT. ##### GetRawTransaction {% include helpers/subhead-links.md %} + + {% 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." %} {% autocrossref %} The `getrawtransaction` RPC {{summary_getRawTransaction}} +Note: By default this function only works for mempool transactions. If the +`-txindex` option is enabled, it also works for blockchain transactions. For now, +it also works for transactions with unspent outputs although this feature is +deprecated. + {{reindexNote}} *Parameter #1---the TXID of the transaction to get* @@ -31,7 +38,7 @@ The `getrawtransaction` RPC {{summary_getRawTransaction}} - n: "Format" t: "bool" p: "Optional
(0 or 1)" - d: "For Dash:
Set to `0` (the default) to return the serialized transaction as hex. Set to `1` to return a decoded transaction.
*Updated in Bitcoin Core 0.14.0*
Set to `false` (the default) to return the serialized transaction as hex. Set to `true` to return a decoded transaction. Before 0.14.0, use `0` and `1`, respectively" + d: "*Updated in Dash Core 0.12.3 / Bitcoin Core 0.14.0*
Set to `false` (the default) to return the serialized transaction as hex. Set to `true` to return a decoded transaction. Before 0.12.3, use `0` and `1`, respectively" {% enditemplate %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getwalletinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getwalletinfo.md index f4754ec0..0f945f96 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/getwalletinfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getwalletinfo.md @@ -37,6 +37,11 @@ The `getwalletinfo` RPC {{summary_getWalletInfo}} p: "Required
(exactly 1)" d: "The total confirmed balance of the wallet. The same as returned by the `getbalance` RPC with default parameters" +- n: "→
`privatesendbalance`" + t: "number (dash)" + p: "Required
(exactly 1)" + d: "*Added in Dash Core 0.12.3*
The total PrivateSend balance of the wallet" + - n: "→
`unconfirmed_balance`" t: "number (dash)" p: "Required
(exactly 1)" @@ -109,7 +114,7 @@ The `getwalletinfo` RPC {{summary_getWalletInfo}} {% enditemplate %} -*Example from Dash Core 0.12.2* +*Example from Dash Core 0.12.3* {% highlight bash %} dash-cli -testnet getwalletinfo @@ -121,6 +126,7 @@ Result: { "walletversion": 61000, "balance": 3000.00000000, + "privatesend_balance": 413.20413200, "unconfirmed_balance": 10.10000000, "immature_balance": 11.25000000, "txcount": 267, diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/gobject.md b/_includes/devdoc/dash-core/rpcs/rpcs/gobject.md index 01617726..19850f2e 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/gobject.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/gobject.md @@ -423,7 +423,79 @@ Result (wrapped): The `gobject count` RPC returns the count of governance objects and votes. -*Parameters: none* +*Parameter #1---mode* + +{% itemplate ntpd1 %} +- n: "`mode`" + t: "string" + p: "Optional
(exactly 1)" + d: "Result return format:
`json` (default)
`all` - Default before Dash Core 0.12.3 (for backwards compatibility)" + +{% enditemplate %} + + +**Command Mode - `json`** + +*Result---count of governance objects and votes* + +{% itemplate ntpd1 %} +- n: "Result" + t: "object" + p: "Required
(exactly 1)" + d: "Information about the governance object" + +- n: "→
`objects_total`" + t: "int" + p: "Required
(exactly 1)" + d: "Total object count" + +- n: "→
`proposals`" + t: "int" + p: "Required
(exactly 1)" + d: "Proposal count" + +- n: "→
`triggers`" + t: "int" + p: "Required
(exactly 1)" + d: "Trigger count" + +- n: "→
`other`" + t: "int" + p: "Required
(exactly 1)" + d: "Non-proposal/trigger count" + +- n: "→
`erased`" + t: "int" + p: "Required
(exactly 1)" + d: "Erased count" + +- n: "→
`votes`" + t: "int" + p: "Required
(exactly 1)" + d: "Vote count" + +{% enditemplate %} + +*Example from Dash Core 0.12.3 (mode: `json`/default)* + +{% highlight bash %} +dash-cli -testnet gobject count +{% endhighlight %} + +Result (wrapped): +{% highlight json %} +{ + "objects_total": 177, + "proposals": 177, + "triggers": 0, + "other": 0, + "erased": 5, + "votes": 9680 +} +{% endhighlight %} + + +**Command Mode - `all`** *Result---count of governance objects and votes* @@ -435,10 +507,10 @@ The `gobject count` RPC returns the count of governance objects and votes. {% enditemplate %} -*Example from Dash Core 0.12.2* +*Example from Dash Core 0.12.3 (mode: `all`)* {% highlight bash %} -dash-cli -testnet gobject count +dash-cli -testnet gobject count all {% endhighlight %} Result (wrapped): @@ -717,7 +789,7 @@ The `gobject getvotes` RPC gets all votes for a governance object hash (includin - n: "→
Vote Info" t: "string" p: "Required
(1 or more)" - d: "Key: vote-hash
Value: vinMasternode, time, outcome, and signal of the vote" + d: "Key: vote-hash
Value: Masternode's unspent outpoint, time, outcome, and signal of the vote" {% enditemplate %} @@ -731,13 +803,13 @@ dash-cli -testnet gobject getvotes 78941af577f639ac94440e4855a1ed8f\ Result (truncated): {% highlight json %} { - "174aaba65982d25a23f437e2a66ec3836146ba7b7ce5b3fe2d5476907f7079d9": "CTxIn(COutPoint(2eab488e3a7b030303de0d18e357ce17a9fc6b8876705d61076bbe923b2e5fc8, 1), scriptSig=):1509354047:YES:DELETE", - "216cbc42addec1a6b83e1f2b0b3779594bd879f5671dd76a9826cc690c68286d": "CTxIn(COutPoint(b0320c1eff10ccb5e26086017a09e77dacb30fdcafccb3d98db3e5b610b9f1bd, 1), scriptSig=):1509117256:YES:DELETE", - "aa4dc9d3b9e74e8c1ffc725b737d07f8a32e43c64907e4bea19e64a86135f08a": "CTxIn(COutPoint(af9f5646ace92f76b3a01b0abe08716a0a7ded64074c2d2e712c93174b9013d1, 1), scriptSig=):1508866932:YES:FUNDING", - "73dd135ea7bece0f2047de75d8ca04f2985daebed9568d28ee58a60a12a2a082": "CTxIn(COutPoint(8e3fee7f668fed7019588be616225c6c4762ee632470878b2dc8eae3f0b3f67d, 1), scriptSig=):1508866932:YES:FUNDING", - "d13b9c5c28bbc8684a7291961a1023abbbe65b534804d0629fb44166cc1a6148": "CTxIn(COutPoint(08b2dbffd61d927bc12c20f6853513f41fbf7737446632b13c7ca0df8c6da282, 1), scriptSig=):1508866932:YES:FUNDING", - "8a4283d457d8635b43c6fa6cbf865813a80d965c777e8ba07364eb6468200ae1": "CTxIn(COutPoint(76c40abd280441b75577e99e9e4f253f9281a7deb4feebff83860f9cede7a09b, 1), scriptSig=):1508866932:YES:FUNDING", - "313e19607813cb0db3b3fb477982b4d3418f13f8511295419df8fe1f7ff6668f": "CTxIn(COutPoint(0fd502f28b9a9a256d9ba29a047c375fe2823b6e76e4853af16e079a709ab72a, 1), scriptSig=):1508866932:YES:FUNDING" + "174aaba65982d25a23f437e2a66ec3836146ba7b7ce5b3fe2d5476907f7079d9": "2eab488e3a7b030303de0d18e357ce17a9fc6b8876705d61076bbe923b2e5fc8-1:1509354047:YES:DELETE", + "216cbc42addec1a6b83e1f2b0b3779594bd879f5671dd76a9826cc690c68286d": "b0320c1eff10ccb5e26086017a09e77dacb30fdcafccb3d98db3e5b610b9f1bd-1:1509117256:YES:DELETE", + "aa4dc9d3b9e74e8c1ffc725b737d07f8a32e43c64907e4bea19e64a86135f08a": "af9f5646ace92f76b3a01b0abe08716a0a7ded64074c2d2e712c93174b9013d1-1:1508866932:YES:FUNDING", + "73dd135ea7bece0f2047de75d8ca04f2985daebed9568d28ee58a60a12a2a082": "8e3fee7f668fed7019588be616225c6c4762ee632470878b2dc8eae3f0b3f67d-1:1508866932:YES:FUNDING", + "d13b9c5c28bbc8684a7291961a1023abbbe65b534804d0629fb44166cc1a6148": "08b2dbffd61d927bc12c20f6853513f41fbf7737446632b13c7ca0df8c6da282-1:1508866932:YES:FUNDING", + "8a4283d457d8635b43c6fa6cbf865813a80d965c777e8ba07364eb6468200ae1": "76c40abd280441b75577e99e9e4f253f9281a7deb4feebff83860f9cede7a09b-1:1508866932:YES:FUNDING", + "313e19607813cb0db3b3fb477982b4d3418f13f8511295419df8fe1f7ff6668f": "0fd502f28b9a9a256d9ba29a047c375fe2823b6e76e4853af16e079a709ab72a-1:1508866932:YES:FUNDING" } {% endhighlight %} @@ -785,11 +857,11 @@ dash-cli -testnet gobject getcurrentvotes 78941af577f639ac94440e4855a1ed8f\ Result (truncated): {% highlight json %} { - "174aaba65982d25a23f437e2a66ec3836146ba7b7ce5b3fe2d5476907f7079d9": "CTxIn(COutPoint(2eab488e3a7b030303de0d18e357ce17a9fc6b8876705d61076bbe923b2e5fc8, 1), scriptSig=):1509354047:YES:DELETE", - "444d4d871ec35479804f060c733f516908382642ec2dfce6044a59fcadfdcd60": "CTxIn(COutPoint(18e496fe85b61ac9a5fcaec1ef683c7e3fc9bce4a83c883608427ecfb1002fca, 1), scriptSig=):1508866932:YES:FUNDING", - "d49a472c62e9d8105931829fc50ef6c6ce04a230507646ee0eaa615e863ef3a0": "CTxIn(COutPoint(18e496fe85b61ac9a5fcaec1ef683c7e3fc9bce4a83c883608427ecfb1002fca, 1), scriptSig=):1509117071:YES:DELETE", - "78442507441d4524d2493b8568d130415c1eb394adb2fe38d6ffeb199115bc5d": "CTxIn(COutPoint(3df7fb192e21c34da99bdd10c34e58ecaf3f3c37d6b2289f0ffedba5050188cc, 1), scriptSig=):1509312524:YES:DELETE", - "aa4dc9d3b9e74e8c1ffc725b737d07f8a32e43c64907e4bea19e64a86135f08a": "CTxIn(COutPoint(af9f5646ace92f76b3a01b0abe08716a0a7ded64074c2d2e712c93174b9013d1, 1), scriptSig=):1508866932:YES:FUNDING", + "174aaba65982d25a23f437e2a66ec3836146ba7b7ce5b3fe2d5476907f7079d9": "2eab488e3a7b030303de0d18e357ce17a9fc6b8876705d61076bbe923b2e5fc8-1:1509354047:YES:DELETE", + "444d4d871ec35479804f060c733f516908382642ec2dfce6044a59fcadfdcd60": "18e496fe85b61ac9a5fcaec1ef683c7e3fc9bce4a83c883608427ecfb1002fca-1:1508866932:YES:FUNDING", + "d49a472c62e9d8105931829fc50ef6c6ce04a230507646ee0eaa615e863ef3a0": "18e496fe85b61ac9a5fcaec1ef683c7e3fc9bce4a83c883608427ecfb1002fca-1:1509117071:YES:DELETE", + "78442507441d4524d2493b8568d130415c1eb394adb2fe38d6ffeb199115bc5d": "3df7fb192e21c34da99bdd10c34e58ecaf3f3c37d6b2289f0ffedba5050188cc-1:1509312524:YES:DELETE", + "aa4dc9d3b9e74e8c1ffc725b737d07f8a32e43c64907e4bea19e64a86135f08a": "af9f5646ace92f76b3a01b0abe08716a0a7ded64074c2d2e712c93174b9013d1-1:1508866932:YES:FUNDING", } {% endhighlight %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/importmulti.md b/_includes/devdoc/dash-core/rpcs/rpcs/importmulti.md index 32810d77..de8dfe10 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/importmulti.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/importmulti.md @@ -7,15 +7,14 @@ http://opensource.org/licenses/MIT. ##### ImportMulti {% include helpers/subhead-links.md %} + + {% assign summary_importMulti="imports addresses or scripts (with private keys, public keys, or P2SH redeem scripts) and optionally performs the minimum necessary rescan for all imports." %} {% autocrossref %} -*Added in Bitcoin Core 0.14.0* +*Added in Dash Core 0.12.3 / Bitcoin Core 0.14.0* -{{WARNING_ICON}} **_Not implemented in Dash Core (as of 0.12.2)_** - -{% comment %} *Requires wallet support. Wallet must be unlocked.* The `importmulti` RPC {{summary_importMulti}} @@ -123,27 +122,27 @@ The `importmulti` RPC {{summary_importMulti}} p: "Optional
(0 or 1)" d: "The error code" -- n: "→ → →
`message`" +- n: "→ → →
`message`" t: "string" p: "Optional
(0 or 1)" d: "The error message" {% enditemplate %} -*Example from Bitcoin Core 0.14.1* +*Example from Dash Core 0.12.3* -Import the address 1NL9w5fP9kX2D9ToNZPxaiwFJCngNYEYJo (giving it a label and scanning the entire block chain) and the scriptPubKey 76a9149e857da0a5b397559c78c98c9d3f7f655d19c68688ac (giving a specific timestamp and label): +Import the address `ycCsAUKsjdmoP4qAXiS1cjYA4ixM48zJWe` (giving it a label and scanning the entire block chain) and the scriptPubKey `76a9146cf5870411edc31ba5630d61c7cddff55b884fda88ac` (giving a specific timestamp and label): {% highlight bash %} -bitcoin-cli importmulti ' +dash-cli importmulti ' [ { - "scriptPubKey" : { "address": "1NL9w5fP9kX2D9ToNZPxaiwFJCngNYEYJo" }, + "scriptPubKey" : { "address": "ycCsAUKsjdmoP4qAXiS1cjYA4ixM48zJWe" }, "timestamp" : 0, "label" : "Personal" }, { - "scriptPubKey" : "76a9149e857da0a5b397559c78c98c9d3f7f655d19c68688ac", + "scriptPubKey" : "76a9146cf5870411edc31ba5630d61c7cddff55b884fda88ac", "timestamp" : 1493912405, "label" : "TestFailure" } @@ -153,18 +152,18 @@ bitcoin-cli importmulti ' Result (scriptPubKey import failed because `internal` was not set to `true`): {% highlight json %} - [ - { - "success": true - }, - { - "success": false, - "error": { +[ + { + "success": true + }, + { + "success": false, + "error": { "code": -8, "message": "Internal must be set for hex scriptPubKey" - } } - ] + } +] {% endhighlight %} *See also* @@ -173,6 +172,4 @@ Result (scriptPubKey import failed because `internal` was not set to `true`): * [ImportAddress][rpc importaddress]: {{summary_importAddress}} * [ImportWallet][rpc importwallet]: {{summary_importWallet}} -{% endcomment %} - {% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/importprunedfunds.md b/_includes/devdoc/dash-core/rpcs/rpcs/importprunedfunds.md index 7f4c2631..d3dc8892 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/importprunedfunds.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/importprunedfunds.md @@ -7,15 +7,14 @@ http://opensource.org/licenses/MIT. ##### ImportPrunedFunds {% include helpers/subhead-links.md %} + + {% assign summary_importPrunedFunds="imports funds without the need of a rescan. Meant for use with pruned wallets." %} {% 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 %} *Requires wallet support.* The `importprunedfunds` RPC {{summary_importPrunedFunds}} Corresponding address or script must previously be included in wallet. @@ -52,7 +51,7 @@ outputs or rescan after the point in the blockchain the transaction is included. {% enditemplate %} -*Example from Bitcoin Core 0.13.1* +*Example from Dash Core 0.12.3* {% highlight bash %} bitcoin-cli importprunedfunds "txhex" "txoutproof" @@ -65,6 +64,4 @@ bitcoin-cli importprunedfunds "txhex" "txoutproof" * [ImportPrivKey][rpc importprivkey]: {{summary_importPrivKey}} * [RemovePrunedFunds][rpc removeprunedfunds]: {{summary_removePrunedFunds}} -{% endcomment %} - {% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/listaddressbalances.md b/_includes/devdoc/dash-core/rpcs/rpcs/listaddressbalances.md new file mode 100644 index 00000000..6deed894 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/listaddressbalances.md @@ -0,0 +1,63 @@ +{% 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/listaddressbalances.md" %} + +##### ListAddressBalances +{% include helpers/subhead-links.md %} + +{% assign summary_listAddressBalances="lists addresses of this wallet and their balances" %} + + + +{% autocrossref %} + +The `listaddressbalances` RPC {{summary_listAddressBalances}} + +*Parameter #1---Minimum Amount* + +{% itemplate ntpd1 %} +- n: "Minimum Amount" + t: "numeric (int)" + p: "Optional
(0 or 1)" + d: "Minimum balance in DASH an address should have to be shown in the list (default=0)" + +{% enditemplate %} + +*Result---an object containing the addresses and their balances* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "object" + p: "Required
(exactly 1)" + d: "An object containing key/value pairs corresponding to the addresses with balances > the minimum amount. May be empty" + +- n: "→
Address/Amount" + t: "string (base58):
number (DASH)" + p: "Optional
(1 or more)" + d: "A key/value pair with a base58check-encoded string containing the address as the key, and an amount of DASH as the value" + +{% enditemplate %} + +*Example from Dash Core 0.12.3* + +{% highlight bash %} +dash-cli -testnet listaddressbalances 25 +{% endhighlight %} + +Result: +{% highlight json %} +{ + "yMQtQkcMBXrAZyqTGZeg7tQHzmbypGEP4w": 299.99990000, + "yRyfgrHm4f5A8GGvqpqTFvbCrCQHJm1L4V": 99.13570000, + "ybePwhPzUbiWzFhkgxPgP6iHnTLTyFH6sU": 123.45600000, + "ycCdPQnjNEVRgrQY8j6mxEx9h7oaQpo5Ge": 500.00000000 +} +{% endhighlight %} + +*See also:* + +* [ListAddressGroupings][rpc listaddressgroupings]: {{summary_listAddressGroupings}} + +{% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/listaddressgroupings.md b/_includes/devdoc/dash-core/rpcs/rpcs/listaddressgroupings.md index 52aaca26..4d15ba83 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/listaddressgroupings.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/listaddressgroupings.md @@ -91,5 +91,6 @@ Result (edited to only three results): * [GetAddressesByAccount][rpc getaddressesbyaccount]: {{summary_getAddressesByAccount}} * [GetTransaction][rpc gettransaction]: {{summary_getTransaction}} +* [ListAddressBalances][rpc listaddressbalances]: {{summary_listAddressBalances}} {% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/listunspent.md b/_includes/devdoc/dash-core/rpcs/rpcs/listunspent.md index 4763d8af..11a5ce3d 100644 --- 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
(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
(exactly 1)" d: "The number of confirmations received for the transaction containing this output" -- n: "→ →
`ps_rounds`" - t: "number (int)" - p: "Required
(exactly 1)" - d: "The number of PrivateSend rounds" - - n: "→ →
`spendable`" t: "bool" p: "Required
(exactly 1)" @@ -122,9 +128,14 @@ the *spendable* field in the results described below. p: "Required
(exactly 1)" d: "*Added in Bitcoin Core 0.13.0*
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: "→ →
`ps_rounds`" + t: "number (int)" + p: "Required
(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 %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/masternode.md b/_includes/devdoc/dash-core/rpcs/rpcs/masternode.md index 4c380e0b..071813bf 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/masternode.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/masternode.md @@ -30,7 +30,7 @@ The `masternode count` RPC prints the number of all known masternode - n: "Mode" t: "string (hex)" p: "Optional
(exactly 1)" - d: "Which masternodes to count:
`ps` - PrivateSend capable,
`enabled` - Enabled,
`all` - All,
`qualify` - Eligible for payment" + d: "Which masternodes to count:
`total` - Pre-0.12.3 default result,
`ps` - PrivateSend capable,
`enabled` - Enabled,
`all` - All,
`qualify` - Eligible for payment" {% enditemplate %} @@ -38,13 +38,33 @@ The `masternode count` RPC prints the number of all known masternode {% itemplate ntpd1 %} - n: "`result`" - t: "string (hex)" + t: "object" p: "Required
(exactly 1)" - d: "Transaction ID for the collateral transaction" + d: "Masternode count by mode" + +- n: "→
`total`" + t: "int" + p: "Required
(exactly 1)" + d: "Count of all masternodes" + +- n: "→
`ps_compatible`" + t: "int" + p: "Required
(exactly 1)" + d: "Count of PrivateSend compatible masternodes" + +- n: "→
`enabled`" + t: "int" + p: "Required
(exactly 1)" + d: "Count of enabled masternodes" + +- n: "→
`qualify`" + t: "int" + p: "Required
(exactly 1)" + d: "Count of masternodes qualified to receive payment" {% enditemplate %} -*Example from Dash Core 0.12.2* +*Example from Dash Core 0.12.3* {% highlight bash %} dash-cli -testnet masternode count @@ -52,10 +72,28 @@ dash-cli -testnet masternode count Result: {% highlight bash %} -120 +{ + "total": 142, + "ps_compatible": 13, + "enabled": 13, + "qualify": 6 +} {% endhighlight %} -Get summarized count of all masternodes + +**Get summarized count of all masternodes** + +*Result---summary of known masternodes* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "string" + p: "Required
(exactly 1)" + d: "Summary of masternodes in each state" + +{% enditemplate %} + +*Example from Dash Core 0.12.3* {% highlight bash %} dash-cli -testnet masternode count all @@ -66,6 +104,29 @@ Result: Total: 129 (PS Compatible: 97 / Enabled: 97 / Qualify: 90) {% endhighlight %} +**Get total count of all masternodes (default output of `masternode count` pre-0.12.3)** + +*Result---number of known masternodes in mode* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "int" + p: "Required
(exactly 1)" + d: "Number of masternodes" + +{% enditemplate %} + +*Example from Dash Core 0.12.3* + +{% highlight bash %} +dash-cli -testnet masternode count total +{% endhighlight %} + +Result: +{% highlight bash %} +142 +{% endhighlight %} + {% endautocrossref %} ###### Masternode Current diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/masternodelist.md b/_includes/devdoc/dash-core/rpcs/rpcs/masternodelist.md index 2f54f3bd..d51aa6ac 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/masternodelist.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/masternodelist.md @@ -7,6 +7,8 @@ http://opensource.org/licenses/MIT. ##### MasternodeList {% include helpers/subhead-links.md %} + + {% assign summary_masternodeList="returns a list of masternodes in different modes." %} {% autocrossref %} @@ -23,14 +25,16 @@ The `masternodelist` RPC {{summary_masternodeList}} {% enditemplate %} -*Mode Options* +*Mode Options (Default=json)* Mode | Description --- | --- | --- | `activeseconds` | Print number of seconds masternode recognized by the network as enabled (since latest issued \"masternodestart/start-many/start-alias\") `addr` | Print ip address associated with a masternode (can be additionally filtered, partial match) +`daemon` | Print daemon version of a masternode (can be additionally filtered, exact match) `full` | Print info in format 'status protocol payee lastseen activeseconds lastpaidtime lastpaidblock IP' (can be additionally filtered, partial match) `info` | Print info in format 'status protocol payee lastseen activeseconds sentinelversion sentinelstate IP' (can be additionally filtered, partial match) +`json` (Default) | Print info in JSON format (can be additionally filtered, partial match) `lastpaidblock` | Print the last block height a node was paid on the network `lastpaidtime` | Print the last time a node was paid on the network `lastseen` | Print timestamp of when a masternode was last seen on the network @@ -38,7 +42,8 @@ Mode | Description `protocol` | Print protocol of a masternode (can be additionally filtered, exact match) `pubkey` | Print the masternode (not collateral) public key `rank` | Print rank of a masternode based on current block -`status` | Print masternode status: PRE_ENABLED / ENABLED / EXPIRED / WATCHDOG_EXPIRED / NEW_START_REQUIRED / UPDATE_REQUIRED / POSE_BAN / OUTPOINT_SPENT (can be additionally filtered, partial match) +`sentinel` | Print sentinel version of a masternode (can be additionally filtered, exact match) +`status` | Print masternode status: PRE_ENABLED / ENABLED / EXPIRED / SENTINEL_PING_EXPIRED / NEW_START_REQUIRED / UPDATE_REQUIRED / POSE_BAN / OUTPOINT_SPENT (can be additionally filtered, partial match) *Parameter #2---List filter* @@ -65,7 +70,7 @@ Mode | Description {% enditemplate %} -*Example from Dash Core 0.12.2* +*Example from Dash Core 0.12.3* Get unfiltered Masternode list in default mode @@ -76,43 +81,123 @@ dash-cli -testnet masternodelist Result: {% highlight json %} { - "6125fc1da46cd2fdd013b1fbb02144367a95feffd379c08064f38de0e3deb80c-1": "NEW_START_REQUIRED", - "a4676419793d232359dfd7240bf1b0635b56f2a16aac4cb57f7e9ba459d50116-1": "ENABLED", - "2b5142cc7b5472cb34a28e7e1fdefe14f0b1ad4cc9fa9cdc68a169423c18c31d-1": "ENABLED", - "4573c2ba5d9d3f8fd2f903cd0f448ee0ad0ff7e20d8f44a14cfce0bdc894c627-1": "ENABLED", - "08c91dfff1f465b70377007426cd5edc37678991c9a864e39072409a5a0fd22a-1": "ENABLED", - "e3a6b7878a7e9413898bb379b323c521676f9d460db17ec3bf42d9ac0c9a432f-1": "ENABLED", - "866d66b88afed15ed1a936b680ace1a99e0ca14d0242bc2983c5fdd2c16c1637-1": "NEW_START_REQUIRED", - "97034d0cfabef04388f3eb1c78a064607f8ed42013ed0fb821361d6592f03338-0": "ENABLED", - "3003df6b886ed4b0cc84453d8034a546da03fc1052c2088b6b38fd84a4f6fa3f-1": "ENABLED", - "61c4696947438861222d7e992a049bfd2ed87f71eb806d8a111c973215141b59-1": "ENABLED", - "ea7e0a87aa823aa65d111ed767a4a02f55b3cd361cbd250908db00822e72fb59-1": "ENABLED", - "f7851e7f670afa3e758d857c48d477b2f3e1ee37f22de2ca4a852f3885d32e6d-1": "EXPIRED", - "f977fba1db0fd32708f0b9488be3806fed6f013a28630cff25ba06abd1f63d72-1": "ENABLED", - "b418a47e8dfbdbb8eb88c1a153bef27dcbdb057eb136b2bb93b439fe74b8c174-1": "ENABLED", - "7c17695bdccc617410164882bd8b5fb7bf4f5a3dceb0a7476800e161cba1c57f-1": "NEW_START_REQUIRED", - "547a86612325ff23945b052a023537aaa68140920143bbf42bd10aec33348487-1": "ENABLED", - "2c2cf299fdca7c07f820b1bc46bd786a1d57ac6c3d2e76ac24a5ba7641066488-0": "ENABLED", - "75fdd0e1dea139333b71f06f3f2a7440629b3cd106e655ae50b56df7d9aa788b-1": "ENABLED", - "320f83802b37f4bbf881cb565bb6e0884615d6b022a81a837cd3716f8dbcec93-0": "ENABLED", - "049f30949af536b0a866f7d39d05447405565160399d12b4f0796936e8b9b9a7-1": "ENABLED", - "0512f77ebceaf288386e9a050e3c80652c7bfb6e993659ded2dff43eae6904ac-1": "EXPIRED", - "94ce1c802de83977fbed283806a1ebef2dcb5539ce9b6c5627c5ac1d844b48bb-1": "ENABLED", - "b0320c1eff10ccb5e26086017a09e77dacb30fdcafccb3d98db3e5b610b9f1bd-1": "ENABLED", - "2eab488e3a7b030303de0d18e357ce17a9fc6b8876705d61076bbe923b2e5fc8-1": "ENABLED", - "18e496fe85b61ac9a5fcaec1ef683c7e3fc9bce4a83c883608427ecfb1002fca-1": "ENABLED", - "2fb6c98b37f1fce1c35b556e5f175dd77939f08c1687ad468d37fc677d297dd6-1": "ENABLED", - "1e2502158eb22e53c07dbae483e89ebd7fb27e2c0412147d4d376b99df1d94db-1": "ENABLED", - "cd0ee654eb517b8b5c36cfa09e1e5344d1766dc71406a112564636b7aef8c9db-1": "ENABLED", - "4222505288507e0f1abc32f0323cce1d6c4d22c8e785adb0cf8075b70ae92ddf-1": "EXPIRED", - "9f0cd683f88f79f757c6d68515dfb2b9fa5b65239b3c5f4487916aa233b9a4e0-1": "ENABLED", - "2102df0dec504b4bd3a1e80b320c5205fe1a8b2fb1366be83c407f048fd62ce6-1": "ENABLED", - "c6585f4ba88875eb2edc376b9ae24b74fd8c0ef89288923cf16a8fe2787b7ce8-1": "ENABLED", - "b454dd0efc19657f8d56a750385b90ebfb53dce5182a21238b225d6cbb3307f0-1": "NEW_START_REQUIRED", - "400f193988092f779104bab20eec042a2686a9903b1bbc84ece7539fd41103f3-1": "ENABLED", - "a087bcb1c2f7fc71f081f2d8eeeeb4928ae21af2087c3d77ce5a5c4e88ec26f4-1": "ENABLED", - "100a6ef1f9c660cfc6e47dab9905d7ca2a435f1870aba46847eae6503e2858fd-1": "ENABLED", - "bbbe50330423337a13501e6273663884f7cb9b475f6d5cf090ba3dabc611d9fe-1": "ENABLED" + "83ab0eaeffc212fab5aea4a3057fba51dafdfa6da8b29c3f0de62ed9319fea03-0": { + "address": "203.0.113.1:19999", + "payee": "yiz8WZ9VY9F7SyGuc8mXj6wrDERs6T47B1", + "status": "ENABLED", + "protocol": 70208, + "daemonversion": "Unknown", + "sentinelversion": "1.0.2", + "sentinelstate": "current", + "lastseen": 1520876844, + "activeseconds": 3389581, + "lastpaidtime": 1520868832, + "lastpaidblock": 89879 + }, + "33a833559acc50b63e0909a550d10af26f41043382a9eed30e5218df5adf5304-1": { + "address": "203.0.113.2:39999", + "payee": "yfY21tLcuKtohnkKtwBQXzEKFapwuhb9FE", + "status": "ENABLED", + "protocol": 70208, + "daemonversion": "Unknown", + "sentinelversion": "1.1.0", + "sentinelstate": "current", + "lastseen": 1520876480, + "activeseconds": 2110895, + "lastpaidtime": 1520866020, + "lastpaidblock": 89862 + }, + "54754314335419cc04ef09295ff7765c8062a6123486aed55fd7e9b04f300b13-0": { + "address": "203.0.113.3:20019", + "payee": "ycn5RWc4Ruo35FTS8bJwugVyCEkfVcrw9a", + "status": "NEW_START_REQUIRED", + "protocol": 70208, + "daemonversion": "Unknown", + "sentinelversion": "Unknown", + "sentinelstate": "expired", + "lastseen": 1517843286, + "activeseconds": 0, + "lastpaidtime": 1520873295, + "lastpaidblock": 89898 + }, + "a4676419793d232359dfd7240bf1b0635b56f2a16aac4cb57f7e9ba459d50116-1": { + "address": "203.0.113.4:19999", + "payee": "ydZHEVgMX67xsi97BhN8KoacN6SCMz6Xho", + "status": "SENTINEL_PING_EXPIRED", + "protocol": 70208, + "daemonversion": "Unknown", + "sentinelversion": "1.0.2", + "sentinelstate": "expired", + "lastseen": 1520876776, + "activeseconds": 7694877, + "lastpaidtime": 0, + "lastpaidblock": 0 + }, + "3d64bd65cb84b935278420de3673cba33470a1e1996c4debfccb5d722254404c-1": { + "address": "203.0.113.5:19999", + "payee": "ySkDc9dHns1AFcjJzGqNmkNnErjakcB2Bp", + "status": "ENABLED", + "protocol": 70208, + "daemonversion": "Unknown", + "sentinelversion": "1.0.2", + "sentinelstate": "current", + "lastseen": 1520876576, + "activeseconds": 10796968, + "lastpaidtime": 1520876143, + "lastpaidblock": 89922 + }, + "54355b4b4d26b84821dab6e0e1c0bded7d8fefc72414f22f45515d1732f1c8e6-1": { + "address": "203.0.113.6:29999", + "payee": "yPk4NCyqvWjeJbE3tW1wmJ9LV2wgVLiYRT", + "status": "ENABLED", + "protocol": 70208, + "daemonversion": "Unknown", + "sentinelversion": "1.1.0", + "sentinelstate": "current", + "lastseen": 1520876323, + "activeseconds": 2110746, + "lastpaidtime": 1520875985, + "lastpaidblock": 89920 + }, + "c6585f4ba88875eb2edc376b9ae24b74fd8c0ef89288923cf16a8fe2787b7ce8-1": { + "address": "203.0.113.7:19999", + "payee": "yP1UHNx26ShYLej56SbHiTiPAUv2QppbUv", + "status": "SENTINEL_PING_EXPIRED", + "protocol": 70208, + "daemonversion": "Unknown", + "sentinelversion": "1.0.2", + "sentinelstate": "expired", + "lastseen": 1520876884, + "activeseconds": 7694986, + "lastpaidtime": 0, + "lastpaidblock": 0 + }, + "b7d45ac3d8c5ddea9ff90d81d92d362e09713a06b2a0089f49c7deb9b2521fef-0": { + "address": "203.0.113.8:19999", + "payee": "yN4iFe7a2G6YYoBtUXcoyixCTV3vDzWSrS", + "status": "NEW_START_REQUIRED", + "protocol": 70208, + "daemonversion": "Unknown", + "sentinelversion": "1.0.2", + "sentinelstate": "current", + "lastseen": 1508842770, + "activeseconds": 416775, + "lastpaidtime": 0, + "lastpaidblock": 0 + }, + "5ef4e5c9d09f6fb927b7b815ea2736ddfce468021d49704acfc3bb7939b425ff-1": { + "address": "203.0.113.9:19999", + "payee": "yPwTQgY8JDFaDjAgUdHmapG4SmzY6SDbE9", + "status": "ENABLED", + "protocol": 70208, + "daemonversion": "Unknown", + "sentinelversion": "1.1.0", + "sentinelstate": "current", + "lastseen": 1520876862, + "activeseconds": 2111317, + "lastpaidtime": 1520872118, + "lastpaidblock": 89892 + } } {% endhighlight %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/preciousblock.md b/_includes/devdoc/dash-core/rpcs/rpcs/preciousblock.md index 3c0d25f3..9057814e 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/preciousblock.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/preciousblock.md @@ -7,15 +7,13 @@ http://opensource.org/licenses/MIT. ##### PreciousBlock {% include helpers/subhead-links.md %} + + {% assign summary_preciousBlock="treats a block as if it were received before others with the same work." %} {% autocrossref %} -*Added in Bitcoin Core 0.14.0* - -**_Not implemented in Dash Core (as of 0.12.2)_** - -{% comment %} +*Added in Dash Core 0.12.3 / Bitcoin Core 0.14.0* The `preciousblock` RPC {{summary_preciousBlock}} A later `preciousblock` call can override the effect of an earlier one. The effects of `preciousblock` are not retained across restarts. @@ -39,15 +37,13 @@ The `preciousblock` RPC {{summary_preciousBlock}} A later `preciousblock` call c {% enditemplate %} -*Example from Bitcoin Core 0.14.1* +*Example from Dash Core 0.12.3* {% highlight bash %} -bitcoin-cli preciousblock 000000000000000001517a0bac70b8cd6f27ee\ -1b50a8f12bf606ea6fb6d561cd +dash-cli preciousblock 00000000034d77e287b63922a94f12e8c4ab9e\ +1d8056060fd51f6153ea5dc757 {% endhighlight %} -Result (no output from `bitcoin-cli` because result is set to `null`). - -{% endcomment %} +Result (no output from `dash-cli` because result is set to `null`). {% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/privatesend.md b/_includes/devdoc/dash-core/rpcs/rpcs/privatesend.md index ff886173..bd303a9b 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/privatesend.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/privatesend.md @@ -11,6 +11,8 @@ http://opensource.org/licenses/MIT. {% autocrossref %} +As of Dash Core 0.12.3, client-side mixing is not supported on masternodes. + The `privatesend` RPC {{summary_privateSend}} {% itemplate ntpd1 %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/pruneblockchain.md b/_includes/devdoc/dash-core/rpcs/rpcs/pruneblockchain.md index 6fec51d4..9d8050ad 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/pruneblockchain.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/pruneblockchain.md @@ -7,15 +7,13 @@ http://opensource.org/licenses/MIT. ##### PruneBlockChain {% include helpers/subhead-links.md %} + + {% assign summary_pruneBlockChain="prunes the blockchain up to a specified height or timestamp." %} {% autocrossref %} -*Added in Bitcoin Core 0.14.0* - -**_Not implemented in Dash Core (as of 0.12.2)_** - -{% comment %} +*Added in Dash Core 0.12.3 / Bitcoin Core 0.14.0* The `pruneblockchain` RPC {{summary_pruneBlockChain}} The `-prune` option needs to be enabled (disabled by default). @@ -39,10 +37,10 @@ The `pruneblockchain` RPC {{summary_pruneBlockChain}} The `-prune` option needs {% enditemplate %} -*Examples from Bitcoin Core 0.14.1* +*Examples from Dash Core 0.12.3* {% highlight bash %} -bitcoin-cli pruneblockchain 413555 +dash-cli pruneblockchain 413555 {% endhighlight %} Result: @@ -55,6 +53,4 @@ Result: * [ImportPrunedFunds][rpc importprunedfunds]: {{summary_importPrunedFunds}} -{% endcomment %} - {% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/removeprunedfunds.md b/_includes/devdoc/dash-core/rpcs/rpcs/removeprunedfunds.md index c93b44e1..e4bdd83f 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/removeprunedfunds.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/removeprunedfunds.md @@ -7,15 +7,14 @@ http://opensource.org/licenses/MIT. ##### RemovePrunedFunds {% include helpers/subhead-links.md %} + + {% assign summary_removePrunedFunds="deletes the specified transaction from the wallet. Meant for use with pruned wallets and as a companion to importprunedfunds." %} {% 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 %} *Requires wallet support.* The `removeprunedfunds` RPC {{summary_removePrunedFunds}} This will effect wallet balances. @@ -40,11 +39,11 @@ The `removeprunedfunds` RPC {{summary_removePrunedFunds}} This will effect walle {% enditemplate %} -*Example from Bitcoin Core 0.13.1* +*Example from Dash Core 0.12.3* {% highlight bash %} -bitcoin-cli removeprunedfunds a8d0c0184dde994a09ec054286f1ce581b\ -ebf46446a512166eae7628734ea0a5 +dash-cli removeprunedfunds bb7daff525b83fa6a847ab50bf7f8f14d6\ +22761a19f69157b362ef3f25bda687 {% endhighlight %} (Success: no result displayed.) @@ -54,6 +53,4 @@ ebf46446a512166eae7628734ea0a5 * [ImportPrivKey][rpc importprivkey]: {{summary_importPrivKey}} * [ImportPrunedFunds][rpc importprunedfunds]: {{summary_importPrunedFunds}} -{% endcomment %} - {% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/setbip69enabled.md b/_includes/devdoc/dash-core/rpcs/rpcs/setbip69enabled.md new file mode 100644 index 00000000..c6dd21c5 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/setbip69enabled.md @@ -0,0 +1,48 @@ +{% 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/setbip69enabled.md" %} + +##### SetBIP69Enabled +{% include helpers/subhead-links.md %} + +{% assign summary_setBIP69Enabled="enables or disables BIP69 input/output sorting (regtest network only)" %} + + + +{% autocrossref %} + +The `setbip69enabled` RPC {{summary_setBIP69Enabled}} + +*Parameter #1---enable/disable BIP69 sorting (regtest only)* + +{% itemplate ntpd1 %} +- n: "`enable`" + t: "boolean" + p: "Required
(exactly 1)" + d: "Set to true to turn on BIP69 sorting, false to turn off." + +{% enditemplate %} + +*Result---`null` or error on failure* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "null" + p: "Required
(exactly 1)" + d: "JSON `null`. The JSON-RPC error field will be set only if you entered an invalid parameter" + +{% enditemplate %} + +*Example from Dash Core 0.12.3* + +{% highlight bash %} +dash-cli -testnet setbip69enabled true +{% endhighlight %} + +Result (no output from `dash-cli` because result is set to `null`). + +*See also: none* + +{% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/setgenerate.md b/_includes/devdoc/dash-core/rpcs/rpcs/setgenerate.md index 7b8bcdf4..9de1db84 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/setgenerate.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/setgenerate.md @@ -7,13 +7,15 @@ http://opensource.org/licenses/MIT. ##### SetGenerate {% include helpers/subhead-links.md %} -{% assign summary_setGenerate="enables or disables hashing to attempt to find the next block." %} +{% assign summary_setGenerate="was removed in Dash Core 0.12.3." %} + + {% autocrossref %} *Requires wallet support.* -*Removed in Bitcoin Core 0.13.0.* +**_Removed in Dash Core 0.12.3 / Bitcoin Core 0.13.0._** The `setgenerate` RPC {{summary_setGenerate}} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/signmessagewithprivkey.md b/_includes/devdoc/dash-core/rpcs/rpcs/signmessagewithprivkey.md index c0388145..234da417 100644 --- 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
(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
(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 %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/spork.md b/_includes/devdoc/dash-core/rpcs/rpcs/spork.md index 2ac92546..385f6e96 100644 --- a/_includes/devdoc/dash-core/rpcs/rpcs/spork.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/spork.md @@ -44,7 +44,7 @@ To display the status of sporks, use the `show` or `active` syntax. {% enditemplate %} -*Example from Dash Core 0.12.2* +*Example from Dash Core 0.12.3* {% highlight bash %} dash-cli -testnet spork show @@ -55,12 +55,12 @@ Result: { "SPORK_2_INSTANTSEND_ENABLED": 0, "SPORK_3_INSTANTSEND_BLOCK_FILTERING": 0, - "SPORK_5_INSTANTSEND_MAX_VALUE": 1000, + "SPORK_5_INSTANTSEND_MAX_VALUE": 3000, + "SPORK_6_NEW_SIGS": 4000000000, "SPORK_8_MASTERNODE_PAYMENT_ENFORCEMENT": 0, "SPORK_9_SUPERBLOCKS_ENABLED": 0, "SPORK_10_MASTERNODE_PAY_UPDATED_NODES": 0, "SPORK_12_RECONSIDER_BLOCKS": 0, - "SPORK_13_OLD_SUPERBLOCK_FLAG": 4070908800, "SPORK_14_REQUIRE_SENTINEL_FLAG": 0 } {% endhighlight %} @@ -82,7 +82,7 @@ Result: {% enditemplate %} -*Example from Dash Core 0.12.2* +*Example from Dash Core 0.12.3* {% highlight bash %} dash-cli -testnet spork active @@ -94,11 +94,11 @@ Result: "SPORK_2_INSTANTSEND_ENABLED": true, "SPORK_3_INSTANTSEND_BLOCK_FILTERING": true, "SPORK_5_INSTANTSEND_MAX_VALUE": true, + "SPORK_6_NEW_SIGS": false, "SPORK_8_MASTERNODE_PAYMENT_ENFORCEMENT": true, "SPORK_9_SUPERBLOCKS_ENABLED": true, "SPORK_10_MASTERNODE_PAY_UPDATED_NODES": true, "SPORK_12_RECONSIDER_BLOCKS": true, - "SPORK_13_OLD_SUPERBLOCK_FLAG": false, "SPORK_14_REQUIRE_SENTINEL_FLAG": true } {% endhighlight %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/validateaddress.md b/_includes/devdoc/dash-core/rpcs/rpcs/validateaddress.md index 35b8ce6d..b70a942c 100644 --- 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
(0 or 1)" d: "*Deprecated: will be removed in a later version of Bitcoin Core*
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: "→
`timestamp`" + t: "number (int)" + p: "Optional
(0 or 1)" + d: "*Added in Dash Core 0.12.3*
The creation time of the key if available in seconds since epoch (Jan 1 1970 GMT)" + - n: "→
`hdkeypath`" t: "string" p: "Optional
(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 %} diff --git a/_includes/devdoc/example_intro.md b/_includes/devdoc/example_intro.md index 68616452..1cbd739b 100644 --- a/_includes/devdoc/example_intro.md +++ b/_includes/devdoc/example_intro.md @@ -26,6 +26,13 @@ Once installed, you'll have access to three programs: `dashd`, * `dash-cli` allows you to send RPC commands to `dashd` from the command line. For example, `dash-cli help` +{% endautocrossref %} + +### Configuration file + + +{% autocrossref %} + All three programs get settings from `dash.conf` in the `DashCore` application directory: @@ -53,8 +60,8 @@ directory: chmod 0600 dash.conf ~~~ -For development, it's safer and cheaper to use Dash's test network (testnet) -or regression test mode (regtest) described below. +For development, it's safer and cheaper to use Dash's test network (testnet), +regression test mode (regtest), or a develper network (devnet) described below. Questions about Dash use are best sent to the [Dash forum][forum tech support] and [Discord channels][Discord channels]. Errors or suggestions related to diff --git a/_includes/devdoc/example_testing.md b/_includes/devdoc/example_testing.md index 1184c7ea..b0b18465 100644 --- a/_includes/devdoc/example_testing.md +++ b/_includes/devdoc/example_testing.md @@ -109,3 +109,63 @@ configuration directory locations on various operating systems. Always back up mainnet wallets before performing dangerous operations such as deleting.) {% endautocrossref %} + +### Devnet Mode +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +Developer networks (devnets) have some aspects of testnet and some aspects of +regtest. Unlike testnet, multiple independent devnets can be created and coexist +without interference. Each one is identified by a name which is hardened into a +"devnet genesis" block, which is automatically positioned at height 1. Validation +rules will ensure that a node from `devnet=test1` never be able to +accept blocks from `devnet=test2`. This is done by checking the +expected devnet genesis block. + +The genesis block of the devnet is the same as the one from regtest. This +starts the devnet with a very low difficulty, allowing quick generation of a +sufficient balance to create a masternode. + +The devnet name is put into the sub-version of the `version` message. +If a node connects to the wrong network, it will immediately be disconnected. + +To use devnet, use the argument `-devnet=
(Nov 2017) | • DIP-0001 (2MB blocks)
• Fee reduction (10x)
• InstantSend fix
• PrivateSend improvements
• _Experimental_ HD wallet
• Local Masternode support removed +| 70210 | Dash Core 0.12.3.x
(July 2018) | • Named Devnets
• New signature format / Spork 6 addition
• Bitcoin Core 0.13/0.14 backports
• [BIP90][]: Buried deployments
• [BIP147][]: NULLYDUMMY enforcement
• [BIP152][] Compact Blocks
• Transaction version increased to 2
• Zero fee transactions removed
• Pruning in Lite Mode +| 70208 | Dash Core 0.12.2.x
(Nov 2017) | • [DIP1][] (2MB blocks)
• Fee reduction (10x)
• InstantSend fix
• PrivateSend improvements
• _Experimental_ HD wallet
• Local Masternode support removed | 70206 | Dash Core 0.12.1.x
(Mar 2017) | • Switch to Bitcoin Core 0.12.1
• BIP-0065 (CheckLockTimeVerify)
• BIP-0112 (CheckSequenceVerify) | 70103 | Dash Core 0.12.0.x
(Aug 2015) | • Switch to Bitcoin Core 0.10
• Decentralized budget system
• New IX implementation | 70076 | Dash Core 0.11.2.x
(Mar 2015) | • Masternode enhancements
• Mining/relay policy enhancements
• BIP-66 - strict DER encoding for signatures @@ -169,8 +173,9 @@ The currently-available type identifiers are: | 17 | [`MSG_GOVERNANCE_OBJECT`][msg_governance_object]{:#term-msg_governance_object}{:.term} | The hash is a Governance Object. | 18 | [`MSG_GOVERNANCE_OBJECT_VOTE`][msg_governance_object_vote]{:#term-msg_governance_object_vote}{:.term} | The hash is a Governance Object Vote. | 19 | [`MSG_MASTERNODE_VERIFY`][msg_masternode_verify]{:#term-msg_masternode_verify}{:.term} | The hash is a Masternode Verify. +| 20 | [`MSG_CMPCT_BLOCK`][msg_cmpct_block]{:#term-msg_cmpct_block}{:.term} | The hash is of a block header; identical to `MSG_BLOCK`. When used in a `getdata` message, this indicates the response should be a `cmpctblock` message. **Only for use in `getdata` messages.** -Type identifier zero and type identifiers greater than nineteen are reserved +Type identifier zero and type identifiers greater than twenty are reserved for future implementations. Dash Core ignores all inventories with one of these unknown types. @@ -199,6 +204,207 @@ different reasons: {% endautocrossref %} +#### Blocktxn +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +*Added in protocol version 70209 of Dash Core as described by BIP152* + +The `blocktxn` message sends requested block transactions to a node which +previously requested them with a `getblocktxn` message. It is defined as a message +containing a serialized `BlockTransactions` message. + +Upon receipt of a properly-formatted requested `blocktxn` message, nodes should: + +1. Attempt to reconstruct the full block by taking the prefilledtxn transactions from the original `cmpctblock` message and placing them in the marked positions +2. For each short transaction ID from the original `cmpctblock` message, in order, find the corresponding transaction (from either the `blocktxn` message or from other sources) +3. Place each short transaction ID in the first available position in the block +4. Once the block has been reconstructed, it shall be processed as normal. + +**Short transaction IDs are expected to occasionally collide. Nodes must +not be penalized for such collisions.** + +The structure of `BlockTransactions` is defined below. + +| Bytes | Name | Data Type | Encoding | Description| +|----------|----------------------|----------------------|----------|------------| +| 32 | blockhash | Binary blob | The output from a double-SHA256 of the block header, as used elsewhere | The blockhash of the block which the transactions being provided are in +| 1 or 3 | transactions
_length | CompactSize | As used to encode array lengths elsewhere | The number of transactions provided +| *Varies* | transactions | List of transactions | As encoded in `tx` messages in response to `getdata MSG_TX` | The transactions provided + +The following annotated hexdump shows a `blocktxn` message. (The +message header has been omitted.) + +{% highlight text %} +182327cb727da7d60541da793831fd0ab0509e79c8cd +3d654cdf3a0100000000 ....................... Block Hash + +01 ......................................... Transactions Provided: 1 + +Transaction(s) +| Transaction 1 +| | 01000000 ................................ Transaction Version: 1 +| | 01 ...................................... Input count: 1 +| | +| | Transaction input #1 +| | | +| | | 0952617a516d956e2ecee71a6adc249f +| | | 4bb757adcc409452ab98c8e55c31e62a ..... Outpoint TXID +| | | 00000000 ............................. Outpoint index number: 0 +| | | +| | | 6b ................................... Bytes in sig. script: 107 +| | | 483045022100d10edf447252e1e69ff1 +| | | 77330bb2c889a50be02e00cc5d79c0d0 +| | | 79ae56518fc40220245d36905dc950fc +| | | d55694cfde8cde3109dc80b12aca3a6e +| | | 332033802ee36e1b01210272cc6e7660 +| | | 2648831d8e80fca8eb24369cd0f23ff0 +| | | 79cf20ae9d9beee05de6db ............... Secp256k1 signature +| | | +| | | ffffffff ............................. Sequence number: UINT32_MAX +| | +| | 02 ..................................... Number of outputs: 02 +| | +| | Transaction output #1 +| | | 0be0f50500000000 ..................... Duffs (0.99999755 Dash) +| | | +| | | 19 ................................... Bytes in pubkey script: 25 +| | | | 76 ................................. OP_DUP +| | | | a9 ................................. OP_HASH160 +| | | | 14 ................................. Push 20 bytes as data +| | | | | 923d91ed359f650eec6ea8b9030b340d +| | | | | ea63d590 ......................... PubKey hash +| | | | 88 ................................. OP_EQUALVERIFY +| | | | ac ................................. OP_CHECKSIG +| | +| | [...] .................................. 1 more tx output omitted +| | +| | 00000000 ............................... locktime: 0 (a block height) +{% endhighlight %} + +{% endautocrossref %} + +#### CmpctBlock +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +*Added in protocol version 70209 of Dash Core as described by BIP152* + +The `cmpctblock` message is a reply to a `getdata` message which +requested a block using the inventory type `MSG_CMPCT_BLOCK`. If the +requested block was recently announced and is close to the tip of the +best chain of the receiver and after having sent the requesting peer +a `sendcmpct` message, nodes respond with a `cmpctblock` message containing +data for the block. + +**If the requested block is too old, the node responds with a *full non-compact block*** + +Upon receipt of a `cmpctblock` message, after sending a `sendcmpct` message, +nodes should calculate the short transaction ID for each unconfirmed +transaction they have available (i.e. in their mempool) and compare each +to each short transaction ID in the `cmpctblock` message. After finding +already-available transactions, nodes which do not have all transactions +available to reconstruct the full block should request the missing transactions +using a `getblocktxn` message. + +A node must not send a `cmpctblock` message unless they are able to respond to +a `getblocktxn` message which requests every transaction in the block. A node +must not send a `cmpctblock` message without having validated that the header properly +commits to each transaction in the block, and properly builds on top of the existing, +fully-validated chain with a valid proof-of-work either as a part of the current most-work +valid chain, or building directly on top of it. A node may send a `cmpctblock` message before +validating that each transaction in the block validly spends existing UTXO set entries. + +The `cmpctblock` message contains a vector of `PrefilledTransaction` whose +structure is defined below. A `PrefilledTransaction` is used in `HeaderAndShortIDs` +to provide a list of a few transactions explicitly. + +| Bytes | Name | Data Type | Encoding | Description| +|----------|----------------------|----------------------|----------|------------| +| 1 or 3 | index | CompactSize | Compact Size, differentially encoded since the last PrefilledTransaction in a list | The index into the block at which this transaction is +| *Varies* | tx | Transaction | As encoded in `tx` messages sent in response to `getdata MSG_TX` | Transaction which is in the block at index `index` + +The `cmpctblock` message is compromised of a serialized `HeaderAndShortIDs` +structure which is defined below. A `HeaderAndShortIDs` structure is used to +relay a block header, the short transactions IDs used for matching +already-available transactions, and a select few transactions which +we expect a peer may be missing. + +| Bytes | Name | Data Type | Encoding | Description| +|----------|----------------------|----------------------|----------|------------| +| 80 | header | Block header | First 80 bytes of the block as defined by the encoding used by `block` messages | The header of the block being provided +| 8 | nonce | uint64_t | Little Endian | A nonce for use in short transaction ID calculations +| 1 or 3 | shortids_
length | CompactSize | As used to encode array lengths elsewhere | The number of short transaction IDs in `shortids` (i.e. block tx count - `prefilledtxn`
`_length`) +| *Varies* | shortids | List of 6-byte integers | Little Endian | The short transaction IDs calculated from the transactions which were not provided explicitly in `prefilledtxn` +| 1 or 3 | prefilledtxn
_length | CompactSize | As used to encode array lengths elsewhere | The number of prefilled transactions in `prefilledtxn` (i.e. block tx count - `shortids`
`_length`) +| *Varies* | prefilledtxn | List of Prefilled
Transactions | As defined by `Prefilled`
`Transaction` definition below | Used to provide the coinbase transaction and a select few which we expect a peer may be missing + +**Short Transaction ID calculation** + +Short transaction IDs are used to represent a transaction without sending a full 256-bit hash. They are calculated as follows, + +* A single-SHA256 hashing the block header with the nonce appended (in little-endian) +* Running SipHash-2-4 with the input being the transaction ID and the keys (k0/k1) set to the first two little-endian 64-bit integers from the above hash, respectively. +* Dropping the 2 most significant bytes from the SipHash output to make it 6 bytes. + + +The following annotated hexdump shows a `cmpctblock` message. (The +message header has been omitted.) + +{% highlight text %} +00000020981178a4342cec6316296b2ad84c9b7cdf9f +2688e5d0fe1a0003cd0000000000f64870f52a3d0125 +1336c9464961216732b25fbf288a51f25a0e81bffb20 +e9600194d85a64a50d1cc02b0181 ................ Block Header + +3151b67e5b418b9d ............................ Nonce + +01 .......................................... Short IDs Length: 1 +483edcd3c799 ................................ Short IDs + +01 .......................................... Prefilled Transaction Length: 1 + +Prefilled Transactions +| 00 ........................................ Index: 0 +| +| Transaction 1 (Coinbase) +| | 01000000 ................................ Transaction Version: 1 +| | 01 ...................................... Input count: 1 +| | +| | Transaction input #1 +| | | +| | | 00000000000000000000000000000000 +| | | 00000000000000000000000000000000 ..... Outpoint TXID +| | | ffffffff ............................. Outpoint index number: UINT32_MAX +| | | +| | | 13 ................................... Bytes in sig. script: 19 +| | | 03daaf010e2f5032506f6f6c2d74444153482f Secp256k1 signature +| | | +| | | ffffffff ............................. Sequence number: UINT32_MAX +| | +| | 04 ..................................... Number of outputs: 04 +| | +| | Transaction output #1 +| | | ffe5654200000000 ..................... Duffs (11.13974271 Dash) +| | | +| | | 19 ................................... Bytes in pubkey script: 25 +| | | | 76 ................................. OP_DUP +| | | | a9 ................................. OP_HASH160 +| | | | 14 ................................. Push 20 bytes as data +| | | | | b885cb21ad12e593c1a46d814df47ccb +| | | | | 450a7d84 ......................... PubKey hash +| | | | 88 ................................. OP_EQUALVERIFY +| | | | ac ................................. OP_CHECKSIG +| | +| | [...] .................................. 3 more tx outputs omitted +| | +| | 00000000 ............................... locktime: 0 (a block height) +{% endhighlight %} + +{% endautocrossref %} + #### GetBlocks {% include helpers/subhead-links.md %} @@ -251,6 +457,46 @@ d39f608a7775b537729884d4e6633bb2 {% endautocrossref %} +#### GetBlockTxn +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +*Added in protocol version 70209 of Dash Core as described by BIP152* + +The `getblocktxn` message requests a `blocktxn` message for any transactions +that it has not seen after a compact block is received. It is defined as a +message containing a serialized `BlockTransactionsRequest` message. Upon receipt +of a properly-formatted `getblocktxn` message, nodes which recently provided the +sender of such a message with a `cmpctblock` message for the block hash +identified in this message must respond with either an appropriate +`blocktxn` message, or a full block message. + +A `blocktxn` message response must contain exactly and only each transaction +which is present in the appropriate block at the index specified in the +`getblocktxn` message indexes list, in the order requested. + +The structure of `BlockTransactionsRequest` is defined below. + +| Bytes | Name | Data Type | Encoding | Description| +|----------|-----------------|----------------------|----------|------| +| 32 | blockhash | Binary blob | The output from a double-SHA256 of the block header, as used elsewhere | The blockhash of the block which the transactions being requested are in +| *Varies* | indexes_length | CompactSize uint | As used to encode array lengths elsewhere | The number of transactions requested +| *Varies* | indexes | CompactSize uint[] | Differentially encoded | Vector of compactSize containing the indexes of the transactions being requested in the block. + +The following annotated hexdump shows a `getblocktxn` message. (The +message header has been omitted.) + +{% highlight text %} +182327cb727da7d60541da793831fd0a +b0509e79c8cd3d654cdf3a0100000000 ... Block Hash + +01 ................................. Index length: 1 +01 ................................. Index: 1 +{% endhighlight %} + +{% endautocrossref %} + #### GetData {% include helpers/subhead-links.md %} @@ -263,7 +509,7 @@ node typically previously received by way of an `inv` message. The response to a `getdata` message can be a `tx` message, `block` message, `merkleblock` message, `ix` message, `txlvote` message, `mnw` message, `mnb` message, `mnp` message, `dstx` message, `govobj` message, -`govobjvote` message, `mnv` message, or `notfound` message. +`govobjvote` message, `mnv` message, `notfound` message, or `cmpctblock` message. This message cannot be used to request arbitrary data, such as historic transactions no longer in the memory pool or relay set. Full nodes may @@ -1238,6 +1484,18 @@ ascending code number (primary) and alphabetic in reply to (secondary) --> | 0x10 | `ix` message | 32 | char[32] | InstantSend transaction is invalid for some reason (invalid tx lock request, conflicting tx lock request, etc.). Extra data may include the rejected transaction's TXID. | 0x11 | `block` message | 32 | char[32] | The block uses a version that is no longer supported. Extra data may include the rejected block's header hash. | 0x11 | `version` message | 0 | N/A | Connecting node is using a protocol version that the rejecting node considers obsolete and unsupported. +| 0x11 | `dsa` message | 0 | N/A | Connecting node is using a PrivateSend protocol version that the rejecting node considers obsolete and unsupported. +| 0x11 | `dsi` message | 0 | N/A | Connecting node is using a PrivateSend protocol version that the rejecting node considers obsolete and unsupported. +| 0x11 | `dsc` message | 0 | N/A | Connecting node is using a PrivateSend protocol version that the rejecting node considers obsolete and unsupported. +| 0x11 | `dsf` message | 0 | N/A | Connecting node is using a PrivateSend protocol version that the rejecting node considers obsolete and unsupported. +| 0x11 | `dsq` message | 0 | N/A | Connecting node is using a PrivateSend protocol version that the rejecting node considers obsolete and unsupported. +| 0x11 | `dssu` message | 0 | N/A | Connecting node is using a PrivateSend protocol version that the rejecting node considers obsolete and unsupported. +| 0x11 | `govsync` message | 0 | N/A | Connecting node is using a governance protocol version that the rejecting node considers obsolete and unsupported. +| 0x11 | `govobj` message | 0 | N/A | Connecting node is using a governance protocol version that the rejecting node considers obsolete and unsupported. +| 0x11 | `govobjvote` message | 0 | N/A | Connecting node is using a governance protocol version that the rejecting node considers obsolete and unsupported. +| 0x11 | `mnget` message | 0 | N/A | Connecting node is using a masternode payment protocol version that the rejecting node considers obsolete and unsupported. +| 0x11 | `mnw` message | 0 | N/A | Connecting node is using a masternode payment protocol version that the rejecting node considers obsolete and unsupported. +| 0x11 | `txlvote` message | 0 | N/A | Connecting node is using an InstantSend protocol version that the rejecting node considers obsolete and unsupported. | 0x12 | `tx` message | 32 | char[32] | Duplicate input spend (double spend): the rejected transaction spends the same input as a previously-received transaction. Extra data may include the rejected transaction's TXID. | 0x12 | `version` message | 0 | N/A | More than one `version` message received in this connection. | 0x40 | `tx` message | 32 | char[32] | The transaction will not be mined or relayed because the rejecting node considers it non-standard---a transaction type or version unknown by the server. Extra data may include the rejected transaction's TXID. @@ -1274,6 +1532,57 @@ header has been omitted.) {% endautocrossref %} +#### SendCmpct +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +*Added in protocol version 70209 of Dash Core as described by BIP152* + +The `sendcmpct` message tells the receiving peer whether or not to announce new +blocks using a `cmpctblock` message. It also sends the compact block protocol +version it supports. The `sendcmpct` message is defined as a message containing +a 1-byte integer followed by a 8-byte integer. The first integer is interpreted +as a boolean and should have a value of either 1 or 0. The second integer +is be interpreted as a little-endian version number. + +Upon receipt of a `sendcmpct` message with the first and second integers +set to 1, the node should announce new blocks by sending a `cmpctblock` message. + +Upon receipt of a `sendcmpct` message with the first integer set to 0, the node +shouldn't announce new blocks by sending a `cmpctblock` message, but instead announce +new blocks by sending invs or headers, as defined by [BIP130][]. + +Upon receipt of a `sendcmpct` message with the second integer set to something +other than 1, nodes should treat the peer as if they had not received the message +(as it indicates the peer will provide an unexpected encoding in `cmpctblock` messages, +and/or other, messages). This allows future versions to send duplicate +`sendcmpct` messages with different versions as a part of a version handshake. + +Nodes should check for a protocol version of >= 70209 before sending `sendcmpct` +messages. Nodes shouldn't send a request for a `MSG_CMPCT_BLOCK` object to a peer +before having received a `sendcmpct` message from that peer. Nodes shouldn't +request a `MSG_CMPCT_BLOCK` object before having sent all `sendcmpct` messages +to that peer which they intend to send, as the peer cannot know what protocol +version to use in the response. + +The structure of a `sendcmpct` message is defined below. + +| Bytes | Name | Data Type | Description +|----------|---------------|------------------|-------------- +| 1 | announce | bool | 0 - Announce blocks via `headers` message or `inv` message
1 - Announce blocks via `cmpctblock` message +| 8 | version | uint64_t | The compact block protocol version number + +The annotated hexdump below shows a `sendcmpct` message. (The message +header has been omitted.) + +{% highlight text %} +01 ................................. Block announce type: Compact Blocks +0100000000000000 ................... Compact block version: 1 +{% endhighlight %} + +{% endautocrossref %} + #### SendHeaders {% include helpers/subhead-links.md %} @@ -1287,7 +1596,6 @@ section][section message header] for an example of a message without a payload. {% endautocrossref %} - #### Spork {% include helpers/subhead-links.md %} @@ -1310,19 +1618,22 @@ signature before accepting the spork message as valid. | 8 | nTimeSigned | int64_t | Required | Time the spork value was signed | 66 | vchSig | char[] | Required | Length (1 byte) + Signature (65 bytes) -Defined Sporks (per [`src/spork.h`][spork.h]) +Sporks (per [`src/spork.h`][spork.h]) | Spork ID | Number | Name | Description | | ---------- | ---------- | ----------- | ----------- | | 10001 | 2 | `INSTANTSEND_ENABLED` | Turns on and off InstantSend network wide | 10002 | 3 | `INSTANTSEND_BLOCK_FILTERING` | Turns on and off InstantSend block filtering | 10004 | 5 | `INSTANTSEND_MAX_VALUE` | Controls the max value for an InstantSend transaction (currently 2000 dash) +| 10005 | 6 | `NEW_SIGS` | Turns on and off new signature format for Dash-specific messages | 10007 | 8 | `MASTERNODE_PAYMENT_ENFORCEMENT` | Requires masternodes to be paid by miners when blocks are processed | 10008 | 9 | `SUPERBLOCKS_ENABLED` | Superblocks are enabled (10% of the block reward allocated to fund the dash treasury for funding approved proposals) | 10009 | 10 | `MASTERNODE_PAY_UPDATED_NODES` | Only current protocol version masternode's will be paid (not older nodes) | 10011 | 12 | `RECONSIDER_BLOCKS` | Forces reindex of a specified number of blocks to recover from unintentional network forks -| 10012 | 13 | `OLD_SUPERBLOCK_FLAG` | Deprecated. No network function since block 614820 | 10013 | 14 | `REQUIRE_SENTINEL_FLAG` | Only masternode's running sentinel will be paid +| | | | +| | | **Removed Sporks** | +| _10012_ | _13_ | _`OLD_SUPERBLOCK_FLAG`_ | _Removed in Dash Core 0.12.3. No network function since block 614820_ To verify `vchSig`, compare the hard-coded spork public key (`strSporkPubKey` from [`src/chainparams.cpp`][spork pubkey]) with the public key recovered from @@ -1337,6 +1648,7 @@ Core can be found in `CPubKey::RecoverCompact`). The hash is a double SHA-256 ha | Mainnet | 04549ac134f694c0243f503e8c8a9a986f5de6610049c40b07816809b0d1
d06a21b07be27b9bb555931773f62ba6cf35a25fd52f694d4e1106ccd237
a7bb899fdd | | Testnet3 | 046f78dcf911fbd61910136f7f0f8d90578f68d0b3ac973b5040fb7afb50
1b5939f39b108b0569dca71488f5bbf498d92e4d1194f6f941307ffd95f7
5e76869f0e | | RegTest | Undefined | +| Devnets | 046f78dcf911fbd61910136f7f0f8d90578f68d0b3ac973b5040fb7afb50
1b5939f39b108b0569dca71488f5bbf498d92e4d1194f6f941307ffd95f7
5e76869f0e | The following annotated hexdump shows a `spork` message. @@ -1551,14 +1863,18 @@ queue the remainder of the time. | Bytes | Name | Data type | Required | Description | | ---------- | ----------- | --------- | -------- | -------- | | 4 | nDenom | int | Required | Denomination that will be exclusively used when submitting inputs into the pool -| 41+ | txCollateral | txIn | Required | Collateral TX that will be charged if this client acts maliciously +| 4 | nInputCount | int | Required | *Added in protocol version 70209. Only present when Spork 6 is active.*
Number of inputs required to join the queue +| 216+ | txCollateral | `tx` message | Required | Collateral TX that will be charged if this client acts maliciously The following annotated hexdump shows a `dsa` message. (The message header has -been omitted.) +been omitted.) Note that the 'Required inputs' bytes will only be preset if +Spork 6 is active and protocol version => 70209. {% highlight text %} 02000000 ................................... Denomination: 1 Dash (2) +03000000 ................................... Inputs required: 3 + Collateral Transaction | Previous Output | | @@ -1738,7 +2054,7 @@ pool, it responds with a `dsf` message. | Bytes | Name | Data type | Required | Description | | ---------- | ----------- | --------- | -------- | -------- | | ? | vecTxDSIn | CTxDSIn[] | Required | Vector of users inputs (CTxDSIn serialization is equal to CTxIn serialization) -| ? | txCollateral | `tx` message | Required |Collateral transaction which is used to prevent misbehavior and also to charge fees randomly +| 216+ | txCollateral | `tx` message | Required | Collateral transaction which is used to prevent misbehavior and also to charge fees randomly | ? | vecTxDSOut | CTxDSOut[] | Required | Vector of user outputs (CTxDSOut serialization is equal to CTxOut serialization) The following annotated hexdump shows a `dsi` message. (The message header has @@ -1880,7 +2196,8 @@ message. | Bytes | Name | Data type | Required | Description | | ---------- | ----------- | --------- | -------- | -------- | | 4 | nDenom | int | Required | Denomination allowed in this mixing session -| 41+ | vin | txIn | Required | Unspent output from masternode which is hosting this session +| 4 | nInputCount | int | Required | *Added in protocol version 70209. Only present when Spork 6 is active.*
Number of inputs required to participate in this mixing session +| 36 | masternodeOutPoint | outPoint | Required | The unspent outpoint of the masternode (holding 1000 DASH) which is hosting this session | 8 | nTime | int64_t | Required | Time this `dsq` message was created | 1 | fReady | bool | Required | Indicates if the mixing pool is ready to be executed | 66* | vchSig | char[] | Required | Signature of this message by masternode verifiable via pubKeyMasternode (Length (1 byte) + Signature (65 bytes)) @@ -1895,11 +2212,14 @@ Denominations (per [`src/privatesend.cpp`][privatesend denominations]) | 8 | 0.01 Dash The following annotated hexdump shows a `dsq` message. (The -message header has been omitted.) +message header has been omitted.) Note that the 'Required inputs' bytes will only +be preset if Spork 6 is active and protocol version => 70209. {% highlight text %} 08000000 ............................. Denomination: 0.01 Dash (8) +03000000 ............................. Required input(s): 3 + Masternode Outpoint | aeed0e77c6db30a616507a37a129bc88 | 1811f08afc51dd485d5322f36c1f04c5 ... Outpoint TXID @@ -2087,7 +2407,7 @@ fees (to provide security in mixing). | Bytes | Name | Data type | Required | Description | | ---------- | ----------- | --------- | -------- | -------- | | # | tx | `tx` message | Required | The transaction -| 41 | vin | txIn | Required | Masternode unspent output +| 36 | masternodeOutPoint | outPoint | Required | The unspent outpoint of the masternode (holding 1000 DASH) which is signing the message | 66 | vchSig | char[] | Required | Signature of this message by masternode verifiable via pubKeyMasternode (Length (1 byte) + Signature (65 bytes)) | 8 | sigTime | int64_t | Require | Time this message was signed @@ -2140,15 +2460,10 @@ Transaction Message | | 00000000 ................................... locktime: 0 (a block height) -Masternode Unspent Output +Masternode Unspent Outpoint | 387d522def2abfb9bdd15be899f074f3 | 49b414cef078ec642e1d14b42996b9fc ......... Outpoint TXID | 00000000 ................................. Outpoint index number: 0 -| -| 00 ....................................... Bytes in sig. script: 0 -| .......................................... Secp256k1 signature (None) -| -| ffffffff ................................. Sequence number: UINT32_MAX 1b6fb8f90f0df6e502bc10aab9604e49 2d14214e05331c9761c834d55c7536e3 @@ -2184,7 +2499,7 @@ and [Masternode Payment](developer-guide#masternode-payment) section The `dseg` message requests either the entire masternode list or a specific entry. To request the list of all masternodes, use an empty txIn (TXID of all zeros and an index of 0xFFFFFFFF). To request information about a specific -masternode, use the unspent output associated with that masternode. +masternode, use the unspent outpoint associated with that masternode. The response to a `dseg` message is an `mnb` message inventory and an `mnp` message inventory for each requested masternode. Masternodes ignore this @@ -2192,7 +2507,7 @@ request if they are not fully synced. | Bytes | Name | Data type | Required | Description | | ---------- | ----------- | --------- | -------- | -------- | -| 41 | vin | txIn | Required | Request options:
`All Entries` - empty txIn
`Single Entry` - Masternode's unspent output which is holding 1000 DASH +| 36 | masternodeOutPoint | outPoint | Required | Request options:
`All Entries` - empty txIn
`Single Entry` - Masternode's unspent outpoint which is holding 1000 DASH {% highlight text %} @@ -2204,30 +2519,20 @@ The following annotated hexdump shows a `dseg` message requesting **all** masternodes. (The message header has been omitted.) {% highlight text %} -Masternode Unspent Output +Masternode Unspent Outpoint | 00000000000000000000000000000000 | 00000000000000000000000000000000 ......... Outpoint TXID | ffffffff ................................. Outpoint index number: 0 -| -| 00 ....................................... Bytes in sig. script: 0 -| .......................................... Secp256k1 signature: None -| -| ffffffff ................................. Sequence number: UINT32_MAX {% endhighlight %} The following annotated hexdump shows a `dseg` message requesting a specific masternode. (The message header has been omitted.) {% highlight text %} -Masternode Unspent Output +Masternode Unspent Outpoint | 7fe33a2901aa654598ae0af572d4fbec | ee97af2d0276f189d177dee5848ef3da ......... Outpoint TXID | 00000000 ................................. Outpoint index number: 0 -| -| 00 ....................................... Bytes in sig. script: 0 -| .......................................... Secp256k1 signature: None -| -| ffffffff ................................. Sequence number: UINT32_MAX {% endhighlight %} {% endautocrossref %} @@ -2243,30 +2548,25 @@ entry and how to validate messages from it. | Bytes | Name | Data type | Required | Description | | ---------- | ----------- | --------- | -------- | -------- | -| 41 | vin | txIn | Required | The unspent output which is holding 1000 DASH +| 36 | outPoint | outPoint | Required | The unspent outpoint of the masternode (holding 1000 DASH) which is signing the message | # | addr | CService | Required | IPv4 address of the masternode -| 33-65 | pubKeyCollateralAddress | CPubKey | Required | CPubKey of the main 1000 DASH unspent output. Length determined by if it is a compressed public key or not. +| 33-65 | pubKeyCollateralAddress | CPubKey | Required | CPubKey of the main 1000 DASH unspent outpoint. Length determined by if it is a compressed public key or not. | 33-65 | pubKeyMasternode | CPubKey | Required | CPubKey of the secondary signing key (For all messaging other than the announce message). Length determined by if it is a compressed public key or not. | 66 | sig | char[] | Required | Signature of this message verifiable via pubKeyMasternode (Length (1 byte) + Signature (65 bytes)) | 8 | sigTime | int64_t | Required | Time which the signature was created | 4 | nProtocolVersion | int | Required | The protocol version of the masternode | # | lastPing | `mnp` message | Required | The last known ping of the masternode -| 8 | nLastDsq | int64_t | Deprecated | The last time the masternode sent a `dsq` message (for mixing) (DEPRECATED) +| 8 | nLastDsq | int64_t | Deprecated | **Removed in Dash Core 0.12.3.0**
The last time the masternode sent a `dsq` message (for mixing) (DEPRECATED) The following annotated hexdump shows a `mnb` message. (The message header has been omitted and the actual IP address has been replaced with a RFC5737 reserved IP address.) {% highlight text %} -Masternode Unspent Output +Masternode Unspent Outpoint | 3fbc7d4a8f68ba6ecb02a8db34d1f5b6 | 2dc105f0b5c3505243435cf815d02394 ......... Outpoint TXID | 01000000 ................................. Outpoint index number: 1 -| -| 00 ....................................... Bytes in sig. script: 0 -| .......................................... Secp256k1 signature: None -| -| ffffffff ................................. Sequence number: UINT32_MAX Masternode Address | 00000000000000000000ffffc0000233 ......... IP Address: ::ffff:192.0.2.51 @@ -2298,15 +2598,10 @@ Message Signature 3e120100 ................................... Protocol Version: 70206 Masternode Ping Message -| Masternode Unspent Output +| Masternode Unspent Outpoint | | 3fbc7d4a8f68ba6ecb02a8db34d1f5b6 | | 2dc105f0b5c3505243435cf815d02394 ........ Outpoint TXID | | 01000000 ................................ Outpoint index number: 1 -| | -| | 00 ...................................... Bytes in sig. script: 0 -| | ......................................... Secp256k1 signature: None -| | -| | ffffffff ................................ Sequence number: UINT32_MAX | | 94fc0fad18b166c2fedf1a5dc0511372 | 26c353d57e086737ff05000000000000 ......... Chaintip block hash @@ -2330,19 +2625,28 @@ Masternode Ping Message {% autocrossref %} The `mnget` message requests masternode payment sync. The response to an -`mnget` message is `mnw` message inventories (up to the number asked for in the -request). Masternodes ignore this request if they are not fully synced. - -| Bytes | Name | Data type | Required | Description | -| ---------- | ----------- | --------- | -------- | -------- | -| 4 | nMnCount | int | Required | Number of masternode payment votes to request +`mnget` message is `mnw` message inventories. Masternodes ignore this request if +they are not fully synced. {% highlight text %} Note: Dash Core limits how frequently a masternode payment sync can be requested. Frequent requests will result in the node being banned. {% endhighlight %} -The following annotated hexdump shows a `mnget` message. (The +There is no payload in a `mnget` message. See the [message header +section][section message header] for an example of a message without a payload. + + **The following information is provided for historical reference only.** + +In protocol versions <=70208, the `mnget` message has a payload consisting of an +integer value requesting a specific number of payment votes. In protocol versions +>70208, the `mnget` message has no payload. + +| Bytes | Name | Data type | Required | Description | +| ---------- | ----------- | --------- | -------- | -------- | +| 4 | nMnCount | int | Deprecated | _Deprecated in Dash Core 0.12.3_
Number of masternode payment votes to request + +The following annotated hexdump shows a pre-0.12.3 `mnget` message. (The message header has been omitted.) {% highlight text %} @@ -2362,37 +2666,39 @@ uses a minimum masternode ping time of 10 minutes. | Bytes | Name | Data type | Required | Description | | ---------- | ----------- | --------- | -------- | -------- | -| 41 | vin | txIn | Required | The unspent output of the masternode (holding 1000 DASH) which is signing the message +| 36 | masternodeOutPoint | outPoint | Required | The unspent outpoint of the masternode (holding 1000 DASH) which is signing the message | 32 | blockHash | uint256 | Required | Block hash from 12 blocks ago (current chaintip minus 12). This offset allows nodes to be slightly out of sync. | 8 | sigTime | int64_t | Required | Time which the signature was created | 66* | vchSig | char[] | Required | Signature of this message by masternode - verifiable via pubKeyMasternode (66 bytes in most cases. Length (1 byte) + Signature (65 bytes)) +| 1 | fSentinelIsCurrent | bool | Required | True if last sentinel ping was current +| 4 | nSentinelVersion | uint32_t | Required | The version of Sentinel running on the masternode which is signing the message +| 4 | nDaemonVersion | uint32_t | Required | The version of dashd on the masternode which is signing the message (i.e. CLIENT_VERSION) The following annotated hexdump shows a `mnp` message. (The message header has been omitted.) {% highlight text %} -Masternode Unspent Output -| 0bfa3616099771bb5f36181ff4060a9b -| 9afe7b3e47d7f4327800f0f8ce586c6e ......... Outpoint TXID -| 01000000 ................................. Outpoint index number: 1 -| -| 00 ....................................... Bytes in sig. script: 0 -| .......................................... Secp256k1 signature: None -| -| ffffffff ................................. Sequence number: UINT32_MAX +Masternode Unspent Outpoint +| ce12d7f32945c9544c5aeb0dcf131174 +| a6269b64b40f9461595e26689b573c58 ......... Outpoint TXID +| 00000000 ................................. Outpoint index number: 0 -a26a68ebb733192c1c40f9b42f872ac0 -e23d4c360e20d5ab6608000000000000 ........... Chaintip block hash +6c7da9d9eae78644a3406eac8ed0be3b +f15eb4bc369acc95b106f37400000000 ........... Chaintip block hash -1bbfa95900000000 ........................... Sig. Timestamp: 2017-10-01 20:12:11 UTC +3c84025a00000000 ........................... Sig. Timestamp: 2017-11-08 04:12:44 UTC Masternode Signature | 41 ....................................... Bytes in signature: 65 -| 1c2b205bd6ba472d7a9495f049ef66dc -| f844154846e25f2389385ba2d3e95cde -| cf3ccf82bc26d94c6fdafcd7b965bb61 -| db02d05483595196ea4d92b2e797612b -| 79 ....................................... Masternode Signature +| 1c7572842058a2075b8a996c3905e306 +| 27a581a0b0702842ac4088e6c1a61b22 +| 8e79a4d8aed0f413150f976045f256ef +| 2727e68a36622efcabfd60a554533b8c +| 6f ....................................... Masternode Signature + +01 ......................................... Sentinel Current: true +02000100 ................................... Sentinel Version (1.0.2) +ecd50100 ................................... Dashd Deamon Version (12.3.0) {% endhighlight %} {% endautocrossref %} @@ -2408,8 +2714,8 @@ masternode 1 being validated as of the provided block height. | Bytes | Name | Data type | Required | Description | | ---------- | ----------- | --------- | -------- | -------- | -| 41 | vin1 | txIn | Required | The unspent output which is holding 1000 DASH for masternode 1 -| 41 | vin2 | txIn | Required | The unspent output which is holding 1000 DASH for masternode 2 +| 36 | masternodeOutPoint1 | outPoint | Required | The unspent outpoint which is holding 1000 DASH for masternode 1 +| 36 | masternodeOutPoint2 | outPoint | Required | The unspent outpoint which is holding 1000 DASH for masternode 2 | # | addr | CService | Required | IPv4 address and port of masternode 1 | 4 | nonce | int | Required | Random nonce | 4 | nBlockHeight | int | Required | Block height @@ -2426,9 +2732,9 @@ in the table below. | | **Verification request** | | | **`mnv` message with no signatures** | | 1 | `mnv` message | → | | Contains `addr`, `nonce`, and `nBlockHeight`.
Sent by _SendVerifyRequest()_. | 2 | | ← | `mnv` message | Add `vchSig1` (signature of the IP address + nonce + hash of the requested block).
Sent by _SendVerifyReply()_. -| 3 | `mnv` message | → | | Verify `vchSig1`
Add `vin1`, `vin2`, and `vchSig2` (signature of the IP address + nonce + hash of the requested block + `vin1` prevout + `vin2` prevout) and relay message to peers if valid.
Sent by _ProcessVerifyReply()_. +| 3 | `mnv` message | → | | Verify `vchSig1`
Add `masternodeOutPoint1`, `masternodeOutPoint2`, and `vchSig2` (signature of the IP address + nonce + hash of the requested block + `masternodeOutPoint1` + `masternodeOutPoint2`) and relay message to peers if valid.
Sent by _ProcessVerifyReply()_. -Nodes receiving a relayed `mnv` message (one in which `vin1`, `vin2`, `vchSig1` +Nodes receiving a relayed `mnv` message (one in which `masternodeOutPoint1`, `masternodeOutPoint2`, `vchSig1` and `vchSig2` are already present) use it to update the PoSe ban score. If the ban score reaches `MASTERNODE_POSE_BAN_MAX_SCORE` (5), the masternode will be considered malicious and banned. If the received message is valid, nodes @@ -2450,25 +2756,15 @@ initial request (Step 1) so it does not contain any signatures. (The message header has been omitted.) {% highlight text %} -Masternode 1 Unspent Output (empty) +Masternode 1 Unspent Outpoint (empty) | 00000000000000000000000000000000 | 00000000000000000000000000000000 ......... Outpoint TXID | ffffffff ................................. Outpoint index number: 0 -| -| 00 ....................................... Bytes in sig. script: 0 -| .......................................... Secp256k1 signature: None -| -| ffffffff ................................. Sequence number: UINT32_MAX -Masternode 2 Unspent Output (empty) +Masternode 2 Unspent Outpoint (empty) | 00000000000000000000000000000000 | 00000000000000000000000000000000 ......... Outpoint TXID | ffffffff ................................. Outpoint index number: 0 -| -| 00 ....................................... Bytes in sig. script: 0 -| .......................................... Secp256k1 signature: None -| -| ffffffff ................................. Sequence number: UINT32_MAX 00000000000000000000ffff2d20ed4c ........... IP Address: ::ffff:45.32.237.76 4e1f ....................................... Port: 19999 @@ -2490,25 +2786,15 @@ initial response (Step 2) so it only contains the signature of masternode 1 (the masternode being verified). (The message header has been omitted.) {% highlight text %} -Masternode 1 Unspent Output (empty) +Masternode 1 Unspent Outpoint (empty) | 00000000000000000000000000000000 | 00000000000000000000000000000000 ......... Outpoint TXID | ffffffff ................................. Outpoint index number: 0 -| -| 00 ....................................... Bytes in sig. script: 0 -| .......................................... Secp256k1 signature: None -| -| ffffffff ................................. Sequence number: UINT32_MAX -Masternode 2 Unspent Output (empty) +Masternode 2 Unspent Outpoint (empty) | 00000000000000000000000000000000 | 00000000000000000000000000000000 ......... Outpoint TXID | ffffffff ................................. Outpoint index number: 0 -| -| 00 ....................................... Bytes in sig. script: 0 -| .......................................... Secp256k1 signature: None -| -| ffffffff ................................. Sequence number: UINT32_MAX 00000000000000000000ffff2d20ed4c ........... IP Address: ::ffff:45.32.237.76 4e1f ....................................... Port: 19999 @@ -2540,7 +2826,7 @@ selected masternodes will issue the masternode payment vote message. | Bytes | Name | Data type | Required | Description | | ---------- | ----------- | --------- | -------- | -------- | -| 41 | vin | txIn | Required | The unspent output which is holding 1000 DASH +| 36 | masternodeOutPoint | outPoint | Required | The unspent outpoint of the masternode (holding 1000 DASH) which is signing the message | 4 | nBlockHeight | int | Required | The blockheight which the payee should be paid | ? | payeeAddress | CScript | Required | The address receiving payment | 66* | vchSig | char[] | Required | Signature of the masternode which is signing the message (66 bytes in most cases. Length (1 byte) + Signature (65 bytes)) @@ -2549,15 +2835,10 @@ The following annotated hexdump shows a `mnw` message. (The message header has been omitted.) {% highlight text %} -Masternode Unspent Output +Masternode Unspent Outpoint | 0c1b5c5846792b25b05eeea9586d8c34 | ecb996c566bedb4ecf6a68fe8ffa9582 ......... Outpoint TXID | 00000000 ................................. Outpoint index number: 0 -| -| 00 ....................................... Bytes in sig. script: 0 -| .......................................... Secp256k1 signature: None -| -| ffffffff ................................. Sequence number: UINT32_MAX fb4f0a00 ................................... Block pay height: 675835 @@ -2667,7 +2948,7 @@ contract, or setting. Masternodes ignore this request if they are not fully sync | 32 | nCollateralHash | uint256 | Required* | Hash of the collateral fee transaction for proposals.
Set to all zeros for Triggers/Watchdogs. | 0-16384 | strData | string | Required | Data field - can be used for anything (leading varint indicates size of data) | 4 | nObjectType | int | Required | Type of governance object:
• `0` - Unknown
• `1` - Proposal
• `2` - Trigger
• `3` - Watchdog -| 41 | vinMasternode | CTxIn | Required* | Unspent output for the masternode which is signing this object.
Set to all zeros for proposals since they can be created by non-masternodes. +| 36 | masternodeOutPoint | outPoint | Required* | The unspent outpoint of the masternode (holding 1000 DASH) which is signing this object.
Set to all zeros for proposals since they can be created by non-masternodes. | 66* | vchSig | char[] | Required* | Signature of the masternode (Length (1 byte) + Signature (65 bytes))
Not required for proposals - they will have a length of 0x00 and no Signature. Governance Object Types (defined by src/governance-object.h) @@ -2680,9 +2961,8 @@ Governance Object Types (defined by src/governance-object.h) | 3 | `GOVERNANCE_OBJECT_WATCHDOG` | Masternode generated. Two hour expiration time.
DEPRECATED since 12.2. The following annotated hexdump shows a `govobj` message for a Proposal object. -Notice the presence of a non-zero collateral hash, a vinMasternode that is an -empty CTxIn (hash of all zeros, index/sequence of 0xffffffff, no Signature), -and no vchSig. +Notice the presence of a non-zero collateral hash, a masternodeOutPoint that is an +empty Outpoint (hash of all zeros), and no vchSig. (The message header has been omitted.) {% highlight text %} @@ -2699,14 +2979,10 @@ Data 01000000 ............................. Object Type: GOVERNANCE_OBJECT_PROPOSAL (1) -Transaction input -| Previous Output -| | 00000000000000000000000000000000 -| | 00000000000000000000000000000000 ... Outpoint TXID -| | ffffffff ........................... Outpoint index number: 0 -| 00 ................................... Script length: 0 -| ...................................... Signature: None -| ffffffff ............................. Sequence +Masternode Unspent Outpoint +| 00000000000000000000000000000000 +| 00000000000000000000000000000000 ... Outpoint TXID +| ffffffff ........................... Outpoint index number: 0 00 ................................... Signature length: 0 @@ -2731,14 +3007,10 @@ Data 02000000 ............................. Object Type: GOVERNANCE_OBJECT_TRIGGER (2) -Transaction input -| Previous Output -| | ffefbe4959085907bcd2ba29e357a441 -| | fa7b6e26e25896d8127332bba2419e97 ... Outpoint TXID -| | 00000000 ........................... Outpoint index number: 0 -| 00 ................................... Script length: 0 -| ...................................... Signature: None -| ffffffff ............................. Sequence +Masternode Unspent Outpoint +| ffefbe4959085907bcd2ba29e357a441 +| fa7b6e26e25896d8127332bba2419e97 ... Outpoint TXID +| 00000000 ........................... Outpoint index number: 0 41 ................................... Signature length: 65 @@ -2782,7 +3054,7 @@ the node being banned. | Bytes | Name | Data type | Required | Description | | ---------- | ----------- | --------- | -------- | -------- | -| 41+ | vinMasternode | CTxIn | Required | Unspent output for the masternode which is voting +| 36 | masternodeOutPoint | outPoint | Required | The unspent outpoint of the masternode (holding 1000 DASH) which is voting | 32 | nParentHash | uint256 | Required | Object (`govobj`) being voted on (proposal, contract, setting or final budget) | 4 | nVoteOutcome | int | Required | None (0), Yes (1), No (2), Abstain (3) | 4 | nVoteSignal | int | Required | None (0), Funding (1), Valid (2), Delete (3), Endorsed (4) @@ -2802,14 +3074,10 @@ The following annotated hexdump shows a `govobjvote` message. (The message header has been omitted.) {% highlight text %} -Transaction input -| Previous Output -| | 57566a0ef85e6cac3415ced67b0b07e1 -| | 781bafb853650d7c9d56d8bc132cc3b4 ... Outpoint TXID -| | 00000000 ........................... Outpoint index number: 0 -| 00 ................................... Script length: 0 -| ...................................... Signature: None -| ffffffff ............................. Sequence +Masternode Unspent Outpoint +| 57566a0ef85e6cac3415ced67b0b07e1 +| 781bafb853650d7c9d56d8bc132cc3b4 ... Outpoint TXID +| 00000000 ........................... Outpoint index number: 0 ad9579d5c181eee904156df1c88b050f b8b4d39e5fda71f015996dbf14a51bff...... Parent Hash (0 = root) diff --git a/_includes/devdoc/ref_transactions.md b/_includes/devdoc/ref_transactions.md index eb3f634d..f282b8eb 100644 --- a/_includes/devdoc/ref_transactions.md +++ b/_includes/devdoc/ref_transactions.md @@ -210,16 +210,19 @@ transaction---making the transaction format part of the consensus rules. Dash Core and many other tools print and accept raw transactions encoded as hex. -All transactions use the version 1 format described below. +Transactions prior to protocol version 70209 defaulted to version 1. Transaction +version 2 became the default in protocol version 70209. Version 2 transactions +have the same format, but the `lock_time` parameter was redefined by BIP68 +to enable relative lock-times. (Note: transactions in the block chain are allowed to list a higher version -number to permit soft forks, but they are treated as version 1 transactions +number to permit soft forks, but they are treated as version 2 transactions by current software.) A raw transaction has the following top-level format: | Bytes | Name | Data Type | Description |----------|--------------|---------------------|------------- -| 4 | version | uint32_t | Transaction version number; currently version 1. Programs creating transactions using newer consensus rules may use higher version numbers. +| 4 | version | uint32_t | Transaction version number; currently version 2. Programs creating transactions using newer consensus rules may use higher version numbers. | *Varies* | tx_in count | compactSize uint | Number of inputs in this transaction. | *Varies* | tx_in | txIn | Transaction inputs. See description of txIn below. | *Varies* | tx_out count | compactSize uint | Number of outputs in this transaction. diff --git a/_includes/helpers/summaries.md b/_includes/helpers/summaries.md index 56810035..67a59ce0 100644 --- a/_includes/helpers/summaries.md +++ b/_includes/helpers/summaries.md @@ -47,7 +47,7 @@ This file is licensed under the terms of its source texts{%endcomment%} {% assign summary_getChainTips="returns information about the highest-height block (tip) of each local block chain." %} {% assign summary_getConnectionCount="returns the number of connections to other nodes." %} {% assign summary_getDifficulty="returns the proof-of-work difficulty as a multiple of the minimum difficulty." %} -{% assign summary_getGenerate="returns if the server is set to generate coins or not." %} +{% assign summary_getGenerate="was removed in Dash Core 0.12.3." %} {% assign summary_getGovernanceInfo="returns an object containing governance parameters." %} {% assign summary_getHashesPerSec="was removed in Bitcoin Core 0.11.0 and is not part of Dash." %} {% assign summary_getInfo="prints various information about the node and the network." %} @@ -89,6 +89,7 @@ This file is licensed under the terms of its source texts{%endcomment%} {% assign summary_keepass="provides commands for configuring and managing KeePass authentication" %} {% assign summary_keyPoolRefill="fills the cache of unused pre-generated keys (the keypool)." %} {% assign summary_listAccounts="lists accounts and their balances." %} +{% assign summary_listAddressBalances="lists addresses of this wallet and their balances" %} {% assign summary_listAddressGroupings="lists groups of addresses that may have had their common ownership made public by common use as inputs in the same transaction or from being used as change from a previous transaction." %} {% assign summary_listBanned="lists all banned IPs/Subnets." %} {% assign summary_listLockUnspent="returns a list of temporarily unspendable (locked) outputs." %} @@ -123,8 +124,9 @@ This file is licensed under the terms of its source texts{%endcomment%} {% assign summary_sendToAddress="spends an amount to a given address." %} {% assign summary_sentinelPing="sends a Sentinel Ping to the network." %} {% assign summary_setAccount="puts the specified address in the given account." %} +{% assign summary_setBIP69Enabled="enables or disables BIP69 input/output sorting (regtest network only)" %} {% assign summary_setBan="attempts add or remove a IP/Subnet from the banned list." %} -{% assign summary_setGenerate="enables or disables hashing to attempt to find the next block." %} +{% assign summary_setGenerate="was removed in Dash Core 0.12.3." %} {% assign summary_setNetworkActive="disables/enables all P2P network activity." %} {% assign summary_setTxFee="sets the transaction fee per kilobyte paid by transactions created by this wallet." %} {% assign summary_signMessage="signs a message with the private key of an address." %} diff --git a/_includes/helpers/vars.md b/_includes/helpers/vars.md index 5be65729..b3ba1ee9 100644 --- a/_includes/helpers/vars.md +++ b/_includes/helpers/vars.md @@ -427,4 +427,4 @@ NOT IN DASH {% assign WARNING=" **Warning:**" %} {% assign WARNING_ICON="" %} -{% assign reindexNote="Note: if you begin using `txindex=1` after downloading the block chain, you must rebuild your indexes by starting Bitcoin Core with the option `-reindex`. This may take several hours to complete, during which time your node will not process new blocks or transactions. This reindex only needs to be done once." %} +{% assign reindexNote="Note: if you begin using `txindex=1` after downloading the block chain, you must rebuild your indexes by starting Dash Core with the option `-reindex`. This may take several hours to complete, during which time your node will not process new blocks or transactions. This reindex only needs to be done once." %} diff --git a/_includes/layout/base/head-menu.html b/_includes/layout/base/head-menu.html index ce81849d..184fe25b 100644 --- a/_includes/layout/base/head-menu.html +++ b/_includes/layout/base/head-menu.html @@ -4,7 +4,7 @@ http://opensource.org/licenses/MIT. {% endcomment %}
-
-
- {% translate menu-documentation layout %}
diff --git a/_includes/layout/base/rpc-table.html b/_includes/layout/base/rpc-table.html
index c6b0b24a..fd761ba9 100644
--- a/_includes/layout/base/rpc-table.html
+++ b/_includes/layout/base/rpc-table.html
@@ -77,7 +77,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::
Blockchain GetBlockChainInfo Y -+ Updated in 0.12.3.0 Blockchain @@ -113,7 +113,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Blockchain GetChainTips Y -+ Updated in 0.12.3.0 Blockchain @@ -124,20 +124,20 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Blockchain GetMemPoolAncestors -N -N/A +Y +0.12.3.0+ Blockchain GetMemPoolDescendants -N -N/A +Y +0.12.3.0+ Blockchain GetMemPoolEntry -N -N/A +Y +0.12.3.0+ Blockchain @@ -149,7 +149,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Blockchain GetRawMemPool Y -+ Updated in 0.12.3.0 Blockchain @@ -178,14 +178,14 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Blockchain PreciousBlock -N -N/A +Y +0.12.3.0+ Blockchain PruneBlockChain -N -N/A +Y +0.12.3.0+ Blockchain @@ -203,7 +203,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Control Debug Y -+ Updated in 0.12.3.0 Control @@ -227,7 +227,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Dash GetGovernanceInfo Y -Updated in 0.12.2.2 +Updated in 0.12.3.0 Dash @@ -245,13 +245,13 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Dash GObject Y -+ Updated in 0.12.3.0 Dash Masternode Y -+ Updated in 0.12.3.0 Dash @@ -263,7 +263,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Dash MasternodeList Y -+ Updated in 0.12.3.0 Dash @@ -275,7 +275,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Dash PrivateSend Y -+ Updated in 0.12.3.0 Dash @@ -299,31 +299,31 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Generating Generate Y -+ Updated in 0.12.3.0 Generating GenerateToAddress -N -N/A -- -Generating -GetGenerate -Y -- - +Generating -SetGenerate Y -+ 0.12.3.0+ ++ +Removed +GetGenerate +N +Removed in 0.12.3.0 ++ Removed +SetGenerate +N +Removed in 0.12.3.0 Mining GetBlockTemplate Y -+ Updated in 0.12.3.0 Mining @@ -371,7 +371,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Network GetAddedNodeInfo Y -+ Updated in 0.12.3.0 Network @@ -389,7 +389,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Network GetNetworkInfo Y -+ Updated in 0.12.3.0 Network @@ -425,7 +425,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Rawtransactions CreateRawTransaction Y -+ Updated in 0.12.3.0 Rawtransactions @@ -443,13 +443,13 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Rawtransactions FundRawTransaction Y -+ Updated in 0.12.3.0 Rawtransactions GetRawTransaction Y -+ Updated in 0.12.3.0 Rawtransactions @@ -491,7 +491,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Util EstimatePriority Y -+ Deprecated in 0.12.3.0 Util @@ -503,19 +503,25 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Util EstimateSmartPriority Y -+ Deprecated in 0.12.3.0 Util GetMemoryInfo -N -N/A +Y +0.12.3.0+ ++ Util +SetBIP69Enabled +Y +0.12.3.0+ Util ValidateAddress Y -+ Updated in 0.12.3.0 Util @@ -641,7 +647,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Wallet GetWalletInfo Y -+ Updated in 0.12.3.0 Wallet @@ -658,8 +664,8 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Wallet ImportMulti -N -N/A +Y +0.12.3.0+ Wallet @@ -670,8 +676,8 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Wallet ImportPrunedFunds -N -N/A +Y +0.12.3.0+ Wallet @@ -709,6 +715,12 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Y + Wallet +ListAddressBalances +Y +0.12.3.0+ +Wallet ListAddressGroupings @@ -749,7 +761,7 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Wallet ListUnspent Y -+ Updated in 0.12.3.0 Wallet @@ -766,8 +778,8 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Wallet RemovePrunedFunds -N -N/A +Y +0.12.3.0+ Wallet @@ -808,8 +820,8 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::Wallet SignMessageWithPrivKey -N -N/A +Y +0.12.3.0+ Wallet diff --git a/_includes/references.md b/_includes/references.md index 4674464d..e602cc5f 100644 --- a/_includes/references.md +++ b/_includes/references.md @@ -4,8 +4,11 @@ http://opensource.org/licenses/MIT. {% endcomment %} {% comment %}{% endcomment %} +[blocktransactions]: /en/developer-reference#blocktxn "A P2P Networking data structure used to provide some of the transactions in a block as requested" +[blocktransactionsrequest]: /en/developer-reference#getblocktxn "A P2P Networking data structure used to list transaction indexes in a block being requested by a peer" [coinbase block height]: /en/developer-reference#term-coinbase-block-height "The current block's height encoded into the first bytes of the coinbase field" [data-pushing opcode]: https://en.bitcoin.it/wiki/Script#Constants "Any opcode from 0x01 to 0x4e which pushes data on to the script evaluation stack" +[headerandshortids]: /en/developer-reference#cmpctblock "A P2P Networking data structure used to relay a block header, the short transactions IDs used for matching already-available transactions, and a select few transactions which a peer may be missing" [key index]: /en/developer-guide#term-key-index "An index number used in the HD wallet formula to generate child keys from a parent key" [key pair]: /en/developer-guide#term-key-pair "A private key and its derived public key" @@ -29,6 +32,7 @@ http://opensource.org/licenses/MIT. [msg_governance_object]: /en/developer-reference#term-msg_governance_object "Governance object data type identifier of an inventory on the P2P network" [msg_governance_object_vote]: /en/developer-reference#term-msg_governance_object_vote "Governance object vote data type identifier of an inventory on the P2P network" [msg_masternode_verify]: /en/developer-reference#term-msg_masternode_verify "Masternode Verify data type identifier of an inventory on the P2P network" +[msg_cmpct_block]: /en/developer-reference#term-msg_cmpct_block "An alternative to the block header hash data type identifier of an inventory on the P2P network used to request a compact block" [network]: /en/developer-guide#term-network "The Dash P2P network which broadcasts transactions and blocks" [op_checkmultisig]: /en/developer-reference#term-op-checkmultisig "Opcode which returns true if one or more provided signatures (m) sign the correct parts of a transaction and match one or more provided public keys (n)" @@ -41,6 +45,7 @@ http://opensource.org/licenses/MIT. [op_verify]: /en/developer-reference#term-op-verify "Operation which terminates the script if the entry below it on the stack is non-true (zero)" [output index]: /en/developer-guide#term-output-index "The sequentially-numbered index of outputs in a single transaction starting from 0" [point function]: /en/developer-guide#term-point-function "The ECDSA function used to create a public key from a private key" +[prefilledtransaction]: /en/developer-reference#cmpctblock "A P2P Networking data structure used to represent a vector of a few transactions" [previous block header hash]: /en/developer-reference#term-previous-block-header-hash "A field in the block header which contains the SHA256(SHA256()) hash of the previous block's header" [proper money handling]: /en/developer-reference#term-proper-money-handling "Bitcoin amounts need to be correctly processed without introducing rounding errors that could cause monetary loss" [standard block relay]: /en/developer-guide#term-standard-block-relay "The regular block relay method: announcing a block with an inv message and waiting for a response" @@ -144,6 +149,7 @@ http://opensource.org/licenses/MIT. [rpc keepass]: /en/developer-reference#keepass [rpc keypoolrefill]: /en/developer-reference#keypoolrefill [rpc listaccounts]: /en/developer-reference#listaccounts +[rpc listaddressbalances]: /en/developer-reference#listaddressbalances [rpc listaddressgroupings]: /en/developer-reference#listaddressgroupings [rpc listbanned]: /en/developer-reference#listbanned [rpc listlockunspent]: /en/developer-reference#listlockunspent @@ -170,6 +176,7 @@ http://opensource.org/licenses/MIT. [rpc sendtoaddress]: /en/developer-reference#sendtoaddress [rpc setaccount]: /en/developer-reference#setaccount [rpc setban]: /en/developer-reference#setban +[rpc setbip69enabled]: /en/developer-reference#setbip69enabled [rpc setgenerate]: /en/developer-reference#setgenerate [rpc setnetworkactive]: /en/developer-reference#setnetworkactive [rpc settxfee]: /en/developer-reference#settxfee @@ -203,6 +210,8 @@ http://opensource.org/licenses/MIT. [addr message]: /en/developer-reference#addr "The P2P network message which relays IP addresses and port numbers of active nodes to other nodes and clients, allowing decentralized peer discovery." [alert message]: /en/developer-reference#alert "The P2P network message which sends alerts in case of major software problems." [block message]: /en/developer-reference#block "The P2P network message which sends a serialized block" +[blocktxn message]: /en/developer-reference#blocktxn "The P2P network message which sends a list of requested transactions from a compact block" +[cmpctblock message]: /en/developer-reference#cmpctblock "The P2P network message which sends a serialized compact block" [dsa message]: /en/developer-reference#dsa "A P2P network message used to join a mixing pool" [dsc message]: /en/developer-reference#dsc "A P2P network message used to indicates a PrivateSend mixing session is complete" [dsf message]: /en/developer-reference#dsf "A P2P network message sent as the final mixing transaction in a session asking users to sign the final mixing TX messages" @@ -218,6 +227,7 @@ http://opensource.org/licenses/MIT. [filterload message]: /en/developer-reference#filterclear "A P2P protocol message used to send a filter to a remote peer, requesting that they only send transactions which match the filter." [getaddr message]: /en/developer-reference#getaddr "A P2P protool message used to request an addr message containing connection information for other nodes" [getblocks message]: /en/developer-reference#getblocks "A P2P protocol message used to request an inv message containing a range of block header hashes" +[getblocktxn message]: /en/developer-reference#getblocktxn "A P2P protocol message used to request transactions from a compact block" [getdata message]: /en/developer-reference#getdata "A P2P protocol message used to request one or more transactions, blocks, or merkle blocks" [getheaders message]: /en/developer-reference#getheaders "A P2P protocol message used to request a range of block headers" [getsporks message]: /en/developer-reference#getsporks "A P2P network message used to request the status of sporks" @@ -238,6 +248,7 @@ http://opensource.org/licenses/MIT. [ping message]: /en/developer-reference#ping "A P2P network message used to see if the remote host is still connected" [pong message]: /en/developer-reference#pong "A P2P network message used to reply to a P2P network ping message" [reject message]: /en/developer-reference#reject "A P2P network message used to indicate a previously-received message was rejected for some reason" +[sendcmpct message]: /en/developer-reference#sendcmpct "A P2P network message used to request new blocks be announced as compact blocks" [sendheaders message]: /en/developer-reference#sendheaders "A P2P network message used to request new blocks be announced through headers messages rather than inv messages" [spork message]: /en/developer-reference#spork "A P2P network message used to send the activation status of a spork" [ssc message]: /en/developer-reference#ssc "A P2P network message used to track the sync status of masternode objects ()" @@ -312,9 +323,11 @@ http://opensource.org/licenses/MIT. [BIP62]: https://github.com/bitcoin/bips/blob/master/bip-0062.mediawiki [BIP65]: https://github.com/bitcoin/bips/blob/master/bip-0065.mediawiki [BIP66]: https://github.com/bitcoin/bips/blob/master/bip-0066.mediawiki +[BIP68]: https://github.com/bitcoin/bips/blob/master/bip-0068.mediawiki [BIP70]: https://github.com/bitcoin/bips/blob/master/bip-0070.mediawiki [BIP71]: https://github.com/bitcoin/bips/blob/master/bip-0071.mediawiki [BIP72]: https://github.com/bitcoin/bips/blob/master/bip-0072.mediawiki +[BIP90]: https://github.com/bitcoin/bips/blob/master/bip-0090.mediawiki [BIP111]: https://github.com/bitcoin/bips/blob/master/bip-0111.mediawiki [BIP112]: https://github.com/bitcoin/bips/blob/master/bip-0112.mediawiki [BIP113]: https://github.com/bitcoin/bips/blob/master/bip-0113.mediawiki @@ -322,6 +335,7 @@ http://opensource.org/licenses/MIT. [BIP130]: https://github.com/bitcoin/bips/blob/master/bip-0130.mediawiki [BIP133]: https://github.com/bitcoin/bips/blob/master/bip-0133.mediawiki [BIP141]: https://github.com/bitcoin/bips/blob/master/bip-0141.mediawiki +[BIP147]: https://github.com/bitcoin/bips/blob/master/bip-0147.mediawiki [BIP151]: https://github.com/bitcoin/bips/blob/master/bip-0151.mediawiki [BIP152]: https://github.com/bitcoin/bips/blob/master/bip-0152.mediawiki [CVE-2012-2459]: https://en.bitcoin.it/wiki/CVEs#CVE-2012-2459 diff --git a/_sass/screen.scss b/_sass/screen.scss index 4887b9fb..cd44db37 100644 --- a/_sass/screen.scss +++ b/_sass/screen.scss @@ -556,7 +556,7 @@ h1 span.fa, h2 span.fa, h3 span.fa, h4 span.fa, h5 span.fa, h6 span.fa { background-image:-ms-linear-gradient(bottom, #20598f 14%, #2c6fad 70%); background-image:linear-gradient(bottom, #20598f 14%, #2c6fad 70%); color:#fff; - padding:15px 20px 20px 68px; + padding:15px 20px 20px 15px; margin:40px 0 40px 0; -webkit-border-radius:12px; -moz-border-radius:12px; diff --git a/_templates/bitcoin-for-developers.html b/_templates/dash-for-developers.html similarity index 91% rename from _templates/bitcoin-for-developers.html rename to _templates/dash-for-developers.html index a6f43933..de4907cc 100755 --- a/_templates/bitcoin-for-developers.html +++ b/_templates/dash-for-developers.html @@ -3,7 +3,7 @@ # http://opensource.org/licenses/MIT. layout: base -id: bitcoin-for-developers +id: dash-for-developers ---{% translate pagetitle %}
{% translate summary %}
@@ -28,4 +28,4 @@ id: bitcoin-for-developers - + diff --git a/_translations/en.yml b/_translations/en.yml index 66ef0d37..bd5c138a 100644 --- a/_translations/en.yml +++ b/_translations/en.yml @@ -61,7 +61,7 @@ en: multisigtext: "Bitcoin also includes a multi-signature feature which allows bitcoins to be spent only if a subset of a group of people authorize the transaction. This can be used by a board of directors to prevent any member to make expenditures without enough consent from other members, as well as to track which members allowed each payment." transparency: "Accounting transparency" transparencytext: "Many organizations are required to produce accounting documents about their activity. Using Bitcoin allows you to offer the highest level of transparency since you can provide information your members can use to verify your balances and transactions. Non-profit organizations can also allow the public to see how much they receive in donations." - bitcoin-for-developers: + dash-for-developers: title: "Dash for Developers - Dash" pagetitle: "Dash for Developers" summary: "Dash can be used to build amazing things or just answer common needs." @@ -868,7 +868,7 @@ en: layout: menu-about-us: "About bitcoin.org" menu-bitcoin-for-businesses: Businesses - menu-bitcoin-for-developers: Developers + menu-dash-for-developers: Developers menu-bitcoin-for-individuals: Individuals menu-community: Community menu-development: Development @@ -907,7 +907,7 @@ en: donation-modal-optional-message: "Optional description (for your wallet)" url: about-us: about-us - bitcoin-for-developers: bitcoin-for-developers + dash-for-developers: dash-for-developers bitcoin-for-individuals: bitcoin-for-individuals bitcoin-for-businesses: bitcoin-for-businesses buy: buy diff --git a/doxygen/doxygen_header.html b/doxygen/doxygen_header.html index 64656143..7f998417 100644 --- a/doxygen/doxygen_header.html +++ b/doxygen/doxygen_header.html @@ -33,7 +33,7 @@