diff --git a/.gitignore b/.gitignore index 44786c45..55f6a9dc 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,4 @@ +scripts/*.md _site/ .DS_Store .DS_Store? diff --git a/Makefile b/Makefile index 3bd56d3c..5406fcda 100644 --- a/Makefile +++ b/Makefile @@ -222,9 +222,9 @@ check-for-missing-copyright-licenses: check-for-missing-rpc-summaries: ## Make sure the Quick Reference section has a summary for each RPC we ## have documented - $S for f in _includes/devdoc/bitcoin-core/rpcs/rpcs/*.md ;\ - do grep -q "\[$$( grep '^##### ' $$f | sed 's/^##### *\([a-zA-Z]*\).*/\1/')\]\[" _includes/devdoc/bitcoin-core/rpcs/quick-reference.md \ - || echo 'missing summary for '$$f', you need to add the summary to _includes/devdoc/bitcoin-core/rpcs/quick-ref.md and run make manual-updates' \ + $S for f in _includes/devdoc/dash-core/rpcs/rpcs/*.md ;\ + do grep -q "\[$$( grep '^##### ' $$f | sed 's/^##### *\([a-zA-Z]*\).*/\1/')\]\[" _includes/devdoc/dash-core/rpcs/quick-reference.md \ + || echo 'missing summary for '$$f', you need to add the summary to _includes/devdoc/dash-core/rpcs/quick-ref.md and run make manual-updates' \ ; done | eval $(ERROR_ON_OUTPUT) manual-update-summaries-file: diff --git a/_autocrossref.yaml b/_autocrossref.yaml index de4971ee..6ea849a0 100644 --- a/_autocrossref.yaml +++ b/_autocrossref.yaml @@ -24,6 +24,25 @@ certificate chain: DER: DER format: der DER-formatted: der +'`dsa` message': dsa message +'`dsa` messages': dsa message +'`dsc` message': dsc message +'`dsc` messages': dsc message +'`dsf` message': dsf message +'`dsf` messages': dsf message +'`dsi` message': dsi message +'`dsi` messages': dsi message +'`dsq` message': dsq message +'`dsq` messages': dsq message +'`dseg` message': dseg message +'`dseg` messages': dseg message +'`dss` message': dss message +'`dss` messages': dss message +'`dssu` message': dssu message +'`dssu` messages': dssu message +'`dstx` message': dstx message +'`dstx` messages': dstx message +DNS address: DO NOT AUTOCROSSREF ECDSA: epoch time: unix epoch time '`expires`': pp expires @@ -44,12 +63,22 @@ fiat: '`getheaders` messages': getheaders message '`getaddr` message': getaddr message '`getaddr` messages': getaddr message +'`getsporks` message': getsporks message +'`getsporks` messages': getsporks message +'`govobj` message': govobj message +'`govobj` messages': govobj message +'`govobjvote` message': govobjvote message +'`govobjvote` messages': govobjvote message +'`govsync` message': govsync message +'`govsync` messages': govsync message '`headers` message': headers message '`headers` messages': headers message intermediate certificate: intermediate certificates: intermediate certificate '`inv` message': inv message '`inv` messages': inv message +'`ix` message': ix message +'`ix` messages': ix message IP address: DO NOT AUTOCROSSREF IP addresses: DO NOT AUTOCROSSREF IPv4 address: DO NOT AUTOCROSSREF @@ -75,6 +104,16 @@ merge: Merge avoidance: micropayment channel: micropayment channels: micropayment channel +'`mnb` message': mnb message +'`mnb` messages': mnb message +'`mnget` message': mnget message +'`mnget` messages': mnget message +'`mnp` message': mnp message +'`mnp` messages': mnp message +'`mnv` message': mnv message +'`mnv` messages': mnv message +'`mnw` message': mnw message +'`mnw` messages': mnw message '`MSG_BLOCK`': msg_block '`MSG_FILTERED_BLOCK`': msg_filtered_block '`MSG_TX`': msg_tx @@ -124,7 +163,7 @@ public key infrastructure: pki '`r`': r receipt: recurrent rebilling: -refund: +refund: refunds: refund '`reject` message': reject message '`reject` messages': reject message @@ -133,11 +172,17 @@ RPC: RPCs: rpc '`script`': pp script secp256k1: +'`spork` message': spork message +'`spork` messages': spork message +'`ssc` message': ssc message +'`ssc` messages': ssc message standard block relay: transaction object format: transaction version number: '`tx` message': tx message '`tx` messages': tx message +'`txlvote` message': txlvote message +'`txlvote` messages': txlvote message unencrypted wallet: unix epoch time: unix time: unix epoch time @@ -172,6 +217,7 @@ BIP39: BIP50: BIP61: BIP62: +BIP65: BIP66: BIP70: BIP71: @@ -208,6 +254,8 @@ CVE-2012-2459: '`createmultisig` RPC': rpc createmultisig '`createrawtransaction`': rpc createrawtransaction '`createrawtransaction` RPC': rpc createrawtransaction +'`debug`': rpc debug +'`debug` RPC': rpc debug '`decoderawtransaction`': rpc decoderawtransaction '`decoderawtransaction` RPC': rpc decoderawtransaction '`decodescript`': rpc decodescript @@ -236,8 +284,18 @@ CVE-2012-2459: '`getaccountaddress` RPC': rpc getaccountaddress '`getaddednodeinfo`': rpc getaddednodeinfo '`getaddednodeinfo` RPC': rpc getaddednodeinfo +'`getaddressbalance`': rpc getaddressbalance +'`getaddressbalance` RPC': rpc getaddressbalance +'`getaddressdeltas`': rpc getaddressdeltas +'`getaddressdeltas` RPC': rpc getaddressdeltas '`getaddressesbyaccount`': rpc getaddressesbyaccount '`getaddressesbyaccount` RPC': rpc getaddressesbyaccount +'`getaddressmempool`': rpc getaddressmempool +'`getaddressmempool` RPC': rpc getaddressmempool +'`getaddresstxids`': rpc getaddresstxids +'`getaddresstxids` RPC': rpc getaddresstxids +'`getaddressutxos`': rpc getaddressutxos +'`getaddressutxos` RPC': rpc getaddressutxos '`getbalance`': rpc getbalance '`getbalance` RPC': rpc getbalance '`getbestblockhash`': rpc getbestblockhash @@ -250,8 +308,12 @@ CVE-2012-2459: '`getblockcount` RPC': rpc getblockcount '`getblockhash`': rpc getblockhash '`getblockhash` RPC': rpc getblockhash +'`getblockhashes`': rpc getblockhashes +'`getblockhashes` RPC': rpc getblockhashes '`getblockheader`': rpc getblockheader '`getblockheader` RPC': rpc getblockheader +'`getblockheaders`': rpc getblockheaders +'`getblockheaders` RPC': rpc getblockheaders '`getblocktemplate`': rpc getblocktemplate '`getblocktemplate` RPC': rpc getblocktemplate '`getchaintips`': rpc getchaintips @@ -262,6 +324,8 @@ CVE-2012-2459: '`getdifficulty` RPC': rpc getdifficulty '`getgenerate`': rpc getgenerate '`getgenerate` RPC': rpc getgenerate +'`getgovernanceinfo`': rpc getgovernanceinfo +'`getgovernanceinfo` RPC': rpc getgovernanceinfo '`gethashespersec`': rpc gethashespersec '`gethashespersec` RPC': rpc gethashespersec '`getinfo`': rpc getinfo @@ -288,6 +352,8 @@ CVE-2012-2459: '`getnewaddress` RPC': rpc getnewaddress '`getpeerinfo`': rpc getpeerinfo '`getpeerinfo` RPC': rpc getpeerinfo +'`getpoolinfo`': rpc getpoolinfo +'`getpoolinfo` RPC': rpc getpoolinfo '`getrawchangeaddress`': rpc getrawchangeaddress '`getrawchangeaddress` RPC': rpc getrawchangeaddress '`getrawmempool`': rpc getrawmempool @@ -298,6 +364,10 @@ CVE-2012-2459: '`getreceivedbyaccount` RPC': rpc getreceivedbyaccount '`getreceivedbyaddress`': rpc getreceivedbyaddress '`getreceivedbyaddress` RPC': rpc getreceivedbyaddress +'`getspentinfo`': rpc getspentinfo +'`getspentinfo` RPC': rpc getspentinfo +'`getsuperblockbudget`': rpc getsuperblockbudget +'`getsuperblockbudget` RPC': rpc getsuperblockbudget '`gettransaction`': rpc gettransaction '`gettransaction` RPC': rpc gettransaction '`gettxout`': rpc gettxout @@ -312,6 +382,8 @@ CVE-2012-2459: '`getwalletinfo` RPC': rpc getwalletinfo '`getwork`': rpc getwork '`getwork` RPC': rpc getwork +'`gobject`': rpc gobject +'`gobject` RPC': rpc gobject '`help`': rpc help '`help` RPC': rpc help '`importaddress`': rpc importaddress @@ -346,6 +418,14 @@ CVE-2012-2459: '`listunspent` RPC': rpc listunspent '`lockunspent`': rpc lockunspent '`lockunspent` RPC': rpc lockunspent +'`masternode`': rpc masternode +'`masternode` RPC': rpc masternode +'`masternodebroadcast`': rpc masternodebroadcast +'`masternodebroadcast` RPC': rpc masternodebroadcast +'`masternodelist`': rpc masternodelist +'`masternodelist` RPC': rpc masternodelist +'`mnsync`': rpc mnsync +'`mnsync` RPC': rpc mnsync '`move`': rpc move '`move` RPC': rpc move '`ping`': rpc ping @@ -354,6 +434,8 @@ CVE-2012-2459: '`preciousblock` RPC': rpc preciousblock '`prioritisetransaction`': rpc prioritisetransaction '`prioritisetransaction` RPC': rpc prioritisetransaction +'`privatesend`': rpc privatesend +'`privatesend` RPC': rpc privatesend '`pruneblockchain`': rpc pruneblockchain '`pruneblockchain` RPC': rpc pruneblockchain '`removeprunedfunds`': rpc removeprunedfunds @@ -385,6 +467,8 @@ CVE-2012-2459: '`signmessagewithprivkey` RPC': rpc signmessagewithprivkey '`signrawtransaction`': rpc signrawtransaction '`signrawtransaction` RPC': rpc signrawtransaction +'`spork`': rpc spork +'`spork` RPC': rpc spork '`stop`': rpc stop '`stop` RPC': rpc stop '`submitblock`': rpc submitblock @@ -397,6 +481,8 @@ CVE-2012-2459: '`verifymessage` RPC': rpc verifymessage '`verifytxoutproof`': rpc verifytxoutproof '`verifytxoutproof` RPC': rpc verifytxoutproof +'`voteraw`': rpc voteraw +'`voteraw` RPC': rpc voteraw '`walletlock`': rpc walletlock '`walletlock` RPC': rpc walletlock '`walletpassphrase`': rpc walletpassphrase diff --git a/_config.yml b/_config.yml index ce88deed..6031cc79 100644 --- a/_config.yml +++ b/_config.yml @@ -263,6 +263,7 @@ devsearches: - 'ClearBanned': "/en/developer-reference#clearbanned" - 'CreateMultisig': "/en/developer-reference#createmultisig" - 'CreateRawTransaction': "/en/developer-reference#createrawtransaction" + - 'Debug': "/en/developer-reference#debug" - 'DecodeRawTransaction': "/en/developer-reference#decoderawtransaction" - 'DecodeScript': "/en/developer-reference#decodescript" - 'DisconnectNode': "/en/developer-reference#disconnectnode" @@ -278,17 +279,25 @@ devsearches: - 'GetAccountAddress': "/en/developer-reference#getaccountaddress" - 'GetAddedNodeInfo': "/en/developer-reference#getaddednodeinfo" - 'GetAddressesByAccount': "/en/developer-reference#getaddressesbyaccount" + - 'GetAddressBalance': "/en/developer-reference#getaddressbalance" + - 'GetAddressDeltas': "/en/developer-reference#getaddressdeltas" + - 'GetAddressMempool': "/en/developer-reference#getaddressmempool" + - 'GetAddressTxids': "/en/developer-reference#getaddresstxids" + - 'GetAddressUtxos': "/en/developer-reference#getaddressutxos" - 'GetBalance': "/en/developer-reference#getbalance" - 'GetBestBlockHash': "/en/developer-reference#getbestblockhash" - 'GetBlock': "/en/developer-reference#getblock" - 'GetBlockChainInfo': "/en/developer-reference#getblockchaininfo" - 'GetBlockCount': "/en/developer-reference#getblockcount" - 'GetBlockHash': "/en/developer-reference#getblockhash" + - 'GetBlockHashes': "/en/developer-reference#getblockhashes" - 'GetBlockHeader': "/en/developer-reference#getblockheader" + - 'GetBlockHeaders': "/en/developer-reference#getblockheaders" - 'GetBlockTemplate': "/en/developer-reference#getblocktemplate" - 'GetChainTips': "/en/developer-reference#getchaintips" - 'GetConnectionCount': "/en/developer-reference#getconnectioncount" - 'GetDifficulty': "/en/developer-reference#getdifficulty" + - 'GetGovernanceInfo': "/en/developer-reference#getgovernanceinfo" - 'GetGenerate': "/en/developer-reference#getgenerate" - 'GetHashesPerSec': "/en/developer-reference#gethashespersec" - 'GetInfo': "/en/developer-reference#getinfo" @@ -303,11 +312,14 @@ devsearches: - 'GetNetworkInfo': "/en/developer-reference#getnetworkinfo" - 'GetNewAddress': "/en/developer-reference#getnewaddress" - 'GetPeerInfo': "/en/developer-reference#getpeerinfo" + - 'GetPoolInfo': "/en/developer-reference#getpoolinfo" - 'GetRawChangeAddress': "/en/developer-reference#getrawchangeaddress" - 'GetRawMempool': "/en/developer-reference#getrawmempool" - 'GetRawTransaction': "/en/developer-reference#getrawtransaction" - 'GetReceivedByAccount': "/en/developer-reference#getreceivedbyaccount" - 'GetReceivedByAddress': "/en/developer-reference#getreceivedbyaddress" + - 'GetSpentInfo': "/en/developer-reference#getspentinfo" + - 'GetSuperblockBudget': "/en/developer-reference#getsuperblockbudget" - 'GetTransaction': "/en/developer-reference#gettransaction" - 'GetTxout': "/en/developer-reference#gettxout" - 'GetTxOutProof': "/en/developer-reference#gettxoutproof" @@ -315,6 +327,7 @@ devsearches: - 'GetUnconfirmedBalance': "/en/developer-reference#getunconfirmedbalance" - 'GetWalletInfo': "/en/developer-reference#getwalletinfo" - 'GetWork': "/en/developer-reference#getwork" + - 'GObject': "/en/developer-reference#gobject" - 'Help': "/en/developer-reference#help" - 'ImportAddress': "/en/developer-reference#importaddress" - 'ImportMulti': "/en/developer-reference#importmulti" @@ -332,10 +345,15 @@ devsearches: - 'ListTransactions': "/en/developer-reference#listtransactions" - 'ListUnspent': "/en/developer-reference#listunspent" - 'LockUnspent': "/en/developer-reference#lockunspent" + - 'Masternode': "/en/developer-reference#masternode" + - 'MasternodeBroadcast': "/en/developer-reference#masternodebroadcast" + - 'MasternodeList': "/en/developer-reference#masternodelist" + - 'MnSync': "/en/developer-reference#mnsync" - 'Move': "/en/developer-reference#move" - 'Ping': "/en/developer-reference#ping-rpc" - 'PreciousBlock': "/en/developer-reference#preciousblock" - 'PrioritiseTransaction': "/en/developer-reference#prioritisetransaction" + - 'PrivateSend': "/en/developer-reference#privatesend" - 'PruneBlockChain': "/en/developer-reference#pruneblockchain" - 'RemovePrunedFunds': "/en/developer-reference#removeprunedfunds" - 'SendFrom': "/en/developer-reference#sendfrom" @@ -350,12 +368,14 @@ devsearches: - 'SignMessage': "/en/developer-reference#signmessage" - 'SignMessageWithPrivKey': "/en/developer-reference#signmessagewithprivkey" - 'SignRawTransaction': "/en/developer-reference#signrawtransaction" + - 'Spork': "/en/developer-reference#spork-rpc" - 'Stop': "/en/developer-reference#stop" - 'SubmitBlock': "/en/developer-reference#submitblock" - 'ValidateAddress': "/en/developer-reference#validateaddress" - 'VerifyChain': "/en/developer-reference#verifychain" - 'VerifyMessage': "/en/developer-reference#verifymessage" - 'VerifyTxOutProof': "/en/developer-reference#verifytxoutproof" + - 'VoteRaw': "/en/developer-reference#voteraw" - 'WalletLock': "/en/developer-reference#walletlock" - 'WalletPassphrase': "/en/developer-reference#walletpassphrase" - 'WalletPassphraseChange': "/en/developer-reference#walletpassphrasechange" diff --git a/_data/glossary/en/denominations.yaml b/_data/glossary/en/denominations.yaml index 08f8714b..53c55bda 100644 --- a/_data/glossary/en/denominations.yaml +++ b/_data/glossary/en/denominations.yaml @@ -7,27 +7,23 @@ required: title_max_40_characters_no_formatting: Denominations summary_max_255_characters_no_formatting: > - Denominations of Bitcoin value, usually measured in fractions of - a bitcoin but sometimes measured in multiples of a satoshi. One - bitcoin equals 100,000,000 satoshis. + Denominations of Dash value, usually measured in fractions of + a dash but sometimes measured in multiples of a duff. One + dash equals 100,000,000 duffs. synonyms_shown_in_glossary_capitalize_first_letter: - Denomination - - Bitcoins - - Satoshis + #- Bitcoins + - Duffs optional: synonyms_and_pluralizations_not_shown_in_glossary: - denominations - - millibitcoin - - millibitcoins - - millibit - - millibits - - microbitcoin - - microbitcoins - - microbit - - microbits - - satoshi + - millidash + #- millibit + #- millibits + - microdash + - duff ## Don't add bitcoin singular, we use bare "Bitcoin" massively often ## Don't add bits; the dev docs use [binary] "bits" often diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getblocktemplate.md b/_includes/devdoc/bitcoin-core/rpcs/rpcs/getblocktemplate.md deleted file mode 100644 index a394755c..00000000 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getblocktemplate.md +++ /dev/null @@ -1,28 +0,0 @@ -{% comment %} -This file is licensed under the MIT License (MIT) available on -http://opensource.org/licenses/MIT. -{% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getblocktemplate.md" %} - -##### GetBlockTemplate -{% include helpers/subhead-links.md %} - -{% assign summary_getBlockTemplate="gets a block template or proposal for use with mining software." %} - -{% autocrossref %} - -The `getblocktemplate` RPC {{summary_getBlockTemplate}} For more -information, please see the following resources: - -* [Bitcoin Wiki GetBlockTemplate][wiki getblocktemplate] -* [BIP22][] -* [BIP23][] - -*See also* - -* [SetGenerate][rpc setgenerate]: {{summary_setGenerate}} -* [GetMiningInfo][rpc getmininginfo]: {{summary_getMiningInfo}} -* [SubmitBlock][rpc submitblock]: {{summary_submitBlock}} -* [PrioritiseTransaction][rpc prioritisetransaction]: {{summary_prioritiseTransaction}} - -{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getgenerate.md b/_includes/devdoc/bitcoin-core/rpcs/rpcs/getgenerate.md deleted file mode 100644 index f94383dd..00000000 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getgenerate.md +++ /dev/null @@ -1,26 +0,0 @@ -{% comment %} -This file is licensed under the MIT License (MIT) available on -http://opensource.org/licenses/MIT. -{% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getgenerate.md" %} - -##### GetGenerate -{% include helpers/subhead-links.md %} - -{% assign summary_getGenerate="was removed in Bitcoin Core 0.13.0." %} - -{% autocrossref %} - -*Requires wallet support.* - -The `getgenerate` RPC {{summary_getGenerate}} If you have an older -version of Bitcoin Core, use `help getgenerate` to get help. - -*See also* - -* [Generate][rpc generate]: {{summary_generate}} -* [GenerateToAddress][rpc generatetoaddress]: {{summary_generateToAddress}} -* [GetMiningInfo][rpc getmininginfo]: {{summary_getMiningInfo}} - - -{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/setgenerate.md b/_includes/devdoc/bitcoin-core/rpcs/rpcs/setgenerate.md deleted file mode 100644 index a77242c4..00000000 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/setgenerate.md +++ /dev/null @@ -1,28 +0,0 @@ -{% comment %} -This file is licensed under the MIT License (MIT) available on -http://opensource.org/licenses/MIT. -{% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/setgenerate.md" %} - -##### SetGenerate -{% include helpers/subhead-links.md %} - -{% assign summary_setGenerate="was removed in Bitcoin Core 0.13.0." %} - -{% autocrossref %} - -*Requires wallet support.* - -The `setgenerate` RPC {{summary_setGenerate}} If you have an older -version of Bitcoin Core, use `help setgenerate` RPC to get help. For testing, -the generate call can still be used to mine a block, and the `generatetoaddress` RPC -call has been added to mine to a specific address. This works with wallet disabled. - -*See also* - -* [Generate][rpc generate]: {{summary_generate}} -* [GenerateToAddress][rpc generatetoaddress]: {{summary_generateToAddress}} -* [GetMiningInfo][rpc getmininginfo]: {{summary_getMiningInfo}} -* [GetBlockTemplate][rpc getblocktemplate]: {{summary_getBlockTemplate}} - -{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/submitblock.md b/_includes/devdoc/bitcoin-core/rpcs/rpcs/submitblock.md deleted file mode 100644 index 57fd1141..00000000 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/submitblock.md +++ /dev/null @@ -1,71 +0,0 @@ -{% comment %} -This file is licensed under the MIT License (MIT) available on -http://opensource.org/licenses/MIT. -{% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/submitblock.md" %} - -##### SubmitBlock -{% include helpers/subhead-links.md %} - -{% assign summary_submitBlock="accepts a block, verifies it is a valid addition to the block chain, and broadcasts it to the network. Extra parameters are ignored by Bitcoin Core but may be used by mining pools or other programs." %} - -{% autocrossref %} - -The `submitblock` RPC {{summary_submitBlock}} - -*Parameter #1---the new block in serialized block format as hex* - -{% itemplate ntpd1 %} -- n: "Block" - t: "string (hex)" - p: "Required
(exactly 1)" - d: "The full block to submit in serialized block format as hex" - -{% enditemplate %} - -*Parameter #2---additional parameters* - -{% itemplate ntpd1 %} -- n: "Parameters" - t: "object" - p: "Optional
(0 or 1)" - d: "A JSON object containing extra parameters. Not used directly by Bitcoin Core and also not broadcast to the network. This is available for use by mining pools and other software. A common parameter is a `workid` string" - -{% enditemplate %} - -*Result---`null` or error string* - -{% itemplate ntpd1 %} -- n: "`result`" - t: "null/string" - p: "Required
(exactly 1)" - d: "If the block submission succeeded, set to JSON `null`. If submission failed, set to one of the following strings: `duplicate`, `duplicate-invalid`, `inconclusive`, or `rejected`. The JSON-RPC `error` field will still be set to `null` if submission failed for one of these reasons" - -{% enditemplate %} - -*Example from Bitcoin Core 0.10.0* - -Submit the following block with the workid, "test". - -{% highlight bash %} -bitcoin-cli -testnet submitblock 02000000df11c014a8d798395b5059c\ -722ebdf3171a4217ead71bf6e0e99f4c7000000004a6f6a2db225c81e77773f6\ -f0457bcb05865a94900ed11356d0b75228efb38c7785d6053ffff001d005d437\ -0010100000001000000000000000000000000000000000000000000000000000\ -0000000000000ffffffff0d03b477030164062f503253482fffffffff0100f90\ -29500000000232103adb7d8ef6b63de74313e0cd4e07670d09a169b13e4eda2d\ -650f529332c47646dac00000000 \ -'{ "workid": "test" }' -{% endhighlight %} - -Result (the block above was already on a local block chain): - -{% highlight text %} -duplicate -{% endhighlight %} - -*See also* - -* [GetBlockTemplate][rpc getblocktemplate]: {{summary_getBlockTemplate}} - -{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/verifytxoutproof.md b/_includes/devdoc/bitcoin-core/rpcs/rpcs/verifytxoutproof.md deleted file mode 100644 index 813694e7..00000000 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/verifytxoutproof.md +++ /dev/null @@ -1,73 +0,0 @@ -{% comment %} -This file is licensed under the MIT License (MIT) available on -http://opensource.org/licenses/MIT. -{% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/verifytxoutproof.md" %} - -##### VerifyTxOutProof -{% include helpers/subhead-links.md %} - -{% assign summary_verifyTxOutProof="verifies that a proof points to one or more transactions in a block, returning the transactions the proof commits to and throwing an RPC error if the block is not in our best block chain." %} - -{% autocrossref %} - -The `verifytxoutproof` RPC {{summary_verifyTxOutProof}} - -*Parameter #1---The hex-encoded proof generated by gettxoutproof* - -{% itemplate ntpd1 %} -- n: "`proof`" - t: "string" - p: "Required" - d: "A hex-encoded proof" - -{% enditemplate %} - -*Result---txid(s) which the proof commits to* - -{% itemplate ntpd1 %} -- n: "`result`" - t: "string" - p: "Required
(exactly 1)" - d: "The txid(s) which the proof commits to, or empty array if the proof is invalid" - -{% enditemplate %} - -*Example from Bitcoin Core 0.11.0* - -Verify a proof: - -{% highlight bash %} -bitcoin-cli verifytxoutproof \ -03000000394ab3f08f712aa0f1d26c5daa4040b50e96d31d4e8e3c130000000000000000\ -ca89aaa0bbbfcd5d1210c7888501431256135736817100d8c2cf7e4ab9c02b168115d455\ -04dd1418836b20a6cb0800000d3a61beb3859abf1b773d54796c83b0b937968cc4ce3c0f\ -71f981b2407a3241cb8908f2a88ac90a2844596e6019450f507e7efb8542cbe54ea55634\ -c87bee474ee48aced68179564290d476e16cff01b483edcd2004d555c617dfc08200c083\ -08ba511250e459b49d6a465e1ab1d5d8005e0778359c2993236c85ec66bac4bfd974131a\ -dc1ee0ad8b645f459164eb38325ac88f98c9607752bc1b637e16814f0d9d8c2775ac3f20\ -f85260947929ceef16ead56fcbfd77d9dc6126cce1b5aacd9f834690f7508ee2db2ab67d\ -382c5e738b1b6fe3fb079511952d33ec18c8440ef291eb8d3546a971ee4aa5e574b7be7f\ -5aff0b1c989b2059ae5a611c8ce5c58e8e8476246c5e7c6b70e0065f2a6654e2e6cf4efb\ -6ae19bf2548a7d9febf5b0aceaff28610922e1b9e23e52f650a4a11d2986c9c2b09bb168\ -a70a7d4ac16e4d389bc2868ee91da1837d2cd79288bdc680e9c35ebb3ddfd045d69d767b\ -164ec69d5db9f995c045d10af5bd90cd9d1116c3732e14796ef9d1a57fa7bb718c07989e\ -d06ff359bf2009eaf1b9e000c054b87230567991b447757bc6ca8e1bb6e9816ad604dbd6\ -0600 -{% endhighlight %} - -Result: - -{% highlight json %} -[ -"f20e44c818ec332d95119507fbe36f1b8b735e2c387db62adbe28e50f7904683" -] -{% endhighlight %} - -*See also* - -* [GetTxOutProof][rpc gettxoutproof]: {{summary_getTxOutProof}} -* [`merkleblock` message][merkleblock message]: A description of the - format used for the proof. - -{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/api-intro.md b/_includes/devdoc/dash-core/api-intro.md similarity index 87% rename from _includes/devdoc/bitcoin-core/api-intro.md rename to _includes/devdoc/dash-core/api-intro.md index 2c93275c..7dc30288 100644 --- a/_includes/devdoc/bitcoin-core/api-intro.md +++ b/_includes/devdoc/dash-core/api-intro.md @@ -2,9 +2,9 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/api-intro.md" %} +{% assign filename="_includes/devdoc/dash-core/api-intro.md" %} -## Bitcoin Core APIs +## Dash Core APIs {% include helpers/subhead-links.md %} ### Hash Byte Order @@ -12,7 +12,7 @@ http://opensource.org/licenses/MIT. {% autocrossref %} -Bitcoin Core RPCs accept and return the byte-wise reverse of computed +Dash Core RPCs accept and return the byte-wise reverse of computed SHA-256 hash values. For example, the Unix `sha256sum` command displays the SHA256(SHA256()) hash of mainnet block 300,000's header as: @@ -26,25 +26,28 @@ previous-header-hash part of block 300,001's header: 0000000000000ab0aaa377ca3f49b1545e2ae6b0667a08f42e72d8c24ae\ 237140e28f14f3bb7c6bcc6d536c890019edd83ccf -However, Bitcoin Core's RPCs use the byte-wise reverse for hashes, so if you -want to get information about block 300,000 using the `getblock` RPC, +However, Dash Core's RPCs use the byte-wise reverse for hashes, so if you +want to get information about block 675,776 using the `getblock` RPC, you need to reverse the requested hash: - > bitcoin-cli getblock \ + bitcoin-cli getblock \ 000000000000000082ccf8f1557c5d40b21edabb18d2d691cfbf87118bac7254 + --> + > dash-cli getblock \ + 000000000000327a66cd1011b2d1defd1417b7d9e39b439e8e67ba996ee92602 (Note: hex representation uses two characters to display each byte of data, which is why the reversed string looks somewhat mangled.) The rationale for the reversal is unknown, but it likely stems from -Bitcoin Core's use of hashes (which are byte arrays in C++) as integers +Dash Core's use of hashes (which are byte arrays in C++) as integers for the purpose of determining whether the hash is below the network target. Whatever the reason for reversing header hashes, the reversal also extends to other hashes used in RPCs, such as TXIDs and merkle roots. As header hashes and TXIDs are widely used as global identifiers in -other Bitcoin software, this reversal of hashes has become the standard +other Dash software, this reversal of hashes has become the standard way to refer to certain objects. The table below should make clear where each byte order is used. diff --git a/_includes/devdoc/bitcoin-core/rest/intro.md b/_includes/devdoc/dash-core/rest/intro.md similarity index 95% rename from _includes/devdoc/bitcoin-core/rest/intro.md rename to _includes/devdoc/dash-core/rest/intro.md index 453c62f2..0f54eb50 100644 --- a/_includes/devdoc/bitcoin-core/rest/intro.md +++ b/_includes/devdoc/dash-core/rest/intro.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rest/intro.md" %} +{% assign filename="_includes/devdoc/dash-core/rest/intro.md" %} ### HTTP REST {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rest/quick-reference.md b/_includes/devdoc/dash-core/rest/quick-reference.md similarity index 92% rename from _includes/devdoc/bitcoin-core/rest/quick-reference.md rename to _includes/devdoc/dash-core/rest/quick-reference.md index e92b2f20..b5a9026f 100644 --- a/_includes/devdoc/bitcoin-core/rest/quick-reference.md +++ b/_includes/devdoc/dash-core/rest/quick-reference.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rest/quick-reference.md" %} +{% assign filename="_includes/devdoc/dash-core/rest/quick-reference.md" %} #### Quick Reference {#rest-quick-reference} {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rest/requests/get_block-notxdetails.md b/_includes/devdoc/dash-core/rest/requests/get_block-notxdetails.md similarity index 98% rename from _includes/devdoc/bitcoin-core/rest/requests/get_block-notxdetails.md rename to _includes/devdoc/dash-core/rest/requests/get_block-notxdetails.md index 70c67b0b..101708f2 100644 --- a/_includes/devdoc/bitcoin-core/rest/requests/get_block-notxdetails.md +++ b/_includes/devdoc/dash-core/rest/requests/get_block-notxdetails.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rest/requests/get_block-notxdetails.md" %} +{% assign filename="_includes/devdoc/dash-core/rest/requests/get_block-notxdetails.md" %} ##### GET Block/NoTxDetails {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rest/requests/get_block.md b/_includes/devdoc/dash-core/rest/requests/get_block.md similarity index 98% rename from _includes/devdoc/bitcoin-core/rest/requests/get_block.md rename to _includes/devdoc/dash-core/rest/requests/get_block.md index e6856431..d6b8578e 100644 --- a/_includes/devdoc/bitcoin-core/rest/requests/get_block.md +++ b/_includes/devdoc/dash-core/rest/requests/get_block.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rest/requests/get_block.md" %} +{% assign filename="_includes/devdoc/dash-core/rest/requests/get_block.md" %} ##### GET Block {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rest/requests/get_chaininfo.md b/_includes/devdoc/dash-core/rest/requests/get_chaininfo.md similarity index 98% rename from _includes/devdoc/bitcoin-core/rest/requests/get_chaininfo.md rename to _includes/devdoc/dash-core/rest/requests/get_chaininfo.md index 605a3ae7..1f220a5f 100644 --- a/_includes/devdoc/bitcoin-core/rest/requests/get_chaininfo.md +++ b/_includes/devdoc/dash-core/rest/requests/get_chaininfo.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rest/requests/get_chaininfo.md" %} +{% assign filename="_includes/devdoc/dash-core/rest/requests/get_chaininfo.md" %} ##### GET ChainInfo {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rest/requests/get_getutxos.md b/_includes/devdoc/dash-core/rest/requests/get_getutxos.md similarity index 98% rename from _includes/devdoc/bitcoin-core/rest/requests/get_getutxos.md rename to _includes/devdoc/dash-core/rest/requests/get_getutxos.md index 8d5b894c..0c02c142 100644 --- a/_includes/devdoc/bitcoin-core/rest/requests/get_getutxos.md +++ b/_includes/devdoc/dash-core/rest/requests/get_getutxos.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rest/requests/get_getutxos.md" %} +{% assign filename="_includes/devdoc/dash-core/rest/requests/get_getutxos.md" %} ##### GET GetUtxos {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rest/requests/get_headers.md b/_includes/devdoc/dash-core/rest/requests/get_headers.md similarity index 98% rename from _includes/devdoc/bitcoin-core/rest/requests/get_headers.md rename to _includes/devdoc/dash-core/rest/requests/get_headers.md index d90d0474..2279acb1 100644 --- a/_includes/devdoc/bitcoin-core/rest/requests/get_headers.md +++ b/_includes/devdoc/dash-core/rest/requests/get_headers.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rest/requests/get_headers.md" %} +{% assign filename="_includes/devdoc/dash-core/rest/requests/get_headers.md" %} ##### GET Headers {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rest/requests/get_mempool-contents.md b/_includes/devdoc/dash-core/rest/requests/get_mempool-contents.md similarity index 98% rename from _includes/devdoc/bitcoin-core/rest/requests/get_mempool-contents.md rename to _includes/devdoc/dash-core/rest/requests/get_mempool-contents.md index 858dc1bd..725574a8 100644 --- a/_includes/devdoc/bitcoin-core/rest/requests/get_mempool-contents.md +++ b/_includes/devdoc/dash-core/rest/requests/get_mempool-contents.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rest/requests/get_mempool-contents.md" %} +{% assign filename="_includes/devdoc/dash-core/rest/requests/get_mempool-contents.md" %} ##### GET MemPool/Contents {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rest/requests/get_mempool-info.md b/_includes/devdoc/dash-core/rest/requests/get_mempool-info.md similarity index 95% rename from _includes/devdoc/bitcoin-core/rest/requests/get_mempool-info.md rename to _includes/devdoc/dash-core/rest/requests/get_mempool-info.md index bfe3843a..3fa7ba45 100644 --- a/_includes/devdoc/bitcoin-core/rest/requests/get_mempool-info.md +++ b/_includes/devdoc/dash-core/rest/requests/get_mempool-info.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rest/requests/get_mempool-info.md" %} +{% assign filename="_includes/devdoc/dash-core/rest/requests/get_mempool-info.md" %} ##### GET MemPool/Info {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rest/requests/get_tx.md b/_includes/devdoc/dash-core/rest/requests/get_tx.md similarity index 98% rename from _includes/devdoc/bitcoin-core/rest/requests/get_tx.md rename to _includes/devdoc/dash-core/rest/requests/get_tx.md index da945df7..2621c20c 100644 --- a/_includes/devdoc/bitcoin-core/rest/requests/get_tx.md +++ b/_includes/devdoc/dash-core/rest/requests/get_tx.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rest/requests/get_tx.md" %} +{% assign filename="_includes/devdoc/dash-core/rest/requests/get_tx.md" %} ##### GET Tx {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/intro.md b/_includes/devdoc/dash-core/rpcs/intro.md similarity index 76% rename from _includes/devdoc/bitcoin-core/rpcs/intro.md rename to _includes/devdoc/dash-core/rpcs/intro.md index a7f2d915..cc6e163d 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/intro.md +++ b/_includes/devdoc/dash-core/rpcs/intro.md @@ -2,41 +2,41 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/intro.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/intro.md" %} ### Remote Procedure Calls (RPCs) {% include helpers/subhead-links.md %} {% autocrossref %} -Bitcoin Core provides a remote procedure call (RPC) interface for various +Dash Core provides a remote procedure call (RPC) interface for various administrative tasks, wallet operations, and queries about network and block chain data. -If you start Bitcoin Core using `bitcoin-qt`, the RPC interface is disabled by -default. To enable it, set `server=1` in `bitcoin.conf` or supply the `-server` -argument when invoking the program. If you start Bitcoin Core using `bitcoind`, +If you start Dash Core using `dash-qt`, the RPC interface is disabled by +default. To enable it, set `server=1` in `dash.conf` or supply the `-server` +argument when invoking the program. If you start Dash Core using `dashd`, the RPC interface is enabled by default. The interface requires the user to provide a password for authenticating RPC requests. This password can be set either using the `rpcpassword` property in -`bitcoin.conf` or by supplying the `-rpcpassword` program argument. Optionally a +`dash.conf` or by supplying the `-rpcpassword` program argument. Optionally a username can be set using the `rpcuser` configuration value. See the [Examples -Page][devexamples] for more information about setting Bitcoin Core configuration +Page][devexamples] for more information about setting Dash Core configuration values. Open-source client libraries for the RPC interface are readily available in most modern programming languages, so you probably don't need to write your own from -scratch. Bitcoin Core also ships with its own compiled C++ RPC client, -`bitcoin-cli`, located in the `bin` directory alongside `bitcoind` and -`bitcoin-qt`. The `bitcoin-cli` program can be used as a command-line interface -(CLI) to Bitcoin Core or for making RPC calls from applications written in +scratch. Dash Core also ships with its own compiled C++ RPC client, +`dash-cli`, located in the `bin` directory alongside `dashd` and +`dash-qt`. The `dash-cli` program can be used as a command-line interface +(CLI) to Dash Core or for making RPC calls from applications written in languages lacking a suitable native client. The remainder of this section -describes the Bitcoin Core RPC protocol in detail. +describes the Dash Core RPC protocol in detail. -The Bitcoin Core RPC service listens for HTTP `POST` requests on port 8332 in -mainnet mode or 18332 in testnet or regtest mode. The port number can be changed -by setting `rpcport` in `bitcoin.conf`. By default the RPC service binds to your +The Dash Core RPC service listens for HTTP `POST` requests on port 9998 in +mainnet mode, 19998 in testnet, or 18332 in regtest mode. The port number can be changed +by setting `rpcport` in `dash.conf`. By default the RPC service binds to your server's [localhost][Localhost] loopback network interface so it's not accessible from other servers. Authentication is implemented using [HTTP basic @@ -53,7 +53,7 @@ format: | Name | Type | Presence | Description |----------------------|-----------------|-----------------------------|---------------- | Request | object | Required
(exactly 1) | The JSON-RPC request object -| →
`jsonrpc` | number (real) | Optional
(0 or 1) | Version indicator for the JSON-RPC request. Currently ignored by Bitcoin Core. +| →
`jsonrpc` | number (real) | Optional
(0 or 1) | Version indicator for the JSON-RPC request. Currently ignored by Dash Core. | →
`id` | string | Optional
(0 or 1) | An arbitrary string that will be returned with the response. May be omitted or set to an empty string ("") | →
`method` | string | Required
(exactly 1) | The RPC method name (e.g. `getblock`). See the RPC section for a list of available methods. | →
`params` | array | Optional
(0 or 1) | An array containing positional parameter values for the RPC. May be an empty array or omitted for RPC calls that don't have any required parameters. @@ -72,7 +72,7 @@ output, we use the following conventions * Code-style names like `params` are literal strings that appear in the JSON object. -* "Type" is the JSON data type and the specific Bitcoin Core type. +* "Type" is the JSON data type and the specific Dash Core type. * "Presence" indicates whether or not a field must be present within its containing array or object. Note that an optional object may still have @@ -103,38 +103,38 @@ the genesis block: } {% endhighlight %} -The command to send this request using `bitcoin-cli` is: +The command to send this request using `dash-cli` is: {% highlight bash %} -bitcoin-cli getblockhash 0 +dash-cli getblockhash 0 {% endhighlight %} Alternatively, we could `POST` this request using the cURL command-line program as follows: {% highlight bash %} -curl --user ':my_secret_password' --data-binary ''' +curl --user 'my_username:my_secret_password' --data-binary ''' { "method": "getblockhash", "params": [0], "id": "foo" }''' \ - --header 'Content-Type: text/plain;' localhost:8332 + --header 'Content-Type: text/plain;' localhost:9998 {% endhighlight %} The HTTP response data for this request would be: {% highlight json %} { - "result": "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f", + "result": "00000ffd590b1485b3caadc19b22e6379c733355108f107a430458cdf3407ab6", "error": null, "id": "foo" } {% endhighlight %} -Note: In order to minimize its size, the raw JSON response from Bitcoin Core +Note: In order to minimize its size, the raw JSON response from Dash Core doesn't include any extraneous whitespace characters. Here we've added -whitespace to make the object more readable. Speaking of which, `bitcoin-cli` +whitespace to make the object more readable. Speaking of which, `dash-cli` also transforms the raw response to make it more human-readable. It: - Adds whitespace indentation to JSON objects @@ -143,14 +143,14 @@ also transforms the raw response to make it more human-readable. It: - Strips the outer double-quotes around `result`s of type string - Returns only the `error` field if there's an error -Continuing with the example above, the output from the `bitcoin-cli` +Continuing with the example above, the output from the `dash-cli` command would be simply: {% highlight text %} -000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f +00000ffd590b1485b3caadc19b22e6379c733355108f107a430458cdf3407ab6 {% endhighlight %} -If there's an error processing a request, Bitcoin Core sets the `result` field +If there's an error processing a request, Dash Core sets the `result` field to `null` and provides information about the error in the `error` field. For example, a request for the block hash at block height -1 would be met with the following response (again, whitespace added for clarity): @@ -166,28 +166,47 @@ following response (again, whitespace added for clarity): } {% endhighlight %} -If `bitcoin-cli` encounters an error, it exits with a non-zero status code and +If `dash-cli` encounters an error, it exits with a non-zero status code and outputs the `error` field as text to the process's standard error stream: {% highlight text %} -error: {"code": -8, "message": "Block height out of range"} +error code: -8 +error message: +Block height out of range {% endhighlight %} -Starting in Bitcoin Core version 0.7.0, the RPC interface supports request +The RPC interface supports request batching as described in [version 2.0 of the JSON-RPC specification][JSON-RPC request batching]. To initiate multiple RPC requests within a single HTTP request, a client can `POST` a JSON array filled with Request objects. The HTTP response data is then a JSON array filled with the corresponding Response objects. Depending on your usage pattern, -request batching may provide significant performance gains. The `bitcoin-cli` +request batching may provide significant performance gains. The `dash-cli` RPC client does not support batch requests. +{% highlight bash %} +curl --user 'my_username:my_secret_password' --data-binary ''' + [ + { + "method": "getblockhash", + "params": [0], + "id": "foo" + }, + { + "method": "getblockhash", + "params": [1], + "id": "foo2" + } + ]''' \ + --header 'Content-Type: text/plain;' localhost:9998 +{% endhighlight %} + To keep this documentation compact and readable, the examples for each of the -available RPC calls will be given as `bitcoin-cli` commands: +available RPC calls will be given as `dash-cli` commands: {% highlight text %} -bitcoin-cli [options] ... +dash-cli [options] ... {% endhighlight %} This translates into an JSON-RPC Request object of the form: diff --git a/_includes/devdoc/bitcoin-core/rpcs/quick-reference.md b/_includes/devdoc/dash-core/rpcs/quick-reference.md similarity index 64% rename from _includes/devdoc/bitcoin-core/rpcs/quick-reference.md rename to _includes/devdoc/dash-core/rpcs/quick-reference.md index bd4b4037..bc5a9f28 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/quick-reference.md +++ b/_includes/devdoc/dash-core/rpcs/quick-reference.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/quick-reference.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/quick-reference.md" %} #### Quick Reference {#rpc-quick-reference} {% include helpers/subhead-links.md %} @@ -16,32 +16,39 @@ changes made more than two years ago. Use v0.n.n in abbreviation title to prevent autocrossrefing. {% endcomment %} + +{% assign DASH_NOT_IMPLEMENTED='**Not Implemented**' %} + + +{% assign DASH_NEW0_12_1='*New in Dash Core 0.12.1*' %} +{% assign DASH_UPDATED0_12_1='**Updated in Dash Core 0.12.1**' %} + {% assign DEPRECATED='**Deprecated**' %} -{% assign UPDATED0_14_0='**Updated in 0.14.1**' %} +{% assign UPDATED0_14_0='**Updated in Bitcoin Core 0.14.1**' %} -{% assign NEW0_14_0='**New in 0.14.0**' %} -{% assign UPDATED0_14_0='**Updated in 0.14.0**' %} +{% assign NEW0_14_0='**New in Bitcoin Core 0.14.0**' %} +{% assign UPDATED0_14_0='**Updated in Bitcoin Core 0.14.0**' %} -{% assign UPDATED0_13_1='*Updated in 0.13.1*' %} +{% assign UPDATED0_13_1='*Updated in Bitcoin Core 0.13.1*' %} -{% assign NEW0_13_0='*New in 0.13.0*' %} -{% assign UPDATED0_13_0='*Updated in 0.13.0*' %} +{% assign NEW0_13_0='*New in Bitcoin Core 0.13.0*' %} +{% assign UPDATED0_13_0='*Updated in Bitcoin Core 0.13.0*' %} -{% assign UPDATED0_12_1='*Updated in 0.12.1*' %} +{% assign UPDATED0_12_1='*Updated in Bitcoin Core 0.12.1*' %} -{% assign NEW0_12_0='*New in 0.12.0*' %} -{% assign UPDATED0_12_0='*Updated in 0.12.0*' %} +{% assign NEW0_12_0='*New in Bitcoin Core 0.12.0*' %} +{% assign UPDATED0_12_0='*Updated in Bitcoin Core 0.12.0*' %} -{% assign NEW0_11_0='*New in 0.11.0*' %} +{% assign NEW0_11_0='*New in Bitcoin Core 0.11.0*' %} {% include helpers/summaries.md %} +#### Addressindex RPCs +These RPCs are all Dash-specific and not found in Bitcoin Core +{:.no_toc} + + +{% autocrossref %} + +* [GetAddressBalance][rpc getaddressbalance]: {{summary_getAddressBalance}} +* [GetAddressDeltas][rpc getaddressdeltas]: {{summary_getAddressDeltas}} +* [GetAddressMempool][rpc getaddressmempool]: {{summary_getAddressMempool}} +* [GetAddressTxids][rpc getaddresstxids]: {{summary_getAddressTxids}} +* [GetAddressUtxos][rpc getaddressutxos]: {{summary_getAddressUtxos}} + +{% endautocrossref %} + + #### Block Chain RPCs {:.no_toc} @@ -61,36 +84,67 @@ Use v0.n.n in abbreviation title to prevent autocrossrefing. * [GetBlockChainInfo][rpc getblockchaininfo]: {{summary_getBlockChainInfo}} {{UPDATED0_12_1}} * [GetBlockCount][rpc getblockcount]: {{summary_getBlockCount}} * [GetBlockHash][rpc getblockhash]: {{summary_getBlockHash}} +* [GetBlockHashes][rpc getblockhashes]: {{summary_getBlockHashes}} {{DASH_NEW0_12_1}} * [GetBlockHeader][rpc getblockheader]: {{summary_getBlockHeader}} {{NEW0_12_0}} -* [GetChainTips][rpc getchaintips]: {{summary_getChainTips}} -* [GetDifficulty][rpc getdifficulty]: {{summary_getDifficultly}} -* [GetMemPoolAncestors][rpc getmempoolancestors]: {{summary_getMemPoolAncestors}} {{NEW0_13_0}} -* [GetMemPoolDescendants][rpc getmempooldescendants]: {{summary_getMemPoolDescendants}} {{NEW0_13_0}} -* [GetMemPoolEntry][rpc getmempoolentry]: {{summary_getMemPoolEntry}} {{NEW0_13_0}} +* [GetBlockHeaders][rpc getblockheaders]: {{summary_getBlockHeaders}} {{DASH_NEW0_12_1}} +* [GetChainTips][rpc getchaintips]: {{summary_getChainTips}} {{DASH_UPDATED0_12_1}} +* [GetDifficulty][rpc getdifficulty]: {{summary_getDifficulty}} * [GetMemPoolInfo][rpc getmempoolinfo]: {{summary_getMemPoolInfo}} {{UPDATED0_12_0}} * [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}} {{UPDATED0_13_0}} +* [GetSpentInfo][rpc getspentinfo]: {{summary_getSpentInfo}} {{DASH_NEW0_12_1}} * [GetTxOut][rpc gettxout]: {{summary_getTxOut}} * [GetTxOutProof][rpc gettxoutproof]: {{summary_getTxOutProof}} {{NEW0_11_0}} * [GetTxOutSetInfo][rpc gettxoutsetinfo]: {{summary_getTxOutSetInfo}} -* [PreciousBlock][rpc preciousblock]: {{summary_preciousBlock}} {{NEW0_14_0}} -* [PruneBlockChain][rpc pruneblockchain]: {{summary_pruneBlockChain}} {{NEW0_14_0}} * [VerifyChain][rpc verifychain]: {{summary_verifyChain}} * [VerifyTxOutProof][rpc verifytxoutproof]: {{summary_verifyTxOutProof}} {{NEW0_11_0}} {% endautocrossref %} +**Not implemented in Dash** + +{% autocrossref %} + +* {{DASH_NOT_IMPLEMENTED}} [GetMemPoolAncestors][rpc getmempoolancestors]: {{summary_getMemPoolAncestors}} {{NEW0_13_0}} +* {{DASH_NOT_IMPLEMENTED}} [GetMemPoolDescendants][rpc getmempooldescendants]: {{summary_getMemPoolDescendants}} {{NEW0_13_0}} +* {{DASH_NOT_IMPLEMENTED}} [GetMemPoolEntry][rpc getmempoolentry]: {{summary_getMemPoolEntry}} {{NEW0_13_0}} +* {{DASH_NOT_IMPLEMENTED}} [PreciousBlock][rpc preciousblock]: {{summary_preciousBlock}} {{NEW0_14_0}} +* {{DASH_NOT_IMPLEMENTED}} [PruneBlockChain][rpc pruneblockchain]: {{summary_pruneBlockChain}} {{NEW0_14_0}} + +{% endautocrossref %} + #### Control RPCs {:.no_toc} {% autocrossref %} +* [Debug][rpc debug]: {{summary_debug}} * [GetInfo][rpc getinfo]: {{summary_getInfo}} {{DEPRECATED}} * [Help][rpc help]: {{summary_help}} * [Stop][rpc stop]: {{summary_stop}} {% endautocrossref %} +#### Dash RPCs +{:.no_toc} + + +{% autocrossref %} + +* [GetGovernanceInfo][rpc getgovernanceinfo]: {{summary_getGovernanceInfo}} +* [GetPoolInfo][rpc getpoolinfo]: {{summary_getPoolInfo}} +* [GetSuperblockBudget][rpc getsuperblockbudget]: {{summary_getSuperblockBudget}} +* [GObject][rpc gobject]: {{summary_gObject}} +* [Masternode][rpc masternode]: {{summary_masternode}} +* [MasternodeBroadcast][rpc masternodebroadcast]: {{summary_masternodeBroadcast}} +* [MasternodeList][rpc masternodelist]: {{summary_masternodeList}} +* [MnSync][rpc mnsync]: {{summary_mnSync}} +* [PrivateSend][rpc privatesend]: {{summary_privateSend}} +* [Spork][rpc spork]: {{summary_spork-rpc}} +* [VoteRaw][rpc voteraw]: {{summary_voteRaw}} + +{% endautocrossref %} + #### Generating RPCs {:.no_toc} @@ -98,7 +152,9 @@ Use v0.n.n in abbreviation title to prevent autocrossrefing. {% autocrossref %} * [Generate][rpc generate]: {{summary_generate}} {{NEW0_11_0}}, {{UPDATED0_13_0}} -* [GenerateToAddress][rpc generatetoaddress]: {{summary_generateToAddress}} {{NEW0_13_0}} +* [GetGenerate][rpc getgenerate]: {{summary_getGenerate}} +* [SetGenerate][rpc setgenerate]: {{summary_setGenerate}} +* {{DASH_NOT_IMPLEMENTED}} [GenerateToAddress][rpc generatetoaddress]: {{summary_generateToAddress}} {{NEW0_13_0}} {% endautocrossref %} @@ -144,9 +200,9 @@ Use v0.n.n in abbreviation title to prevent autocrossrefing. {% autocrossref %} * [CreateRawTransaction][rpc createrawtransaction]: {{summary_createRawTransaction}} {{UPDATED0_14_1}} -* [FundRawTransaction][rpc fundrawtransaction]: {{summary_fundRawTransaction}} {{NEW0_12_0}}, {{UPDATED0_14_0}} * [DecodeRawTransaction][rpc decoderawtransaction]: {{summary_decodeRawTransaction}} {{UPDATED0_13_0}} * [DecodeScript][rpc decodescript]: {{summary_decodeScript}} +* [FundRawTransaction][rpc fundrawtransaction]: {{summary_fundRawTransaction}} {{NEW0_12_0}}, {{UPDATED0_14_0}} * [GetRawTransaction][rpc getrawtransaction]: {{summary_getRawTransaction}} {{UPDATED0_14_0}} * [SendRawTransaction][rpc sendrawtransaction]: {{summary_sendRawTransaction}} * [SignRawTransaction][rpc signrawtransaction]: {{summary_signRawTransaction}} @@ -160,12 +216,15 @@ Use v0.n.n in abbreviation title to prevent autocrossrefing. {% autocrossref %} * [CreateMultiSig][rpc createmultisig]: {{summary_createMultiSig}} -* [EstimateFee][rpc estimatefee]: {{summary_estimateFee}} {{UPDATED0_14_0}} -* [EstimatePriority][rpc estimatepriority]: {{summary_estimatePriority}} {{DEPRECATED}} -* [GetMemoryInfo][rpc getmemoryinfo]: {{summary_getMemoryInfo}} {{NEW_14_0}} +* [EstimateFee][rpc estimatefee]: {{summary_estimateFee}} +* [EstimatePriority][rpc estimatepriority]: {{summary_estimatePriority}} + * [EstimateSmartFee][rpc estimatesmartfee]: {{summary_estimateSmartFee}} {{DEPRECATED}} + * [EstimateSmartPriority][rpc estimatesmartpriority]: {{summary_estimateSmartPriority}} {{DEPRECATED}} * [ValidateAddress][rpc validateaddress]: {{summary_validateAddress}} {{UPDATED0_13_0}} * [VerifyMessage][rpc verifymessage]: {{summary_verifyMessage}} +* {{DASH_NOT_IMPLEMENTED}} [GetMemoryInfo][rpc getmemoryinfo]: {{summary_getMemoryInfo}} {{NEW_14_0}} + {% endautocrossref %} #### Wallet RPCs @@ -174,20 +233,19 @@ Use v0.n.n in abbreviation title to prevent autocrossrefing. {% autocrossref %} -**Note:** the wallet RPCs are only available if Bitcoin Core was built +**Note:** the wallet RPCs are only available if Dash Core was built with [wallet support][]{:#term-wallet-support}{:.term}, which is the default. * [AbandonTransaction][rpc abandontransaction]: {{summary_abandonTransaction}} {{NEW0_12_0}} -* [AddWitnessAddress][rpc addwitnessaddress]: {{summary_addWitnessAddress}} {{NEW0_13_0}} * [AddMultiSigAddress][rpc addmultisigaddress]: {{summary_addMultiSigAddress}} * [BackupWallet][rpc backupwallet]: {{summary_backupWallet}} -* [BumpFee][rpc bumpfee]: {{summary_bumpFee}} {{NEW0_14_0}} + * [DumpHDInfo][rpc dumphdinfo]: {{summary_dumpHdInfo}} * [DumpPrivKey][rpc dumpprivkey]: {{summary_dumpPrivKey}} * [DumpWallet][rpc dumpwallet]: {{summary_dumpWallet}} * [EncryptWallet][rpc encryptwallet]: {{summary_encryptWallet}} -* [GetAccountAddress][rpc getaccountaddress]: {{summary_getAccountAddress}} {{DEPRECATED}} * [GetAccount][rpc getaccount]: {{summary_getAccount}} +* [GetAccountAddress][rpc getaccountaddress]: {{summary_getAccountAddress}} {{DEPRECATED}} * [GetAddressesByAccount][rpc getaddressesbyaccount]: {{summary_getAddressesByAccount}} {{DEPRECATED}} * [GetBalance][rpc getbalance]: {{summary_getBalance}} * [GetNewAddress][rpc getnewaddress]: {{summary_getNewAddress}} @@ -198,10 +256,12 @@ default. * [GetUnconfirmedBalance][rpc getunconfirmedbalance]: {{summary_getUnconfirmedBalance}} * [GetWalletInfo][rpc getwalletinfo]: {{summary_getWalletInfo}} * [ImportAddress][rpc importaddress]: {{summary_importAddress}} -* [ImportMulti][rpc importmulti]: {{summary_importMulti}} {{NEW0_14_0}} -* [ImportPrunedFunds][rpc importprunedfunds]: {{summary_importPrunedFunds}} {{NEW0_13_0}} + * [ImportElectrumWallet][rpc importelecturmwallet]: {{summary_importElectrumWallet}} {{DASH_NEW0_12_1}} * [ImportPrivKey][rpc importprivkey]: {{summary_importPrivKey}} + * [ImportPubKey][rpc importpubkey]: {{summary_importPubKey}} * [ImportWallet][rpc importwallet]: {{summary_importWallet}} + * [InstantSendToAddress][rpc instantsendtoaddress]: {{summary_instantSendToAddress}} + * [Keepass][rpc keepass]: {{summary_keepass}} * [KeyPoolRefill][rpc keypoolrefill]: {{summary_keyPoolRefill}} * [ListAccounts][rpc listaccounts]: {{summary_listAccounts}} {{DEPRECATED}} * [ListAddressGroupings][rpc listaddressgroupings]: {{summary_listAddressGroupings}} @@ -213,18 +273,23 @@ default. * [ListUnspent][rpc listunspent]: {{summary_listUnspent}} {{UPDATED0_13_0}} * [LockUnspent][rpc lockunspent]: {{summary_lockUnspent}} * [Move][rpc move]: {{summary_move}} {{DEPRECATED}} -* [RemovePrunedFunds][rpc removeprunedfunds]: {{summary_removePrunedFunds}} {{NEW0_13_0}} * [SendFrom][rpc sendfrom]: {{summary_sendFrom}} {{DEPRECATED}} * [SendMany][rpc sendmany]: {{summary_sendMany}} * [SendToAddress][rpc sendtoaddress]: {{summary_sendToAddress}} * [SetAccount][rpc setaccount]: {{summary_setAccount}} {{DEPRECATED}} * [SetTxFee][rpc settxfee]: {{summary_setTxFee}} -* [SignMessage][rpc signmessage]: {{summary_signMessage}} -* [SignMessageWithPrivKey][rpc signmessagewithprivkey]: {{summary_signMessageWithPrivKey}} {{NEW0_13_0}} +* [SignMessage][rpc signmessage]: {{summary_signMessage}} * [WalletLock][rpc walletlock]: {{summary_walletLock}} * [WalletPassphrase][rpc walletpassphrase]: {{summary_walletPassphrase}} * [WalletPassphraseChange][rpc walletpassphrasechange]: {{summary_walletPassphraseChange}} +* {{DASH_NOT_IMPLEMENTED}} [AddWitnessAddress][rpc addwitnessaddress]: {{summary_addWitnessAddress}} {{NEW0_13_0}} +* {{DASH_NOT_IMPLEMENTED}} [BumpFee][rpc bumpfee]: {{summary_bumpFee}} {{NEW0_14_0}} +* {{DASH_NOT_IMPLEMENTED}} [ImportMulti][rpc importmulti]: {{summary_importMulti}} {{NEW0_14_0}} +* {{DASH_NOT_IMPLEMENTED}} [ImportPrunedFunds][rpc importprunedfunds]: {{summary_importPrunedFunds}} {{NEW0_13_0}} +* {{DASH_NOT_IMPLEMENTED}} [RemovePrunedFunds][rpc removeprunedfunds]: {{summary_removePrunedFunds}} {{NEW0_13_0}} +* {{DASH_NOT_IMPLEMENTED}} [SignMessageWithPrivKey][rpc signmessagewithprivkey]: {{summary_signMessageWithPrivKey}} {{NEW0_13_0}} + {% endautocrossref %} #### Removed RPCs @@ -233,9 +298,10 @@ default. {% autocrossref %} -* [GetGenerate][rpc getgenerate]: {{summary_getGenerate}} * [GetHashesPerSec][rpc gethashespersec]: {{summary_getHashesPerSec}} * [GetWork][rpc getwork]: {{summary_getWork}} + {% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/abandontransaction.md b/_includes/devdoc/dash-core/rpcs/rpcs/abandontransaction.md similarity index 93% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/abandontransaction.md rename to _includes/devdoc/dash-core/rpcs/rpcs/abandontransaction.md index e6b538e1..f0c4832b 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/abandontransaction.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/abandontransaction.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/abandontransaction.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/abandontransaction.md" %} ##### AbandonTransaction {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/addmultisigaddress.md b/_includes/devdoc/dash-core/rpcs/rpcs/addmultisigaddress.md similarity index 96% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/addmultisigaddress.md rename to _includes/devdoc/dash-core/rpcs/rpcs/addmultisigaddress.md index 36c57582..ea0db441 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/addmultisigaddress.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/addmultisigaddress.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/addmultisigaddress.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/addmultisigaddress.md" %} ##### AddMultiSigAddress {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/addnode.md b/_includes/devdoc/dash-core/rpcs/rpcs/addnode.md similarity index 78% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/addnode.md rename to _includes/devdoc/dash-core/rpcs/rpcs/addnode.md index 5f2b2a82..ef0a0424 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/addnode.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/addnode.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/addnode.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/addnode.md" %} ##### AddNode {% include helpers/subhead-links.md %} @@ -16,17 +16,17 @@ The `addnode` RPC {{summary_addNode}} *Parameter #1---hostname/IP address and port of node to add or remove* {% itemplate ntpd1 %} -- n: "Node" +- n: "`node`" t: "string" p: "Required
(exactly 1)" - d: "The node to add as a string in the form of `:`. The IP address may be a hostname resolvable through DNS, an IPv4 address, an IPv4-as-IPv6 address, or an IPv6 address" + d: "The node to add as a string in the form of `:`." {% enditemplate %} *Parameter #2---whether to add or remove the node, or to try only once to connect* {% itemplate ntpd1 %} -- n: "Command" +- n: "`command`" t: "string" p: "Required
(exactly 1)" d: "What to do with the IP address above. Options are:
• `add` to add a node to the addnode list. Up to 8 nodes can be added additional to the default 8 nodes. Not limited by `-maxconnections`
• `remove` to remove a node from the list. If currently connected, this will disconnect immediately
• `onetry` to immediately attempt connection to the node even if the outgoing connection slots are full; this will only attempt the connection once" @@ -39,19 +39,19 @@ The `addnode` RPC {{summary_addNode}} - n: "`result`" t: "null" p: "Required
(exactly 1)" - d: "Always JSON `null` whether the node was added, removed, tried-and-connected, or tried-and-not-connected. The JSON-RPC error field will be set only if you try removing a node that is not on the addnodes list" + d: "Always JSON `null` whether the node was added, removed, tried-and-connected, or tried-and-not-connected. The JSON-RPC error field will be set only if you try adding a node that was already added or removing a node that is not on the addnodes list" {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* Try connecting to the following node. {% highlight bash %} -bitcoin-cli -testnet addnode 192.0.2.113:18333 onetry +dash-cli -testnet addnode 192.0.2.113:19999 onetry {% endhighlight %} -Result (no output from `bitcoin-cli` because result is set to `null`). +Result (no output from `dash-cli` because result is set to `null`). *See also* diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/addwitnessaddress.md b/_includes/devdoc/dash-core/rpcs/rpcs/addwitnessaddress.md similarity index 94% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/addwitnessaddress.md rename to _includes/devdoc/dash-core/rpcs/rpcs/addwitnessaddress.md index 072ae18e..21c7d67c 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/addwitnessaddress.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/addwitnessaddress.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/addwitnessaddress.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/addwitnessaddress.md" %} ##### AddWitnessAddress {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/backupwallet.md b/_includes/devdoc/dash-core/rpcs/rpcs/backupwallet.md similarity index 94% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/backupwallet.md rename to _includes/devdoc/dash-core/rpcs/rpcs/backupwallet.md index b29ed3ab..771285ff 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/backupwallet.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/backupwallet.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/backupwallet.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/backupwallet.md" %} ##### BackupWallet {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/bumpfee.md b/_includes/devdoc/dash-core/rpcs/rpcs/bumpfee.md similarity index 97% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/bumpfee.md rename to _includes/devdoc/dash-core/rpcs/rpcs/bumpfee.md index 7f10c7bf..4fbe2fc7 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/bumpfee.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/bumpfee.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/bumpfee.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/bumpfee.md" %} ##### BumpFee {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/clearbanned.md b/_includes/devdoc/dash-core/rpcs/rpcs/clearbanned.md similarity index 78% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/clearbanned.md rename to _includes/devdoc/dash-core/rpcs/rpcs/clearbanned.md index 390d3230..5675c6e0 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/clearbanned.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/clearbanned.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/clearbanned.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/clearbanned.md" %} ##### ClearBanned {% include helpers/subhead-links.md %} @@ -27,15 +27,15 @@ The `clearbanned` RPC {{summary_clearBanned}} {% enditemplate %} -*Example from Bitcoin Core 0.13.1* +*Example from Dash Core 0.12.2* Clears the ban list. {% highlight bash %} -bitcoin-cli clearbanned +dash-cli clearbanned {% endhighlight %} -Result (no output from `bitcoin-cli` because result is set to `null`). +Result (no output from `dash-cli` because result is set to `null`). *See also* diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/createmultisig.md b/_includes/devdoc/dash-core/rpcs/rpcs/createmultisig.md similarity index 97% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/createmultisig.md rename to _includes/devdoc/dash-core/rpcs/rpcs/createmultisig.md index 17096cb8..9dac3cde 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/createmultisig.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/createmultisig.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/createmultisig.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/createmultisig.md" %} ##### CreateMultiSig {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/createrawtransaction.md b/_includes/devdoc/dash-core/rpcs/rpcs/createrawtransaction.md similarity index 77% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/createrawtransaction.md rename to _includes/devdoc/dash-core/rpcs/rpcs/createrawtransaction.md index ae909607..486cab33 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/createrawtransaction.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/createrawtransaction.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/createrawtransaction.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/createrawtransaction.md" %} ##### CreateRawTransaction {% include helpers/subhead-links.md %} @@ -16,7 +16,7 @@ The `createrawtransaction` RPC {{summary_createRawTransaction}} *Parameter #1---Inputs* {% itemplate ntpd1 %} -- n: "Inputs" +- n: "Transactions" t: "array" p: "Required
(exactly 1)" d: "An array of objects, each one to be used as an input to the transaction" @@ -35,11 +35,11 @@ The `createrawtransaction` RPC {{summary_createRawTransaction}} t: "number (int)" p: "Required
(exactly 1)" d: "The output index number (vout) of the outpoint to be spent; the first output in a transaction is index `0`" - + - n: "→ →
`Sequence`" t: "number (int)" p: "Optional
(0 or 1)" - d: "The sequence number to use for the input" + d: "NOT IMPLEMENTED IN DASH.

The sequence number to use for the input" {% enditemplate %} @@ -52,9 +52,9 @@ The `createrawtransaction` RPC {{summary_createRawTransaction}} d: "The addresses and amounts to pay" - n: "→
Address/Amount" - t: "string : number (bitcoins)" + t: "string : number (Dash)" p: "Required
(1 or more)" - d: "A key/value pair with the address to pay as a string (key) and the amount to pay that address (value) in bitcoins" + d: "A key/value pair with the address to pay as a string (key) and the amount to pay that address (value) in Dash" {% enditemplate %} @@ -78,24 +78,27 @@ The `createrawtransaction` RPC {{summary_createRawTransaction}} {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli -testnet createrawtransaction ''' +dash-cli -testnet createrawtransaction ''' [ { - "txid": "1eb590cd06127f78bf38ab4140c4cdce56ad9eb8886999eb898ddf4d3b28a91d", + "txid": "f6c83fd96bfaa47887c4587cceadeb9af6238a2c86fe36b883c4d7a6867eab0f", "vout" : 0 } - ]''' '{ "mgnucj8nYqdrPFh2JfZSB1NmUThUGnmsqe": 0.13 }' + ]''' \ + '{"ySutkc49Khpz1HQN8AfWNitVBLwqtyaxvv": 800, "yY6AmGopsZS31wy1JLHR9P6AC6owFaXwuh":77.78}' '1024' + {% endhighlight %} Result (wrapped): {% highlight text %} -01000000011da9283b4ddf8d89eb996988b89ead56cecdc44041ab38bf787f12\ -06cd90b51e0000000000ffffffff01405dc600000000001976a9140dfc8bafc8\ -419853b34d5e072ad37d1a5159f58488ac00000000 +01000000010fab7e86a6d7c483b836fe862c8a23f69aebadce7c58c48778a4fa6bd93fc8f6\ +0000000000ffffffff0200205fa0120000001976a914485485425fa99504ec1638ac4213f3\ +cfc9f32ef388ac80dc9acf010000001976a914811eacc14db8ebb5b64486dc43400c0226b4\ +28a488ac00040000 {% endhighlight %} *See also* diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/debug.md b/_includes/devdoc/dash-core/rpcs/rpcs/debug.md new file mode 100644 index 00000000..589c5ea0 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/debug.md @@ -0,0 +1,40 @@ +{% 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/debug.md" %} + +##### Debug +{% include helpers/subhead-links.md %} + +{% assign summary_debug="changes the debug category from the console." %} + +{% autocrossref %} + +The `debug` RPC {{summary_debug}} + +*Parameter #1---debug category* + +{% itemplate ntpd1 %} +- n: "Debug category" + t: "string" + p: "Required
(1 or more)" + d: "The debug category to activate. Use a comma to specify multiple categories. Categories will be one of the following:
• `0` - Disables all categories
• `1` - Enables all categories
• `addrman`
• `alert`
• `bench`
• `coindb`
• `db`
• `lock`
• `rand`
• `rpc`
• `selectcoins`
• `mempool`
• `mempoolrej`
• `net`
• `proxy`
• `prune`
• `http`
• `libevent`
• `tor`
• `zmq`
• `dash`
• `privatesend`
• `instantsend`
• `masternode`
• `spork`
• `keepass`
• `mnpayments`
• `gobject`
" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +{% highlight bash %} +dash-cli -testnet debug "net,mempool" +{% endhighlight %} + +Result: + +{% highlight text %} +Debug mode: net,mempool +{% endhighlight %} + +*See also: none* + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/decoderawtransaction.md b/_includes/devdoc/dash-core/rpcs/rpcs/decoderawtransaction.md similarity index 97% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/decoderawtransaction.md rename to _includes/devdoc/dash-core/rpcs/rpcs/decoderawtransaction.md index 0a71ca4b..e359f273 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/decoderawtransaction.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/decoderawtransaction.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/decoderawtransaction.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/decoderawtransaction.md" %} ##### DecodeRawTransaction {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/decodescript.md b/_includes/devdoc/dash-core/rpcs/rpcs/decodescript.md similarity index 97% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/decodescript.md rename to _includes/devdoc/dash-core/rpcs/rpcs/decodescript.md index 158731dc..33b9bd80 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/decodescript.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/decodescript.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/decodescript.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/decodescript.md" %} ##### DecodeScript {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/disconnectnode.md b/_includes/devdoc/dash-core/rpcs/rpcs/disconnectnode.md similarity index 66% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/disconnectnode.md rename to _includes/devdoc/dash-core/rpcs/rpcs/disconnectnode.md index 849f0754..058adcc4 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/disconnectnode.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/disconnectnode.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/disconnectnode.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/disconnectnode.md" %} ##### DisconnectNode {% include helpers/subhead-links.md %} @@ -18,10 +18,10 @@ The `disconnectnode` RPC {{summary_disconnectNode}} *Parameter #1---hostname/IP address and port of node to disconnect* {% itemplate ntpd1 %} -- n: "Address" +- n: "`node`" t: "string" p: "Required
(exactly 1)" - d: "*Updated in Bitcoin Core 0.14.1*

The node you want to disconnect from as a string in the form of `:`. The IP address may be a hostname resolvable through DNS, an IPv4 address, an IPv4-as-IPv6 address, or an IPv6 address" + d: "The node you want to disconnect from as a string in the form of `:`.

*Updated in Bitcoin Core 0.14.1*" {% enditemplate %} @@ -35,15 +35,15 @@ The `disconnectnode` RPC {{summary_disconnectNode}} {% enditemplate %} -*Example from Bitcoin Core 0.14.1* +*Example from Dash Core 0.12.2* Disconnects following node from your node. {% highlight bash %} -bitcoin-cli -testnet disconnectnode 192.0.2.113:18333 +dash-cli -testnet disconnectnode 192.0.2.113:19999 {% endhighlight %} -Result (no output from `bitcoin-cli` because result is set to `null`). +Result (no output from `dash-cli` because result is set to `null`). *See also* diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/dumpprivkey.md b/_includes/devdoc/dash-core/rpcs/rpcs/dumpprivkey.md similarity index 94% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/dumpprivkey.md rename to _includes/devdoc/dash-core/rpcs/rpcs/dumpprivkey.md index a250ac57..f4432348 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/dumpprivkey.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/dumpprivkey.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/dumpprivkey.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/dumpprivkey.md" %} ##### DumpPrivKey {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/dumpwallet.md b/_includes/devdoc/dash-core/rpcs/rpcs/dumpwallet.md similarity index 96% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/dumpwallet.md rename to _includes/devdoc/dash-core/rpcs/rpcs/dumpwallet.md index e5f4f4b3..0050f3b6 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/dumpwallet.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/dumpwallet.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/dumpwallet.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/dumpwallet.md" %} ##### DumpWallet {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/encryptwallet.md b/_includes/devdoc/dash-core/rpcs/rpcs/encryptwallet.md similarity index 95% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/encryptwallet.md rename to _includes/devdoc/dash-core/rpcs/rpcs/encryptwallet.md index 1f72bac7..c3721ac6 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/encryptwallet.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/encryptwallet.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/encryptwallet.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/encryptwallet.md" %} ##### EncryptWallet {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/estimatefee.md b/_includes/devdoc/dash-core/rpcs/rpcs/estimatefee.md similarity index 95% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/estimatefee.md rename to _includes/devdoc/dash-core/rpcs/rpcs/estimatefee.md index bc244d42..209b4133 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/estimatefee.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/estimatefee.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/estimatefee.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/estimatefee.md" %} ##### EstimateFee {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/estimatepriority.md b/_includes/devdoc/dash-core/rpcs/rpcs/estimatepriority.md similarity index 96% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/estimatepriority.md rename to _includes/devdoc/dash-core/rpcs/rpcs/estimatepriority.md index e245666c..183c3987 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/estimatepriority.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/estimatepriority.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/estimatepriority.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/estimatepriority.md" %} ##### EstimatePriority {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/fundrawtransaction.md b/_includes/devdoc/dash-core/rpcs/rpcs/fundrawtransaction.md similarity index 98% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/fundrawtransaction.md rename to _includes/devdoc/dash-core/rpcs/rpcs/fundrawtransaction.md index c3d34d20..b77c7e63 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/fundrawtransaction.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/fundrawtransaction.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/fundrawtransaction.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/fundrawtransaction.md" %} ##### FundRawTransaction {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/generate.md b/_includes/devdoc/dash-core/rpcs/rpcs/generate.md similarity index 59% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/generate.md rename to _includes/devdoc/dash-core/rpcs/rpcs/generate.md index b3b5a6c5..b9291881 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/generate.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/generate.md @@ -2,36 +2,26 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/generate.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/generate.md" %} ##### Generate {% include helpers/subhead-links.md %} -{% assign summary_generate="nearly instantly generates blocks." %} +{% assign summary_generate="mines blocks immediately (before the RPC call returns)." %} {% autocrossref %} -*Requires wallet support.* +*Requires wallet support. Can only be used on the regtest network.* The `generate` RPC {{summary_generate}} *Parameter #1---the number of blocks to generate* {% itemplate ntpd1 %} -- n: "Blocks" +- n: "`numblocks`" 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" - -{% enditemplate %} - -*Parameter #2---the maximum number of iterations to try* - -{% itemplate ntpd1 %} -- n: "Maxtries" - t: "number (int)" - p: "Optional
(0 or 1)" - d: "The maximum number of iterations that are tried to create the requested number of blocks. Default is `1000000`" + d: "The number of blocks to generate. The RPC call will not return until all blocks have been generated." {% enditemplate %} @@ -49,27 +39,29 @@ The `generate` RPC {{summary_generate}} d: "The hashes of the headers of the blocks generated in regtest mode, as hex in RPC byte order" {% enditemplate %} -*Example from Bitcoin Core 0.13.1* +*Example from Dash Core 0.12.2* -Using regtest mode (also works in normal mode), generate 2 blocks: +Using regtest mode, generate 2 blocks: {% highlight bash %} -bitcoin-cli -regtest generate 2 500000 +dash-cli -regtest generate 2 {% endhighlight %} Result: {% highlight json %} [ - "36252b5852a5921bdfca8701f936b39edeb1f8c39fffe73b0d8437921401f9af", - "5f2956817db1e386759aa5794285977c70596b39ea093b9eab0aa4ba8cd50c06" + "55a4c47da8151c0823eec22c41ebc6d690a0288302179625bae9eb6f36808266", + "3f07b9aa4e3bcd5518610945c4a6b32699acac71b1762605ff79ba553111fc79" ] {% endhighlight %} *See also* * [GenerateToAddress][rpc generatetoaddress]: {{summary_generateToAddress}} -* [GetMiningInfo][rpc getmininginfo]: {{summary_getMiningInfo}} * [GetBlockTemplate][rpc getblocktemplate]: {{summary_getBlockTemplate}} +* [GetGenerate][rpc getgenerate]: {{summary_getGenerate}} +* [GetMiningInfo][rpc getmininginfo]: {{summary_getMiningInfo}} +* [SetGenerate][rpc setgenerate]: {{summary_setGenerate}} {% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/generatetoaddress.md b/_includes/devdoc/dash-core/rpcs/rpcs/generatetoaddress.md similarity index 93% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/generatetoaddress.md rename to _includes/devdoc/dash-core/rpcs/rpcs/generatetoaddress.md index 41bec74c..9375c9fb 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/generatetoaddress.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/generatetoaddress.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/generatetoaddress.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/generatetoaddress.md" %} ##### GenerateToAddress {% include helpers/subhead-links.md %} @@ -13,6 +13,9 @@ http://opensource.org/licenses/MIT. *Added in Bitcoin Core 0.13.0* +**_Not implemented in Dash Core (as of 0.12.2)_** + +{% comment %} *Requires wallet support.* The `generatetoaddress` RPC {{summary_generateToAddress}} @@ -24,7 +27,7 @@ The `generatetoaddress` RPC {{summary_generateToAddress}} 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" - + {% enditemplate %} *Parameter #2---a transaction identifier (TXID)* @@ -34,7 +37,7 @@ The `generatetoaddress` RPC {{summary_generateToAddress}} t: "string (base58)" p: "Required
(exactly 1)" d: "The address to send the newly generated Bitcoin to" - + {% enditemplate %} *Parameter #3---the maximum number of iterations to try* @@ -85,4 +88,6 @@ Result: * [GetMiningInfo][rpc getmininginfo]: {{summary_getMiningInfo}} * [GetBlockTemplate][rpc getblocktemplate]: {{summary_getBlockTemplate}} +{% endcomment %} + {% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getaccount.md b/_includes/devdoc/dash-core/rpcs/rpcs/getaccount.md similarity index 93% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getaccount.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getaccount.md index 1dac63be..a45ae01d 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getaccount.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getaccount.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getaccount.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getaccount.md" %} ##### GetAccount {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getaccountaddress.md b/_includes/devdoc/dash-core/rpcs/rpcs/getaccountaddress.md similarity index 95% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getaccountaddress.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getaccountaddress.md index 04bb66a4..b47c8c3a 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getaccountaddress.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getaccountaddress.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getaccountaddress.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getaccountaddress.md" %} ##### GetAccountAddress {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getaddednodeinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getaddednodeinfo.md similarity index 67% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getaddednodeinfo.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getaddednodeinfo.md index 8f472fa3..e6a88341 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getaddednodeinfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getaddednodeinfo.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getaddednodeinfo.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getaddednodeinfo.md" %} ##### GetAddedNodeInfo {% include helpers/subhead-links.md %} @@ -16,17 +16,17 @@ The `getaddednodeinfo` RPC {{summary_getAddedNodeInfo}} *Parameter #1---whether to display connection information* {% itemplate ntpd1 %} -- n: "Details" +- n: "Dummy" t: "bool" p: "Required
(exactly 1)" - d: "*Removed in Bitcoin Core 0.14.0*

Set to `true` to display detailed information about each added node; set to `false` to only display the IP address or hostname and port added" + d: "Kept for historical purposes but ignored

*Removed in Bitcoin Core 0.14.0*" {% enditemplate %} *Parameter #2---what node to display information about* {% itemplate ntpd1 %} -- n: "Node" +- n: "`node`" t: "string" p: "Optional
(0 or 1)" d: "The node to get information about in the same `:` format as the `addnode` RPC. If this parameter is not provided, information about all added nodes will be returned" @@ -41,7 +41,7 @@ The `getaddednodeinfo` RPC {{summary_getAddedNodeInfo}} p: "Required
(exactly 1)" d: "An array containing objects describing each added node. If no added nodes are present, the array will be empty. Nodes added with `onetry` will not be returned" -- n: "→
Added Node" +- n: "→
Added Node" t: "object" p: "Optional
(0 or more)" d: "An object containing details about a single added node" @@ -49,22 +49,22 @@ The `getaddednodeinfo` RPC {{summary_getAddedNodeInfo}} - n: "→ →
`addednode`" t: "string" p: "Required
(exactly 1)" - d: "An added node in the same `:` format as used in the `addnode` RPC. This element is present for any added node whether or not the Details parameter was set to `true`" + d: "An added node in the same `:` format as used in the `addnode` RPC." - n: "→ →
`connected`" t: "bool" p: "Optional
(0 or 1)" - d: "If the Details parameter was set to `true`, this will be set to `true` if the node is currently connected and `false` if it is not" + d: "This will be set to `true` if the node is currently connected and `false` if it is not" - n: "→ →
`addresses`" t: "array" - p: "Optional
(0 or 1)" - d: "If the Details parameter was set to `true`, this will be an array of addresses belonging to the added node" + p: "Requred
(exactly 1)" + d: "This will be an array of addresses belonging to the added node" -- n: "→ → →
Address" +- n: "→ → →
Address" t: "object" p: "Optional
(0 or more)" - d: "An object describing one of this node's addresses" + d: "An object describing one of this node's addresses" - n: "→ → → →
`address`" t: "string" @@ -78,26 +78,26 @@ The `getaddednodeinfo` RPC {{summary_getAddedNodeInfo}} {% enditemplate %} -*Example from Bitcoin Core 0.14.1* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli getaddednodeinfo +dash-cli getaddednodeinfo true {% endhighlight %} -Result (real hostname and IP address replaced): +Result (real hostname and IP address replaced with [RFC5737][] reserved address): {% highlight json %} [ - { - "addednode" : "bitcoind.example.com:8333", - "connected" : true, - "addresses" : [ - { - "address" : "192.0.2.113:8333", - "connected" : "outbound" - } - ] - } + { + "addednode": "192.0.2.113:19999", + "connected": true, + "addresses": [ + { + "address": "192.0.2.113:19999", + "connected": "outbound" + } + ] + } ] {% endhighlight %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getaddressbalance.md b/_includes/devdoc/dash-core/rpcs/rpcs/getaddressbalance.md new file mode 100644 index 00000000..e5d4d479 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getaddressbalance.md @@ -0,0 +1,75 @@ +{% 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/getaddressbalance.md" %} + +##### GetAddressBalance +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +{% assign summary_getAddressBalance="returns the balance for address(es)." %} + +*Requires wallet support and `-addressindex` Dash Core command-line/configuration-file parameter to be enabled.* + +The `getaddressbalance` RPC {{summary_getAddressBalance}} + +*Parameter #1---an array of addresses* + +{% itemplate ntpd1 %} +- n: "`addresses`" + t: "object" + p: "Required
(exactly 1)" + d: "An array of P2PKH or P2SH Dash address(es)" + +- n: "→Address" + t: "string (base58)" + p: "Required
(1 or more)" + d: "The base58check encoded address" + +{% enditemplate %} + +*Result---the current balance in duffs and the total number of duffs received (including change)* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "object" + p: "Required
(exactly 1)" + d: "An object listing the current balance and total amount received (including change), or an error if any address is invalid" + +- n: "→
`balance`" + t: "string" + p: "Required
(exactly 1)" + d: "The current balance in duffs" + +- n: "→
`received`" + t: "string" + p: "Required
(exactly 1)" + d: "The total number of duffs received (including change)" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +Get the balance for an address: + +{% highlight bash %} +dash-cli getaddressbalance '{"addresses": ["yWjoZBvnUKWhpKMbBkVVnnMD8Bzno9j6tQ"]}' +{% endhighlight %} + +Result: + +{% highlight json %} +{ + "balance": 0, + "received": 10000100 +} +{% endhighlight %} + +*See also* + +* [GetBalance][rpc getbalance]: {{summary_getBalance}} +* [GetUnconfirmedBalance][rpc getunconfirmedbalance]: {{summary_getUnconfirmedBalance}} + +{% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getaddressdeltas.md b/_includes/devdoc/dash-core/rpcs/rpcs/getaddressdeltas.md new file mode 100644 index 00000000..ab1b1ee1 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getaddressdeltas.md @@ -0,0 +1,124 @@ +{% 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/getaddressdeltas.md" %} + +##### GetAddressDeltas +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +{% assign summary_getAddressDeltas="returns all changes for an address." %} + +*Requires wallet support and `-addressindex` Dash Core command-line/configuration-file parameter to be enabled.* + +The `getaddressdeltas` RPC {{summary_getAddressDeltas}} + +*Parameter #1---an array of addresses* + +{% itemplate ntpd1 %} +- n: "`addresses`" + t: "object" + p: "Required
(exactly 1)" + d: "An array of P2PKH or P2SH Dash address(es)" + +- n: "→Address" + t: "string (base58)" + p: "Required
(1 or more)" + d: "The base58check encoded address" + +{% enditemplate %} + +*Parameter #2---the start block height* + +{% itemplate ntpd1 %} +- n: "`start`" + t: "number (int)" + p: "Optional
(exactly 1)" + d: "The start block height" + +{% enditemplate %} + +*Parameter #3---the end block height* + +{% itemplate ntpd1 %} +- n: "`end`" + t: "number (int)" + p: "Optional
(exactly 1)" + d: "The end block height" + +{% enditemplate %} + +*Result---information about all changes for the address(es)* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "array" + p: "Required
(exactly 1)" + d: "An array of JSON objects, with each object describing a transaction involving one of the requested addresses" + +- n: "→
Delta" + t: "object" + p: "Required
(1 or more)" + d: "An object describing a particular address delta" + +- n: "→→
`satoshis`" + t: "number" + p: "Required
(exactly 1)" + d: "The difference of duffs" + +- n: "→→
`txid`" + t: "string" + p: "Required
(exactly 1)" + d: "The related txid" + +- n: "→→
`blockindex`" + t: "number" + p: "Required
(exactly 1)" + d: "The related input or output index" + +- n: "→→
`height`" + t: "number" + p: "Required
(exactly 1)" + d: "The block height" + +- n: "→→
`address`" + t: "string" + p: "Required
(exactly 1)" + d: "The base58check encoded address" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +Get the deltas for an address: + +{% highlight bash %} +dash-cli getaddressdeltas '{"addresses": ["yWjoZBvnUKWhpKMbBkVVnnMD8Bzno9j6tQ"], "start":5000, "end":7500}' +{% endhighlight %} + +Result: + +{% highlight json %} +[ + { + "satoshis": 10000100, + "txid": "1fe86e463a9394d4ccd9a5ff1c6b483c95b4350ffdb055b55dc3615111e977de", + "index": 18, + "blockindex": 1, + "height": 6708, + "address": "yWjoZBvnUKWhpKMbBkVVnnMD8Bzno9j6tQ" + }, + { + "satoshis": -10000100, + "txid": "6cb4379eec45cd3bb08b8f4c3a101b8cd89795e24f2cb8288a9941a85fb114cf", + "index": 0, + "blockindex": 1, + "height": 7217, + "address": "yWjoZBvnUKWhpKMbBkVVnnMD8Bzno9j6tQ" + } +] +{% endhighlight %} + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getaddressesbyaccount.md b/_includes/devdoc/dash-core/rpcs/rpcs/getaddressesbyaccount.md similarity index 95% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getaddressesbyaccount.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getaddressesbyaccount.md index 570fd627..40907f63 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getaddressesbyaccount.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getaddressesbyaccount.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getaddressesbyaccount.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getaddressesbyaccount.md" %} ##### GetAddressesByAccount {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getaddressmempool.md b/_includes/devdoc/dash-core/rpcs/rpcs/getaddressmempool.md new file mode 100644 index 00000000..6a1c7206 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getaddressmempool.md @@ -0,0 +1,96 @@ +{% 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/getaddressmempool.md" %} + +##### GetAddressMempool +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +{% assign summary_getAddressMempool="returns all mempool deltas for an address." %} + +*Requires wallet support and `-addressindex` Dash Core command-line/configuration-file parameter to be enabled.* + +The `getaddressmempool` RPC {{summary_getAddressMempool}} + +*Parameter #1---an array of addresses* + +{% itemplate ntpd1 %} +- n: "`addresses`" + t: "object" + p: "Required
(exactly 1)" + d: "An array of P2PKH or P2SH Dash address(es)" + +- n: "→Address" + t: "string (base58)" + p: "Required
(1 or more)" + d: "The base58check encoded address" + +{% enditemplate %} + +*Result---information about mempool deltas for the address(es)* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "array" + p: "Required
(exactly 1)" + d: "An array of JSON objects, with each object describing a transaction involving one of the requested addresses" + +- n: "→Mempool Deltas" + t: "object" + p: "Required
(1 or more)" + d: "An object describing a particular mempool address delta" + +- n: "→→
`address`" + t: "string" + p: "Required
(exactly 1)" + d: "The base58check encoded address" + +- n: "→→
`txid`" + t: "string" + p: "Required
(exactly 1)" + d: "The related txid" + +- n: "→→
`index`" + t: "number" + p: "Required
(exactly 1)" + d: "The related input or output index" + +- n: "→→
`satoshis`" + t: "number" + p: "Required
(exactly 1)" + d: "The difference of duffs" + +- n: "→→
`timestamp`" + t: "string" + p: "Required
(exactly 1)" + d: "The time the transaction entered the mempool (seconds)" + +- n: "→→
`prevtxid`" + t: "string" + p: "Required
(exactly 1)" + d: "The previous txid (if spending)" + +- n: "→→
`prevout`" + t: "string" + p: "Required
(exactly 1)" + d: "The previous transaction output index (if spending)" +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +Get the deltas for an address: + +{% highlight bash %} +dash-cli getaddressmempool '{"addresses": ["yWjoZBvnUKWhpKMbBkVVnnMD8Bzno9j6tQ"]}' +{% endhighlight %} + +Result: + +{% highlight text %} + Example result needed +{% endhighlight %} + +{% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getaddresstxids.md b/_includes/devdoc/dash-core/rpcs/rpcs/getaddresstxids.md new file mode 100644 index 00000000..fb3dc293 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getaddresstxids.md @@ -0,0 +1,85 @@ +{% 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/getaddresstxids.md" %} + +##### GetAddressTxids +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +{% assign summary_getAddressTxids="returns the txids for an address(es)." %} + +*Requires wallet support and `-addressindex` Dash Core command-line/configuration-file parameter to be enabled.* + +The `getaddresstxids` RPC {{summary_getAddressTxids}} + +*Parameter #1---an array of addresses* + +{% itemplate ntpd1 %} +- n: "`addresses`" + t: "object" + p: "Required
(exactly 1)" + d: "An array of P2PKH or P2SH Dash address(es)" + +- n: "→Address" + t: "string (base58)" + p: "Required
(1 or more)" + d: "The base58check encoded address" + +{% enditemplate %} + +*Parameter #2---the start block height* + +{% itemplate ntpd1 %} +- n: "`start`" + t: "number (int)" + p: "Optional
(exactly 1)" + d: "The start block height" + +{% enditemplate %} + +*Parameter #3---the end block height* + +{% itemplate ntpd1 %} +- n: "`end`" + t: "number (int)" + p: "Optional
(exactly 1)" + d: "The end block height" + +{% enditemplate %} + +*Result---information about txids for the address(es)* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "array" + p: "Required
(exactly 1)" + d: "An array of txids related to the requested address(es)" + +- n: "→
TXID" + t: "string" + p: "Required
(1 or more)" + d: "The transaction id" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +Get the deltas for an address: + +{% highlight bash %} +dash-cli getaddresstxids '{"addresses": ["yWjoZBvnUKWhpKMbBkVVnnMD8Bzno9j6tQ"], "start":5000, "end":7500}' +{% endhighlight %} + +Result: + +{% highlight json %} +[ + "1fe86e463a9394d4ccd9a5ff1c6b483c95b4350ffdb055b55dc3615111e977de", + "6cb4379eec45cd3bb08b8f4c3a101b8cd89795e24f2cb8288a9941a85fb114cf" +] +{% endhighlight %} + +{% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getaddressutxos.md b/_includes/devdoc/dash-core/rpcs/rpcs/getaddressutxos.md new file mode 100644 index 00000000..06805a2e --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getaddressutxos.md @@ -0,0 +1,100 @@ +{% 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/getaddressutxos.md" %} + +##### GetAddressUtxos +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +{% assign summary_getAddressUtxos="returns all unspent outputs for an address." %} + +*Requires wallet support and `-addressindex` Dash Core command-line/configuration-file parameter to be enabled.* + +The `getaddressutxos` RPC {{summary_getAddressUtxos}} + +*Parameter #1---an array of addresses* + +{% itemplate ntpd1 %} +- n: "`addresses`" + t: "object" + p: "Required
(exactly 1)" + d: "An array of P2PKH or P2SH Dash address(es)" + +- n: "→Address" + t: "string (base58)" + p: "Required
(1 or more)" + d: "The base58check encoded address" + +{% enditemplate %} + +*Result---information about unspent outputs for the address(es)* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "array" + p: "Required
(exactly 1)" + d: "An array of JSON objects, with each object describing a transaction involving one of the requested addresses" + +- n: "→Unspent outputs" + t: "object" + p: "Required
(1 or more)" + d: "An object describing a particular unspent output for the requested address(es)" + +- n: "→→
`address`" + t: "string" + p: "Required
(exactly 1)" + d: "The base58check encoded address" + +- n: "→→
`txid`" + t: "string" + p: "Required
(exactly 1)" + d: "The output txid" + +- n: "→→
`outputIndex`" + t: "number" + p: "Required
(exactly 1)" + d: "The output index" + +- n: "→→
`script`" + t: "string" + p: "Required
(exactly 1)" + d: "The script hex encoded" + +- n: "→→
`satoshis`" + t: "number" + p: "Required
(exactly 1)" + d: "The number of duffs of the output" + +- n: "→→
`height`" + t: "number" + p: "Required
(exactly 1)" + d: "The block height" +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +Get the unspent outputs for an address: + +{% highlight bash %} +dash-cli getaddressutxos '{"addresses": ["yLeC3F9UxJmFaRaf5yzH7FDc7RdvBasi84"]}' +{% endhighlight %} + +Result: + +{% highlight json %} +[ + { + "address": "yLeC3F9UxJmFaRaf5yzH7FDc7RdvBasi84", + "txid": "ef7bcd083db8c9551ca295698c3b7a6811288fae9944018d2a660a0f939bdb35", + "outputIndex": 0, + "script": "76a914038b8a73338c8f9c22024338198d63ff7c4cb4c088ac", + "satoshis": 1000010000, + "height": 7683 + } +] +{% endhighlight %} + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getbalance.md b/_includes/devdoc/dash-core/rpcs/rpcs/getbalance.md similarity index 95% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getbalance.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getbalance.md index 02d1cc99..85194348 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getbalance.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getbalance.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getbalance.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getbalance.md" %} ##### GetBalance {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getbestblockhash.md b/_includes/devdoc/dash-core/rpcs/rpcs/getbestblockhash.md similarity index 80% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getbestblockhash.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getbestblockhash.md index eff82831..31e82e80 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getbestblockhash.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getbestblockhash.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getbestblockhash.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getbestblockhash.md" %} ##### GetBestBlockHash {% include helpers/subhead-links.md %} @@ -25,16 +25,16 @@ The `getbestblockhash` RPC {{summary_getBestBlockHash}} {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli -testnet getbestblockhash +dash-cli -testnet getbestblockhash {% endhighlight %} Result: {% highlight text %} -0000000000075c58ed39c3e50f99b32183d090aefa0cf8c324a82eea9b01a887 +00000bafbc94add76cb75e2ec92894837288a481e5c005f6563d91623bf8bc2c {% endhighlight %} *See also* diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getblock.md b/_includes/devdoc/dash-core/rpcs/rpcs/getblock.md similarity index 67% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getblock.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getblock.md index baa43b43..2b11232a 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getblock.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getblock.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getblock.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getblock.md" %} ##### GetBlock {% include helpers/subhead-links.md %} @@ -27,9 +27,9 @@ The `getblock` RPC {{summary_getBlock}} {% itemplate ntpd1 %} - n: "Format" - t: "number" - p: "Optional
(0, 1 or 2)" - d: "Set to `0` to get the block in serialized block format; set to `1` (the default) to get the decoded block as a JSON object; set to `2` to get the decoded block as a JSON object with verbose transaction decoding" + t: "boolean" + p: "Optional
(true or false)" + d: "Set to `false` to get the block in serialized block format; set to `true` (the default) to get the decoded block as a JSON object" {% enditemplate %} @@ -66,16 +66,6 @@ The `getblock` RPC {{summary_getBlock}} p: "Required
(exactly 1)" d: "The size of this block in serialized block format, counted in bytes" -- n: "→
`strippedsize`" - t: "number (int)" - p: "Required
(exactly 1)" - d: "*Added in Bitcoin Core 0.13.0*

The size of this block in serialized block format excluding witness data, counted in bytes" - -- n: "→
`weight`" - t: "number (int)" - p: "Required
(exactly 1)" - d: "*Added in Bitcoin Core 0.13.0*

This block's weight as defined in BIP141" - - n: "→
`height`" t: "number (int)" p: "Required
(exactly 1)" @@ -86,11 +76,6 @@ The `getblock` RPC {{summary_getBlock}} p: "Required
(exactly 1)" d: "This block's version number. See [block version numbers][section block versions]" -- n: "→
`versionHex`" - t: "string (hex)" - p: "Required
(exactly 1)" - d: "*Added in Bitcoin Core 0.13.0*

This block's version formatted in hexadecimal" - - n: "→
`merkleroot`" t: "string (hex)" p: "Required
(exactly 1)" @@ -148,60 +133,63 @@ The `getblock` RPC {{summary_getBlock}} {% enditemplate %} -*Example from Bitcoin Core 0.13.1* +*Example from Dash Core 0.12.2* Get a block in raw hex: {% highlight bash %} -bitcoin-cli getblock \ - 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 \ +dash-cli -testnet getblock \ + 0000000037955fcc39af8b1ae75914ffb422313c0fca7eba96a1ac99c2e57f84 \ false {% endhighlight %} Result (wrapped): {% highlight text %} -010000006fe28c0ab6f1b372c1a6a246ae63f74f931e8365e15a089c68d61900\ -00000000982051fd1e4ba744bbbe680e1fee14677ba1a3c3540bf7b1cdb606e8\ -57233e0e61bc6649ffff001d01e3629901010000000100000000000000000000\ -00000000000000000000000000000000000000000000ffffffff0704ffff001d\ -0104ffffffff0100f2052a0100000043410496b538e853519c726a2c91e61ec1\ -1600ae1390813a627c66fb8be7947be63c52da7589379515d4e0a604f8141781\ -e62294721166bf621e73a82cbf2342c858eeac00000000 +0100002011f5719a0a0c4881ff98b4a68c1c828dc3b10f5b51033f5f93d48dbf\ +000000004b8e38f197d6ee878e160d2bae3ce05ab898a6252458ec67ce770140\ +260397c4dd2ed659a1dd001d00636b5601010000000100000000000000000000\ +00000000000000000000000000000000000000000000ffffffff4b02041204dd\ +2ed65908fabe6d6d7445746d63506b62572d2d35584853467a765a6748696972\ +30657a3a6f6d656e010000000000000017fffff9020000000d2f6e6f64655374\ +726174756d2f00000000058028bb13010000001976a914bad55652dffb1af943\ +41015c94feea79793442fd88ac40e553b1020000001976a9142b7856de53d4c1\ +823090c98f8ad79862842c09b588ac4094dd89000000001976a914c2c29ebc78\ +7954ef99d01c5f79115abf7012fb8e88ac4094dd89000000001976a914d7b47d\ +4b40a23c389f5a17754d7f60f511c7d0ec88ac4094dd89000000001976a914dc\ +3e0793134b081145ec0c67a9c72a7b297df27c88ac00000000 {% endhighlight %} Get the same block in JSON: {% highlight bash %} -bitcoin-cli getblock \ - 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 +dash-cli -testnet getblock \ + 0000000037955fcc39af8b1ae75914ffb422313c0fca7eba96a1ac99c2e57f84 {% endhighlight %} Result: {% highlight json %} { - "hash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048", - "confirmations": 447014, - "strippedsize": 215, - "size": 215, - "weight": 860, - "height": 1, - "version": 1, - "versionHex": "00000001", - "merkleroot": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098", - "tx": [ - "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098" - ], - "time": 1231469665, - "mediantime": 1231469665, - "nonce": 2573394689, - "bits": "1d00ffff", - "difficulty": 1, - "chainwork": "0000000000000000000000000000000000000000000000000000000200020002", - "previousblockhash": "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f", - "nextblockhash": "000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd" + "hash": "0000000037955fcc39af8b1ae75914ffb422313c0fca7eba96a1ac99c2e57f84", + "confirmations": 3, + "size": 377, + "height": 4612, + "version": 536870913, + "merkleroot": "c4970326400177ce67ec582425a698b85ae03cae2b0d168e87eed697f1388e4b", + "tx": [ + "c4970326400177ce67ec582425a698b85ae03cae2b0d168e87eed697f1388e4b" + ], + "time": 1507208925, + "mediantime": 1507208645, + "nonce": 1449878272, + "bits": "1d00dda1", + "difficulty": 1.155066358813473, + "chainwork": "000000000000000000000000000000000000000000000000000001c3e86f0f04", + "previousblockhash": "00000000bf8dd4935f3f03515b0fb1c38d821c8ca6b498ff81480c0a9a71f511", + "nextblockhash": "0000000028817c7fce55d802f3647640600535a983d00e16076f284ec6cb001b" } + {% endhighlight %} *See also* diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getblockchaininfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getblockchaininfo.md similarity index 81% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getblockchaininfo.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getblockchaininfo.md index d52e52ad..d22dbb99 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getblockchaininfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getblockchaininfo.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getblockchaininfo.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getblockchaininfo.md" %} ##### GetBlockChainInfo {% include helpers/subhead-links.md %} @@ -52,7 +52,7 @@ The `getblockchaininfo` RPC {{summary_getBlockChainInfo}} t: "number (int)" p: "Required
(exactly 1)" d: "*Added in Bitcoin Core 0.12.0*

The median time of the 11 blocks before the most recent block on the blockchain. Used for validating transaction locktime under BIP113" - + - n: "→
`verificationprogress`" t: "number (real)" p: "Required
(exactly 1)" @@ -67,12 +67,12 @@ The `getblockchaininfo` RPC {{summary_getBlockChainInfo}} t: "bool" p: "Required
(exactly 1)" d: "*Added in Bitcoin Core 0.11.0*

Indicates if the blocks are subject to pruning" - + - n: "→
`pruneheight`" t: "number (int)" p: "Optional
(0 or 1)" - d: "*Added in Bitcoin Core 0.11.0*

The lowest-height complete block stored if prunning is activated" - + d: "*Added in Bitcoin Core 0.11.0*

The lowest-height complete block stored if pruning is activated" + - n: "→
`softforks`" t: "array" p: "Required
(exactly 1)" @@ -82,17 +82,17 @@ The `getblockchaininfo` RPC {{summary_getBlockChainInfo}} t: "object" p: "Required
(3 or more)" d: "A specific softfork" - + - n: "→ → →
`id`" t: "string" p: "Required
(exactly 1)" d: "The name of the softfork" - + - n: "→ → →
`version`" t: "numeric
(int)" p: "Required
(exactly 1)" d: "The block version used for the softfork" - + - n: "→ → →
`enforce`" t: "string : object" p: "Optional
(0 or 1)" @@ -102,12 +102,12 @@ The `getblockchaininfo` RPC {{summary_getBlockChainInfo}} t: "bool" p: "Required
(exactly 1)" d: "Indicates if the threshold was reached" - + - n: "→ → → →
`found`" t: "numeric
(int)" p: "Optional
(0 or 1)" d: "Number of blocks that support the softfork" - + - n: "→ → → →
`required`" t: "numeric
(int)" p: "Optional
(0 or 1)" @@ -127,12 +127,12 @@ The `getblockchaininfo` RPC {{summary_getBlockChainInfo}} t: "bool" p: "Optional
(0 or 1)" d: "Indicates if the threshold was reached" - + - n: "→ → → →
`found`" t: "numeric
(int)" p: "Optional
(0 or 1)" d: "Number of blocks that support the softfork" - + - n: "→ → → →
`required`" t: "numeric
(int)" p: "Optional
(0 or 1)" @@ -142,101 +142,108 @@ The `getblockchaininfo` RPC {{summary_getBlockChainInfo}} t: "numeric
(int)" p: "Optional
(0 or 1)" d: "The maximum size of examined window of recent blocks" - + - n: "→
`bip9_softforks`" t: "object" p: "Required
(exactly 1)" d: "*Added in Bitcoin Core 0.12.1*

The status of BIP9 softforks in progress" - + - n: "→ →
Name" t: "string : object" p: "Required
(2 or more)" d: "A specific BIP9 softfork" - + - n: "→ → →
`status`" t: "string" p: "Required
(exactly 1)" d: "Set to one of the following reasons:
• `defined` if voting hasn't started yet
• `started` if the voting has started
• `locked_in` if the voting was successful but the softfort hasn't been activated yet
• `active` if the softfork was activated
• `failed` if the softfork has not receieved enough votes" - + - n: "→ → →
`bit`" t: "numeric
(int)" 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 Bitcoin Core 0.14.1* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli getblockchaininfo +dash-cli -testnet getblockchaininfo {% endhighlight %} Result: {% highlight json %} { - "chain": "main", - "blocks": 464562, - "headers": 464562, - "bestblockhash": "00000000000000000085bd56990c579a36bade6ea427646612f13476edb30ceb", - "difficulty": 521974519553.6282, - "mediantime": 1493758169, - "verificationprogress": 0.999989733170878, - "chainwork": "00000000000000000000000000000000000000000052c26f32ffa22706efd28c", + "chain": "test", + "blocks": 4622, + "headers": 4622, + "bestblockhash": "000000007f4141e557309da09911b1c3c65b8e9eed3f5e940f7083aec8999ac7", + "difficulty": 1.380236305048335, + "mediantime": 1507209819, + "verificationprogress": 0.9999053826626874, + "chainwork": "000000000000000000000000000000000000000000000000000001d17aeaf58b", "pruned": false, "softforks": [ { "id": "bip34", "version": 2, + "enforce": { + "status": true, + "found": 100, + "required": 51, + "window": 100 + }, "reject": { - "status": true + "status": true, + "found": 100, + "required": 75, + "window": 100 } }, { "id": "bip66", "version": 3, + "enforce": { + "status": true, + "found": 100, + "required": 51, + "window": 100 + }, "reject": { - "status": true + "status": true, + "found": 100, + "required": 75, + "window": 100 } }, { "id": "bip65", "version": 4, + "enforce": { + "status": true, + "found": 100, + "required": 51, + "window": 100 + }, "reject": { - "status": true + "status": true, + "found": 100, + "required": 75, + "window": 100 } } ], - "bip9_softforks": { - "csv": { - "status": "active", - "startTime": 1462060800, - "timeout": 1493596800, - "since": 419328 + "bip9_softforks": [ + { + "id": "csv", + "status": "started" }, - "segwit": { - "status": "started", - "bit": 1, - "startTime": 1479168000, - "timeout": 1510704000, - "since": 439488 + { + "id": "dip0001", + "status": "started" } - } + ] } {% endhighlight %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getblockcount.md b/_includes/devdoc/dash-core/rpcs/rpcs/getblockcount.md similarity index 85% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getblockcount.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getblockcount.md index 586bbf08..86b5043c 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getblockcount.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getblockcount.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getblockcount.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getblockcount.md" %} ##### GetBlockCount {% include helpers/subhead-links.md %} @@ -25,16 +25,16 @@ The `getblockcount` RPC {{summary_getBlockCount}} {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli -testnet getblockcount +dash-cli -testnet getblockcount {% endhighlight %} Result: {% highlight text %} -315280 +4627 {% endhighlight %} *See also* diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getblockhash.md b/_includes/devdoc/dash-core/rpcs/rpcs/getblockhash.md similarity index 84% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getblockhash.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getblockhash.md index 344b0c99..ec2253d4 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getblockhash.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getblockhash.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getblockhash.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getblockhash.md" %} ##### GetBlockHash {% include helpers/subhead-links.md %} @@ -33,16 +33,16 @@ The `getblockhash` RPC {{summary_getBlockHash}} {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli -testnet getblockhash 240886 +dash-cli -testnet getblockhash 4000 {% endhighlight %} Result: {% highlight text %} -00000000a0faf83ab5799354ae9c11da2a2bd6db44058e03c528851dee0a3fff +00000ce22113f3eb8636e225d6a1691e132fdd587aed993e1bc9b07a0235eea4 {% endhighlight %} *See also* diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getblockhashes.md b/_includes/devdoc/dash-core/rpcs/rpcs/getblockhashes.md new file mode 100644 index 00000000..2f732fbc --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getblockhashes.md @@ -0,0 +1,78 @@ +{% 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/getblockhashes.md" %} + +##### GetBlockHashes +{% include helpers/subhead-links.md %} + +{% assign summary_getBlockHashes="returns array of hashes of blocks within the timestamp range provided (requires `timestampindex` to be enabled)." %} + +{% autocrossref %} + +*Added in Dash Core 0.12.1* + +The `getblockhashes` RPC {{summary_getBlockHashes}} + +*Parameter #1---high block timestamp* + +{% itemplate ntpd1 %} +- n: "Block Timestamp" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The block timestamp for the newest block hash that should be returned." + +{% enditemplate %} + +*Parameter #2---low block timestamp* + +{% itemplate ntpd1 %} +- n: "Block Timestamp" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The block timestamp for the oldest block hash that should be returned." + +{% enditemplate %} + +*Result---the block header hashes in the give time range* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "array" + p: "Required
(exactly 1)" + d: "The hashes of the blocks in the requested time range" + +- n: "→
`hash`" + t: "string (hex)" + p: "Required
(1 or more)" + d: "The hash of a block in the chain, encoded as hex in RPC byte order" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +{% highlight bash %} +dash-cli -testnet getblockhashes 1507555793 1507554793 +{% endhighlight %} + +Result: + +{% highlight json %} +[ + "0000000010a16c6fbc6bd5cdc238c2beabcda334e97fde1500d59be4e6fc4b89", + "000000009910885e811230c403e55aac6547d6df04ee671b2e8348524f73cab8", + "000000004bbb3828db1c4d4491760336cec215087819ab656336f30d4095e3d2", + "00000000ad2df2149aca2261a9a87c41e139dfe8f73d91db7ec0c1837fee21a0", + "0000000074068a9e3a271d165da3deb28bc3f8c751dde97f460d8078d92a9d06" +] +{% endhighlight %} + +*See also* + +* [GetBlock][rpc getblock]: {{summary_getBlock}} +* [GetBlockHash][rpc getblockhash]: {{summary_getBlockHash}} +* [GetBestBlockHash][rpc getbestblockhash]: {{summary_getBestBlockHash}} + + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getblockheader.md b/_includes/devdoc/dash-core/rpcs/rpcs/getblockheader.md similarity index 76% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getblockheader.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getblockheader.md index bc3239dd..75b4d0fa 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getblockheader.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getblockheader.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getblockheader.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getblockheader.md" %} ##### GetBlockHeader {% include helpers/subhead-links.md %} @@ -72,17 +72,17 @@ The `getblockheader` RPC {{summary_getBlockHeader}} t: "number (int)" p: "Required
(exactly 1)" d: "This block's version number. See [block version numbers][section block versions]" - -- n: "→
`versionHex`" - t: "number (hex)" - p: "Required
(exactly 1)" - d: "This block's hex version number. See [block version numbers][section block versions]" - n: "→
`merkleroot`" t: "string (hex)" p: "Required
(exactly 1)" d: "The merkle root for this block, encoded as hex in RPC byte order" +- n: "→
`time`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The time of the block" + - n: "→
`mediantime`" t: "number (int)" p: "Required
(exactly 1)" @@ -120,30 +120,41 @@ The `getblockheader` RPC {{summary_getBlockHeader}} {% enditemplate %} -*Example from Bitcoin Core 0.12.1* +*Changes from Bitcoin - Following items not present in Dash result* + +{% itemplate ntpd1 %} + +- n: "→
`versionHex`" + t: "number (hex)" + p: "Required
(exactly 1)" + d: "This block's hex version number. See [block version numbers][section block versions]" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* Get a block header in raw hex: {% highlight bash %} -bitcoin-cli -testnet getblockheader \ - 00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09 \ +dash-cli -testnet getblockheader \ + 00000000eb0af5aec7b673975a22593dc0cc763f71ba8de26292410273437078 \ false {% endhighlight %} Result (wrapped): {% highlight text %} -010000007de867cc8adc5cc8fb6b898ca4462cf9fd667d7830a275277447e608\ -00000000338f121232e169d3100edd82004dc2a1f0e1f030c6c488fa61eafa93\ -0b0528fe021f7449ffff001d36b4af9a +01000020f61396cfd2747e94cfa088fe1f7875d8171accc22d6e5616edca0cb8\ +00000000c31eb96ee1d9e78d61a601371a348c19e4e59698d0ff7869334b72cb\ +7ffb76893b41d6593016011d09b2aa3c {% endhighlight %} Get the same block in JSON: {% highlight bash %} -bitcoin-cli -testnet getblockheader \ - 00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09 +dash-cli -testnet getblockheader \ + 00000000eb0af5aec7b673975a22593dc0cc763f71ba8de26292410273437078 {% endhighlight %} Result: @@ -151,20 +162,19 @@ Result: {% highlight json %} { - "hash": "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09", - "confirmations": 437926, - "height": 1000, - "version": 1, - "versionHex": "00000001", - "merkleroot": "fe28050b93faea61fa88c4c630f0e1f0a1c24d0082dd0e10d369e13212128f33", - "time": 1232346882, - "mediantime": 1232344831, - "nonce": 2595206198, - "bits": "1d00ffff", - "difficulty": 1, - "chainwork": "000000000000000000000000000000000000000000000000000003e903e903e9", - "previousblockhash": "0000000008e647742775a230787d66fdf92c46a48c896bfbc85cdc8acc67e87d", - "nextblockhash": "00000000a2887344f8db859e372e7e4bc26b23b9de340f725afbf2edb265b4c6" + "hash": "00000000eb0af5aec7b673975a22593dc0cc763f71ba8de26292410273437078", + "confirmations": 7, + "height": 4635, + "version": 536870913, + "merkleroot": "8976fb7fcb724b336978ffd09896e5e4198c341a3701a6618de7d9e16eb91ec3", + "time": 1507213627, + "mediantime": 1507213022, + "nonce": 1017819657, + "bits": "1d011630", + "difficulty": 0.920228600314536, + "chainwork": "000000000000000000000000000000000000000000000000000001e06428c09a", + "previousblockhash": "00000000b80ccaed16566e2dc2cc1a17d875781ffe88a0cf947e74d2cf9613f6", + "nextblockhash": "000000003b1aa290db62ae7cfb4dbb67c8e1402a40ef387587f930b8ec3b45db" } {% endhighlight %} @@ -173,6 +183,8 @@ Result: * [GetBlock][rpc getblock]: {{summary_getBlock}} * [GetBlockHash][rpc getblockhash]: {{summary_getBlockHash}} +* [GetBlockHashes][rpc getblockhashes]: {{summary_getBlockHashes}} +* [GetBlockHeaders][rpc getblockheaders]: {{summary_getBlockHeaders}} * [GetBestBlockHash][rpc getbestblockhash]: {{summary_getBestBlockHash}} {% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getblockheaders.md b/_includes/devdoc/dash-core/rpcs/rpcs/getblockheaders.md new file mode 100644 index 00000000..1727d7f5 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getblockheaders.md @@ -0,0 +1,219 @@ +{% 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/getblockheaders.md" %} + +##### GetBlockHeaders +{% include helpers/subhead-links.md %} + +{% assign summary_getBlockHeaders="returns an array of items with information about the requested number of blockheaders starting from the requested hash." %} + +{% autocrossref %} + +*Added in Dash Core 0.12.1* + +The `getblockheaders` RPC {{summary_getBlockHeaders}} + +*Parameter #1---header hash* + +{% itemplate ntpd1 %} +- n: "Header Hash" + t: "string (hex)" + p: "Required
(exactly 1)" + d: "The hash of the block header to get, encoded as hex in RPC byte order" + +{% enditemplate %} + +*Parameter #2---number of headers to return* + +{% itemplate ntpd1 %} +- n: "Count" + t: "number" + p: "Optional
(exactly 1)" + d: "The number of block headers to get" + +{% enditemplate %} + +*Parameter #3---JSON or hex output* + +{% itemplate ntpd1 %} +- n: "Verbose" + t: "bool" + p: "Optional
(0 or 1)" + d: "Set to `false` to get the block headers in serialized block format; set to `true` (the default) to get the decoded block headers as a JSON object" + +{% enditemplate %} + +*Result (if format was `false`)---a serialized block header* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "array" + p: "Required
(exactly 1)" + d: "The requested block header(s) as a serialized block" + +- n: "→
`header`" + t: "string (hex)" + p: "Required
(1 or more)" + d: "The block header encoded as hex in RPC byte order" + +{% enditemplate %} + +*Result (if format was `true` or omitted)---a JSON block header* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "array" + p: "Required
(exactly 1)" + d: "An array of objects each containing a block header, or JSON `null` if an error occurred" + +- n: "→
Block Header" + t: "object/null" + p: "Required
(exactly 1)" + d: "An object containing a block header" + +- n: "→ →
`hash`" + t: "string (hex)" + p: "Required
(exactly 1)" + d: "The hash of this block's block header encoded as hex in RPC byte order. This is the same as the hash provided in parameter #1" + +- n: "→ →
`confirmations`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The number of confirmations the transactions in this block have, starting at 1 when this block is at the tip of the best block chain. This score will be -1 if the the block is not part of the best block chain" + +- n: "→ →
`height`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The height of this block on its block chain" + +- n: "→ →
`version`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "This block's version number. See [block version numbers][section block versions]" + +- n: "→ →
`merkleroot`" + t: "string (hex)" + p: "Required
(exactly 1)" + d: "The merkle root for this block, encoded as hex in RPC byte order" + +- n: "→ →
`time`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The time of the block" + +- n: "→ →
`mediantime`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The computed median time of the previous 11 blocks. Used for validating transaction locktime under BIP113" + +- n: "→ →
`nonce`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The nonce which was successful at turning this particular block into one that could be added to the best block chain" + +- n: "→ →
`bits`" + t: "string (hex)" + p: "Required
(exactly 1)" + d: "The value of the *nBits* field in the block header, indicating the target threshold this block's header had to pass" + +- n: "→ →
`difficulty`" + t: "number (real)" + p: "Required
(exactly 1)" + d: "The estimated amount of work done to find this block relative to the estimated amount of work done to find block 0" + +- n: "→
`chainwork`" + t: "string (hex)" + p: "Required
(exactly 1)" + d: "The estimated number of block header hashes miners had to check from the genesis block to this block, encoded as big-endian hex" + +- n: "→ →
`previousblockhash`" + t: "string (hex)" + p: "Optional
(0 or 1)" + d: "The hash of the header of the previous block, encoded as hex in RPC byte order. Not returned for genesis block" + +- n: "→ →
`nextblockhash`" + t: "string (hex)" + p: "Optional
(0 or 1)" + d: "The hash of the next block on the best block chain, if known, encoded as hex in RPC byte order" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +Get two block headers in raw hex: + +{% highlight bash %} +dash-cli -testnet getblockheaders \ + 0000000010a16c6fbc6bd5cdc238c2beabcda334e97fde1500d59be4e6fc4b89 \ + 2 false +{% endhighlight %} + +Result (wrapped): + +{% highlight text %} +[ + "010000207216dc7b7c898ba3fc0b39d1fd16756b97b1e07e3eb5c64d1510a64b0000000\ + 0bb64e58a0be4276bf3e9c366bba960953ef9e47a8f62342476be56a5dfa7a2670276db\ + 59eae1001d0735577e", + "01000020894bfce6e49bd50015de7fe934a3cdabbec238c2cdd56bbc6f6ca1100000000\ + 0edb2a018d535de70b0622a3303dc329dcb315e7507d074c0c641501c58d88aa08576db\ + 59c5db001d03cf8986" +] +{% endhighlight %} + +Get the same two block headers in JSON: + +{% highlight bash %} +dash-cli -testnet getblockheader \ + 00000000eb0af5aec7b673975a22593dc0cc763f71ba8de26292410273437078 \ + 2 true +{% endhighlight %} + +Result: + +{% highlight json %} +[ + { + "hash": "0000000010a16c6fbc6bd5cdc238c2beabcda334e97fde1500d59be4e6fc4b89", + "confirmations": 20, + "height": 6802, + "version": 536870913, + "merkleroot": "67a2a7dfa556be762434628f7ae4f93e9560a9bb66c3e9f36b27e40b8ae564bb", + "time": 1507554818, + "mediantime": 1507554058, + "nonce": 2119644423, + "bits": "1d00e1ea", + "difficulty": 1.1331569664903, + "chainwork": "0000000000000000000000000000000000000000000000000000092c7b511197", + "previousblockhash": "000000004ba610154dc6b53e7ee0b1976b7516fdd1390bfca38b897c7bdc1672", + "nextblockhash": "000000009910885e811230c403e55aac6547d6df04ee671b2e8348524f73cab8" + }, + { + "hash": "000000009910885e811230c403e55aac6547d6df04ee671b2e8348524f73cab8", + "confirmations": 19, + "height": 6803, + "version": 536870913, + "merkleroot": "a08ad8581c5041c6c074d007755e31cb9d32dc03332a62b070de35d518a0b2ed", + "time": 1507554949, + "mediantime": 1507554181, + "nonce": 2257178371, + "bits": "1d00dbc5", + "difficulty": 1.164838875953147, + "chainwork": "0000000000000000000000000000000000000000000000000000092da5851d38", + "previousblockhash": "0000000010a16c6fbc6bd5cdc238c2beabcda334e97fde1500d59be4e6fc4b89", + "nextblockhash": "000000004bbb3828db1c4d4491760336cec215087819ab656336f30d4095e3d2" + } +] +{% endhighlight %} + +*See also* + +* [GetBlock][rpc getblock]: {{summary_getBlock}} +* [GetBlockHash][rpc getblockhash]: {{summary_getBlockHash}} +* [GetBlockHashes][rpc getblockhashes]: {{summary_getBlockHashes}} +* [GetBlockHeader][rpc getblockheader]: {{summary_getBlockHeader}} +* [GetBestBlockHash][rpc getbestblockhash]: {{summary_getBestBlockHash}} + +{% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getblocktemplate.md b/_includes/devdoc/dash-core/rpcs/rpcs/getblocktemplate.md new file mode 100644 index 00000000..891f25fc --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getblocktemplate.md @@ -0,0 +1,361 @@ +{% 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/getblocktemplate.md" %} + +##### GetBlockTemplate +{% include helpers/subhead-links.md %} + +{% assign summary_getBlockTemplate="gets a block template or proposal for use with mining software." %} + +{% autocrossref %} + +The `getblocktemplate` RPC {{summary_getBlockTemplate}} For more +information, please see the following resources: + +* [Bitcoin Wiki GetBlockTemplate][wiki getblocktemplate] +* [BIP22][] +* [BIP23][] + +*Parameter #1---a JSON request object* + +{% itemplate ntpd1 %} +- n: "Request" + t: "object" + p: "Optional
(exactly 1)" + d: "A JSON request object" + +- n: "→
`mode`" + t: "string" + p: "Optional
(exactly 1)" + d: "This must be set to \"template\" or omitted" + +- n: "→
`capabilities`" + t: "array (string)" + p: "Optional
(0 or more)" + d: "A list of strings" + +- n: "→ →
Capability" + t: "string" + p: "Optional
(exactly 1)" + d: "Client side supported feature, `longpoll`, `coinbasetxn`, `coinbasevalue`, `proposal`, `serverlist`, `workid`" + +{% enditemplate %} + +*Result---block template* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "object" + p: "Required
(exactly 1)" + d: "A object containing a block template" + +- n: "→
`capabilities`" + t: "array (string)" + p: "Required
(1 or more)" + d: "The client side supported features" + +- n: "→ →
Capability" + t: "string" + p: "Optional
(0 or more)" + d: "A client side supported feature" + +- n: "→
`version`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The block version" + +- n: "→
`rules`" + t: "array (string)" + p: "Required
(1 or more)" + d: "The specific block rules that are to be enforced" + +- n: "→ →
Block Rule" + t: "string" + p: "Optional
(0 or more)" + d: "A specific block rule to be enforced" + +- n: "→
`vbavailable`" + t: "object" + p: "Required
(exactly 1)" + d: "Contains the set of pending, supported versionbit (BIP 9) softfork deployments" + +- n: "→ →
Bit Number" + t: "number" + p: "Required
(0 or more)" + d: "The bit number the named softfork rule" + +- n: "→
`vbrequired`" + t: "number" + p: "Required
(exactly 1)" + d: "The bit mask of versionbits the server requires set in submissions" + +- n: "→
`previousblockhash`" + t: "string (hex)" + p: "Required
(exactly 1)" + d: "The hash of current highest block" + +- n: "→
`transactions`" + t: "array (objects)" + p: "Optional
(0 or more)" + d: "Non-coinbase transactions to be included in the next block" + +- n: "→ →
Transaction" + t: "object" + p: "Optional (0 or more)" + d: "Non-coinbase transaction" + +- n: "→ → →
`data`" + t: "string (hex)" + p: "Optional (0 or more)" + d: "Transaction data encoded in hex (byte-for-byte)" + +- n: "→ → →
`hash`" + t: "string (hex)" + p: "Optional (0 or more)" + d: "The hash/id encoded in little-endian hex" + +- n: "→ → →
`depends`" + t: "array (numbers)" + p: "Required
(0 or more)" + d: "An array holding TXIDs of unconfirmed transactions this TX depends upon (parent transactions)." + +- n: "→ → → →
Transaction number" + t: "number" + p: "Optional
(1 or more)" + d: "Transactions before this one (by 1-based index in `transactions` list) that must be present in the final block if this one is" + +- n: "→ → →
`fee`" + t: "number" + p: "Required
(exactly 1)" + d: "The difference in value between transaction inputs and outputs (in duffs). For coinbase transactions, this is a negative number of the total collected block fees (ie., not including the block subsidy); if key is not present, fee is unknown and clients MUST NOT assume there isn't one" + +- n: "→ → →
`sigops`" + t: "number" + p: "Required
(exactly 1)" + d: "Total SigOps. If not present, the count is unknown (clients MUST NOT assume there aren't any)" + +- n: "→ → →
`required`" + t: "boolean" + p: "Optional
(exactly 1)" + d: "If provided and true, this transaction must be in the final block" + +- n: "→
`coinbaseaux`" + t: "object" + p: "Required
(exactly 1)" + d: "A object containing data that should be included in the coinbase scriptSig content" + +- n: "→ →
Flags" + t: "string" + p: "Required
(0 or more)" + d: "" + +- n: "→
`coinbasevalue`" + t: "number" + p: "Required
(exactly 1)" + d: "The maximum allowable input to coinbase transaction, including the generation award and transaction fees (in duffs)" + +- n: "→
`coinbasetxn`" + t: "object" + p: "Required
(exactly 1)" + d: "Information for the coinbase transaction)" + +- n: "→
`target`" + t: "string" + p: "Required
(exactly 1)" + d: "The hash target" + +- n: "→
`mintime`" + t: "number" + p: "Required
(exactly 1)" + d: "The minimum timestamp appropriate for next block time in seconds since epoch" + +- n: "→
`mutable`" + t: "array (string)" + p: "Required
(exactly 1)" + d: "The list of ways the block template may be changed" + +- n: "→ →
Value" + t: "string" + p: "Required
(0 or more)" + d: "A way the block template may be changed, e.g. 'time', 'transactions', 'prevblock'" + +- n: "→
`noncerange`" + t: "string" + p: "Required
(exactly 1)" + d: "A range of valid nonces" + +- n: "→
`sigoplimit`" + t: "number" + p: "Required
(exactly 1)" + d: "The limit of sigops in blocks" + +- n: "→
`sizelimit`" + t: "number" + p: "Required
(exactly 1)" + d: "The limit of block size" + +- n: "→
`curtime`" + t: "number" + p: "Required
(exactly 1)" + d: "The current timestamp in seconds since epoch" + +- n: "→
`bits`" + t: "string" + p: "Required
(exactly 1)" + d: "The compressed target of next block" + +- n: "→
`height`" + t: "number" + p: "Required
(exactly 1)" + d: "The height of the next block" + +- n: "→
`masternode`" + t: "object" + p: "Required
(exactly 1)" + d: "The masternode payee that must be included in the next block" + +- n: "→ →
`payee`" + t: "string" + p: "Required
(exactly 1)" + d: "Payee address" + +- n: "→ →
`script`" + t: "string" + p: "Required
(exactly 1)" + d: "Payee scriptPubKey" + +- n: "→ →
`amount`" + t: "number" + p: "Required
(exactly 1)" + d: "Required amount to pay" + +- n: "→
`masternode_payments_started`" + t: "boolean" + p: "Required
(exactly 1)" + d: "True if masternode payments started" + +- n: "→
`masternode_payments_enforced`" + t: "boolean" + p: "Required
(exactly 1)" + d: "True if masternode payments enforced" + +- n: "→
`superblock`" + t: "array (objects)" + p: "Required
(0 or more)" + d: "The superblock payees that must be included in the next block" + +- n: "→ →
Superblock Payee" + t: "object" + p: "Optional (0 or more)" + d: "Object containing a superblock payee's information" + +- n: "→ → →
`payee`" + t: "string" + p: "Required
(exactly 1)" + d: "Payee address" + +- n: "→ → →
`script`" + t: "string" + p: "Required
(exactly 1)" + d: "Payee scriptPubKey" + +- n: "→ → →
`amount`" + t: "number" + p: "Required
(exactly 1)" + d: "Required amount to pay" + +- n: "→
`superblocks_started`" + t: "boolean" + p: "Required
(exactly 1)" + d: "True if superblock payments started" + +- n: "→
`superblocks_enabled`" + t: "boolean" + p: "Required
(exactly 1)" + d: "True if superblock payments enabled" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +{% highlight bash %} +dash-cli -testnet getblocktemplate +{% endhighlight %} + +Result: + +{% highlight json %} +{ + "capabilities": [ + "proposal" + ], + "version": 536870913, + "rules": [ + "dip0001" + ], + "vbavailable": { + "csv": 0 + }, + "vbrequired": 0, + "previousblockhash": "000000003d5c325259275fbf51a5dd623a13aade887cf83e5fdc3b\ + 11898a71ce", + "transactions": [ + { + "data": "01000000013e9e7e2116d8546a54d8531092d50e2da705a6f229f91a6d129f\ + 3f3e529d2bdb010000006a473044022044569ec727012e06bd4fa853fdcb2d\ + c268f193ca00b68649f3dee0c0ca3207ff02206dc8656025c2f503e58779e6\ + 8a14ed18a7134f2c7d2c4235269bd70a3d6d5bd301210226d4ce54b37c1886\ + 92844201edbfb19e37cdbe7138a133b92b7d3d43ec157da6feffffff02a00b\ + d100000000001976a914d7b47d4b40a23c389f5a17754d7f60f511c7d0ec88\ + ac43321005140000001976a914616fdfd6eae0548f0b0f51bef165974abc10\ + 511688ac1e1f0000", + "hash": "9fd01aafcb4c59741ddfef41da2ec0eb3e1cc5b740150320b29534abdcd67e77", + "depends": [ + ], + "fee": 226, + "sigops": 2 + } + ], + "coinbaseaux": { + "flags": "" + }, + "coinbasevalue": 13230000226, + "longpollid": "000000003d5c325259275fbf51a5dd623a13aade887cf83e5fdc3b11898a\ + 71ce316", + "target": "00000001231e0000000000000000000000000000000000000000000000000000", + "mintime": 1507737402, + "mutable": [ + "time", + "transactions", + "prevblock" + ], + "noncerange": "00000000ffffffff", + "sigoplimit": 40000, + "sizelimit": 2000000, + "curtime": 1507738818, + "bits": "1d01231e", + "height": 7967, + "masternode": { + "payee": "yaJc6tADbEjxQBAC69ugWNoTFpzxqkcgWd", + "script": "76a914996911b133d83de25d1f169c7046d74b728a757b88ac", + "amount": 6615000108 + }, + "masternode_payments_started": true, + "masternode_payments_enforced": true, + "superblock": [ + ], + "superblocks_started": true, + "superblocks_enabled": true +} +{% endhighlight %} + +*See also* + +* [SetGenerate][rpc setgenerate]: {{summary_setGenerate}} +* [GetMiningInfo][rpc getmininginfo]: {{summary_getMiningInfo}} +* [SubmitBlock][rpc submitblock]: {{summary_submitBlock}} +* [PrioritiseTransaction][rpc prioritisetransaction]: {{summary_prioritiseTransaction}} + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getchaintips.md b/_includes/devdoc/dash-core/rpcs/rpcs/getchaintips.md similarity index 76% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getchaintips.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getchaintips.md index 8b822d0d..5da84f0d 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getchaintips.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getchaintips.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getchaintips.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getchaintips.md" %} ##### GetChainTips {% include helpers/subhead-links.md %} @@ -38,6 +38,16 @@ The `getchaintips` RPC {{summary_getChainTips}} p: "Required
(exactly 1)" d: "The hash of the highest block in the chain, encoded as hex in RPC byte order" +- n: "→
`difficulty`" + t: "number (real)" + p: "Required
(exactly 1)" + d: "The difficulty of the highest-height block in the best block chain (Added in Dash Core 0.12.1)" + +- n: "→
`chainwork`" + t: "string (hex)" + p: "Required
(exactly 1)" + d: "The estimated number of block header hashes checked from the genesis block to this block, encoded as big-endian hex (Added in Dash Core 0.12.1)" + - n: "→ →
`branchlen`" t: "number (int)" p: "Required
(exactly 1)" @@ -50,32 +60,22 @@ The `getchaintips` RPC {{summary_getChainTips}} {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli -testnet getchaintips +dash-cli -testnet getchaintips {% endhighlight %} {% highlight json %} [ - { - "height" : 312647, - "hash" : "000000000b1be96f87b31485f62c1361193304a5ad78acf47f9164ea4773a843", - "branchlen" : 0, - "status" : "active" - }, - { - "height" : 282072, - "hash" : "00000000712340a499b185080f94b28c365d8adb9fc95bca541ea5e708f31028", - "branchlen" : 5, - "status" : "valid-fork" - }, - { - "height" : 281721, - "hash" : "000000006e1f2a32199629c6c1fbd37766f5ce7e8c42bab0c6e1ae42b88ffe12", - "branchlen" : 1, - "status" : "valid-headers" - }, + { + "height": 4655, + "hash": "00000000629c276241d9526d85297f2675d6edebcc7fd0c39e8f4263d729b8c1", + "difficulty": 0.9622782802772231, + "chainwork": "000000000000000000000000000000000000000000000000000001f1e286e12a", + "branchlen": 0, + "status": "active" + } ] {% endhighlight %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getconnectioncount.md b/_includes/devdoc/dash-core/rpcs/rpcs/getconnectioncount.md similarity index 85% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getconnectioncount.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getconnectioncount.md index 1dec97c1..fc602bac 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getconnectioncount.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getconnectioncount.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getconnectioncount.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getconnectioncount.md" %} ##### GetConnectionCount {% include helpers/subhead-links.md %} @@ -25,10 +25,10 @@ The `getconnectioncount` RPC {{summary_getConnectionCount}} {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli -testnet getconnectioncount +dash-cli -testnet getconnectioncount {% endhighlight bash %} Result: diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getdifficulty.md b/_includes/devdoc/dash-core/rpcs/rpcs/getdifficulty.md similarity index 76% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getdifficulty.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getdifficulty.md index 5659b4d9..e09b46b6 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getdifficulty.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getdifficulty.md @@ -2,12 +2,12 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getdifficulty.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getdifficulty.md" %} ##### GetDifficulty {% include helpers/subhead-links.md %} -{% assign summary_getDifficultly="returns the proof-of-work difficulty as a multiple of the minimum difficulty." %} +{% assign summary_getDifficulty="returns the proof-of-work difficulty as a multiple of the minimum difficulty." %} {% autocrossref %} @@ -25,16 +25,16 @@ The `getdifficulty` RPC {{summary_getDifficulty}} {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli -testnet getdifficulty +dash-cli -testnet getdifficulty {% endhighlight %} Result: {% highlight text %} -1.00000000 +1.069156225528583 {% endhighlight %} *See also* diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getgenerate.md b/_includes/devdoc/dash-core/rpcs/rpcs/getgenerate.md new file mode 100644 index 00000000..7692a574 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getgenerate.md @@ -0,0 +1,51 @@ +{% 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/getgenerate.md" %} + +##### GetGenerate +{% include helpers/subhead-links.md %} + +{% assign summary_getGenerate="returns if the server is set to generate coins or not." %} + +{% autocrossref %} + +*Requires wallet support.* + +*Removed in Bitcoin Core 0.13.0.* + +The `getgenerate` RPC {{summary_getGenerate}} + +*Parameters: none* + +*Result---whether the server is set to generate blocks* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "bool" + p: "Required
(exactly 1)" + d: "Set to `true` if the server is set to generate blocks; set to `false` if it is not" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +{% highlight bash %} +dash-cli -regtest getgenerate +{% endhighlight %} + +Result: + +{% highlight json %} +false +{% endhighlight %} + +*See also* + +* [Generate][rpc generate]: {{summary_generate}} +* [GenerateToAddress][rpc generatetoaddress]: {{summary_generateToAddress}} +* [GetMiningInfo][rpc getmininginfo]: {{summary_getMiningInfo}} +* [SetGenerate][rpc setgenerate]: {{summary_setGenerate}} + +{% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getgovernanceinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getgovernanceinfo.md new file mode 100644 index 00000000..576e2ece --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getgovernanceinfo.md @@ -0,0 +1,80 @@ +{% 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/getgovernanceinfo.md" %} + +##### GetGovernanceInfo +{% include helpers/subhead-links.md %} + +{% assign summary_getGovernanceInfo="returns an object containing governance parameters." %} + +{% autocrossref %} + +The `getgovernanceinfo` RPC {{summary_getGovernanceInfo}} + +*Parameters: none* + +*Result---information about the governance system* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "object" + p: "Required
(exactly 1)" + d: "Information about the governance system" + +- n: "→
`governanceminquorum`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The absolute minimum number of votes needed to trigger a governance action" + +- n: "→
`masternodewatchdogmaxseconds`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "Sentinel watchdog expiration time in seconds" + +- n: "→
`proposalfee`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The collateral transaction fee which must be paid to create a proposal in Dash" + +- n: "→
`superblockcycle`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The number of blocks between superblocks" + +- n: "→
`lastsuperblock`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The block number of the last superblock" + +- n: "→
`nextsuperblock`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The block number of the next superblock" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +{% highlight bash %} +dash-cli -testnet getgovernanceinfo +{% endhighlight %} + +Result: +{% highlight json %} +{ + "governanceminquorum": 1, + "masternodewatchdogmaxseconds": 7200, + "proposalfee": 5.00000000, + "superblockcycle": 24, + "lastsuperblock": 7368, + "nextsuperblock": 7392 +} +{% endhighlight %} + +*See also:* + +* [GObject][rpc gobject]: {{summary_gObject}} + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/gethashespersec.md b/_includes/devdoc/dash-core/rpcs/rpcs/gethashespersec.md similarity index 87% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/gethashespersec.md rename to _includes/devdoc/dash-core/rpcs/rpcs/gethashespersec.md index 370cc742..f632cf0c 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/gethashespersec.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/gethashespersec.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/gethashespersec.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/gethashespersec.md" %} ##### GetHashesPerSec {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getinfo.md similarity index 78% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getinfo.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getinfo.md index 1ad97aad..3612c887 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getinfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getinfo.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getinfo.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getinfo.md" %} ##### GetInfo {% include helpers/subhead-links.md %} @@ -13,7 +13,7 @@ http://opensource.org/licenses/MIT. The `getinfo` RPC {{summary_getInfo}} -{{WARNING}} `getinfo` will be removed in a later version of Bitcoin +{{WARNING}} `getinfo` will be removed in a later version of Dash Core. Use the RPCs listed in the See Also subsection below instead. *Parameters: none* @@ -29,7 +29,7 @@ Core. Use the RPCs listed in the See Also subsection below instead. - n: "→
`version`" t: "number (int)" p: "Required
(exactly 1)" - d: "This node's version of Bitcoin Core in its internal integer format. For example, Bitcoin Core 0.9.2 has the integer version number 90200" + d: "This node's version of Bitcoin Core in its internal integer format. For example, Dash Core 0.12.2 has the integer version number 120200" - n: "→
`protocolversion`" t: "number (int)" @@ -42,9 +42,14 @@ Core. Use the RPCs listed in the See Also subsection below instead. d: "The version number of the wallet. Only returned if wallet support is enabled" - n: "→
`balance`" - t: "number (bitcoins)" + t: "number (duffs)" p: "Optional
(0 or 1)" - d: "The balance of the wallet in bitcoins. Only returned if wallet support is enabled" + d: "The total balance of the wallet in duffs. Only returned if wallet support is enabled" + +- n: "→
`privatesend_balance`" + t: "number (duffs)" + p: "Optional
(0 or 1)" + d: "The PrivateSend balance of the wallet in duffs. Only returned if wallet support is enabled (Added in Dash Core 0.11.0)" - n: "→
`blocks`" t: "number (int)" @@ -86,21 +91,21 @@ Core. Use the RPCs listed in the See Also subsection below instead. p: "Optional
(0 or 1)" d: "The number of keys in the wallet keypool. Only returned if wallet support is enabled" -- n: "→
`paytxfee`" - t: "number (bitcoins)" - p: "Optional
(0 or 1)" - d: "The minimum fee to pay per kilobyte of transaction; may be `0`. Only returned if wallet suuport is enabled" - -- n: "→
`relayfee`" - t: "number (bitcoins)" - p: "Required
(exactly 1)" - d: "The minimum fee a low-priority transaction must pay in order for this node to accept it into its memory pool" - - n: "→
`unlocked_until`" t: "number (int)" p: "Optional
(0 or 1)" d: "The Unix epoch time when the wallet will automatically re-lock. Only displayed if wallet encryption is enabled. Set to `0` if wallet is currently locked" +- n: "→
`paytxfee`" + t: "number (duffs)" + p: "Optional
(0 or 1)" + d: "The minimum fee to pay per kilobyte of transaction; may be `0`. Only returned if wallet support is enabled" + +- n: "→
`relayfee`" + t: "number (duffs)" + p: "Required
(exactly 1)" + d: "The minimum fee a low-priority transaction must pay in order for this node to accept it into its memory pool" + - n: "→
`errors`" t: "string" p: "Required
(exactly 1)" @@ -108,31 +113,33 @@ Core. Use the RPCs listed in the See Also subsection below instead. {% enditemplate %} -*Example from Bitcoin Core 0.10.0 with wallet support enabled* +*Example from Dash Core 0.12.2 with wallet support enabled* {% highlight bash %} -bitcoin-cli -testnet getinfo +dash-cli -testnet getinfo {% endhighlight %} Result: {% highlight json %} { - "version" : 100000, - "protocolversion" : 70002, - "walletversion" : 60000, - "balance" : 1.27007770, - "blocks" : 315281, - "timeoffset" : 0, - "connections" : 9, - "proxy" : "", - "difficulty" : 1.00000000, - "testnet" : true, - "keypoololdest" : 1418924649, - "keypoolsize" : 101, - "paytxfee" : 0.00000000, - "relayfee" : 0.00001000, - "errors" : "" + "version": 120200, + "protocolversion": 70208, + "walletversion": 61000, + "balance": 0.00000000, + "privatesend_balance": 0.00000000, + "blocks": 0, + "timeoffset": 0, + "connections": 0, + "proxy": "", + "difficulty": 0.000244140625, + "testnet": true, + "keypoololdest": 1507579068, + "keypoolsize": 617, + "unlocked_until": 0, + "paytxfee": 0.00000000, + "relayfee": 0.00010000, + "errors": "" } {% endhighlight %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getmemoryinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getmemoryinfo.md similarity index 95% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getmemoryinfo.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getmemoryinfo.md index e31a13d3..9adbfc93 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getmemoryinfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getmemoryinfo.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getmemoryinfo.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getmemoryinfo.md" %} ##### GetMemoryInfo {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getmempoolancestors.md b/_includes/devdoc/dash-core/rpcs/rpcs/getmempoolancestors.md similarity index 97% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getmempoolancestors.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getmempoolancestors.md index 2b8c5af2..2a4fd641 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getmempoolancestors.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getmempoolancestors.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getmempoolancestors.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getmempoolancestors.md" %} ##### GetMemPoolAncestors {% include helpers/subhead-links.md %} @@ -13,6 +13,9 @@ http://opensource.org/licenses/MIT. *Added in Bitcoin Core 0.13.0* +**_Not implemented in Dash Core (as of 0.12.2)_** + +{% comment %} The `getmempoolancestors` RPC {{summary_getMemPoolAncestors}} *Parameter #1---a transaction identifier (TXID)* @@ -72,7 +75,7 @@ The `getmempoolancestors` RPC {{summary_getMemPoolAncestors}} t: "number (bitcoins)" p: "Required
(exactly 1)" d: "The transaction fee paid by the transaction in decimal bitcoins" - + - n: "→ →
`modifiedfee`" t: "number (bitcoins)" p: "Required
(exactly 1)" @@ -211,4 +214,6 @@ Result: * [GetMemPoolDescendants][rpc getmempooldescendants]: {{summary_getMemPoolDescendants}} * [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}} +{% endcomment %} + {% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getmempooldescendants.md b/_includes/devdoc/dash-core/rpcs/rpcs/getmempooldescendants.md similarity index 97% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getmempooldescendants.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getmempooldescendants.md index 3cc2eeeb..d430b6e0 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getmempooldescendants.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getmempooldescendants.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getmempooldescendants.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getmempooldescendants.md" %} ##### GetMemPoolDescendants {% include helpers/subhead-links.md %} @@ -13,6 +13,10 @@ http://opensource.org/licenses/MIT. *Added in Bitcoin Core 0.13.0* +**_Not implemented in Dash Core (as of 0.12.2)_** + +{% comment %} + The `getmempooldescendants` RPC {{summary_getMemPoolDescendants}} *Parameter #1---a transaction identifier (TXID)* @@ -72,7 +76,7 @@ The `getmempooldescendants` RPC {{summary_getMemPoolDescendants}} t: "number (bitcoins)" p: "Required
(exactly 1)" d: "The transaction fee paid by the transaction in decimal bitcoins" - + - n: "→ →
`modifiedfee`" t: "number (bitcoins)" p: "Required
(exactly 1)" @@ -211,4 +215,6 @@ Result: * [GetMemPoolAncestors][rpc getmempoolancestors]: {{summary_getMemPoolAncestors}} * [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}} +{% endcomment %} + {% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getmempoolentry.md b/_includes/devdoc/dash-core/rpcs/rpcs/getmempoolentry.md similarity index 95% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getmempoolentry.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getmempoolentry.md index a159280e..b62b7679 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getmempoolentry.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getmempoolentry.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getmempoolentry.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getmempoolentry.md" %} ##### GetMemPoolEntry {% include helpers/subhead-links.md %} @@ -13,6 +13,10 @@ http://opensource.org/licenses/MIT. *Added in Bitcoin Core 0.13.0* +**_Not implemented in Dash Core (as of 0.12.2)_** + +{% comment %} + The `getmempoolentry` RPC {{summary_getMemPoolEntry}} *Parameter #1---a transaction identifier (TXID)* @@ -42,7 +46,7 @@ The `getmempoolentry` RPC {{summary_getMemPoolEntry}} t: "number (bitcoins)" p: "Required
(exactly 1)" d: "The transaction fee paid by the transaction in decimal bitcoins" - + - n: "→
`modifiedfee`" t: "number (bitcoins)" p: "Required
(exactly 1)" @@ -145,4 +149,6 @@ Result: * [GetMemPoolDescendants][rpc getmempooldescendants]: {{summary_getMemPoolDescendants}} * [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}} -{% endautocrossref %} \ No newline at end of file +{% endcomment %} + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getmempoolinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getmempoolinfo.md similarity index 89% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getmempoolinfo.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getmempoolinfo.md index 165a9ae1..85d3e997 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getmempoolinfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getmempoolinfo.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getmempoolinfo.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getmempoolinfo.md" %} ##### GetMemPoolInfo {% include helpers/subhead-links.md %} @@ -50,19 +50,19 @@ The `getmempoolinfo` RPC {{summary_getMemPoolInfo}} {% enditemplate %} -*Example from Bitcoin Core 0.14.1* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli -testnet getmempoolinfo +dash-cli -testnet getmempoolinfo {% endhighlight %} Result: {% highlight json %} { - "size": 1237, - "bytes": 591126, - "usage": 1900416, + "size": 1, + "bytes": 3471, + "usage": 8544, "maxmempool": 300000000, "mempoolminfee": 0.00000000 } diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getmininginfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getmininginfo.md similarity index 68% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getmininginfo.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getmininginfo.md index 8394aceb..db82c6cd 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getmininginfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getmininginfo.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getmininginfo.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getmininginfo.md" %} ##### GetMiningInfo {% include helpers/subhead-links.md %} @@ -51,7 +51,7 @@ The `getmininginfo` RPC {{summary_getMiningInfo}} - n: "→
`genproclimit`" t: "number (int)" p: "Required
(exactly 1)" - d: "*Removed in Bitcoin Core 0.13.0*

The limit on the number of processors to use for generation. If generation was enabled since the last time this node was restarted, this is the number used in the second parameter of the `setgenerate` RPC (or the default). Otherwise, it is `-1`" + d: "The processor limit for generation (-1 if no generation - see getgenerate or setgenerate calls).

*Removed in Bitcoin Core 0.13.0*" - n: "→
`networkhashps`" t: "number (int)" @@ -66,7 +66,7 @@ The `getmininginfo` RPC {{summary_getMiningInfo}} - n: "→
`testnet`" t: "bool" p: "Required
(exactly 1)" - d: "*Removed in Bitcoin Core 0.14.0*

Set to `true` if this node is running on testnet. Set to `false` if this node is on mainnet or a regtest" + d: "Set to `true` if this node is running on testnet. Set to `false` if this node is on mainnet or a regtest

*Removed in Bitcoin Core 0.14.0*" - n: "→
`chain`" t: "string" @@ -76,34 +76,31 @@ The `getmininginfo` RPC {{summary_getMiningInfo}} - n: "→
`generate`" t: "bool" p: "Optional
(0 or 1)" - d: "*Removed in Bitcoin Core 0.13.0*

Set to `true` if generation is currently enabled; set to `false` if generation is currently disabled. Only returned if the node has wallet support enabled" - -- n: "→
`hashespersec`" - t: "number (int)" - p: "Optional
(0 or 1)" - d: "*Removed in Bitcoin Core 0.11.0*

The approximate number of hashes per second this node is generating across all CPUs, if generation is enabled. Otherwise `0`. Only returned if the node has wallet support enabled" + d: "Set to `true` if generation is currently enabled; set to `false` if generation is currently disabled. Only returned if the node has wallet support enabled

*Removed in Bitcoin Core 0.13.0*" {% enditemplate %} -*Example from Bitcoin Core 0.14.1* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli getmininginfo +dash-cli getmininginfo {% endhighlight %} Result: {% highlight json %} { - "blocks": 464545, - "currentblocksize": 0, - "currentblockweight": 0, - "currentblocktx": 0, - "difficulty": 521974519553.6282, - "errors": "", - "networkhashps": 4.126888339085874e+18, - "pooledtx": 31241, - "chain": "main" + "blocks": 8036, + "currentblocksize": 0, + "currentblocktx": 0, + "difficulty": 0.8239043524175907, + "errors": "", + "genproclimit": 1, + "networkhashps": 22234635.4469006, + "pooledtx": 3, + "testnet": true, + "chain": "test", + "generate": false } {% endhighlight %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getnettotals.md b/_includes/devdoc/dash-core/rpcs/rpcs/getnettotals.md similarity index 78% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getnettotals.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getnettotals.md index 295b7fab..ed3f2615 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getnettotals.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getnettotals.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getnettotals.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getnettotals.md" %} ##### GetNetTotals {% include helpers/subhead-links.md %} @@ -37,57 +37,57 @@ The `getnettotals` RPC {{summary_getNetTotals}} t: "number (int)" p: "Required
(exactly 1)" d: "Unix epoch time in milliseconds according to the operating system's clock (not the node adjusted time)" - + - n: "→
`uploadtarget`" t: "string :
object" p: "Required
(exactly 1)" d: "The upload traget information" - + - n: "→ →
`timeframe`" t: "number (int)" p: "Required
(exactly 1)" - d: "Length of the measuring timeframe in seconds. The timeframe is currently set to `24` hours" + d: "Length of the measuring timeframe in seconds (currently set to `24` hours)" - n: "→ →
`target`" t: "number (int)" p: "Required
(exactly 1)" - d: "The maximum allowed outbound traffic in bytes. The default is `0`. Can be changed with `-maxuploadtarget`" + d: "The maximum allowed outbound traffic in bytes (default is `0`). Can be changed with `-maxuploadtarget`" - n: "→ →
`target_reached`" t: "bool" p: "Required
(exactly 1)" - d: "Indicates if the target is reached. If the target is reached the node won't serve SPV and historical block requests anymore" + d: "Indicates if the target is reached. If the target is reached the node won't serve SPV and historical block requests anymore" - n: "→ →
`serve_historical_blocks`" t: "bool" p: "Required
(exactly 1)" d: "Indicates if historical blocks are served" - + - n: "→ →
`bytes_left_in_cycle`" t: "number (int)" p: "Required
(exactly 1)" - d: "Amount of bytes left in current time cycle. `0` is displayed if no upload target is set" + d: "Amount of bytes left in current time cycle. `0` is displayed if no upload target is set" - n: "→ →
`time_left_in_cycle`" t: "number (int)" p: "Required
(exactly 1)" - d: "Seconds left in current time cycle. `0` is displayed if no upload target is set" + d: "Seconds left in current time cycle. `0` is displayed if no upload target is set" {% enditemplate %} -*Example from Bitcoin Core 0.13.1* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli getnettotals +dash-cli getnettotals {% endhighlight %} Result: {% highlight json %} { - "totalbytesrecv": 7137052851, - "totalbytessent": 211648636140, - "timemillis": 1481227418585, + "totalbytesrecv": 4661588, + "totalbytessent": 2899423, + "timemillis": 1507815162756, "uploadtarget": { "timeframe": 86400, "target": 0, diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getnetworkhashps.md b/_includes/devdoc/dash-core/rpcs/rpcs/getnetworkhashps.md similarity index 78% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getnetworkhashps.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getnetworkhashps.md index 480e9f99..3b6ce87c 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getnetworkhashps.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getnetworkhashps.md @@ -2,12 +2,12 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getnetworkhashps.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getnetworkhashps.md" %} ##### GetNetworkHashPS {% include helpers/subhead-links.md %} -{% assign summary_getNetworkHashPS="returns the estimated current or historical network hashes per second based on the last *n* blocks." %} +{% assign summary_getNetworkHashPS="returns the estimated network hashes per second based on the last n blocks." %} {% autocrossref %} @@ -16,7 +16,7 @@ The `getnetworkhashps` RPC {{summary_getNetworkHashPS}} *Parameter #1---number of blocks to average* {% itemplate ntpd1 %} -- n: "Blocks" +- n: "`blocks`" t: "number (int)" p: "Optional
(0 or 1)" d: "The number of blocks to average together for calculating the estimated hashes per second. Default is `120`. Use `-1` to average all blocks produced since the last difficulty change" @@ -26,7 +26,7 @@ The `getnetworkhashps` RPC {{summary_getNetworkHashPS}} *Parameter #2---block height* {% itemplate ntpd1 %} -- n: "Height" +- n: "`height`" t: "number (int)" p: "Optional
(0 or 1)" d: "The height of the last block to use for calculating the average. Defaults to `-1` for the highest-height block on the local best block chain. If the specified height is higher than the highest block on the local best block chain, it will be interpreted the same as `-1`" @@ -43,24 +43,24 @@ The `getnetworkhashps` RPC {{summary_getNetworkHashPS}} {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* Get the average hashes per second for all the blocks since the last -difficulty change before block 227255. +difficulty change before block 6000. {% highlight bash %} -bitcoin-cli -testnet getnetworkhashps -1 227255 +dash-cli -testnet getnetworkhashps -1 6000 {% endhighlight %} Result: {% highlight json %} -79510076167 +22214011.90821117 {% endhighlight %} *See also* -* [GetDifficulty][rpc getdifficulty]: {{summary_getDifficultly}} +* [GetDifficulty][rpc getdifficulty]: {{summary_getDifficulty}} * [GetBlock][rpc getblock]: {{summary_getBlock}} {% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getnetworkinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getnetworkinfo.md similarity index 70% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getnetworkinfo.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getnetworkinfo.md index 3dbbf385..e905e6e2 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getnetworkinfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getnetworkinfo.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getnetworkinfo.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getnetworkinfo.md" %} ##### GetNetworkInfo {% include helpers/subhead-links.md %} @@ -26,7 +26,7 @@ The `getnetworkinfo` RPC {{summary_getNetworkInfo}} - n: "→
`version`" t: "number" p: "Required
(exactly 1)" - d: "This node's version of Bitcoin Core in its internal integer format. For example, Bitcoin Core 0.9.2 has the integer version number 90200" + d: "This node's version of Dash Core in its internal integer format. For example, Dash Core 0.12.2 has the integer version number 120200" - n: "→
`subversion`" t: "string" @@ -37,12 +37,12 @@ The `getnetworkinfo` RPC {{summary_getNetworkInfo}} t: "number (int)" p: "Required
(exactly 1)" d: "The protocol version number used by this node. See the [protocol versions section][section protocol versions] for more information" - + - n: "→
`localservices`" t: "string (hex)" p: "Required
(exactly 1)" d: "The services supported by this node as advertised in its `version` message" - + - n: "→
`localrelay`" t: "bool" p: "Required
(exactly 1)" @@ -63,55 +63,55 @@ The `getnetworkinfo` RPC {{summary_getNetworkInfo}} p: "Required
(exactly 1)" d: "An array with three objects: one describing the IPv4 connection, one describing the IPv6 connection, and one describing the Tor hidden service (onion) connection" -- n: "→ →
Network" +- n: "→ →
Network" t: "object" p: "Optional
(0 to 3)" - d: "An object describing a network. If the network is unroutable, it will not be returned" + d: "An object describing a network. If the network is unroutable, it will not be returned" - n: "→ → →
`name`" t: "string" p: "Required
(exactly 1)" - d: "The name of the network. Either `ipv4`, `ipv6`, or `onion`" + d: "The name of the network. Either `ipv4`, `ipv6`, or `onion`" - n: "→ → →
`limited`" t: "bool" p: "Required
(exactly 1)" - d: "Set to `true` if only connections to this network are allowed according to the `-onlynet` Bitcoin Core command-line/configuration-file parameter. Otherwise set to `false`" + d: "Set to `true` if only connections to this network are allowed according to the `-onlynet` Dash Core command-line/configuration-file parameter. Otherwise set to `false`" - n: "→ → →
`reachable`" t: "bool" p: "Required
(exactly 1)" - d: "Set to `true` if connections can be made to or from this network. Otherwise set to `false`" + d: "Set to `true` if connections can be made to or from this network. Otherwise set to `false`" - n: "→ → →
`proxy`" t: "string" p: "Required
(exactly 1)" - d: "The hostname and port of any proxy being used for this network. If a proxy is not in use, an empty string" - + d: "The hostname and port of any proxy being used for this network. If a proxy is not in use, an empty string" + - n: "→ → →
`proxy_randomize_credentials`" t: "bool" p: "Required
(exactly 1)" 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 (bitcoins)" + t: "number (Dash)" p: "Required
(exactly 1)" - d: "The minimum fee a low-priority transaction must pay in order for this node to accept it into its memory pool" + d: "The minimum relay fee for non-free transactions in order for this node to accept it into its memory pool" - n: "→
`localaddresses`" t: "array" p: "Required
(exactly 1)" - d: "An array of objects each describing the local addresses this node believes it listens on" + d: "An array of objects each describing the local addresses this node believes it listens on" -- n: "→ →
Address" +- n: "→ →
Address" t: "object" p: "Optional
(0 or more)" - d: "An object describing a particular address this node believes it listens on" + d: "An object describing a particular address this node believes it listens on" - n: "→ → →
`address`" t: "string" p: "Required
(exactly 1)" - d: "An IP address or .onion address this node believes it listens on. This may be manually configured, auto detected, or based on `version` messages this node received from its peers" + d: "An IP address or .onion address this node believes it listens on. This may be manually configured, auto detected, or based on `version` messages this node received from its peers" - n: "→ → →
`port`" t: "number (int)" @@ -121,8 +121,8 @@ The `getnetworkinfo` RPC {{summary_getNetworkInfo}} - n: "→ → →
`score`" t: "number (int)" p: "Required
(exactly 1)" - d: "The number of incoming connections during the uptime of this node that have used this address in their `version` message" - + d: "The number of incoming connections during the uptime of this node that have used this `address` in their `version` message" + - n: "→
`warnings`" t: "string" p: "Required
(exactly 1)" @@ -130,23 +130,24 @@ The `getnetworkinfo` RPC {{summary_getNetworkInfo}} {% enditemplate %} -*Example from Bitcoin Core 0.13.1* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli getnetworkinfo +dash-cli getnetworkinfo {% endhighlight %} -Result (actual addresses have been replaced with reserved addresses): +Result (actual addresses have been replaced with [RFC5737][] reserved addresses): {% highlight json %} { - "version": 130100, - "subversion": "/Satoshi:0.13.1/", - "protocolversion": 70014, - "localservices": "000000000000000d", + "version": 120200, + "subversion": "/Dash Core:0.12.2/", + "protocolversion": 70208, + "localservices": "0000000000000005", "localrelay": true, - "timeoffset": -19, - "connections": 8, + "timeoffset": 0, + "networkactive": true, + "connections": 9, "networks": [ { "name": "ipv4", @@ -154,14 +155,14 @@ Result (actual addresses have been replaced with reserved addresses): "reachable": true, "proxy": "", "proxy_randomize_credentials": false - }, + }, { "name": "ipv6", "limited": false, "reachable": true, "proxy": "", "proxy_randomize_credentials": false - }, + }, { "name": "onion", "limited": true, @@ -170,16 +171,17 @@ Result (actual addresses have been replaced with reserved addresses): "proxy_randomize_credentials": false } ], - "relayfee": 5000.00000000, + "relayfee": 0.00001000, "localaddresses": [ { - "address": "0600:3c03::f03c:91ff:fe89:dfc4", - "port": 8333, + "address": "192.0.2.113", + "port": 19999, "score": 4 } ], "warnings": "" } + {% endhighlight %} *See also* diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getnewaddress.md b/_includes/devdoc/dash-core/rpcs/rpcs/getnewaddress.md similarity index 95% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getnewaddress.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getnewaddress.md index ccce5bf4..67c8ce35 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getnewaddress.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getnewaddress.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getnewaddress.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getnewaddress.md" %} ##### GetNewAddress {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getpeerinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getpeerinfo.md similarity index 77% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getpeerinfo.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getpeerinfo.md index 64c43e21..0f4b5e59 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getpeerinfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getpeerinfo.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getpeerinfo.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getpeerinfo.md" %} ##### GetPeerInfo {% include helpers/subhead-links.md %} @@ -23,7 +23,7 @@ The `getpeerinfo` RPC {{summary_getPeerInfo}} p: "Required
(exactly 1)" d: "An array of objects each describing one connected node. If there are no connections, the array will be empty" -- n: "→
Node" +- n: "→
Node" t: "object" p: "Optional
(0 or more)" d: "An object describing a particular connected node" @@ -31,7 +31,7 @@ The `getpeerinfo` RPC {{summary_getPeerInfo}} - n: "→ →
`id`" t: "number (int)" p: "Required
(exactly 1)" - d: "The node's index number in the local node address database" + d: "The node's index number in the local node address database" - n: "→ →
`addr`" t: "string" @@ -41,7 +41,7 @@ The `getpeerinfo` RPC {{summary_getPeerInfo}} - n: "→ →
`addrlocal`" t: "string" p: "Optional
(0 or 1)" - d: "Our IP address and port number according to the remote node. May be incorrect due to error or lying. Most SPV nodes set this to `127.0.0.1:8333`" + d: "Our IP address and port number according to the remote node. May be incorrect due to error or lying. Most SPV nodes set this to `127.0.0.1:9999`" - n: "→ →
`services`" t: "string (hex)" @@ -72,7 +72,7 @@ The `getpeerinfo` RPC {{summary_getPeerInfo}} t: "number (int)" p: "Required
(exactly 1)" d: "The Unix epoch time when we connected to this node" - + - n: "→ →
`timeoffset`" t: "number (int)" p: "Required
(exactly 1)" @@ -82,7 +82,7 @@ The `getpeerinfo` RPC {{summary_getPeerInfo}} t: "number (real)" p: "Required
(exactly 1)" d: "The number of seconds this node took to respond to our last P2P `ping` message" - + - n: "→ →
`minping`" t: "number (real)" p: "Optional
(0 or 1)" @@ -106,7 +106,7 @@ The `getpeerinfo` RPC {{summary_getPeerInfo}} - n: "→ →
`inbound`" t: "bool" p: "Required
(exactly 1)" - d: "Set to `true` if this node connected to us; set to `false` if we connected to this node" + d: "Set to `true` if this node connected to us (inbound); set to `false` if we connected to this node (outbound)" - n: "→ →
`startingheight`" t: "number (int)" @@ -116,7 +116,7 @@ The `getpeerinfo` RPC {{summary_getPeerInfo}} - n: "→ →
`banscore`" t: "number (int)" p: "Required
(exactly 1)" - d: "The ban score we've assigned the node based on any misbehavior it's made. By default, Bitcoin Core disconnects when the ban score reaches `100`" + d: "The ban score we've assigned the node based on any misbehavior it's made. By default, Dash Core disconnects when the ban score reaches `100`" - n: "→ →
`synced_headers`" t: "number (int)" @@ -133,7 +133,7 @@ The `getpeerinfo` RPC {{summary_getPeerInfo}} p: "Required
(exactly 1)" d: "An array of blocks which have been requested from this peer. May be empty" -- n: "→ → →
Blocks" +- n: "→ → →
Blocks" t: "number (int)" p: "Optional
(0 or more)" d: "The height of a block being requested from the remote peer" @@ -147,29 +147,28 @@ The `getpeerinfo` RPC {{summary_getPeerInfo}} t: "string :
object" p: "Required
(exactly 1)" d: "*Added in Bitcoin Core 0.13.0*

Information about total sent bytes aggregated by message type" - + - n: "→ → →
Message Type" t: "number (int)" p: "Required
(1 or more)" d: "Total sent bytes aggregated by message type. One field for every used message type" - + - n: "→ →
`bytesrecv_per_msg`" t: "string :
object" p: "Required
(exactly 1)" d: "*Added in Bitcoin Core 0.13.0*

Information about total received bytes aggregated by message type" - + - n: "→ → →
Message Type" t: "number (int)" p: "Required
(1 or more)" d: "Total received bytes aggregated by message type. One field for every used message type" - {% enditemplate %} -*Example from Bitcoin Core 0.13.1* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli getpeerinfo +dash-cli getpeerinfo {% endhighlight %} Result (edited to show only a single entry, with IP addresses changed to @@ -177,47 +176,74 @@ Result (edited to show only a single entry, with IP addresses changed to {% highlight json %} [ - { + { "id": 3, - "addr": "192.0.2.113:43132", - "addrlocal": "127.0.0.1:8333", - "services": "0000000000000000", + "addr": "192.0.2.113:19999", + "addrlocal": "127.0.0.1:56332", + "services": "0000000000000005", "relaytxes": true, - "lastsend": 1481158534, - "lastrecv": 1481158534, - "bytessent": 142772, - "bytesrecv": 14167, - "conntime": 1481158420, - "timeoffset": 11, - "pingtime": 0.226368, - "minping": 0.226368, - "version": 70001, - "subver": "/Satoshi:0.12.1/", - "inbound": true, - "startingheight": 0, + "lastsend": 1507818327, + "lastrecv": 1507818327, + "bytessent": 844135, + "bytesrecv": 887651, + "conntime": 1507808575, + "timeoffset": 0, + "pingtime": 0.189852, + "minping": 0.187152, + "version": 70208, + "subver": "/Dash Core:0.12.2/", + "inbound": false, + "startingheight": 8416, "banscore": 0, - "synced_headers": -1, - "synced_blocks": -1, + "synced_headers": 8474, + "synced_blocks": 8474, "inflight": [ ], "whitelisted": false, "bytessent_per_msg": { - "addr": 55, - "inv": 12161, - "ping": 32, - "pong": 1824, - "tx": 128549, + "addr": 165, + "dseg": 65, + "dsq": 33984, + "getaddr": 24, + "getdata": 73261, + "getheaders": 861, + "getsporks": 48, + "govobj": 20244, + "govobjvote": 22196, + "govsync": 545682, + "headers": 106, + "inv": 139035, + "mnget": 28, + "notfound": 1220, + "ping": 2624, + "pong": 2624, + "sendheaders": 24, + "ssc": 1792, "verack": 24, - "version": 127 + "version": 128 }, "bytesrecv_per_msg": { - "getdata": 12161, - "ping": 1824, - "pong": 32, + "addr": 4365, + "block": 22307, + "dsq": 33984, + "getdata": 10417, + "getheaders": 861, + "govobjvote": 179, + "govsync": 4620, + "headers": 6254, + "inv": 130964, + "mnp": 352, + "mnw": 600208, + "notfound": 31192, + "ping": 2624, + "pong": 2624, + "sendheaders": 24, + "spork": 2860, + "ssc": 33664, "verack": 24, - "version": 126 + "version": 128 } - } + }, ] {% endhighlight %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getpoolinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getpoolinfo.md new file mode 100644 index 00000000..06209fd1 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getpoolinfo.md @@ -0,0 +1,120 @@ +{% 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/getpoolinfo.md" %} + +##### GetPoolInfo +{% include helpers/subhead-links.md %} + +{% assign summary_getPoolInfo="returns an object containing mixing pool related information." %} + +{% autocrossref %} + +The `getpoolinfo` RPC {{summary_getPoolInfo}} + +*Parameters: none* + +*Result---information about the mixing pool* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "object" + p: "Required
(exactly 1)" + d: "Information about the mixing pool" + +- n: "→
`state`" + t: "string" + p: "Required
(exactly 1)" + d: "Mixing pool state. Will be one of the following:
• `IDLE`
• `QUEUE`
• `ACCEPTING_ENTRIES`
• `SIGNING`
• `ERROR`
• `SUCCESS`
• `UNKNOWN`
" + +- n: "→
`mixing_mode`" + t: "string" + p: "Required
(exactly 1)" + d: "Mixing mode - will be one of the following:
• `normal`
• `multi-session`
" + +- n: "→
`queue`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "Queue size" + +- n: "→
`entries`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The number of entries" + +- n: "→
`status`" + t: "string" + p: "Required
(exactly 1)" + d: "A more detailed description of the current state" + +- n: "→
`outpoint`" + t: "string (hex)" + p: "Optional
(exactly 1)" + d: "Previous output" + +- n: "→
`addr`" + t: "string" + p: "Optional
(exactly 1)" + d: "Address" + +- n: "→
`keys_left`" + t: "number (int)" + p: "Optional
(exactly 1)" + d: "The number of keys left in the local wallet" + +- n: "→
`warnings`" + t: "number (int)" + p: "Optional
(exactly 1)" + d: "Warnings related to local wallet" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +{% highlight bash %} +dash-cli -testnet getpoolinfo +{% endhighlight %} + +Result: +{% highlight json %} +{ + "state": "IDLE", + "mixing_mode": "normal", + "queue": 0, + "entries": 0, + "status": "PrivateSend is idle.", + "keys_left": 617, + "warnings": "" +} +{% endhighlight %} + +{% highlight json %} +{ + "state": "QUEUE", + "mixing_mode": "normal", + "queue": 1, + "entries": 0, + "status": "Submitted to masternode, waiting in queue .", + "outpoint": "e3a6b7878a7e9413898bb379b323c521676f9d460db17ec3bf42d9ac0c9a432f-1", + "addr": "217.182.229.146:19999", + "keys_left": 571, + "warnings": "" +} +{% endhighlight %} + +{% highlight json %} +{ + "state": "ERROR", + "mixing_mode": "normal", + "queue": 0, + "entries": 0, + "status": "PrivateSend request incomplete: Session timed out. Will retry...", + "keys_left": 571, + "warnings": "" +} +{% endhighlight %} + +*See also:* + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getrawchangeaddress.md b/_includes/devdoc/dash-core/rpcs/rpcs/getrawchangeaddress.md similarity index 94% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getrawchangeaddress.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getrawchangeaddress.md index e8255bf7..d879a302 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getrawchangeaddress.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getrawchangeaddress.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getrawchangeaddress.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getrawchangeaddress.md" %} ##### GetRawChangeAddress {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getrawmempool.md b/_includes/devdoc/dash-core/rpcs/rpcs/getrawmempool.md similarity index 76% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getrawmempool.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getrawmempool.md index 319ee314..a95dc1f7 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getrawmempool.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getrawmempool.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getrawmempool.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getrawmempool.md" %} ##### GetRawMemPool {% include helpers/subhead-links.md %} @@ -57,14 +57,14 @@ The `getrawmempool` RPC {{summary_getRawMemPool}} d: "The size of the serialized transaction in bytes" - n: "→ →
`fee`" - t: "number (bitcoins)" + t: "amount (Dash)" p: "Required
(exactly 1)" - d: "The transaction fee paid by the transaction in decimal bitcoins" - + d: "The transaction fee paid by the transaction in decimal Dash" + - n: "→ →
`modifiedfee`" - t: "number (bitcoins)" + t: "amount (Dash)" p: "Required
(exactly 1)" - d: "*Added in Bitcoin Core 0.12.0*

The transaction fee with fee deltas used for mining priority in decimal bitcoins" + d: "*Added in Bitcoin Core 0.12.0*

The transaction fee with fee deltas used for mining priority in decimal Dash" - n: "→ →
`time`" t: "number (int)" @@ -101,21 +101,6 @@ 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 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 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 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)" @@ -128,65 +113,64 @@ The `getrawmempool` RPC {{summary_getRawMemPool}} {% enditemplate %} -*Examples from Bitcoin Core 0.13.1* +*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* The default (`false`): {% highlight bash %} -bitcoin-cli getrawmempool +dash-cli getrawmempool {% endhighlight %} Result: {% highlight json %} [ - "b104586f229e330caf42c475fd52684e9eb5e2d02f0fcd216d9554c5347b0873", - "094f7dcbc7494510d4daeceb2941ed73b1bd011bf527f6c3b7c897fee85c11d4" + "9dc994e03e387ff2d2709fbe86edede9f3d7aaddea7f75694495e415561b22fe" ] {% endhighlight %} Verbose output (`true`): {% highlight bash %} -bitcoin-cli getrawmempool true +dash-cli getrawmempool 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, - "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, + "286b3ec21e6ce5463fc712c98d86e02353525e09452113836651f3f91e562354": { + "size": 225, + "fee": 0.00000225, + "modifiedfee": 0.00000225, + "time": 1507735322, + "height": 7940, + "startingpriority": 0, + "currentpriority": 0, + "descendantcount": 4, + "descendantsize": 901, + "descendantfees": 902, "depends": [ + "2aacf53e0e15d3b4d778837792c7b6bd298edd3c41a0608586bdec41adcfe7c4" ] } } diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getrawtransaction.md b/_includes/devdoc/dash-core/rpcs/rpcs/getrawtransaction.md similarity index 98% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getrawtransaction.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getrawtransaction.md index 0c3d381a..7ffbaccc 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getrawtransaction.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getrawtransaction.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getrawtransaction.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getrawtransaction.md" %} ##### GetRawTransaction {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getreceivedbyaccount.md b/_includes/devdoc/dash-core/rpcs/rpcs/getreceivedbyaccount.md similarity index 95% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getreceivedbyaccount.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getreceivedbyaccount.md index 7af970d4..02832328 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getreceivedbyaccount.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getreceivedbyaccount.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getreceivedbyaccount.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getreceivedbyaccount.md" %} ##### GetReceivedByAccount {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getreceivedbyaddress.md b/_includes/devdoc/dash-core/rpcs/rpcs/getreceivedbyaddress.md similarity index 94% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getreceivedbyaddress.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getreceivedbyaddress.md index 57cf6cf1..9dcee2a5 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getreceivedbyaddress.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getreceivedbyaddress.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getreceivedbyaddress.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getreceivedbyaddress.md" %} ##### GetReceivedByAddress {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getspentinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getspentinfo.md new file mode 100644 index 00000000..400cc692 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getspentinfo.md @@ -0,0 +1,82 @@ +{% 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/getspentinfo.md" %} + +##### GetSpentInfo +{% include helpers/subhead-links.md %} + +{% assign summary_getSpentInfo="returns the txid and index where an output is spent (requires `spentindex` to be enabled)." %} + +{% autocrossref %} + +*Added in Dash Core 0.12.1* + +The `getspentinfo` RPC {{summary_getSpentInfo}} + +*Parameter #1---the TXID of the output* + +{% itemplate ntpd1 %} +- n: "TXID" + t: "string (hex)" + p: "Required
(exactly 1)" + d: "The TXID of the transaction containing the relevant output, encoded as hex in RPC byte order" + +{% enditemplate %} + +*Parameter #2---the start block height* + +{% itemplate ntpd1 %} +- n: "Index" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The block height to begin looking in" + +{% enditemplate %} + +*Result---the TXID and spending input index* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "object/null" + p: "Required
(exactly 1)" + d: "Information about the spent output. If output wasn't found or if an error occurred, this will be JSON `null`" + +- n: "→
`txid`" + t: "string" + p: "Required
(exactly 1)" + d: "The output txid" + +- n: "→
`index`" + t: "number" + p: "Required
(exactly 1)" + d: "The spending input index" +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +Get the txid and index where an output is spent: + +{% highlight bash %} +dash-cli getspentinfo \ + ''' + { + "txid": "0456aaf51a8df21dd47c2a06ede046a5bf7403bcb95d14d1d71b178c189fb933", \ + "index": 0 + } +{% endhighlight %} + +Result: + +{% highlight json %} +{ + "txid": "14e874421350840e9d43965967c5a989e7d41ad361ef37484ee67d01d433ecfa", + "index": 1, + "height": 7742 +} +{% endhighlight %} + +*See also: none* + +{% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getsuperblockbudget.md b/_includes/devdoc/dash-core/rpcs/rpcs/getsuperblockbudget.md new file mode 100644 index 00000000..0522bd93 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getsuperblockbudget.md @@ -0,0 +1,51 @@ +{% 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/getsuperblockbudget.md" %} + +##### GetSuperblockBudget +{% include helpers/subhead-links.md %} + +{% assign summary_getSuperblockBudget="returns the absolute maximum sum of superblock payments allowed." %} + +{% autocrossref %} + +The `getsuperblockbudget` RPC {{summary_getSuperblockBudget}} + +*Parameter #1---block index* + +{% itemplate ntpd1 %} +- n: "index" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The superblock index" + +{% enditemplate %} + +*Result---maximum sum of superblock payments* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The absolute maximum sum of superblock payments allowed, in DASH" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +{% highlight bash %} +dash-cli -testnet getsuperblockbudget 7392 +{% endhighlight %} + +Result: +{% highlight text %} +367.20 +{% endhighlight %} + +*See also:* + +* [GetGovernanceInfo][rpc getgovernanceinfo]: {{summary_getGovernanceInfo}} + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/gettransaction.md b/_includes/devdoc/dash-core/rpcs/rpcs/gettransaction.md similarity index 98% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/gettransaction.md rename to _includes/devdoc/dash-core/rpcs/rpcs/gettransaction.md index a52e69b3..efa75791 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/gettransaction.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/gettransaction.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/gettransaction.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/gettransaction.md" %} ##### GetTransaction {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/gettxout.md b/_includes/devdoc/dash-core/rpcs/rpcs/gettxout.md similarity index 84% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/gettxout.md rename to _includes/devdoc/dash-core/rpcs/rpcs/gettxout.md index 202a8f05..bc0c7b62 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/gettxout.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/gettxout.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/gettxout.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/gettxout.md" %} ##### GetTxOut {% include helpers/subhead-links.md %} @@ -63,9 +63,9 @@ The `gettxout` RPC {{summary_getTxOut}} d: "The number of confirmations received for the transaction containing this output or `0` if the transaction hasn't been confirmed yet" - n: "→
`value`" - t: "number (bitcoins)" + t: "number (Dash)" p: "Required
(exactly 1)" - d: "The amount of bitcoins spent to this output. May be `0`" + d: "The amount of Dash spent to this output. May be `0`" - n: "→
`scriptPubKey`" t: "string : object" @@ -114,15 +114,15 @@ The `gettxout` RPC {{summary_getTxOut}} {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* Get the UTXO from the following transaction from the first output index ("0"), searching the memory pool if necessary. {% highlight bash %} -bitcoin-cli -testnet gettxout \ - d77aee99e8bdc11f40b8a9354956f0346fec5535b82c77c8b5c06047e3bca86a \ +dash-cli -testnet gettxout \ + e0a06b47f0de6f3851a228d5ac377ac38b495adf04298c43e951e679c5b0aa8f \ 0 true {% endhighlight %} @@ -130,20 +130,20 @@ Result: {% highlight json %} { - "bestblock" : "00000000c92356f7030b1deeab54b3b02885711320b4c48523be9daa3e0ace5d", - "confirmations" : 0, - "value" : 0.00100000, - "scriptPubKey" : { - "asm" : "OP_DUP OP_HASH160 a11418d3c144876258ba02909514d90e71ad8443 OP_EQUALVERIFY OP_CHECKSIG", - "hex" : "76a914a11418d3c144876258ba02909514d90e71ad844388ac", - "reqSigs" : 1, - "type" : "pubkeyhash", - "addresses" : [ - "mvCfAJSKaoFXoJEvv8ssW7wxaqRPphQuSv" - ] - }, - "version" : 1, - "coinbase" : false + "bestblock": "000000005651f6d7859793dee07d476a2f2a7338e66bbb41caf4b544c5b0318d", + "confirmations": 2, + "value": 25.00000000, + "scriptPubKey": { + "asm": "OP_DUP OP_HASH160 b66266c5017a759817f3bb99e8d9124bf5bb2e74 OP_EQUALVERIFY OP_CHECKSIG", + "hex": "76a914b66266c5017a759817f3bb99e8d9124bf5bb2e7488ac", + "reqSigs": 1, + "type": "pubkeyhash", + "addresses": [ + "ycwoiAibTjpwnoCZSX7S4kiB2H8wULw9qo" + ] + }, + "version": 1, + "coinbase": false } {% endhighlight %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/gettxoutproof.md b/_includes/devdoc/dash-core/rpcs/rpcs/gettxoutproof.md similarity index 57% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/gettxoutproof.md rename to _includes/devdoc/dash-core/rpcs/rpcs/gettxoutproof.md index 1fa05800..861c4e68 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/gettxoutproof.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/gettxoutproof.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/gettxoutproof.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/gettxoutproof.md" %} ##### GetTxOutProof {% include helpers/subhead-links.md %} @@ -53,38 +53,28 @@ specify the block in which the transaction is included in manually (by block hea {% enditemplate %} -*Example from Bitcoin Core 0.11.0* +*Example from Dash Core 0.12.2* -Get the hex-encoded proof that "txid" was included in block 0000000000000000140e84bf183d8d5207d65fbfae596bdf48f684d13d951847: +Get the hex-encoded proof that "txid" was included in block 000000012d774f3c7668f32bc448efeb93b317f312dd863679de3a007d47817f: {% highlight bash %} -bitcoin-cli gettxoutproof \ +dash-cli gettxoutproof \ ''' [ - "f20e44c818ec332d95119507fbe36f1b8b735e2c387db62adbe28e50f7904683" + "e0a06b47f0de6f3851a228d5ac377ac38b495adf04298c43e951e679c5b0aa8f" ] ''' \ - '0000000000000000140e84bf183d8d5207d65fbfae596bdf48f684d13d951847' + '000000012d774f3c7668f32bc448efeb93b317f312dd863679de3a007d47817f' {% endhighlight %} Result (wrapped): {% highlight text %} -03000000394ab3f08f712aa0f1d26c5daa4040b50e96d31d4e8e3c130000000000000000\ -ca89aaa0bbbfcd5d1210c7888501431256135736817100d8c2cf7e4ab9c02b168115d455\ -04dd1418836b20a6cb0800000d3a61beb3859abf1b773d54796c83b0b937968cc4ce3c0f\ -71f981b2407a3241cb8908f2a88ac90a2844596e6019450f507e7efb8542cbe54ea55634\ -c87bee474ee48aced68179564290d476e16cff01b483edcd2004d555c617dfc08200c083\ -08ba511250e459b49d6a465e1ab1d5d8005e0778359c2993236c85ec66bac4bfd974131a\ -dc1ee0ad8b645f459164eb38325ac88f98c9607752bc1b637e16814f0d9d8c2775ac3f20\ -f85260947929ceef16ead56fcbfd77d9dc6126cce1b5aacd9f834690f7508ee2db2ab67d\ -382c5e738b1b6fe3fb079511952d33ec18c8440ef291eb8d3546a971ee4aa5e574b7be7f\ -5aff0b1c989b2059ae5a611c8ce5c58e8e8476246c5e7c6b70e0065f2a6654e2e6cf4efb\ -6ae19bf2548a7d9febf5b0aceaff28610922e1b9e23e52f650a4a11d2986c9c2b09bb168\ -a70a7d4ac16e4d389bc2868ee91da1837d2cd79288bdc680e9c35ebb3ddfd045d69d767b\ -164ec69d5db9f995c045d10af5bd90cd9d1116c3732e14796ef9d1a57fa7bb718c07989e\ -d06ff359bf2009eaf1b9e000c054b87230567991b447757bc6ca8e1bb6e9816ad604dbd6\ -0600 +01000020ed72cc6a7294782a7711d8fa7ef74716ef062dc50bb0820f7eec923801000000\ +aa5d17c5128043803b67c7ab03e4d3ffbc9604b54f877f1c5cf9ed3adeaa19b2cd7ed659\ +f838011d10a70a480200000002033c89c2baecba9fc983c85dcf365c2d9cc93aca1dee2e\ +5ac18124464056542e8faab0c579e651e9438c2904df5a498bc37a37acd528a251386fde\ +f0476ba0e00105 {% endhighlight %} *See also* diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/gettxoutsetinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/gettxoutsetinfo.md similarity index 80% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/gettxoutsetinfo.md rename to _includes/devdoc/dash-core/rpcs/rpcs/gettxoutsetinfo.md index e3a98e81..ba8db755 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/gettxoutsetinfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/gettxoutsetinfo.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/gettxoutsetinfo.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/gettxoutsetinfo.md" %} ##### GetTxOutSetInfo {% include helpers/subhead-links.md %} @@ -54,29 +54,29 @@ The `gettxoutsetinfo` RPC {{summary_getTxOutSetInfo}} d: "A SHA256(SHA256()) hash of the serialized UTXO set; useful for comparing two nodes to see if they have the same set (they should, if they always used the same serialization format and currently have the same best block). The hash is encoded as hex in RPC byte order" - n: "→
`total_amount`" - t: "number (bitcoins)" + t: "number (Dash)" p: "Required
(exactly 1)" - d: "The total number of bitcoins in the UTXO set" + d: "The total amount of Dash in the UTXO set" {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli -testnet gettxoutsetinfo +dash-cli -testnet gettxoutsetinfo {% endhighlight %} Result: {% highlight json %} { - "height" : 315293, - "bestblock" : "00000000c92356f7030b1deeab54b3b02885711320b4c48523be9daa3e0ace5d", - "transactions" : 771920, - "txouts" : 2734587, - "bytes_serialized" : 102629817, - "hash_serialized" : "4753470fda0145760109e79b8c218a1331e84bb4269d116857b8a4597f109905", - "total_amount" : 13131746.33839451 + "height": 4755, + "bestblock": "0000000025da0abc9e9937f1c65b3f544a57bb7e8817422f7ff2a89ff32696f4", + "transactions": 4748, + "txouts": 10602, + "bytes_serialized": 463925, + "hash_serialized": "fce0776d7961b409c4d8a46363c8d049879321861f7f40db97b0432e59532320", + "total_amount": 2243585.70000000 } {% endhighlight %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getunconfirmedbalance.md b/_includes/devdoc/dash-core/rpcs/rpcs/getunconfirmedbalance.md similarity index 91% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getunconfirmedbalance.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getunconfirmedbalance.md index 4c451850..ae0ed231 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getunconfirmedbalance.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getunconfirmedbalance.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getunconfirmedbalance.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getunconfirmedbalance.md" %} ##### GetUnconfirmedBalance {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getwalletinfo.md b/_includes/devdoc/dash-core/rpcs/rpcs/getwalletinfo.md similarity index 96% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getwalletinfo.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getwalletinfo.md index eeac8f4e..0420d4b6 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getwalletinfo.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getwalletinfo.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getwalletinfo.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getwalletinfo.md" %} ##### GetWalletInfo {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getwork.md b/_includes/devdoc/dash-core/rpcs/rpcs/getwork.md similarity index 88% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/getwork.md rename to _includes/devdoc/dash-core/rpcs/rpcs/getwork.md index b8b2965f..693eea44 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/getwork.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getwork.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getwork.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/getwork.md" %} ##### GetWork {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/gobject.md b/_includes/devdoc/dash-core/rpcs/rpcs/gobject.md new file mode 100644 index 00000000..a454f6f7 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/gobject.md @@ -0,0 +1,314 @@ +{% 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/gobject.md" %} + +##### GObject +{% include helpers/subhead-links.md %} + +{% assign summary_gObject="provides a set of commands for managing governance objects and displaying information about them." %} + +{% autocrossref %} + +The `gobject` RPC {{summary_gObject}} + +###### GObject Check + +###### GObject Prepare + +###### GObject Submit + +###### GObject Deserialize + +###### GObject Count + +The `gobject count` RPC returns the count of governance objects and votes. + +*Parameters: none* + +*Result---count of governance objects and votes* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "string" + p: "Required
(exactly 1)" + d: "The count of governance objects and votes" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +{% highlight bash %} +dash-cli -testnet gobject count +{% endhighlight %} + +Result (wrapped): +{% highlight text %} +Governance Objects: 177 (Proposals: 177, Triggers: 0, Watchdogs: 0/0, \ + Other: 0; Erased: 5), Votes: 9680 +{% endhighlight %} + + + +###### GObject Get + +The `gobject get` RPC returns a governance object by hash. + +*Parameter #1---object hash* + +{% itemplate ntpd1 %} +- n: "`governance-hash`" + t: "string (hex)" + p: "Required
(exactly 1)" + d: "The hash of a governance object" + +{% enditemplate %} + +*Result---governance object details* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "object" + p: "Required
(exactly 1)" + d: "Information about the governance object" + +- n: "→
`DataHex`" + t: "string (hex)" + p: "Required
(exactly 1)" + d: "Governance object info as hex string" + +- n: "→
`DataString`" + t: "string" + p: "Required
(exactly 1)" + d: "Governance object info as string" + +- n: "→
`Hash`" + t: "string (hex)" + p: "Required
(exactly 1)" + d: "Hash of this governance object" + +- n: "→
`CollateralHash`" + t: "string (hex)" + p: "Required
(exactly 1)" + d: "Hash of the collateral payment transaction" + +- n: "→
`ObjectType`" + t: "number" + p: "Required
(exactly 1)" + d: "Object types:
`1` - Unknown
`2` - Proposal
`3` - Trigger
`4` - Watchdog" + +- n: "→
`CreationTime`" + t: "number" + p: "Required
(exactly 1)" + d: "Object creation time as Unix epoch time" + +- n: "→
`FundingResult`" + t: "object" + p: "Required
(exactly 1)" + d: "Funding vote details" + +- n: "→ →
`AbsoluteYesCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `Yes` votes minus number of `No` votes" + +- n: "→ →
`YesCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `Yes` votes" + +- n: "→ →
`NoCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `No` votes" + +- n: "→ →
`AbstainCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `Abstain` votes" + +- n: "→
`ValidResult`" + t: "object" + p: "Required
(exactly 1)" + d: "Object validity vote details" + +- n: "→ →
`AbsoluteYesCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `Yes` votes minus number of `No` votes" + +- n: "→ →
`YesCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `Yes` votes" + +- n: "→ →
`NoCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `No` votes" + +- n: "→ →
`AbstainCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `Abstain` votes" + +- n: "→
`DeleteResult`" + t: "object" + p: "Required
(exactly 1)" + d: "Delete vote details" + +- n: "→ →
`AbsoluteYesCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `Yes` votes minus number of `No` votes" + +- n: "→ →
`YesCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `Yes` votes" + +- n: "→ →
`NoCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `No` votes" + +- n: "→ →
`AbstainCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `Abstain` votes" + +- n: "→
`EndorsedResult`" + t: "object" + p: "Required
(exactly 1)" + d: "Endorsed vote details" + +- n: "→ →
`AbsoluteYesCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `Yes` votes minus number of `No` votes" + +- n: "→ →
`YesCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `Yes` votes" + +- n: "→ →
`NoCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `No` votes" + +- n: "→ →
`AbstainCount`" + t: "number" + p: "Required
(exactly 1)" + d: "Number of `Abstain` votes" + +- n: "→
`fLocalValidity`" + t: "boolean" + p: "Required
(exactly 1)" + d: "Valid by the blockchain" + +- n: "→
`IsValidReason`" + t: "string" + p: "Required
(exactly 1)" + d: "`fLocalValidity` error result. Empty if no error returned." + +- n: "→
`fCachedValid`" + t: "boolean" + p: "Required
(exactly 1)" + d: "Minimum network support has been reached flagging this object as a valid and understood governance object (e.g, the serialized data is correct format, etc)" + +- n: "→
`fCachedFunding`" + t: "boolean" + p: "Required
(exactly 1)" + d: "Minimum network support has been reached for this object to be funded (doesn't mean it will be for sure though)" + +- n: "→
`fCachedDelete`" + t: "boolean" + p: "Required
(exactly 1)" + d: "Minimum network support has been reached saying this object should be deleted from the system entirely" + +- n: "→
`fCachedEndorsed`" + t: "boolean" + p: "Required
(exactly 1)" + d: "Minimum network support has been reached flagging this object as endorsed" + + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +{% highlight bash %} +dash-cli -testnet gobject get \ + 42253a7bec554b97a65d2889e6cb9a1cf308b3d47a778c704bf9cdc1fe1bf6ff +{% endhighlight %} + +Result (wrapped): +{% highlight json %} +{ + "DataHex": "5b5b2270726f706f73616c222c7b22656e645f65706f6368223a2231353037343339353130222c226e616d65223a227465737470726f706f73616c5f2d5f6162636465666768696a6b6c6d6e6f707172737475767778797a3031323334353637383931353037323530343338222c227061796d656e745f61646472657373223a22795668577955345933756456784d5234464b3333556741534a41436831436835516a222c227061796d656e745f616d6f756e74223a2232222c2273746172745f65706f6368223a2231353037323530343338222c2274797065223a312c2275726c223a2268747470733a2f2f7777772e6461736863656e7472616c2e6f72672f702f746573745f70726f706f73616c5f31353037323530343338227d5d5d", + "DataString": "[[\"proposal\",{\"end_epoch\":\"1507439510\",\"name\":\"testproposal_-_abcdefghijklmnopqrstuvwxyz01234567891507250438\",\"payment_address\":\"yVhWyU4Y3udVxMR4FK33UgASJACh1Ch5Qj\",\"payment_amount\":\"2\",\"start_epoch\":\"1507250438\",\"type\":1,\"url\":\"https://www.dashcentral.org/p/test_proposal_1507250438\"}]]", + "Hash": "42253a7bec554b97a65d2889e6cb9a1cf308b3d47a778c704bf9cdc1fe1bf6ff", + "CollateralHash": "cb09bd0310c0a67cde9387ad4d8908a7ad9f5d89c5afd58e9332b8bd26a646c7", + "ObjectType": 1, + "CreationTime": 1507246694, + "FundingResult": { + "AbsoluteYesCount": 0, + "YesCount": 0, + "NoCount": 0, + "AbstainCount": 0 + }, + "ValidResult": { + "AbsoluteYesCount": 0, + "YesCount": 0, + "NoCount": 0, + "AbstainCount": 0 + }, + "DeleteResult": { + "AbsoluteYesCount": 31, + "YesCount": 31, + "NoCount": 0, + "AbstainCount": 0 + }, + "EndorsedResult": { + "AbsoluteYesCount": 0, + "YesCount": 0, + "NoCount": 0, + "AbstainCount": 0 + }, + "fLocalValidity": true, + "IsValidReason": "", + "fCachedValid": true, + "fCachedFunding": false, + "fCachedDelete": false, + "fCachedEndorsed": false +} +{% endhighlight %} + +###### GObject Getvotes + +###### GObject Getcurrentvotes + +###### GObject List + +###### GObject Diff + +###### GObject Vote-alias + +###### GObject Vote-conf + +###### GObject Vote-many + + +{% highlight bash %} +dash-cli -testnet gobject +{% endhighlight %} + +Result: +{% highlight json %} + *INSERT RESULTS HERE* +{% endhighlight %} + +*See also:* + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/help.md b/_includes/devdoc/dash-core/rpcs/rpcs/help.md similarity index 75% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/help.md rename to _includes/devdoc/dash-core/rpcs/rpcs/help.md index cf9bf7ba..6da12200 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/help.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/help.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/help.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/help.md" %} ##### Help {% include helpers/subhead-links.md %} @@ -19,7 +19,7 @@ The `help` RPC {{summary_help}} - n: "RPC" t: "string" p: "Optional
(0 or 1)" - d: "The name of the RPC to get help for. If omitted, Bitcoin Core 0.9x will display an alphabetical list of commands; Bitcoin Core 0.10.0 will display a categorized list of commands" + d: "The name of the RPC to get help for. If omitted, Dash Core 0.10x will display an alphabetical list of commands; Dash Core 0.11.0 will display a categorized list of commands" {% enditemplate %} @@ -29,16 +29,16 @@ The `help` RPC {{summary_help}} - n: "`result`" t: "string" p: "Required
(exactly 1)" - d: "The help text for the specified RPC or the list of commands. The `bitcoin-cli` command will parse this text and format it as human-readable text" + d: "The help text for the specified RPC or the list of commands. The `dash-cli` command will parse this text and format it as human-readable text" {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* Command to get help about the `help` RPC: {% highlight bash %} -bitcoin-cli -testnet help help +dash-cli -testnet help help {% endhighlight %} Result: diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/importaddress.md b/_includes/devdoc/dash-core/rpcs/rpcs/importaddress.md similarity index 97% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/importaddress.md rename to _includes/devdoc/dash-core/rpcs/rpcs/importaddress.md index 41e24818..81d85506 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/importaddress.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/importaddress.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/importaddress.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/importaddress.md" %} ##### ImportAddress {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/importmulti.md b/_includes/devdoc/dash-core/rpcs/rpcs/importmulti.md similarity index 98% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/importmulti.md rename to _includes/devdoc/dash-core/rpcs/rpcs/importmulti.md index fa8c2257..f8cfe88a 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/importmulti.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/importmulti.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/importmulti.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/importmulti.md" %} ##### ImportMulti {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/importprivkey.md b/_includes/devdoc/dash-core/rpcs/rpcs/importprivkey.md similarity index 97% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/importprivkey.md rename to _includes/devdoc/dash-core/rpcs/rpcs/importprivkey.md index bcff61ca..b93afe56 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/importprivkey.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/importprivkey.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/importprivkey.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/importprivkey.md" %} ##### ImportPrivKey {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/importprunedfunds.md b/_includes/devdoc/dash-core/rpcs/rpcs/importprunedfunds.md similarity index 95% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/importprunedfunds.md rename to _includes/devdoc/dash-core/rpcs/rpcs/importprunedfunds.md index 033f49e3..a2adf239 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/importprunedfunds.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/importprunedfunds.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/importprunedfunds.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/importprunedfunds.md" %} ##### ImportPrunedFunds {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/importwallet.md b/_includes/devdoc/dash-core/rpcs/rpcs/importwallet.md similarity index 95% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/importwallet.md rename to _includes/devdoc/dash-core/rpcs/rpcs/importwallet.md index 0c2cf450..587ee94e 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/importwallet.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/importwallet.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/importwallet.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/importwallet.md" %} ##### ImportWallet {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/keypoolrefill.md b/_includes/devdoc/dash-core/rpcs/rpcs/keypoolrefill.md similarity index 94% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/keypoolrefill.md rename to _includes/devdoc/dash-core/rpcs/rpcs/keypoolrefill.md index 637a4bd3..bf50f0d4 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/keypoolrefill.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/keypoolrefill.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/keypoolrefill.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/keypoolrefill.md" %} ##### KeyPoolRefill {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listaccounts.md b/_includes/devdoc/dash-core/rpcs/rpcs/listaccounts.md similarity index 96% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/listaccounts.md rename to _includes/devdoc/dash-core/rpcs/rpcs/listaccounts.md index a9d14a28..e293c6c5 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listaccounts.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/listaccounts.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/listaccounts.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/listaccounts.md" %} ##### ListAccounts {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listaddressgroupings.md b/_includes/devdoc/dash-core/rpcs/rpcs/listaddressgroupings.md similarity index 96% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/listaddressgroupings.md rename to _includes/devdoc/dash-core/rpcs/rpcs/listaddressgroupings.md index 63563170..4afbd088 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listaddressgroupings.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/listaddressgroupings.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/listaddressgroupings.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/listaddressgroupings.md" %} ##### ListAddressGroupings {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listbanned.md b/_includes/devdoc/dash-core/rpcs/rpcs/listbanned.md similarity index 83% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/listbanned.md rename to _includes/devdoc/dash-core/rpcs/rpcs/listbanned.md index 5832d021..38a44653 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listbanned.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/listbanned.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/listbanned.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/listbanned.md" %} ##### ListBanned {% include helpers/subhead-links.md %} @@ -25,11 +25,11 @@ The `listbanned` RPC {{summary_listBanned}} p: "Required
(exactly 1)" d: "An array of objects each describing one entry. If there are no entries in the ban list, the array will be empty" -- n: "→
Node" +- n: "→
Node" t: "object" p: "Optional
(0 or more)" d: "A ban list entry" - + - n: "→ →
`address`" t: "string" p: "Required
(exactly 1)" @@ -44,7 +44,7 @@ The `listbanned` RPC {{summary_listBanned}} t: "number
(int)" p: "Required
(exactly 1)" d: "The Unix epoch time until the IP/Subnet is banned" - + - n: "→ →
`ban_reason`" t: "string" p: "Required
(exactly 1)" @@ -52,29 +52,28 @@ The `listbanned` RPC {{summary_listBanned}} {% enditemplate %} -*Examples from Bitcoin Core 0.12.1* +*Examples from Dash Core 0.12.2* The default (`false`): {% highlight bash %} -bitcoin-cli listbanned +dash-cli listbanned {% endhighlight %} Result: {% highlight json %} - [ { - "address": "83.84.25.82/32", - "banned_until": 1487269503, - "ban_created": 1478629503, + "address": "192.0.2.201/32", + "banned_until": 1507906175, + "ban_created": 1507819775, "ban_reason": "node misbehaving" }, { - "address": "111.111.0.111/32", - "banned_until": 1487791655, - "ban_created": 1479151655, + "address": "192.0.2.101/32", + "banned_until": 1507906199, + "ban_created": 1507819799, "ban_reason": "manually added" } ] diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listlockunspent.md b/_includes/devdoc/dash-core/rpcs/rpcs/listlockunspent.md similarity index 94% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/listlockunspent.md rename to _includes/devdoc/dash-core/rpcs/rpcs/listlockunspent.md index 8aba538f..cea3ebec 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listlockunspent.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/listlockunspent.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/listlockunspent.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/listlockunspent.md" %} ##### ListLockUnspent {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listreceivedbyaccount.md b/_includes/devdoc/dash-core/rpcs/rpcs/listreceivedbyaccount.md similarity index 97% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/listreceivedbyaccount.md rename to _includes/devdoc/dash-core/rpcs/rpcs/listreceivedbyaccount.md index e60eef85..6e3f1386 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listreceivedbyaccount.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/listreceivedbyaccount.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/listreceivedbyaccount.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/listreceivedbyaccount.md" %} ##### ListReceivedByAccount {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listreceivedbyaddress.md b/_includes/devdoc/dash-core/rpcs/rpcs/listreceivedbyaddress.md similarity index 97% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/listreceivedbyaddress.md rename to _includes/devdoc/dash-core/rpcs/rpcs/listreceivedbyaddress.md index f615e0a4..b851718c 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listreceivedbyaddress.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/listreceivedbyaddress.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/listreceivedbyaddress.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/listreceivedbyaddress.md" %} ##### ListReceivedByAddress {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listsinceblock.md b/_includes/devdoc/dash-core/rpcs/rpcs/listsinceblock.md similarity index 98% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/listsinceblock.md rename to _includes/devdoc/dash-core/rpcs/rpcs/listsinceblock.md index 62639fd6..b6fea427 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listsinceblock.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/listsinceblock.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/listsinceblock.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/listsinceblock.md" %} ##### ListSinceBlock {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listtransactions.md b/_includes/devdoc/dash-core/rpcs/rpcs/listtransactions.md similarity index 99% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/listtransactions.md rename to _includes/devdoc/dash-core/rpcs/rpcs/listtransactions.md index 1a886a8e..80d92959 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listtransactions.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/listtransactions.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/listtransactions.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/listtransactions.md" %} ##### ListTransactions {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listunspent.md b/_includes/devdoc/dash-core/rpcs/rpcs/listunspent.md similarity index 98% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/listunspent.md rename to _includes/devdoc/dash-core/rpcs/rpcs/listunspent.md index c54fc432..64bb91db 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/listunspent.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/listunspent.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/listunspent.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/listunspent.md" %} ##### ListUnspent {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/lockunspent.md b/_includes/devdoc/dash-core/rpcs/rpcs/lockunspent.md similarity index 97% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/lockunspent.md rename to _includes/devdoc/dash-core/rpcs/rpcs/lockunspent.md index 97508f6b..850532b9 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/lockunspent.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/lockunspent.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/lockunspent.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/lockunspent.md" %} ##### LockUnspent {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/masternode.md b/_includes/devdoc/dash-core/rpcs/rpcs/masternode.md new file mode 100644 index 00000000..d5e5920d --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/masternode.md @@ -0,0 +1,27 @@ +{% 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/masternode.md" %} + +##### Masternode +{% include helpers/subhead-links.md %} + +{% assign summary_masternode="" %} + +{% autocrossref %} + +The `masternode` RPC {{summary_masternode}} + +{% highlight bash %} +dash-cli -testnet masternode +{% endhighlight %} + +Result: +{% highlight json %} + *INSERT RESULTS HERE* +{% endhighlight %} + +*See also:* + +{% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/masternodebroadcast.md b/_includes/devdoc/dash-core/rpcs/rpcs/masternodebroadcast.md new file mode 100644 index 00000000..ad69a34c --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/masternodebroadcast.md @@ -0,0 +1,27 @@ +{% 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/masternodebroadcast.md" %} + +##### MasternodeBroadcast +{% include helpers/subhead-links.md %} + +{% assign summary_masternodeBroadcast="" %} + +{% autocrossref %} + +The `masternodebroadcast` RPC {{summary_masternodeBroadcast}} + +{% highlight bash %} +dash-cli -testnet masternodebroadcast +{% endhighlight %} + +Result: +{% highlight json %} + *INSERT RESULTS HERE* +{% endhighlight %} + +*See also:* + +{% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/masternodelist.md b/_includes/devdoc/dash-core/rpcs/rpcs/masternodelist.md new file mode 100644 index 00000000..2f54f3bd --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/masternodelist.md @@ -0,0 +1,143 @@ +{% 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/masternodelist.md" %} + +##### MasternodeList +{% include helpers/subhead-links.md %} + +{% assign summary_masternodeList="returns a list of masternodes in different modes." %} + +{% autocrossref %} + +The `masternodelist` RPC {{summary_masternodeList}} + +*Parameter #1---List mode* + +{% itemplate ntpd1 %} +- n: "`mode`" + t: "string" + p: "Optional (exactly 1);
Required to use `filter`" + d: "The mode to run list in" + +{% enditemplate %} + +*Mode Options* + +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) +`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) +`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 +`payee` | Print Dash address associated with a masternode (can be additionally filtered, partial match) +`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) + +*Parameter #2---List filter* + +{% itemplate ntpd1 %} +- n: "`filter`" + t: "string" + p: "Optional
(exactly 1)" + d: "Filter results. Partial match by outpoint by default in all modes, additional matches in some modes are also available." + +{% enditemplate %} + +*Result---the masternode list* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "object/null" + p: "Required
(exactly 1)" + d: "Information about the masternode sync status" + +- n: "→
Masternode Info" + t: "string" + p: "Required
(1 or more)" + d: "The requested masternode info. Output varies based on selected `mode` and `filter` parameters" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +Get unfiltered Masternode list in default mode + +{% highlight bash %} +dash-cli -testnet masternodelist +{% endhighlight %} + +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" +} +{% endhighlight %} + +Get a filtered Masternode list + +{% highlight bash %} +dash-cli -testnet masternodelist full "NEW" +{% endhighlight %} + +Result: +{% highlight json %} +{ + "6125fc1da46cd2fdd013b1fbb02144367a95feffd379c08064f38de0e3deb80c-1": "NEW_START_REQUIRED 70208 yh7RGWjZN8yDAAzPpYFUJZAj41jG7G43c8 1507401630 0 1507409411 5874 1.1.1.1:19999", + "866d66b88afed15ed1a936b680ace1a99e0ca14d0242bc2983c5fdd2c16c1637-1": "NEW_START_REQUIRED 70208 yQHJ4muL7FyhUj1x8iBr2Ws9E4cJ68DKin 1507626190 138962 1507620650 7215 178.62.203.249:19999", + "7c17695bdccc617410164882bd8b5fb7bf4f5a3dceb0a7476800e161cba1c57f-1": "NEW_START_REQUIRED 70208 yjWGCrz6iJnDsrog5FX6ag3iQUNor9UFj5 1507636178 0 0 0 83.1.99.1:19999", + "0512f77ebceaf288386e9a050e3c80652c7bfb6e993659ded2dff43eae6904ac-1": "NEW_START_REQUIRED 70208 ydahSbZKWUjBi6jHeWjLgr7navPoZVCgwH 1507646277 32460 1507649163 7397 172.104.45.115:19999", + "4222505288507e0f1abc32f0323cce1d6c4d22c8e785adb0cf8075b70ae92ddf-1": "NEW_START_REQUIRED 70208 yUznkRL396PewekhtCpUJkfJcxt8fhDyoX 1507646174 9996 1507642757 7355 83.1.99.2:19999", + "b454dd0efc19657f8d56a750385b90ebfb53dce5182a21238b225d6cbb3307f0-1": "NEW_START_REQUIRED 70208 yYR5dcULfpnbPSixorzMkQ9SGwzPPsXcuC 1507401632 0 1507408648 5868 2.2.2.2:19999" +} +{% endhighlight %} + +*See also:* + +* [Masternode][rpc masternode]: {{summary_masternode}} +* [MasternodeBroadcast][rpc masternodebroadcast]: {{summary_masternodeBroadcast}} +* [MnSync][rpc mnsync]: {{summary_mnSync}} + +{% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/mnsync.md b/_includes/devdoc/dash-core/rpcs/rpcs/mnsync.md new file mode 100644 index 00000000..3b164241 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/mnsync.md @@ -0,0 +1,172 @@ +{% 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/mnsync.md" %} + +##### MnSync +{% include helpers/subhead-links.md %} + +{% assign summary_mnSync="returns the sync status, updates to the next step or resets it entirely." %} + +{% autocrossref %} + +The `mnsync` RPC {{summary_mnSync}} + +*Parameter #1---Command mode* + +{% itemplate ntpd1 %} +- n: "`mode`" + t: "string" + p: "Required
(exactly 1)" + d: "The command mode to use:
`status` - Get masternode sync status
`next` - Move to next sync asset
`reset` - Reset sync status" + +{% enditemplate %} + +**Command Mode - `status`** + +*Result---the sync status* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "object/null" + p: "Required
(exactly 1)" + d: "Information about the masternode sync status" + +- n: "→
`AssetID`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The sync asset ID" + +- n: "→
`AssetName`" + t: "string" + p: "Required
(exactly 1)" + d: "The sync asset name" + +- n: "→
`AssetStartTime`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The sync asset start time" + +- n: "→
`Attempt`" + t: "number (int)" + p: "Required
(exactly 1)" + d: "The sync attempt number" + +- n: "→
`IsBlockchainSynced`" + t: "boolean" + p: "Required
(exactly 1)" + d: "Blockchain sync status" + +- n: "→
`IsMasternodeListSynced`" + t: "boolean" + p: "Required
(exactly 1)" + d: "Masternode list sync status" + +- n: "→
`IsWinnersListSynced`" + t: "boolean" + p: "Required
(exactly 1)" + d: "Masternode winners list sync status" + +- n: "→
`IsSynced`" + t: "boolean" + p: "Required
(exactly 1)" + d: "Masternode sync status" + +- n: "→
`IsFailed`" + t: "boolean" + p: "Required
(exactly 1)" + d: "Masternode list sync fail status" + +{% enditemplate %} + +Sync Assets + +AssetID | AssetName +--- | --- | --- | +0 | MASTERNODE_SYNC_INITIAL +1 | MASTERNODE_SYNC_WAITING +2 | MASTERNODE_SYNC_LIST +3 | MASTERNODE_SYNC_MNW +4 | MASTERNODE_SYNC_GOVERNANCE +-1 | MASTERNODE_SYNC_FAILED +999 | MASTERNODE_SYNC_FINISHED + +*Example from Dash Core 0.12.2* + +Get Masternode sync status + +{% highlight bash %} +dash-cli -testnet mnsync status +{% endhighlight %} + +Result: +{% highlight json %} +{ + "AssetID": 999, + "AssetName": "MASTERNODE_SYNC_FINISHED", + "AssetStartTime": 1507662300, + "Attempt": 0, + "IsBlockchainSynced": true, + "IsMasternodeListSynced": true, + "IsWinnersListSynced": true, + "IsSynced": true, + "IsFailed": false +} +{% endhighlight %} + + +**Command Mode - `next`** + +*Result---next command return status* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "string" + p: "Required
(exactly 1)" + d: "Command return status" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +{% highlight bash %} +dash-cli -testnet mnsync next +{% endhighlight %} + +Result: +{% highlight text %} +sync updated to MASTERNODE_SYNC_LIST +{% endhighlight %} + + +**Command Mode - `reset`** + +*Result---reset command return status* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "string" + p: "Required
(exactly 1)" + d: "Command return status:
`success` or `failure`" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +{% highlight bash %} +dash-cli -testnet mnsync reset +{% endhighlight %} + +Result: +{% highlight text %} +success +{% endhighlight %} + +*See also:* + +* [Masternode][rpc masternode]: {{summary_masternode}} +* [MasternodeBroadcast][rpc masternodebroadcast]: {{summary_masternodeBroadcast}} +* [MasternodeList][rpc masternodelist]: {{summary_masternodeList}} + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/move.md b/_includes/devdoc/dash-core/rpcs/rpcs/move.md similarity index 97% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/move.md rename to _includes/devdoc/dash-core/rpcs/rpcs/move.md index 840853cd..9bb9a73c 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/move.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/move.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/move.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/move.md" %} ##### Move {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/ping.md b/_includes/devdoc/dash-core/rpcs/rpcs/ping.md similarity index 83% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/ping.md rename to _includes/devdoc/dash-core/rpcs/rpcs/ping.md index dc4fa8e0..ec915861 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/ping.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/ping.md @@ -2,12 +2,12 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/ping.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/ping.md" %} ##### Ping {#ping-rpc} {% include helpers/subhead-links.md %} -{% assign summary_ping-rpc="sends a P2P ping message to all connected nodes to measure ping time. Results are provided by the `getpeerinfo` RPC pingtime and pingwait fields as decimal seconds. The P2P `ping` message is handled in a queue with all other commands, so it measures processing backlog, not just network ping." %} +{% assign summary_ping-rpc="sends a P2P ping message to all connected nodes to measure ping time. Results are provided by the `getpeerinfo` RPC pingtime and pingwait fields as decimal seconds. The P2P `ping` message is handled in a queue with all other commands, so it measures processing backlog, not just network ping." %} {% autocrossref %} @@ -25,10 +25,10 @@ The `ping` RPC {{summary_ping-rpc}} {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli -testnet ping +dash-cli -testnet ping {% endhighlight %} (Success: no result printed.) @@ -36,7 +36,7 @@ bitcoin-cli -testnet ping Get the results using the `getpeerinfo` RPC: {% highlight bash %} -bitcoin-cli -testnet getpeerinfo | grep ping +dash-cli -testnet getpeerinfo | grep ping {% endhighlight %} Results: diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/preciousblock.md b/_includes/devdoc/dash-core/rpcs/rpcs/preciousblock.md similarity index 88% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/preciousblock.md rename to _includes/devdoc/dash-core/rpcs/rpcs/preciousblock.md index c212ed80..3c0d25f3 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/preciousblock.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/preciousblock.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/preciousblock.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/preciousblock.md" %} ##### PreciousBlock {% include helpers/subhead-links.md %} @@ -13,6 +13,10 @@ http://opensource.org/licenses/MIT. *Added in Bitcoin Core 0.14.0* +**_Not implemented in Dash Core (as of 0.12.2)_** + +{% comment %} + 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. *Parameter #1---the block hash* @@ -44,4 +48,6 @@ bitcoin-cli preciousblock 000000000000000001517a0bac70b8cd6f27ee\ Result (no output from `bitcoin-cli` because result is set to `null`). +{% endcomment %} + {% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/prioritisetransaction.md b/_includes/devdoc/dash-core/rpcs/rpcs/prioritisetransaction.md similarity index 81% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/prioritisetransaction.md rename to _includes/devdoc/dash-core/rpcs/rpcs/prioritisetransaction.md index 9eadb854..13736a78 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/prioritisetransaction.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/prioritisetransaction.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/prioritisetransaction.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/prioritisetransaction.md" %} ##### PrioritiseTransaction {% include helpers/subhead-links.md %} @@ -39,7 +39,7 @@ The `prioritisetransaction` RPC {{summary_prioritiseTransaction}} - n: "Fee" t: "number (int)" p: "Required
(exactly 1)" - d: "**Warning:** this value is in satoshis, not bitcoins

If positive, the virtual fee to add to the actual fee paid by the transaction; if negative, the virtual fee to subtract from the actual fee paid by the transaction. No change is made to the actual fee paid by the transaction" + d: "**Warning:** this value is in duffs, not Dash

If positive, the virtual fee to add to the actual fee paid by the transaction; if negative, the virtual fee to subtract from the actual fee paid by the transaction. No change is made to the actual fee paid by the transaction" {% enditemplate %} @@ -53,11 +53,11 @@ The `prioritisetransaction` RPC {{summary_prioritiseTransaction}} {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli -testnet prioritisetransaction \ - fe0165147da737e16f5096ab6c1709825217377a95a882023ed089a89af4cff9 \ +dash-cli -testnet prioritisetransaction \ + f86c74f27fdd9c7e618d69b3606eeae1710b3f02fabede6ae8c88dd7bb756942 \ 1234 456789 {% endhighlight %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/privatesend.md b/_includes/devdoc/dash-core/rpcs/rpcs/privatesend.md new file mode 100644 index 00000000..ff886173 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/privatesend.md @@ -0,0 +1,97 @@ +{% 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/privatesend.md" %} + +##### PrivateSend +{% include helpers/subhead-links.md %} + +{% assign summary_privateSend="controls the mixing process." %} + +{% autocrossref %} + +The `privatesend` RPC {{summary_privateSend}} + +{% itemplate ntpd1 %} +- n: "`mode`" + t: "string" + p: "Required
(exactly 1)" + d: "The command mode to use:
`start` - Start mixing
`stop` - Stop mixing
`reset` - Reset mixing" + +{% enditemplate %} + +**Command Mode - `start`** + +*Result---start command return status* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "string" + p: "Required
(exactly 1)" + d: "Command return status" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +{% highlight bash %} +dash-cli -testnet privatesend start +{% endhighlight %} + +Result: +{% highlight text %} +Mixing started successfully +{% endhighlight %} + + +**Command Mode - `stop`** + +*Result---stop command return status* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "string" + p: "Required
(exactly 1)" + d: "Command return status" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +{% highlight bash %} +dash-cli -testnet privatesend stop +{% endhighlight %} + +Result: +{% highlight text %} +Mixing was stopped +{% endhighlight %} + + +**Command Mode - `reset`** + +*Result---reset command return status* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "string" + p: "Required
(exactly 1)" + d: "Command return status" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +{% highlight bash %} +dash-cli -testnet privatesend reset +{% endhighlight %} + +Result: +{% highlight text %} +Mixing was reset +{% endhighlight %} + +*See also: none* + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/pruneblockchain.md b/_includes/devdoc/dash-core/rpcs/rpcs/pruneblockchain.md similarity index 88% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/pruneblockchain.md rename to _includes/devdoc/dash-core/rpcs/rpcs/pruneblockchain.md index c178f3fb..6fec51d4 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/pruneblockchain.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/pruneblockchain.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/pruneblockchain.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/pruneblockchain.md" %} ##### PruneBlockChain {% include helpers/subhead-links.md %} @@ -13,6 +13,10 @@ http://opensource.org/licenses/MIT. *Added in Bitcoin Core 0.14.0* +**_Not implemented in Dash Core (as of 0.12.2)_** + +{% comment %} + The `pruneblockchain` RPC {{summary_pruneBlockChain}} The `-prune` option needs to be enabled (disabled by default). *Parameter #1---the block height or timestamp* @@ -51,4 +55,6 @@ Result: * [ImportPrunedFunds][rpc importprunedfunds]: {{summary_importPrunedFunds}} +{% endcomment %} + {% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/removeprunedfunds.md b/_includes/devdoc/dash-core/rpcs/rpcs/removeprunedfunds.md similarity index 94% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/removeprunedfunds.md rename to _includes/devdoc/dash-core/rpcs/rpcs/removeprunedfunds.md index 77f3f0de..94b8edd2 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/removeprunedfunds.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/removeprunedfunds.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/removeprunedfunds.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/removeprunedfunds.md" %} ##### RemovePrunedFunds {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/sendfrom.md b/_includes/devdoc/dash-core/rpcs/rpcs/sendfrom.md similarity index 97% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/sendfrom.md rename to _includes/devdoc/dash-core/rpcs/rpcs/sendfrom.md index b92106e3..2eaa73cb 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/sendfrom.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/sendfrom.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/sendfrom.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/sendfrom.md" %} ##### SendFrom {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/sendmany.md b/_includes/devdoc/dash-core/rpcs/rpcs/sendmany.md similarity index 97% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/sendmany.md rename to _includes/devdoc/dash-core/rpcs/rpcs/sendmany.md index f5a9a624..8358e0e3 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/sendmany.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/sendmany.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/sendmany.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/sendmany.md" %} ##### SendMany {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/sendrawtransaction.md b/_includes/devdoc/dash-core/rpcs/rpcs/sendrawtransaction.md similarity index 96% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/sendrawtransaction.md rename to _includes/devdoc/dash-core/rpcs/rpcs/sendrawtransaction.md index 26e7375a..4b50560b 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/sendrawtransaction.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/sendrawtransaction.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/sendrawtransaction.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/sendrawtransaction.md" %} ##### SendRawTransaction {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/sendtoaddress.md b/_includes/devdoc/dash-core/rpcs/rpcs/sendtoaddress.md similarity index 96% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/sendtoaddress.md rename to _includes/devdoc/dash-core/rpcs/rpcs/sendtoaddress.md index 5686c062..ead7971a 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/sendtoaddress.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/sendtoaddress.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/sendtoaddress.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/sendtoaddress.md" %} ##### SendToAddress {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/setaccount.md b/_includes/devdoc/dash-core/rpcs/rpcs/setaccount.md similarity index 95% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/setaccount.md rename to _includes/devdoc/dash-core/rpcs/rpcs/setaccount.md index 1a0c5329..c6f387ab 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/setaccount.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/setaccount.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/setaccount.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/setaccount.md" %} ##### SetAccount {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/setban.md b/_includes/devdoc/dash-core/rpcs/rpcs/setban.md similarity index 79% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/setban.md rename to _includes/devdoc/dash-core/rpcs/rpcs/setban.md index e7f26d12..62c787c3 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/setban.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/setban.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/setban.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/setban.md" %} ##### SetBan {% include helpers/subhead-links.md %} @@ -31,7 +31,7 @@ The `setban` RPC {{summary_setBan}} - n: "Command" t: "string" p: "Required
(exactly 1)" - d: "What to do with the IP/Subnet address above. Options are:
• `add` to add a node to the addnode list
• `remove` to remove a node from the list. If currently connected, this will disconnect immediately" + d: "What to do with the IP/Subnet address above. Options are:
• `add` to add a node to the addnode list
• `remove` to remove a node from the list. If currently connected, this will disconnect immediately" {% enditemplate %} @@ -65,15 +65,15 @@ The `setban` RPC {{summary_setBan}} {% enditemplate %} -*Example from Bitcoin Core 0.12.1* +*Example from Dash Core 0.12.2* Ban the following node. {% highlight bash %} -bitcoin-cli -testnet setban 192.0.2.113:18333 add 2592000 +dash-cli -testnet setban 192.0.2.113 add 2592000 {% endhighlight %} -Result (no output from `bitcoin-cli` because result is set to `null`). +Result (no output from `dash-cli` because result is set to `null`). *See also* diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/setgenerate.md b/_includes/devdoc/dash-core/rpcs/rpcs/setgenerate.md new file mode 100644 index 00000000..7b8bcdf4 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/setgenerate.md @@ -0,0 +1,69 @@ +{% 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/setgenerate.md" %} + +##### SetGenerate +{% include helpers/subhead-links.md %} + +{% assign summary_setGenerate="enables or disables hashing to attempt to find the next block." %} + +{% autocrossref %} + +*Requires wallet support.* + +*Removed in Bitcoin Core 0.13.0.* + +The `setgenerate` RPC {{summary_setGenerate}} + +*Parameter #1---enable/disable generation* + +{% itemplate ntpd1 %} +- n: "`generate`" + t: "boolean" + p: "Required
(exactly 1)" + d: "Set to true to turn on generation, false to turn off." + +{% enditemplate %} + +*Parameter #2---processor limit* + +{% itemplate ntpd1 %} +- n: "`genproclimit`" + t: "number (int)" + p: "Optional
(exactly 1)" + d: "Set the processor limit for when generation is on. Can be -1 for unlimited." + +{% enditemplate %} + +*Result---the generated block header hashes* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "null" + p: "Required
(exactly 1)" + d: "Always JSON `null`" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +Enable generation using 1 processor: + +{% highlight bash %} +dash-cli -testnet setgenerate 1 +{% endhighlight %} + +Result: + +(Success: no result displayed. Process manager shows 100% CPU usage.) + +*See also* + +* [Generate][rpc generate]: {{summary_generate}} +* [GenerateToAddress][rpc generatetoaddress]: {{summary_generateToAddress}} +* [GetMiningInfo][rpc getmininginfo]: {{summary_getMiningInfo}} +* [GetBlockTemplate][rpc getblocktemplate]: {{summary_getBlockTemplate}} + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/setnetworkactive.md b/_includes/devdoc/dash-core/rpcs/rpcs/setnetworkactive.md similarity index 82% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/setnetworkactive.md rename to _includes/devdoc/dash-core/rpcs/rpcs/setnetworkactive.md index 63de5441..5384eef9 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/setnetworkactive.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/setnetworkactive.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/setnetworkactive.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/setnetworkactive.md" %} ##### SetNetworkActive {% include helpers/subhead-links.md %} @@ -35,13 +35,13 @@ The `setnetworkactive` RPC {{summary_setNetworkActive}} {% enditemplate %} -*Example from Bitcoin Core 0.14.1* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli setnetworkactive true +dash-cli setnetworkactive true {% endhighlight %} -Result (no output from `bitcoin-cli` because result is set to `null`). +Result (no output from `dash-cli` because result is set to `null`). *See also* diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/settxfee.md b/_includes/devdoc/dash-core/rpcs/rpcs/settxfee.md similarity index 94% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/settxfee.md rename to _includes/devdoc/dash-core/rpcs/rpcs/settxfee.md index 0c533845..b5a603af 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/settxfee.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/settxfee.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/settxfee.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/settxfee.md" %} ##### SetTxFee {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/signmessage.md b/_includes/devdoc/dash-core/rpcs/rpcs/signmessage.md similarity index 94% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/signmessage.md rename to _includes/devdoc/dash-core/rpcs/rpcs/signmessage.md index a98da7a2..5368afc1 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/signmessage.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/signmessage.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/signmessage.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/signmessage.md" %} ##### SignMessage {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/signmessagewithprivkey.md b/_includes/devdoc/dash-core/rpcs/rpcs/signmessagewithprivkey.md similarity index 93% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/signmessagewithprivkey.md rename to _includes/devdoc/dash-core/rpcs/rpcs/signmessagewithprivkey.md index f2fc23e5..c232fd4e 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/signmessagewithprivkey.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/signmessagewithprivkey.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/signmessagewithprivkey.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/signmessagewithprivkey.md" %} ##### SignMessageWithPrivKey {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/signrawtransaction.md b/_includes/devdoc/dash-core/rpcs/rpcs/signrawtransaction.md similarity index 98% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/signrawtransaction.md rename to _includes/devdoc/dash-core/rpcs/rpcs/signrawtransaction.md index aa86e1f2..d9bdf26b 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/signrawtransaction.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/signrawtransaction.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/signrawtransaction.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/signrawtransaction.md" %} ##### SignRawTransaction {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/spork.md b/_includes/devdoc/dash-core/rpcs/rpcs/spork.md new file mode 100644 index 00000000..2a8d6939 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/spork.md @@ -0,0 +1,27 @@ +{% 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/spork.md" %} + +##### Spork {#spork-rpc} +{% include helpers/subhead-links.md %} + +{% assign summary_spork-rpc="" %} + +{% autocrossref %} + +The `spork` RPC {{summary_spork-rpc}} + +{% highlight bash %} +dash-cli -testnet spork +{% endhighlight %} + +Result: +{% highlight json %} + *INSERT RESULTS HERE* +{% endhighlight %} + +*See also:* + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/stop.md b/_includes/devdoc/dash-core/rpcs/rpcs/stop.md similarity index 66% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/stop.md rename to _includes/devdoc/dash-core/rpcs/rpcs/stop.md index c6a92204..472aa565 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/stop.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/stop.md @@ -2,12 +2,12 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/stop.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/stop.md" %} ##### Stop {% include helpers/subhead-links.md %} -{% assign summary_stop="safely shuts down the Bitcoin Core server." %} +{% assign summary_stop="safely shuts down the Dash Core server." %} {% autocrossref %} @@ -21,20 +21,20 @@ The `stop` RPC {{summary_stop}} - n: "`result`" t: "string" p: "Required
(exactly 1)" - d: "The string \"Bitcoin server stopping\"" + d: "The string \"Dash Core server stopping\"" {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* {% highlight bash %} -bitcoin-cli -testnet stop +dash-cli -testnet stop {% endhighlight %} Result: {% highlight text %} -Bitcoin server stopping +Dash Core server stopping {% endhighlight %} *See also: none* diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/submitblock.md b/_includes/devdoc/dash-core/rpcs/rpcs/submitblock.md new file mode 100644 index 00000000..66d1f188 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/submitblock.md @@ -0,0 +1,80 @@ +{% 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/submitblock.md" %} + +##### SubmitBlock +{% include helpers/subhead-links.md %} + +{% assign summary_submitBlock="accepts a block, verifies it is a valid addition to the block chain, and broadcasts it to the network. Extra parameters are ignored by Dash Core but may be used by mining pools or other programs." %} + +{% autocrossref %} + +The `submitblock` RPC {{summary_submitBlock}} + +*Parameter #1---the new block in serialized block format as hex* + +{% itemplate ntpd1 %} +- n: "Block" + t: "string (hex)" + p: "Required
(exactly 1)" + d: "The full block to submit in serialized block format as hex" + +{% enditemplate %} + +*Parameter #2---additional parameters* + +{% itemplate ntpd1 %} +- n: "Parameters" + t: "object" + p: "Optional
(0 or 1)" + d: "A JSON object containing extra parameters. Not used directly by Dash Core and also not broadcast to the network. This is available for use by mining pools and other software. A common parameter is a `workid` string" + +{% enditemplate %} + +*Result---`null` or error string* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "null/string" + p: "Required
(exactly 1)" + d: "If the block submission succeeded, set to JSON `null`. If submission failed, set to one of the following strings: `duplicate`, `duplicate-invalid`, `inconclusive`, or `rejected`. The JSON-RPC `error` field will still be set to `null` if submission failed for one of these reasons" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +Submit the following block with the workid, "test". + +{% highlight bash %} +dash-cli -testnet submitblock 0100002032e3965d5fdd7a883209d516599337eb4cb82f\ + 7aea22ecc114942c1f00000000244388a3bd2c38a85bf337755a1a165d0df2b335e3886058\ + 40e08a3cdf1ce1a4297ede598f6a011d027c1c300201000000010000000000000000000000\ + 000000000000000000000000000000000000000000ffffffff1202791f0e2f5032506f6f6c\ + 2d74444153482fffffffff044d75bb8b010000001976a914d4a5ea2641e9dd37f7a5ad5c92\ + 9df4743518769188acac2ea68f010000001976a9148d0934de58f969df3b53a72b4f47211d\ + 890ebf5588ac68b9ea03000000004341047559d13c3f81b1fadbd8dd03e4b5a1c73b05e2b9\ + 80e00d467aa9440b29c7de23664dde6428d75cafed22ae4f0d302e26c5c5a5dd4d3e1b796d\ + 7281bdc9430f35ac00000000000000002a6a28f47e935509fc85533dc78197e93e87d1c793\ + 43bda495429d8e3680069f6a22780000000002000000000000000100000001078e0c77e3b0\ + 4323d0834841f965543aaae2b275f684f55fbaf22e1c83bff97e010000006a473044022077\ + 6e96d202cc4f50f79d269d7cd36712c7486282dda0cb6eae583c916c98b34c022070941efb\ + 3201cf500cc6b879d6570fc477d4c3e6a8d91286e84465235f542c42012102dddbfc3fe06b\ + 96e3a36f3e815222cd1cb9586b3193c4a0de030477f621956d51feffffff02a00bd1000000\ + 00001976a914d7b47d4b40a23c389f5a17754d7f60f511c7d0ec88ac316168821300000019\ + 76a914c9190e507834b78a624d7578f1ad3819592ca1aa88ac771f0000 \ + '{ "workid": "test" }' +{% endhighlight %} + +Result (the block above was already on a local block chain): + +{% highlight text %} +duplicate +{% endhighlight %} + +*See also* + +* [GetBlockTemplate][rpc getblocktemplate]: {{summary_getBlockTemplate}} + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/validateaddress.md b/_includes/devdoc/dash-core/rpcs/rpcs/validateaddress.md similarity index 98% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/validateaddress.md rename to _includes/devdoc/dash-core/rpcs/rpcs/validateaddress.md index e2c65e53..69ec5e02 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/validateaddress.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/validateaddress.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/validateaddress.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/validateaddress.md" %} ##### ValidateAddress {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/verifychain.md b/_includes/devdoc/dash-core/rpcs/rpcs/verifychain.md similarity index 85% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/verifychain.md rename to _includes/devdoc/dash-core/rpcs/rpcs/verifychain.md index bc904469..0661214b 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/verifychain.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/verifychain.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/verifychain.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/verifychain.md" %} ##### VerifyChain {% include helpers/subhead-links.md %} @@ -43,16 +43,15 @@ The `verifychain` RPC {{summary_verifyChain}} {% enditemplate %} -*Example from Bitcoin Core 0.10.0* +*Example from Dash Core 0.12.2* -Verify the most recent 10,000 blocks in the most through way: +Verify the most recent 400 blocks in the most through way: {% highlight bash %} -bitcoin-cli -testnet verifychain 4 10000 +dash-cli -testnet verifychain 4 400 {% endhighlight %} -Result (took 4 minutes and 25 seconds on a generic PC laptop; it -would've taken much longer on mainnet): +Result (took < 1 second on a mobile workstation; it would've taken much longer on mainnet): {% highlight json %} true diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/verifymessage.md b/_includes/devdoc/dash-core/rpcs/rpcs/verifymessage.md similarity index 96% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/verifymessage.md rename to _includes/devdoc/dash-core/rpcs/rpcs/verifymessage.md index c917e837..032a3adf 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/verifymessage.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/verifymessage.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/verifymessage.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/verifymessage.md" %} ##### VerifyMessage {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/verifytxoutproof.md b/_includes/devdoc/dash-core/rpcs/rpcs/verifytxoutproof.md new file mode 100644 index 00000000..15f90bfc --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/verifytxoutproof.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/verifytxoutproof.md" %} + +##### VerifyTxOutProof +{% include helpers/subhead-links.md %} + +{% assign summary_verifyTxOutProof="verifies that a proof points to one or more transactions in a block, returning the transactions the proof commits to and throwing an RPC error if the block is not in our best block chain." %} + +{% autocrossref %} + +The `verifytxoutproof` RPC {{summary_verifyTxOutProof}} + +*Parameter #1---The hex-encoded proof generated by gettxoutproof* + +{% itemplate ntpd1 %} +- n: "`proof`" + t: "string" + p: "Required" + d: "A hex-encoded proof" + +{% enditemplate %} + +*Result---txid(s) which the proof commits to* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "string" + p: "Required
(exactly 1)" + d: "The txid(s) which the proof commits to, or empty array if the proof is invalid" + +{% enditemplate %} + +*Example from Dash Core 0.12.2* + +Verify a proof: + +{% highlight bash %} +dash-cli verifytxoutproof \ +01000020ed72cc6a7294782a7711d8fa7ef74716ef062dc50bb0820f7eec923801000000\ +aa5d17c5128043803b67c7ab03e4d3ffbc9604b54f877f1c5cf9ed3adeaa19b2cd7ed659\ +f838011d10a70a480200000002033c89c2baecba9fc983c85dcf365c2d9cc93aca1dee2e\ +5ac18124464056542e8faab0c579e651e9438c2904df5a498bc37a37acd528a251386fde\ +f0476ba0e00105 +{% endhighlight %} + +Result: + +{% highlight json %} +[ +"e0a06b47f0de6f3851a228d5ac377ac38b495adf04298c43e951e679c5b0aa8f" +] +{% endhighlight %} + +*See also* + +* [GetTxOutProof][rpc gettxoutproof]: {{summary_getTxOutProof}} +* [`merkleblock` message][merkleblock message]: A description of the + format used for the proof. + +{% endautocrossref %} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/voteraw.md b/_includes/devdoc/dash-core/rpcs/rpcs/voteraw.md new file mode 100644 index 00000000..9c70f895 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/voteraw.md @@ -0,0 +1,27 @@ +{% 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/voteraw.md" %} + +##### VoteRaw +{% include helpers/subhead-links.md %} + +{% assign summary_voteRaw="" %} + +{% autocrossref %} + +The `voteraw` RPC {{summary_voteRaw}} + +{% highlight bash %} +dash-cli -testnet voteraw +{% endhighlight %} + +Result: +{% highlight json %} + *INSERT RESULTS HERE* +{% endhighlight %} + +*See also:* + +{% endautocrossref %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/walletlock.md b/_includes/devdoc/dash-core/rpcs/rpcs/walletlock.md similarity index 93% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/walletlock.md rename to _includes/devdoc/dash-core/rpcs/rpcs/walletlock.md index 1e5b3f44..b09b0af0 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/walletlock.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/walletlock.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/walletlock.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/walletlock.md" %} ##### WalletLock {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/walletpassphrase.md b/_includes/devdoc/dash-core/rpcs/rpcs/walletpassphrase.md similarity index 95% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/walletpassphrase.md rename to _includes/devdoc/dash-core/rpcs/rpcs/walletpassphrase.md index e3383f51..c91a51cf 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/walletpassphrase.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/walletpassphrase.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/walletpassphrase.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/walletpassphrase.md" %} ##### WalletPassphrase {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/bitcoin-core/rpcs/rpcs/walletpassphrasechange.md b/_includes/devdoc/dash-core/rpcs/rpcs/walletpassphrasechange.md similarity index 94% rename from _includes/devdoc/bitcoin-core/rpcs/rpcs/walletpassphrasechange.md rename to _includes/devdoc/dash-core/rpcs/rpcs/walletpassphrasechange.md index 896bfc6d..fab335a7 100644 --- a/_includes/devdoc/bitcoin-core/rpcs/rpcs/walletpassphrasechange.md +++ b/_includes/devdoc/dash-core/rpcs/rpcs/walletpassphrasechange.md @@ -2,7 +2,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} -{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/walletpassphrasechange.md" %} +{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/walletpassphrasechange.md" %} ##### WalletPassphraseChange {% include helpers/subhead-links.md %} diff --git a/_includes/devdoc/fragment_reviews_needed.md b/_includes/devdoc/fragment_reviews_needed.md index f9326297..23f90ef6 100644 --- a/_includes/devdoc/fragment_reviews_needed.md +++ b/_includes/devdoc/fragment_reviews_needed.md @@ -5,7 +5,7 @@ http://opensource.org/licenses/MIT.
-BETA: This documentation has not been extensively reviewed by Bitcoin experts and so likely contains numerous errors. Please use the Issue and Edit links on the bottom left menu to help us improve. Click here to close this disclaimer. +BETA: This documentation has not been extensively reviewed by Dash experts and so likely contains numerous errors. Please use the Issue and Edit links on the bottom left menu to help us improve. Click here to close this disclaimer. X
diff --git a/_includes/devdoc/guide_p2p_network.md b/_includes/devdoc/guide_p2p_network.md index 45f78bb9..0890c33c 100644 --- a/_includes/devdoc/guide_p2p_network.md +++ b/_includes/devdoc/guide_p2p_network.md @@ -587,3 +587,123 @@ Take note that for both types of broadcasting, mechanisms are in place to punish Earlier versions of Bitcoin Core allowed developers and trusted community members to issue [Bitcoin alerts](https://bitcoin.org/en/alerts) to notify users of critical network-wide issues. This messaging system [was retired](https://bitcoin.org/en/alert/2016-11-01-alert-retirement) in Bitcoin Core v0.13.0; however, internal alerts, partition detection warnings and the `-alertnotify` option features remain. {% endautocrossref %} + + +### Masternode Payment + +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +Masternode payment uses a verifiable process to determine which masternode is +paid in each block. When a new block is processed, a quorum of +`MNPAYMENTS_SIGNATURES_TOTAL` (10) masternodes vote on the next masternode +payee. Each member of the quorum issues a 'mnw' message that is relayed to the +network. + +{% endautocrossref %} + +### Masternode Sync + +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +Dash Core performs masternode synchronization as required, but it can be started +manually by issuing the `mnsync reset` RPC command. + +*Masternode Sync Data Flow* + +| **Syncing Node Message** | **Direction** | **Masternode Response** | **Description** | +| **1. Sporks** | | | | +| `getsporks` message | → | | Syncing node requests sporks +| | ← | `spork` message(s) | +| **2. Masternode List** | | | Sync Masternode list from other connected clients | +| `dseg` message | → | | Syncing node requests masternode list +| | ← | `ssc` message | Number of entries in masternode list (MASTERNODE_SYNC_LIST)

Only sent if requesting entire list +| | ← | `inv` message(s) (mnb) | MSG_MASTERNODE_ANNOUNCE +| | ← | `inv` message(s) (mnp) | MSG_MASTERNODE_PING +| `getdata` message(s) (mnb) | → | | (Optional) +| `getdata` message(s) (mnp) | → | | (Optional) +| | ← | `mnb` message(s) | (If requested) Masternode announce message +| | ← | `mnp` message(s) | (If requested) Masternode ping message +| **3. Masternode payments** | | | Ask node for all payment votes it has (new nodes will only return votes for future payments) | +| `mnget` message | → | | Syncing node requests masternode payment sync +| | ← | `ssc` message | Number of entries in masternode payment list +| | ← | `inv` message(s) (mnw) | MSG_MASTERNODE_PAYMENT_VOTE +| `getdata` message(s) (mnw) | → | | (Optional) +| | ← | `mnw` message(s) | (If requested) Masternode payment vote message +| **4. Governance** | | | See [Governance sync](#governance) | + +{% endautocrossref %} + + +### Governance + +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +#### Synchronization + +Dash Core synchronizes the governance system via the Masternode network as the +last stage of the Masternode sync process (following the sync of sporks, the +Masternode list, and Masternode payments). + +The `govsync` message initiates a sync of the governance system. Masternodes +ignore this request if they are not fully synced. + +There are two distinct stages of governance sync: + +1. Initial request (object sync) - requests the governance objects only via a +`govsync` message sent with a hash of all zeros. + +2. Follow up request(s) (vote sync) - request governance object votes for a +specific object via a `govsync` message containing the hash of the object. One +message is required for each object. Dash Core periodically (~ every 6 seconds) +sends messages to connected nodes until all the governance objects have been +synchronized. + +{% highlight text %} +Dash Core limits how frequently the first type of sync (object sync) can be +requested. Frequent requests will result in the node being banned. +{% endhighlight %} + + +Masternodes respond to the `govsync` message with several items: + +* First, the Masternode sends one `ssc` message (Sync Status Count) for `govobj` +objects and one for `govobjvote` objects. These messages indicate how many +inventory items will be sent. + +* Second, the Masternode sends `inv` messages for the `govobj` and `govobjvote` +objects. + +Once the syncing node receives the counts and inventories, it may request any +`govobj` and `govobjvote` objects from the masternode via a `getdata` message. + + +*Governance Sync Data Flow* + +| **Syncing Node Message** | **Direction** | **Masternode Response** | **Description** | +| **Inital request** | | | **Requests all governance objects (without votes)** | +| `govsync` message | → | | Syncing node initiates governance sync (hash set to all zeros) +| | ← | `ssc` message (govobj) | Number of governance objects (0 or more) +| | ← | `ssc` message (govobjvote)| Number of governance object votes *(0 since votes are only returned if a specific hash is provided with the `govsync` message)* +| | ← | `inv` message (govobj) | Governance object inventories +| `getdata` message (govobj) | → | | (Optional) Syncing node requests govobj +| | ← | `govobj` message | (If requested) Governance object +| | | | | +| **Follow up requests** | | | **Requests governance object (with votes)** | +| `govsync` message | → | | Syncing node requests governance sync for a specific governance object +| | ← | `ssc` message (govobj) | Number of governance objects (1) +| | ← | `ssc` message (govobjvote)| Number of governance object votes (0 or more) +| | ← | `inv` message (govobj) | Governance object inventory +| | ← | `inv` message (govobjvote)| Governance object vote inventories +| `getdata` message (govobj) | → | | (Optional) Syncing node requests govobj +| | ← | `govobj` message | (If requested) Governance object +| `getdata` message (govobjvote) | → | | (Optional) Syncing node requests govobjvote +| | ← | `govobjvote` message | (If requested) Governance object vote + + +{% endautocrossref %} diff --git a/_includes/devdoc/ref_block_chain.md b/_includes/devdoc/ref_block_chain.md index 2db7583d..f450e947 100644 --- a/_includes/devdoc/ref_block_chain.md +++ b/_includes/devdoc/ref_block_chain.md @@ -15,13 +15,13 @@ The following subsections briefly document core block details. {% autocrossref %} Block headers are serialized in the 80-byte format described below and then -hashed as part of Bitcoin's proof-of-work algorithm, making the +hashed as part of the proof-of-work algorithm, making the serialized header format part of the consensus rules. | Bytes | Name | Data Type | Description |-------|---------------------|-----------|---------------- | 4 | version | int32_t | The [block version][/en/glossary/block]{:#term-block-version}{:.term} number indicates which set of block validation rules to follow. See the list of block versions below. -| 32 | [previous block header hash][]{:#term-previous-block-header-hash}{:.term} | char[32] | A SHA256(SHA256()) hash in internal byte order of the previous block's header. This ensures no previous block can be changed without also changing this block's header. +| 32 | [previous block header hash][]{:#term-previous-block-header-hash}{:.term} | char[32] | An X11() hash in internal byte order of the previous block's header. This ensures no previous block can be changed without also changing this block's header. | 32 | merkle root hash | char[32] | A SHA256(SHA256()) hash in internal byte order. The merkle root is derived from the hashes of all transactions included in this block, ensuring that none of those transactions can be modified without modifying the header. See the [merkle trees section][section merkle trees] below. | 4 | time | uint32_t | The block time is a Unix epoch time when the miner started hashing the header (according to the miner). Must be strictly greater than the median time of the previous 11 blocks. Full nodes will not accept blocks with headers more than two hours in the future according to their clock. | 4 | nBits | uint32_t | An encoded version of the target threshold this block's header hash must be less than or equal to. See the nBits format described below. @@ -52,32 +52,41 @@ fe9f0864 ........................... Nonce {% autocrossref %} -* **Version 1** was introduced in the genesis block (January 2009). +* **Version 1** was used by Dash for the Genesis Block only. -* **[Version 2][v2 block]{:#term-v2-block}{:.term}** was introduced in - Bitcoin Core 0.7.0 (September 2012) as a soft fork. As described in +* **[Version 2][v2 block]{:#term-v2-block}{:.term}** was introduced with + the first block following the Genesis Block (January 2014). As described in BIP34, valid version 2 blocks require a [block height parameter in the - coinbase][coinbase block height]. Also described in BIP34 are rules + coinbase][coinbase block height]. + + +--> -* **Version 3** blocks were introduced in Bitcoin Core 0.10.0 (February - 2015) as a soft fork. When the fork reach full enforcement (July - 2015), it required strict DER encoding of all ECDSA signatures in new - blocks as described in BIP66. Transactions that do not use strict DER - encoding had previously been non-standard since Bitcoin Core 0.8.0 - (February 2012). +* **Version 3** blocks were introduced in Dash Core 0.11.2 (March 2015) as a + soft fork (Block 244,834 was the first version 3 block). + + When the fork reach full enforcement, it required strict DER encoding of all + ECDSA signatures in new blocks as described in BIP66. Transactions that do not + use strict DER encoding had previously been non-standard since Dash Core 0.8.0. -* **Version 4** blocks specified in BIP65 and introduced in Bitcoin Core 0.11.2 - (November 2015) as a soft fork became active in December 2015. These blocks now support the new - `OP_CHECKLOCKTIMEVERIFY` opcode described in that BIP. +* **Version 4** blocks specified in BIP65 and introduced in Bitcoin Core 0.11.2 + (November 2015) as a soft fork became active in December 2015. These blocks + now support the new `OP_CHECKLOCKTIMEVERIFY` opcode described in that BIP. + The mechanism used for the version 2, 3, and 4 upgrades is commonly -called IsSuperMajority() after the function added to Bitcoin Core to +called IsSuperMajority() after the function added to Dash Core to manage those soft forking changes. See BIP34 for a full description of this method. @@ -159,10 +168,10 @@ you might parse a decimal number in base-10 scientific notation: ![Quickly Converting nBits](/img/dev/en-nbits-quick-parse.svg) - Although the target threshold should be an unsigned integer, the @@ -170,20 +179,20 @@ original nBits implementation inherits properties from a signed data class, allowing the target threshold to be negative if the high bit of the significand is set. This is useless---the header hash is treated as an unsigned number, so it can never be equal to or lower than a -negative target threshold. Bitcoin Core deals with this in two ways: +negative target threshold. Dash Core deals with this in two ways: - + -* When parsing nBits, Bitcoin Core converts a negative target +* When parsing nBits, Dash Core converts a negative target threshold into a target of zero, which the header hash can equal (in theory, at least). -* When creating a value for nBits, Bitcoin Core checks to see if it will +* When creating a value for nBits, Dash Core checks to see if it will produce an nBits which will be interpreted as negative; if so, it divides the significand by 256 and increases the exponent by 1 to produce the same number with a different encoding. -Some examples taken from the Bitcoin Core test cases: +Some examples taken from the Dash Core test cases: | nBits | Target | Notes |------------|------------------|---------------- @@ -195,7 +204,7 @@ Some examples taken from the Bitcoin Core test cases: | 0x04123456 |  0x12345600 | Inverse of above; no high bit. Difficulty 1, the minimum allowed difficulty, is represented on mainnet -and the current testnet by the nBits value 0x1d00ffff. Regtest mode uses +and the current testnet by the nBits value 0x1e0ffff0. Regtest mode uses a different difficulty 1 value---0x207fffff, the highest possible value below uint32_max which can be encoded; this allows near-instant building of blocks in regtest mode. @@ -221,16 +230,26 @@ The first transaction in a block must be a [coinbase transaction][/en/glossary/coinbase-transaction]{:#term-coinbase-tx}{:.term} which should collect and spend any transaction fees paid by transactions included in this block. -All blocks with a block height less than 6,930,000 are entitled to -receive a block subsidy of newly created bitcoin value, which also -should be spent in the coinbase transaction. (The block subsidy started -at 50 bitcoins and is being halved every 210,000 blocks---approximately -once every four years. As of November 2014, it's 25 bitcoins.) +Until the coin limit (~18 million Dash) is hit, all blocks are entitled to +receive a block subsidy of newly created Dash value. The newly created value +should be spent in the coinbase transaction. + +The block subsidy declines by ~7.1% per year until all Dash is mined. +Subsidy calculations are performed by the Dash Core [GetBlockSubsidy()][block subsidy] +function. Together, the transaction fees and block subsidy are called the [block reward][/en/glossary/block-reward]{:#term-block-reward}{:.term}. A coinbase transaction is invalid if it tries to spend more value than is available from the block reward. -{% endautocrossref %} +The block reward is divided into three parts: Miners, Masternodes, and +Superblocks. +| Payee | Subsidy | Description | +| ----- | -------- | ----------- | +| Miner | 45% | Payment for mining +| Masternode | 45% | Payment for masternode services (PrivateSend, InstantSend, Governance, etc.) +| Superblock | 10% | Payment for maintenance/expansion of the ecosystem (Core development, marketing, integration, etc.) + +{% endautocrossref %} diff --git a/_includes/devdoc/ref_intro.md b/_includes/devdoc/ref_intro.md index 16b80ad3..0e69abd6 100644 --- a/_includes/devdoc/ref_intro.md +++ b/_includes/devdoc/ref_intro.md @@ -7,16 +7,15 @@ http://opensource.org/licenses/MIT. {% autocrossref %} The Developer Reference aims to provide technical details and API information -to help you start building Bitcoin-based applications, but it is [not a +to help you start building Dash-based applications, but it is [not a specification][]. To make the best use of -this documentation, you may want to install the current version of Bitcoin +this documentation, you may want to install the current version of Dash Core, either from [source][core git] or from a [pre-compiled executable][core executable]. -Questions about Bitcoin development are best asked in one of the -[Bitcoin development communities][dev communities]. +Questions about Dash development are best asked in one of the +[Dash development communities][dev communities]. Errors or suggestions related to -documentation on Bitcoin.org can be [submitted as an issue][docs issue] -or posted to the [bitcoin-documentation mailing list][]. +documentation on {Dash.org} can be [submitted as an issue][docs issue]. In the following documentation, some strings have been shortened or wrapped: "[...]" indicates extra data was removed, and lines ending in a single backslash "\\" @@ -32,18 +31,18 @@ definition of the term will be displayed in a tooltip. {% autocrossref %} -The Bitcoin.org Developer Documentation describes how Bitcoin works to -help educate new Bitcoin developers, but it is not a specification---and +The {Dash.org} Developer Documentation describes how Dash works to +help educate new Dash developers, but it is not a specification---and it never will be. -Bitcoin security depends on consensus. Should your program diverge from +Dash security depends on consensus. Should your program diverge from consensus, its security is weakened or destroyed. The cause of the divergence doesn't matter: it could be a bug in your program, it could be an [error in this documentation][errors in docs] which you implemented as described, or it could be you do everything right but other software on the network [behaves unexpectedly][v0.8 chain -fork]. The specific cause will not matter to the users of your software -whose wealth is lost. +fork] as in the case of Bitcoin's v0.8 chain fork. The specific cause +will not matter to the users of your software whose wealth is lost. The only correct specification of consensus behavior is the actual behavior of programs on the network which maintain consensus. As that @@ -51,15 +50,16 @@ behavior is subject to arbitrary inputs in a large variety of unique environments, it cannot ever be fully documented here or anywhere else. + In addition, we also warn you that this documentation has not been -extensively reviewed by Bitcoin experts and so likely contains numerous +extensively reviewed by Dash experts and so likely contains numerous errors. At the bottom of the menu on the left, you will find links that allow you to report an issue or to edit the documentation on GitHub. Please use those links if you find any errors or important missing diff --git a/_includes/devdoc/ref_p2p_networking.md b/_includes/devdoc/ref_p2p_networking.md index ce973d19..390a117a 100644 --- a/_includes/devdoc/ref_p2p_networking.md +++ b/_includes/devdoc/ref_p2p_networking.md @@ -9,16 +9,18 @@ http://opensource.org/licenses/MIT. {% autocrossref %} -This section describes the Bitcoin P2P network protocol (but it is [not a -specification][]). It does not describe the discontinued direct [IP-to-IP -payment protocol][], the [BIP70 payment protocol][/en/glossary/payment-protocol], the +This section describes the Dash P2P network protocol (but it is [not a +specification][]). It does not describe the +[BIP70 payment protocol][/en/glossary/payment-protocol], the [GetBlockTemplate mining protocol][section getblocktemplate], or any -network protocol never implemented in an official version of Bitcoin Core. +network protocol never implemented in an official version of Dash Core. All peer-to-peer communication occurs entirely over TCP. -**Note:** unless their description says otherwise, all multi-byte +{% highlight text %} +Note: unless their description says otherwise, all multi-byte integers mentioned in this section are transmitted in little-endian order. +{% endhighlight %} {% endautocrossref %} @@ -27,27 +29,25 @@ integers mentioned in this section are transmitted in little-endian order. {% autocrossref %} -The following constants and defaults are taken from Bitcoin Core's +The following constants and defaults are taken from Dash Core's [chainparams.cpp][core chainparams.cpp] source code file. -| Network | Default Port | [Start String][/en/glossary/start-string]{:#term-start-string}{:.term} | Max nBits +| Network | Default Port | Magic Value | [Start String][/en/glossary/start-string]{:#term-start-string}{:.term} | Max nBits |---------|--------------|-----------------------------------------------|--------------- -| Mainnet | 8333 | 0xf9beb4d9 | 0x1d00ffff -| Testnet | 18333 | 0x0b110907 | 0x1d00ffff -| Regtest | 18444 | 0xfabfb5da | 0x207fffff +| Mainnet | 9999 | 0xBD6B0CBF | 0xBF0C6BBD | 0x1e0ffff0 +| Testnet | 19999 | 0xFFCAE2CE | 0xCEE2CAFF | 0x1e0ffff0 +| Regtest | 19994 | 0xDCB7C1FC | 0xFCC1B7DC | 0x207fffff -Note: the testnet start string and nBits above are for testnet3; the -original testnet used a different string and higher (less difficult) -nBits. +Note: the testnet start string and nBits above are for testnet3. Command line parameters can change what port a node listens on (see `-help`). Start strings are hardcoded constants that appear at the start -of all messages sent on the Bitcoin network; they may also appear in -data files such as Bitcoin Core's block database. The nBits displayed -above are in big-endian order; they're sent over the network in -little-endian order. +of all messages sent on the Dash network; they may also appear in +data files such as Dash Core's block database. The Magic Value and nBits +displayed above are in big-endian order; they're sent over the network in +little-endian order. The Start String is simply the endian reversed Magic Value. -Bitcoin Core's [chainparams.cpp][core chainparams.cpp] also includes +Dash Core's [chainparams.cpp][core chainparams.cpp] also includes other constants useful to programs, such as the hash of the genesis blocks for the different networks. @@ -63,13 +63,22 @@ with the most recent versions listed first. (If you know of a protocol version that implemented a major change but which is not listed here, please [open an issue][docs issue].) -As of Bitcoin Core 0.14.2, the most recent protocol version is 70015. +As of Dash Core 0.12.1.5, the most recent protocol version is 70206. + +| Version | Initial Release | Major Changes +|---------|------------------------------------|-------------- +| 70208 | Dash Core 0.12.2.x
(??? 2017) | +| 70206 | Dash Core 0.12.1.x
(Mar 2017) | +| 70103 | Dash Core 0.12.0.x
(Aug 2015) | +| 70076 | Dash Core 0.11.2.x
(Apr 2015) | +| 70066 | Dash Core 0.11.1.x
(Feb 2015) | +| 70051 | Dash Core 0.10.0.x
(Feb 2015) | +| 70002 | Dash Core 0.8.7
(Jan 2014) | Initial Dash release + +Historical Bitcoin protocol versions for reference shown below. | Version | Initial Release | Major Changes |---------|------------------------------------|-------------- -| 70015 | Bitcoin Core 0.13.2
(Jan 2017) | • New banning behavior for invalid compact blocks [#9026](https://github.com/bitcoin/bitcoin/pull/9026) in v0.14.0, Backported to v0.13.2 in [#9048](https://github.com/bitcoin/bitcoin/pull/9048). -| 70014 | Bitcoin Core 0.13.0
(Aug 2016) | [BIP152][]:
• Added `sendcmpct`, `cmpctblock`, `getblocktxn`, `blocktxn` messages
• Added `MSG_CMPCT_BLOCK` inventory type to `getdata` message. -| 70013 | Bitcoin Core 0.13.0
(Aug 2016) | [BIP133][]:
• Added `feefilter` message.
• Removed `alert` message system. See [Alert System Retirement](https://bitcoin.org/en/alert/2016-11-01-alert-retirement) | 70012 | Bitcoin Core 0.12.0
(Feb 2016) | [BIP130][]:
• Added `sendheaders` message. | 70011 | Bitcoin Core 0.12.0
(Feb 2016) | [BIP111][]:
• `filter*` messages are disabled without NODE_BLOOM after and including this version. | 70002 | Bitcoin Core 0.9.0
(Mar 2014) | • Send multiple `inv` messages in response to a `mempool` message if necessary

[BIP61][]:
• Added `reject` message @@ -98,14 +107,14 @@ The message header format is: |-------|--------------|-----------|------------- | 4 | start string | char[4] | Magic bytes indicating the originating network; used to seek to next message when stream state is unknown. | 12 | command name | char[12] | ASCII string which identifies what message type is contained in the payload. Followed by nulls (0x00) to pad out byte count; for example: `version\0\0\0\0\0`. -| 4 | payload size | uint32_t | Number of bytes in payload. The current maximum number of bytes ([`MAX_SIZE`][max_size]) allowed in the payload by Bitcoin Core is 32 MiB---messages with a payload size larger than this will be dropped or rejected. +| 4 | payload size | uint32_t | Number of bytes in payload. The current maximum number of bytes ([`MAX_SIZE`][max_size]) allowed in the payload by Dash Core is 32 MiB---messages with a payload size larger than this will be dropped or rejected. | 4 | checksum | char[4] | *Added in protocol version 209.*

First 4 bytes of SHA256(SHA256(payload)) in internal byte order.

If payload is empty, as in `verack` and `getaddr` messages, the checksum is always 0x5df6e0e2 (SHA256(SHA256(\))). The following example is an annotated hex dump of a mainnet message header from a `verack` message which has no payload. {% highlight text %} -f9beb4d9 ................... Start string: Mainnet +bf0c6bbd ................... Start string: Mainnet 76657261636b000000000000 ... Command name: verack + null padding 00000000 ................... Byte count: 0 5df6e0e2 ................... Checksum: SHA256(SHA256()) @@ -140,9 +149,26 @@ The currently-available type identifiers are: | 1 | [`MSG_TX`][msg_tx]{:#term-msg_tx}{:.term} | The hash is a TXID. | 2 | [`MSG_BLOCK`][msg_block]{:#term-msg_block}{:.term} | The hash is of a block header. | 3 | [`MSG_FILTERED_BLOCK`][msg_filtered_block]{:#term-msg_filtered_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 `merkleblock` message rather than a `block` message (but this only works if a bloom filter was previously configured). **Only for use in `getdata` messages.** +| 4 | [`MSG_TXLOCK_REQUEST`][msg_txlock_request]{:#term-msg_txlock_request}{:.term} | The hash is an Instant Send transaction lock request. +| 5 | [`MSG_TXLOCK_VOTE`][msg_txlock_vote]{:#term-msg_txlock_vote}{:.term} | The hash is an Instant Send transaction vote. +| 6 | [`MSG_SPORK`][msg_spork]{:#term-msg_spork}{:.term} | The hash is Spork ID. +| 7 | [`MSG_MASTERNODE_PAYMENT_VOTE`][msg_masternode_payment_vote]{:#term-msg_masternode_payment_vote}{:.term} | The hash is a Masternode Payment Vote. +| 8 | [`MSG_MASTERNODE_PAYMENT_BLOCK`][msg_masternode_payment_block]{:#term-msg_masternode_payment_block}{:.term} | The hash is a Masternode Payment Block. +| _8_ | _`MSG_MASTERNODE_SCANNING_ERROR`_ | Replaced by `MSG_MASTERNODE_PAYMENT_BLOCK` +| _9_ | _[`MSG_BUDGET_VOTE`][msg_budget_vote]{:#term-msg_budget_vote}{:.term}_ | Deprecated +| _10_ | _[`MSG_BUDGET_PROPOSAL`][msg_budget_proposal]{:#term-msg_budget_proposal}{:.term}_ | Deprecated +| _11_ | _[`MSG_BUDGET_FINALIZED`][msg_budget_finalized]{:#term-msg_budget_finalized}{:.term}_ | Deprecated +| _12_ | _[`MSG_BUDGET_FINALIZED_VOTE`][msg_budget_finalized_vote]{:#term-msg_budget_finalized_vote}{:.term}_ | Deprecated +| _13_ | _[`MSG_MASTERNODE_QUORUM`][msg_masternode_quorum]{:#term-msg_masternode_quorum}{:.term}_ | Not Implemented +| 14 | [`MSG_MASTERNODE_ANNOUNCE`][msg_masternode_announce]{:#term-msg_masternode_announce}{:.term} | The hash is a Masternode Broadcast. +| 15 | [`MSG_MASTERNODE_PING`][msg_masternode_ping]{:#term-msg_masternode_ping}{:.term} | The hash is a Masternode Ping. +| 16 | [`MSG_DSTX`][msg_dstx]{:#term-msg_dstx}{:.term} | The hash is Private Send (Dark Send) Broadcast TX. +| 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}{:.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. -Type identifier zero and type identifiers greater than three are reserved -for future implementations. Bitcoin Core ignores all inventories with +Type identifier zero and type identifiers greater than nineteen are reserved +for future implementations. Dash Core ignores all inventories with one of these unknown types. {% endautocrossref %} @@ -232,7 +258,9 @@ node. The objects are requested by an inventory, which the requesting 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, or `notfound` message. +message, `merkleblock` message, `ix` message, `txlvote` message, +`mnw` message, `mnb` message, `mnp` message, `dstx` message, `govobj` message, +`govobjvote` message, `mnv` message, or `notfound` 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 @@ -251,7 +279,7 @@ identical to the `inv` message; only the message header differs. {% autocrossref %} -*Added in protocol version 31800.* +*Added in protocol version 70077.* The `getheaders` message requests a `headers` message that provides block headers starting from a particular point in the block chain. It allows a @@ -270,7 +298,7 @@ to the `getheaders` message will include as many as 2,000 block headers. {% autocrossref %} -*Added in protocol version 31800.* +*Added in protocol version 31800 (of Bitcoin).* The `headers` message sends block headers to a node which previously requested certain headers with a `getheaders` message. A headers @@ -326,13 +354,13 @@ inventory entries. (The message header has been omitted.) {% highlight text %} 02 ................................. Count: 2 -01000000 ........................... Type: MSG_TX -de55ffd709ac1f5dc509a0925d0b1fc4 -42ca034f224732e429081da1b621f55a ... Hash (TXID) +0f000000 ........................... Type: MSG_MASTERNODE_PING +dd6cc6c11211793b239c2e311f1496e2 +2281b200b35233eaae465d2aa3c9d537 ... Hash (mnp) -01000000 ........................... Type: MSG_TX -91d36d997037e08018262978766f24b8 -a055aaf1d872e94ae85e9817b2c68dc7 ... Hash (TXID) +05000000 ........................... Type: MSG_TXLOCK_VOTE +afc5b2f418f8c06c477a7d071240f5ee +ab17057f9ce4b50c2aef4fadf3729a2e ... Hash (txlvote) {% endhighlight %} {% endautocrossref %} @@ -342,7 +370,7 @@ a055aaf1d872e94ae85e9817b2c68dc7 ... Hash (TXID) {% autocrossref %} -*Added in protocol version 60002.* +*Added in protocol version 60002 (of Bitcoin).* The `mempool` message requests the TXIDs of transactions that the receiving node has verified as valid but which have not yet appeared in @@ -599,19 +627,20 @@ identical to the `inv` message; only the message header differs. The `tx` message transmits a single transaction in the raw transaction format. It can be sent in a variety of situations; -* **Transaction Response:** Bitcoin Core and BitcoinJ will send it in - response to a `getdata` message that requests the transaction with an - inventory type of `MSG_TX`. +* **Transaction Response:** Dash Core will send it in response to a + `getdata` message that requests the transaction with an inventory + type of `MSG_TX`. -* **MerkleBlock Response:** Bitcoin Core will send it in response to a +* **MerkleBlock Response:** Dash Core will send it in response to a `getdata` message that requests a merkle block with an inventory type of `MSG_MERKLEBLOCK`. (This is in addition to sending a `merkleblock` message.) Each `tx` message in this case provides a matched transaction from that block. + For an example hexdump of the raw transaction format, see the [raw transaction section][raw transaction format]. @@ -658,7 +687,7 @@ An `addr` message may also be sent in response to a `getaddr` message. | Bytes | Name | Data Type | Description |------------|------------------|--------------------|---------------- | *Varies* | IP address count | compactSize uint | The number of IP address entries up to a maximum of 1,000. -| *Varies* | IP addresses | network IP address | IP address entries. See the table below for the format of a Bitcoin network IP address. +| *Varies* | IP addresses | network IP address | IP address entries. See the table below for the format of a Dash network IP address. Each encapsulated network IP address currently uses the following structure: @@ -667,7 +696,7 @@ Each encapsulated network IP address currently uses the following structure: | 4 | time | uint32 | *Added in protocol version 31402.*

A time in Unix epoch time format. Nodes advertising their own IP address set this to the current time. Nodes advertising IP addresses they've connected to set this to the last time they connected to that node. Other nodes just relaying the IP address should not change the time. Nodes can use the time field to avoid relaying old `addr` messages.

Malicious nodes may change times or even set them in the future. | 8 | services | uint64_t | The services the node advertised in its `version` message. | 16 | IP address | char | IPv6 address in **big endian byte order**. IPv4 addresses can be provided as [IPv4-mapped IPv6 addresses][] -| 2 | port | uint16_t | Port number in **big endian byte order**. Note that Bitcoin Core will only connect to nodes with non-standard port numbers as a last resort for finding peers. This is to prevent anyone from trying to use the network to disrupt non-Bitcoin services that run on other ports. +| 2 | port | uint16_t | Port number in **big endian byte order**. Note that Dash Core will only connect to nodes with non-standard port numbers as a last resort for finding peers. This is to prevent anyone from trying to use the network to disrupt non-Dash services that run on other ports. The following annotated hexdump shows part of an `addr` message. (The message header has been omitted and the actual IP address has been @@ -687,68 +716,112 @@ d91f4854 ........................... Epoch time: 1414012889 {% endautocrossref %} - - #### Alert {% include helpers/subhead-links.md %} {% autocrossref %} *Added in protocol version 311.* -*Removed in protocol version 70013 and released in Bitcoin Core 0.13.0* +*Removed by Bitcoin in protocol version 70013, but retained by Dash.* -The legacy p2p network alert messaging system has been retired; however, internal alerts, partition detection warnings and the `-alertnotify` option features remain. See [Alert System Retirement](https://bitcoin.org/en/alert/2016-11-01-alert-retirement) for details. +The `alert` message warns nodes of problems that may affect them or the +rest of the network. Each `alert` message is signed using a key controlled +by respected community members, mostly Dash Core developers. -{% endautocrossref %} +To ensure all nodes can validate and forward `alert` messages, +encapsulation is used. Developers create an alert using the data +structure appropriate for the versions of the software they want to +notify; then they serialize that data and sign it. The serialized data +and its signature make up the outer `alert` message---allowing nodes +which don't understand the data structure to validate the signature and +relay the alert to nodes which do understand it. The nodes which +actually need the message can decode the serialized data to access the +inner `alert` message. -#### FeeFilter -{% include helpers/subhead-links.md %} +The outer `alert` message has four fields: -{% autocrossref %} +| Bytes | Name | Data Type | Description +|-------------|-----------------|------------------|------------- +| *Variable* | alert bytes | compactSize uint | The number of bytes in following alert field. +| *Variable* | alert | uchar | The serialized alert. See below for a description of the current alert format. +| *Variable* | signature bytes | compactSize uint | The number of bytes in the following signature field. +| *Variable* | signature | uchar | A DER-encoded ECDSA (secp256k1) signature of the alert signed with the developer's alert key. -*Added in protocol version 70013 as described by BIP133.* +Although designed to be easily upgraded, the format of the inner +serialized alert has not changed since the `alert` message was first +introduced in protocol version 311. -The `feefilter` message is a request to the receiving peer to not relay any -transaction inv messages to the sending peer where the fee rate for the -transaction is below the fee rate specified in the feefilter message. +| Bytes | Name | Data Type | Description +|----------|-------------------|---------------------------|------------- +| 4 | version | int32_t | Alert format version. Version 1 from protocol version 311 through at least protocol version 70002. +| 8 | relayUntil | int64_t | The time beyond which nodes should stop relaying this alert. Unix epoch time format. +| 8 | expiration | int64_t | The time beyond which this alert is no longer in effect and should be ignored. Unix epoch time format. +| 4 | ID | int32_t | A unique ID number for this alert. +| 4 | cancel | int32_t | All alerts with an ID number less than or equal to this number should be canceled: deleted and not accepted in the future. +| *Varies* | setCancel count | compactSize uint | The number of IDs in the following setCancel field. May be zero. +| *Varies* | setCancel | int32_t | Alert IDs which should be canceled. Each alert ID is a separate int32_t number. +| 4 | minVer | int32_t | This alert only applies to protocol versions greater than or equal to this version. Nodes running other protocol versions should still relay it. +| 4 | maxVer | int32_t | This alert only applies to protocol versions less than or equal to this version. Nodes running other protocol versions should still relay it. +| *Varies* | user\_agent count | compactSize uint | The number of user agent strings in the following setUser\_agent field. May be zero. +| *Varies* | setUser\_agent | compactSize uint + string | If this field is empty, it has no effect on the alert. If there is at least one entry is this field, this alert only applies to programs with a user agent that exactly matches one of the strings in this field. Each entry in this field is a compactSize uint followed by a string---the uint indicates how many bytes are in the following string. This field was originally called setSubVer; since BIP14, it applies to user agent strings as defined in the `version` message. +| 4 | priority | int32_t | Relative priority compared to other alerts. +| *Varies* | comment bytes | compactSize uint | The number of bytes in the following comment field. May be zero. +| *Varies* | comment | string | A comment on the alert that is not displayed. +| *Varies* | statusBar bytes | compactSize uint | The number of bytes in the following statusBar field. May be zero. +| *Varies* | statusBar | string | The alert message that is displayed to the user. +| *Varies* | reserved bytes | compactSize uint | The number of bytes in the following reserved field. May be zero. +| *Varies* | reserved | string | Reserved for future use. Originally called RPC Error. -`feefilter` was introduced in Bitcoin Core 0.13.0 following the introduction -of mempool limiting in Bitcoin Core 0.12.0. Mempool limiting provides protection against -attacks and spam transactions that have low fee rates and are unlikely to be -included in mined blocks. The `feefilter` messages allows a node to inform its -peers that it will not accept transactions below a specified fee rate into -its mempool, and therefore that the peers can skip relaying inv messages for -transactions below that fee rate to that node. - -| Bytes | Name | Data Type | Description -|-------|---------|-----------|--------------- -| 8 | feerate | uint64_t | The fee rate (in satoshis per kilobyte) below which transactions should not be relayed to this peer. - -The receiving peer may choose to ignore the message and not filter transaction -inv messages. - -The fee filter is additive with bloom filters. If an SPV client loads a bloom -filter and sends a feefilter message, transactions should only be relayed if -they pass both filters. - -Note however that feefilter has no effect on block propagation or responses to -getdata messages. For example, if a node requests a merkleblock from its peer -by sending a getdata message with inv type MSG_FILTERED_BLOCK and it has -previously sent a feefilter to that peer, the peer should respond with a -merkleblock containing *all* the transactions matching the bloom filter, even -if they are below the feefilter fee rate. - -inv messages generated from a mempool message are subject to a fee filter if it exists. - -The annotated hexdump below shows a `feefilter` message. (The message +The annotated hexdump below shows an `alert` message. (The message header has been omitted.) -{% endautocrossref %} + {% highlight text %} -7cbd000000000000 ... satoshis per kilobyte: 48,508 +73 ................................. Bytes in encapsulated alert: 115 +01000000 ........................... Version: 1 +3766404f00000000 ................... RelayUntil: 1329620535 +b305434f00000000 ................... Expiration: 1330917376 + +f2030000 ........................... ID: 1010 +f1030000 ........................... Cancel: 1009 +00 ................................. setCancel count: 0 + +10270000 ........................... MinVer: 10000 +48ee0000 ........................... MaxVer: 61000 +00 ................................. setUser_agent bytes: 0 +64000000 ........................... Priority: 100 + +00 ................................. Bytes In Comment String: 0 +46 ................................. Bytes in StatusBar String: 70 +53656520626974636f696e2e6f72672f +666562323020696620796f7520686176 +652074726f75626c6520636f6e6e6563 +74696e67206166746572203230204665 +627275617279 ....................... Status Bar String: "See [...]" +00 ................................. Bytes In Reserved String: 0 + +47 ................................. Bytes in signature: 71 +30450221008389df45f0703f39ec8c1c +c42c13810ffcae14995bb648340219e3 +53b63b53eb022009ec65e1c1aaeec1fd +334c6b684bde2b3f573060d5b70c3a46 +723326e4e8a4f1 ..................... Signature {% endhighlight %} +**Alert key compromise:** Dash Core's source code defines a +particular set of alert parameters that can be used to notify users that +the alert signing key has been compromised and that they should upgrade +to get a new alert public key. Once a signed alert containing those +parameters has been received, no other alerts can cancel or override it. +See the `ProcessAlert()` function in the Dash Core [alert.cpp][core +alert.cpp] source code for the parameters of this message. + +{% endautocrossref %} + #### FilterAdd {% include helpers/subhead-links.md %} @@ -802,7 +875,7 @@ previously-set bloom filter. This also undoes the effect of setting the relay field in the `version` message to 0, allowing unfiltered access to `inv` messages announcing new transactions. -Bitcoin Core does not require a `filterclear` message before a +Dash Core does not require a `filterclear` message before a replacement filter is loaded with `filterload`. It also doesn't require a `filterload` message before a `filterclear` message. @@ -907,7 +980,7 @@ function][murmur3]. ![Warning icon](/img/icons/icon_warning.svg) **Warning:** the Murmur3 hash function has separate 32-bit and 64-bit versions that produce different results for the same input. Only the -32-bit Murmur3 version is used with Bitcoin bloom filters. +32-bit Murmur3 version is used with Dash bloom filters. The data to be hashed can be any transaction element which the bloom filter can match. See the next subsection for the list of transaction @@ -915,7 +988,7 @@ elements checked against the filter. The largest element which can be matched is a script data push of 520 bytes, so the data should never exceed 520 bytes. -The example below from Bitcoin Core [bloom.cpp][core bloom.cpp hash] combines +The example below from Dash Core [bloom.cpp][core bloom.cpp hash] combines all the steps above to create the hash function template. The seed is the first parameter; the data to be hashed is the second parameter. The result is a uint32\_t modulo the size of the bit field in bits. @@ -1067,6 +1140,19 @@ section][section message header] for an example of a message without a payload. {% endautocrossref %} +#### GetSporks +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `getsporks` message requests `spork` messages from the receiving node. + +There is no payload in a `getsporks` message. See the [message header +section][section message header] for an example of a message without a payload. + +{% endautocrossref %} + + #### Ping {% include helpers/subhead-links.md %} @@ -1103,7 +1189,7 @@ header has been omitted.) *Added in protocol version 60001 as described by BIP31.* The `pong` message replies to a `ping` message, proving to the pinging -node that the ponging node is still alive. Bitcoin Core will, by +node that the ponging node is still alive. Dash Core will, by default, disconnect from any clients which have not responded to a `ping` message within 20 minutes. @@ -1146,6 +1232,7 @@ ascending code number (primary) and alphabetic in reply to (secondary) --> | 0x01 | *any message* | 0 | N/A | Message could not be decoded. Be careful of `reject` message feedback loops where two peers each don't understand each other's `reject` messages and so keep sending them back and forth forever. | 0x10 | `block` message | 32 | char[32] | Block is invalid for some reason (invalid proof-of-work, invalid signature, etc). Extra data may include the rejected block's header hash. | 0x10 | `tx` message | 32 | char[32] | Transaction is invalid for some reason (invalid signature, output value greater than input, etc.). Extra data may include the rejected transaction's TXID. +| 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. | 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. @@ -1155,6 +1242,19 @@ ascending code number (primary) and alphabetic in reply to (secondary) --> | 0x42 | `tx` message | | char[32] | The transaction did not have a large enough fee or priority to be relayed or mined. Extra data may include the rejected transaction's TXID. | 0x43 | `block` message | 32 | char[32] | The block belongs to a block chain which is not the same block chain as provided by a compiled-in checkpoint. Extra data may include the rejected block's header hash. +Reject Codes + +| Code | Description +|------|-------------- +| 0x01 | Malformed +| 0x10 | Invalid +| 0x11 | Obsolete +| 0x12 | Duplicate +| 0x40 | Non-standard +| 0x41 | Dust +| 0x42 | Insufficient fee +| 0x43 | Checkpoint + The annotated hexdump below shows a `reject` message. (The message header has been omitted.) @@ -1184,6 +1284,75 @@ section][section message header] for an example of a message without a payload. {% endautocrossref %} + +#### Spork +{% include helpers/subhead-links.md %} + +{% autocrossref %} +Sporks are a mechanism by which updated code is released to the network, but +not immediately made active (or “enforced”). Enforcement of the updated code +can be activated remotely. Should problems arise, the code can be deactivated +in the same manner, without the need for a network-wide rollback or client update. + +A `spork` message may be sent in response to a `getsporks` message. + +The `spork` message tells the receiving peer the status of the spork defined by +the SporkID field. Upon receiving a spork message, the client must verify the +signature before accepting the spork message as valid. + +| Bytes | Name | Data type | Required | Description | +| ---------- | ----------- | --------- | -------- | -------- | +| 4 | nSporkID | int | Required | ID assigned in spork.h +| 8 | nValue | int64_t | Required | Value assigned to spork +| 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]) + +| 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) +| 10007 | 8 | `MASTERNODE_PAYMENT_ENFORCEMENT` | Requires masternodes to be paid by miners when blocks are processed +| 10008 | 9 | `SUPERBLOCKS_ENABLED` | Superblocks are enabled (the 10% comes to fund the dash treasury) +| 10009 | 10 | `MASTERNODE_PAY_UPDATED_NODES` | Only current protocol version masternode's will be paid (not older nodes) +| 10011 | 12 | `RECONSIDER_BLOCKS` | +| 10012 | 13 | `OLD_SUPERBLOCK_FLAG` | +| 10013 | 14 | `REQUIRE_SENTINEL_FLAG` | Only masternode's running sentinel will be paid + +To verify `vchSig`, compare the hard-coded spork public key (`strSporkPubKey` +from [`src/chainparams.cpp`][spork pubkey]) with the public key recovered from +the `spork` message's hash and `vchSig` value (implementation details for Dash +Core can be found in `CPubKey::RecoverCompact`). The hash is a double SHA-256 hash of: + +* The spork magic message (`"DarkCoin Signed Message:\n"`) +* nSporkID + nValue + nTimeSigned + +| Network | Spork Pubkey (wrapped) | +| ---------- | ---------- | +| Mainnet | 04549ac134f694c0243f503e8c8a9a986f5de6610049c40b07816809b0d1
d06a21b07be27b9bb555931773f62ba6cf35a25fd52f694d4e1106ccd237
a7bb899fdd | +| Testnet3 | 046f78dcf911fbd61910136f7f0f8d90578f68d0b3ac973b5040fb7afb50
1b5939f39b108b0569dca71488f5bbf498d92e4d1194f6f941307ffd95f7
5e76869f0e | +| RegTest | Undefined | + +The following annotated hexdump shows a `spork` message. + +{% highlight text %} +11270000 .................................... Spork ID: Spork 2 InstantSend enabled (10001) +0000000000000000 ............................ Value (0) +2478da5900000000 ............................ Epoch time: 2017-10-08 19:10:28 UTC (1507489828) + +41 .......................................... Signature length: 65 + +1b6762d3e70890b5cfaed5d1fd72121c +d32020c827a89f8128a00acd210f4ea4 +1b36c26c3767f8a24f48663e189865ed +403ed1e850cdb4207cdd466419d9d183 +45 .......................................... Masternode Signature +{% endhighlight %} + +{% endautocrossref %} + #### VerAck {% include helpers/subhead-links.md %} @@ -1197,7 +1366,6 @@ section][section message header]. {% endautocrossref %} - #### Version {% include helpers/subhead-links.md %} @@ -1217,49 +1385,1127 @@ before initializing its half of the connection by first sending a | 4 | version | int32_t | Required | The highest protocol version understood by the transmitting node. See the [protocol version section][section protocol versions]. | 8 | services | uint64_t | Required | The services supported by the transmitting node encoded as a bitfield. See the list of service codes below. | 8 | timestamp | int64_t | Required | The current Unix epoch time according to the transmitting node's clock. Because nodes will reject blocks with timestamps more than two hours in the future, this field can help other nodes to determine that their clock is wrong. -| 8 | addr_recv services | uint64_t | Required | *Added in protocol version 106.*

The services supported by the receiving node as perceived by the transmitting node. Same format as the 'services' field above. Bitcoin Core will attempt to provide accurate information. BitcoinJ will, by default, always send 0. -| 16 | addr_recv IP address | char | Required | *Added in protocol version 106.*

The IPv6 address of the receiving node as perceived by the transmitting node in **big endian byte order**. IPv4 addresses can be provided as [IPv4-mapped IPv6 addresses][]. Bitcoin Core will attempt to provide accurate information. BitcoinJ will, by default, always return ::ffff:127.0.0.1 +| 8 | addr_recv services | uint64_t | Required | *Added in protocol version 106.*

The services supported by the receiving node as perceived by the transmitting node. Same format as the 'services' field above. Dash Core will attempt to provide accurate information. +| 16 | addr_recv IP address | char | Required | *Added in protocol version 106.*

The IPv6 address of the receiving node as perceived by the transmitting node in **big endian byte order**. IPv4 addresses can be provided as [IPv4-mapped IPv6 addresses][]. Dash Core will attempt to provide accurate information. | 2 | addr_recv port | uint16_t | Required | *Added in protocol version 106.*

The port number of the receiving node as perceived by the transmitting node in **big endian byte order**. | 8 | addr_trans services | uint64_t | Required | The services supported by the transmitting node. Should be identical to the 'services' field above. | 16 | addr_trans IP address | char | Required | The IPv6 address of the transmitting node in **big endian byte order**. IPv4 addresses can be provided as [IPv4-mapped IPv6 addresses][]. Set to ::ffff:127.0.0.1 if unknown. | 2 | addr_trans port | uint16_t | Required | The port number of the transmitting node in **big endian byte order**. | 8 | nonce | uint64_t | Required | A random nonce which can help a node detect a connection to itself. If the nonce is 0, the nonce field is ignored. If the nonce is anything else, a node should terminate the connection on receipt of a `version` message with a nonce it previously sent. | *Varies* | user_agent bytes | compactSize uint | Required | Number of bytes in following user\_agent field. If 0x00, no user agent field is sent. -| *Varies* | user_agent | string | Required if user_agent bytes > 0 | *Renamed in protocol version 60000.*

User agent as defined by BIP14. Previously called subVer. +| *Varies* | user_agent | string | Required if user_agent bytes > 0 | *Renamed in protocol version 60000.*

User agent as defined by BIP14. Previously called subVer.

Dash Core limits the length to 256 characters. | 4 | start_height | int32_t | Required | The height of the transmitting node's best block chain or, in the case of an SPV client, best block header chain. | 1 | relay | bool | Optional | *Added in protocol version 70001 as described by BIP37.*

Transaction relay flag. If 0x00, no `inv` messages or `tx` messages announcing new transactions should be sent to this client until it sends a `filterload` message or `filterclear` message. If the relay field is not present or is set to 0x01, this node wants `inv` messages and `tx` messages announcing new transactions. + The following service identifiers have been assigned. | Value | Name | Description |-------|--------------|--------------- | 0x00 | *Unnamed* | This node is not a full node. It may not be able to provide any data except for the transactions it originates. | 0x01 | NODE_NETWORK | This is a full node and can be asked for full blocks. It should implement all protocol features available in its self-reported protocol version. +| 0x02 | NODE_GETUTXO | This node is capable of responding to the getutxo protocol request. *Dash Core does not support this service.* +| 0x04 | NODE_BLOOM | This node is capable and willing to handle bloom-filtered connections. Dash Core nodes used to support this by default, without advertising this bit, but no longer do as of protocol version 70201 (= NO_BLOOM_VERSION) The following annotated hexdump shows a `version` message. (The message header has been omitted and the actual IP addresses have been replaced with [RFC5737][] reserved IP addresses.) {% highlight text %} -72110100 ........................... Protocol version: 70002 -0100000000000000 ................... Services: NODE_NETWORK -bc8f5e5400000000 ................... Epoch time: 1415483324 +3e120100 .................................... Protocol version: 70206 +0500000000000000 ............................ Services: NODE_NETWORK (1) + NODE_BLOOM (4) +bc8f5e5400000000 ............................ Epoch time: 1415483324 -0100000000000000 ................... Receiving node's services -00000000000000000000ffffc61b6409 ... Receiving node's IPv6 address -208d ............................... Receiving node's port number +0100000000000000 ............................ Receiving node's services +00000000000000000000ffffc61b6409 ............ Receiving node's IPv6 address +270f ........................................ Receiving node's port number -0100000000000000 ................... Transmitting node's services -00000000000000000000ffffcb0071c0 ... Transmitting node's IPv6 address -208d ............................... Transmitting node's port number +0500000000000000 ............................ Transmitting node's services +00000000000000000000ffffcb0071c0 ............ Transmitting node's IPv6 address +270f ........................................ Transmitting node's port number -128035cbc97953f8 ................... Nonce +128035cbc97953f8 ............................ Nonce -0f ................................. Bytes in user agent string: 15 -2f5361746f7368693a302e392e332f ..... User agent: /Satoshi:0.9.2.1/ +14 .......................................... Bytes in user agent string: 20 +2f4461736820436f72653a302e31322e312e352f..... User agent: /Satoshi:0.9.2.1/ -cf050500 ........................... Start height: 329167 -01 ................................. Relay flag: true +851f0b00 .................................... Start height: 728965 +01 .......................................... Relay flag: true {% endhighlight %} {% endautocrossref %} + + + +### InstantSend Messages +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The following network messages all help control the InstantSend feature of Dash. +InstantSend uses the masternode network to lock transaction inputs and enable +secure, instantaneous transactions. + +{% endautocrossref %} + +#### ix +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `ix` message (transaction lock request) has the same structure as the `tx` message. +The masternode network responds with `txlvote` messages if the transaction inputs +can be locked. + +{% endautocrossref %} + + +#### txlvote +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `txlvote` message ([transaction lock vote][msg_txlock_vote]{:#term-msg_txlock_vote}{:.term}) +is sent by masternodes to indicate approval of a transaction lock request +`ix` message. + +| Bytes | Name | Data type | Required | Description | +| ---------- | ----------- | --------- | -------- | -------- | +| 32 | txHash | uint256 | Required | TXID of the transaction to lock +| 36 | outPoint | outpoint | Required | The unspent outpoint to lock in this transaction +| 36 | outpointMasternode | outpoint | Required | The outpoint of the masternode which is signing the vote +| 66* | vchMasternodeSignature | char[] | Required | 66 bytes in most cases. Length (1 byte) + Signature (65 bytes) + +The following annotated hexdump shows a `txlvote` message. (The +message header has been omitted.) + +{% highlight text %} +3c121fb4a12b2f715e2f70a9fa282115 +be197dde14073959fb2a2b8e95a7418f ..... TXID + +Outpoint to lock +| bb607995757c6a6efd6429215dcb3688 +| b252d34d835c81fed310fd905f487020 ... Outpoint TXID +| 01000000 ........................... Outpoint index number: 1 + +Masternode Outpoint +| de9029c7e9b7eb7cd11f27ba670b2349 +| 0c3f0717b86ed949c316874589405cd2 ... Outpoint TXID +| 00000000 ........................... Outpoint index number: 0 + +41 ................................... Signature length: 65 + +1ccc39ffb9c62111a8c82823d3ce61d2 +380db4e8f76ec238d568908f37558a90 +4e79566a53663de12ec2be1183c87d61 +250e8ebd57be171be1d4b5e89b69c263 +88 ................................... Masternode Signature +{% endhighlight %} + +{% endautocrossref %} + + +### PrivateSend Messages +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The following network messages all help control the PrivateSend (formerly +DarkSend) coin mixing features built in to Dash. + +{% endautocrossref %} + +#### dsa +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `dsa` message replies to a `dsq` message and allows the user to join +a mixing pool. + +| 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 + + + +{% endautocrossref %} + + +#### dsc +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `dsc` message indicates a PrivateSend mixing session is complete. + +| Bytes | Name | Data type | Required | Description | +| ---------- | ----------- | --------- | -------- | -------- | +| 4 | nSessionID | int | Required | ID of the mixing session +| 4 | nMessageID | int | Required | Collateral TX that will be charged if this client acts maliciously + +Message IDs + +| Code | Description +|------|-------------- +| 0x00 | ERR_ALREADY_HAVE +| 0x01 | ERR_DENOM +| 0x02 | ERR_ENTRIES_FULL +| 0x03 | ERR_EXISTING_TX +| 0x04 | ERR_FEES +| 0x05 | ERR_INVALID_COLLATERAL +| 0x06 | ERR_INVALID_INPUT +| 0x07 | ERR_INVALID_SCRIPT +| 0x08 | ERR_INVALID_TX +| 0x09 | ERR_MAXIMUM +| 0x0A | ERR_MN_LIST +| 0x0B | ERR_MODE +| 0x0C | ERR_NON_STANDARD_PUBKEY +| 0x0D | ERR_NOT_A_MN (Not used) +| 0x0E | ERR_QUEUE_FULL +| 0x0F | ERR_RECENT +| 0x10 | ERR_SESSION +| 0x11 | ERR_MISSING_TX +| 0x12 | ERR_VERSION +| 0x13 | MSG_NOERR +| 0x14 | MSG_SUCCESS +| 0x15 | MSG_ENTRIES_ADDED + +The following annotated hexdump shows a `dsc` message. (The +message header has been omitted.) + +{% highlight text %} +d9070700 ............................. Session ID: 460761 +14000000 ............................. Message ID: MSG_SUCCESS (0x14) +{% endhighlight %} + +{% endautocrossref %} + + +#### dsf +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `dsf` message is sent as the final mixing transaction in a PrivateSend +mixing session. + +| Bytes | Name | Data type | Required | Description | +| ---------- | ----------- | --------- | -------- | -------- | +| 4 | nSessionID | int | Required | ID of the mixing session +| # | txFinal | `tx` message | Required | Collateral TX that will be charged if this client acts maliciously + +The following annotated hexdump shows a `dsf` message. (The +message header has been omitted.) + +{% highlight text %} +d9070700 ............................. Session ID: 460761 + +Transaction Message +| 01000000 ................................. Version: 1 +| +| 11 ......................................... Number of inputs: 17 +| +| Transaction input #1 +| | +| | 312b2eef73770de0c75647b1fda96d85 +| | fe83b06867abf11057a241a3cf8d2a84 ......... Outpoint TXID +| | 00000000 ................................. Outpoint index number: 0 +| | +| | 00 ....................................... Bytes in sig. script: 0 +| | .......................................... Secp256k1 signature: None +| | +| | ffffffff ................................. Sequence number: UINT32_MAX +| +| [...] ...................................... 16 more transaction inputs omitted +| +| +| 11 ......................................... Number of outputs: 17 +| +| Transaction output #1 +| | 4a420f0000000000 ......................... Duffs (0.01000010 Dash) +| | +| | 19 ....................................... Bytes in pubkey script: 25 +| | | 76 ..................................... OP_DUP +| | | a9 ..................................... OP_HASH160 +| | | 14 ..................................... Push 20 bytes as data +| | | | 0041cc11dac1386e0d8676fda6c5b122 +| | | | 9d8c61e2 ............................. PubKey hash +| | | 88 ..................................... OP_EQUALVERIFY +| | | ac ..................................... OP_CHECKSIG +| +| [...] ...................................... 16 more transaction outputs omitted +| +| +| 00000000 ................................... locktime: 0 (a block height) +{% endhighlight %} + +{% endautocrossref %} + + +#### dsi +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `dsi` message indicates the queue is ready and the user is expected to send +the entry inputs to start mixing. + +| Bytes | Name | Data type | Required | Description | +| ---------- | ----------- | --------- | -------- | -------- | +| ? | vecTxDSIn | CTxDSIn[] | Required | Vector of users inputs (CTxDSIn serialization is equal to CTxIn serialization) +| 8 | nAmount | int64_t | Required | Deprecated since 12.1. Used for backwards compatibility only and can be removed with future protocol bump +| ? | 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) + + + +{% endautocrossref %} + + +#### dsq +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `dsq` message asks users to sign a final mixing TX messages. + +| 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 | nTime | int | Required | Time this `dsq` message was created +| 4 | fReady | int | Required | Indicates if the mixing pool is ready to be executed +| 66* | vchSig | char[] | Required | Signature of this message by masternode verifiable via pubKeyMasternode (66 bytes in most cases. Length (1 byte) + Signature (65 bytes)) + +Denominations + +| Value | Denomination +|------|-------------- +| 1 | 10 Dash +| 2 | 1 Dash +| 4 | 0.1 Dash +| 8 | 0.01 Dash + +The following annotated hexdump shows a `dsq` message. (The +message header has been omitted.) + +{% highlight text %} +08000000 ............................. Denomination: 0.01 Dash (8) + +Masternode Outpoint +| aeed0e77c6db30a616507a37a129bc88 +| 1811f08afc51dd485d5322f36c1f04c5 ... Outpoint TXID +| 01000000 ........................... Outpoint index number: 1 + +1318a859 ............................. Create Time + +00000000 ............................. Ready: 0 + +00 ................................... ??? +41 ................................... Signature length: 65 + +1bd74386ea4e111197f1b4b4660c1415 +13486745ca10ba0632426ed3a644d941 +047e43c988680904d4a4fcf551d8813c +ec12d47ae9b00e870db294cd66708ab7 +dc ................................... Masternode Signature +{% endhighlight %} + +{% endautocrossref %} + + +#### dss +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `dss` message sends the user's signed inputs for a group transaction in a +mixing session. + +| Bytes | Name | Data type | Required | Description | +| ---------- | ----------- | --------- | -------- | -------- | +| # | inputs | txIn[] | Required | Signed inputs for mixing session + + + +{% endautocrossref %} + + +#### dssu +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `dssu` message provides a mixing pool status update. + +| Bytes | Name | Data type | Required | Description | +| ---------- | ----------- | --------- | -------- | -------- | +| 4 | nMsgSessionID | int | Required | Session ID +| 4 | nMsgState | int | Required | Current state of mixing process +| 4 | nMsgEntriesCount | int | Required | Number of entries in the mixing pool +| 4 | nMsgStatusUpdate | int | Required | Update state and/or signal if entry was accepted or not +| 4 | nMsgMessageID | int | Required | ID of the typical masternode reply message + +Pool State + +| State | Description +|------|-------------- +| 0 | POOL_STATE_IDLE +| 1 | POOL_STATE_QUEUE +| 2 | POOL_STATE_ACCEPTING_ENTRIES +| 3 | POOL_STATE_SIGNING +| 4 | POOL_STATE_ERROR +| 5 | POOL_STATE_SUCCESS + +Pool Status Update + +| Status | Description +|------|-------------- +| 0 | STATUS_REJECTED +| 1 | STATUS_ACCEPTED + +The following annotated hexdump shows a `dssu` message. (The +message header has been omitted.) + +{% highlight text %} +e6ce0c00 ............................. Session ID +02000000 ............................. State: POOL_STATE_ACCEPTING_ENTRIES (2) +01000000 ............................. Entries: 1 +01000000 ............................. Status Update: STATUS_ACCEPTED (1) +13000000 ............................. Message ID: MSG_NOERR (0x13) +{% endhighlight %} + +{% endautocrossref %} + + +#### dstx +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `dstx` message allows masternodes to broadcast subsidized transactions without +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 +| 66* | vchSig | char[] | Required | Signature of this message by masternode verifiable via pubKeyMasternode (66 bytes in most cases. Length (1 byte) + Signature (65 bytes)) +| 8 | sigTime | int64_t | Require | Time this message was signed + + +The following annotated hexdump shows a `dstx` message. (The +message header has been omitted.) + +{% highlight text %} +Transaction Message +| 01000000 ................................. Version: 1 +| +| 0b ......................................... Number of inputs: 11 +| +| Transaction input #1 +| | +| | 0adb782b2170018eada54534be880e70 +| | 74ed8307a566731119b1782362af43ad ......... Outpoint TXID +| | 05000000 ................................. Outpoint index number: 5 +| | +| | 6a ....................................... Bytes in sig. script: 106 +| | 47304402204ed56f525ae6df707f9cbe +| | 55c78d82bbcc02daa1fb27b0bf54588a +| | 446dcc804102200c4e03c4a2b9a90aef +| | 9f01de7c28812a0e8b280e6c153b0bd8 +| | 26d2ff660102e18121028c96903b2709 +| | 7b331d55abd1f42d2ff6cc7c784ab839 +| | 7c232b73a34a149a348e ..................... Secp256k1 signature +| | +| | ffffffff ................................. Sequence number: UINT32_MAX +| +| [...] ...................................... 10 more transaction inputs omitted +| +| +| 0b ......................................... Number of outputs: 11 +| +| Transaction output #1 +| | e8e4f50500000000 ......................... Duffs (1.00001000 Dash) +| | +| | 19 ....................................... Bytes in pubkey script: 25 +| | | 76 ..................................... OP_DUP +| | | a9 ..................................... OP_HASH160 +| | | 14 ..................................... Push 20 bytes as data +| | | | 0febbeaa8818b2c2f80fb8c98f90bdae +| | | | 41fe5c26 ............................. PubKey hash +| | | 88 ..................................... OP_EQUALVERIFY +| | | ac ..................................... OP_CHECKSIG +| +| [...] ...................................... 10 more transaction outputs omitted +| +| +| 00000000 ................................... locktime: 0 (a block height) + +Masternode Unspent Output +| 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 +3369e5909479ea88116aad7ea64587d9 +59364326c97d7f249f7b9293e120a5b6 +1c ................................... Masternode Signature + +ece5a95900000000 ..................... Signature Timestamp +{% endhighlight %} + +{% endautocrossref %} + + +### Masternode Messages +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The following network messages enable the Masternode features built in to Dash. + +{% endautocrossref %} + +#### dseg +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +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. + +The response to a `dseg` message is an `mnb` message inventory and an +`mnp` message inventory for each requested masternode. Masternodes ignore this +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 + + +{% highlight text %} +Note: Dash Core only allows nodes to request the entire list every 3 hours. +Additional requests sent prior to then may result in the node being banned. +{% endhighlight %} + +The following annotated hexdump shows a `dseg` message requesting **all** +masternodes. (The message header has been omitted.) + +{% highlight text %} +Masternode Unspent Output +| 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 +| 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 %} + +#### mnb +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `mnb` message is sent whenever a masternode comes online or a client is +syncing. The masternode will send this message which describes the masternode +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 +| # | addr | CService | Required | IPv4 address of the masternode +| 33-65 | pubKeyCollateralAddress | CPubKey | Required | CPubKey of the main 1000 DASH unspent output +| 33-65 | pubKeyMasternode | CPubKey | Required | CPubKey of the secondary signing key (For all other messaging other than announce message) +| 66* | sig | char[] | Required | Signature of this message verifiable via pubKeyMasternode (66 bytes in most cases. 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) + +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 +| 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 +| 270f ..................................... Port: 9999 + +Collateral Public Key +| 21 ....................................... Key Size: 33 +| 02 ....................................... Key Type: 2 - Compressed (even) +| 02a47a6845936a4199e126d35399dd09 +| 97c1aaf89a3fe70d474c53f29624a43a5b ....... Public Key + +Masternode Public Key +| 41 ....................................... Key Size: 65 +| 04 ....................................... Key Type: 4 - Uncompressed +| 04da252243305d604cab90480880af4a +| b5cea3a934c91393452e9b7b4c97a87e +| 198bc809916ac2c27436a1db9c28d0aa +| bfefec4dc3c2193835fd9a56c31150c633 ....... Public Key + +Message Signature +| 41 ....................................... Bytes in signature: 65 +| 1fb80f9ba8c110835e4a7dd4c8deccd7 +| 89027663d00084d9a99ef579a9b5601f +| 40727b27e91aab2897a078f63976ae25 +| 3ff8f01e56862e953278f432530f6ee080 ....... Signature + +4728ef5800000000 ........................... Sig. Timestamp: 2017-04-13 07:27:03 UTC + +3e120100 ................................... Protocol Version: 70206 + +Masternode Ping Message +| Masternode Unspent Output +| | 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 +| +| 66c1a95900000000 ......................... Sig. Timestamp: 2017-10-01 21:21:58 UTC +| +| Masternode Signature +| | 41 ..................................... Bytes in signature: 65 +| | 1b3017c49a03e2d77083f3c92a8c2e4c +| | d815d068b6256498a719e3cb6a34f774 +| | ec6434cfcbb7a5a51704350a05903287 +| | eecc82e6b40ac2fcfa2df29ddaa6c4fc +| | b8 ..................................... Masternode Signature +{% endhighlight %} + +{% endautocrossref %} + +#### mnget +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `mnget` message requests masternode payment sync. The response to an +`mnget` message is an `mnb` message inventory and an `mnp` message inventory for +each requested masternode. 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 + +{% 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 +message header has been omitted.) + +{% highlight text %} +a8170000 ................................... Count: 6056 +{% endhighlight %} + +{% endautocrossref %} + +#### mnp +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `mnp` message is sent by masternodes every few minutes to ping the network +with a message that propagates across the whole network. Dash Core currently +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 +| 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)) + +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 + +a26a68ebb733192c1c40f9b42f872ac0 +e23d4c360e20d5ab6608000000000000 ........... Chaintip block hash + +1bbfa95900000000 ........................... Sig. Timestamp: 2017-10-01 20:12:11 UTC + +Masternode Signature +| 41 ....................................... Bytes in signature: 65 +| 1c2b205bd6ba472d7a9495f049ef66dc +| f844154846e25f2389385ba2d3e95cde +| cf3ccf82bc26d94c6fdafcd7b965bb61 +| db02d05483595196ea4d92b2e797612b +| 79 ....................................... Masternode Signature +{% endhighlight %} + +{% endautocrossref %} + +#### mnv +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `mnv` message is used by masternodes to verify each other. Several `mnv` +messages are exchanged in the process. This results in the IP address of +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 +| # | addr | CService | Required | IPv4 address and port of masternode 1 +| 4 | nonce | int | Required | Random nonce +| 4 | nBlockHeight | int | Required | Block height +| 66 | vchSig1 | char[] | Required*

Added in Step 2 | Signature of this message by masternode 1 - verifiable via pubKeyMasternode (Length (1 byte) + Signature (65 bytes))

+| 66 | vchSig2 | char[] | Required*

Added in Step 3 | Signature of this message by masternode 2 - verifiable via pubKeyMasternode (Length (1 byte) + Signature (65 bytes))

+ +Initially, both `vchSig1` and `vchSig2` are empty. They are updated as the +exchange of messages between the masternodes occurs as detailed in the table +below. + +*Masternode Verify Data Flow* + +| Step | **MN 2 (Verifier)** | **Direction** | **MN 1 (Being verified)** | **Description** | +| | **Verification request** | | | **`mnv` message with no signatures** | +| 1 | `mnv` message | → | | Contains `addr`, `nonce`, and `nBlockHeight` +| 2 | | ← | `mnv` message | Add `vchSig1` (signature of the IP address + nonce + hash of the requested block) +| 3 | `mnv` message | → | | Verify `vchSig1`

Add `vchSig2` (signature of the IP address + nonce + hash of the requested block + `vin1` prevout + `vin2` prevout) and relay message to peers if valid + +Nodes receiving a relayed `mnv` message (one in which both `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. + +{% highlight text %} +Important Notes: +* Dash Core limits how frequently a masternode verify request can be + requested. Frequent requests will result in the node being banned. + +* Only masternodes in the top `MAX_POSE_RANK` (10) can send an `mnv` request + (to no more than `MAX_POSE_CONNECTIONS` (10)). + +{% endhighlight %} + + + +{% endautocrossref %} + +#### mnw +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `mnw` message is used to pick the next winning masternode. When a new block +is found on the network, a masternode quorum will be determined and those 10 +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 +| 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)) + +The following annotated hexdump shows a `mnw` message. (The +message header has been omitted.) + +{% highlight text %} +Masternode Unspent Output +| 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 + +Payee Address +| 19 ....................................... Address Length: 25 +| | 76 ..................................... OP_DUP +| | a9 ..................................... OP_HASH160 +| | 14 ..................................... Push 20 bytes as data +| | | 1767c363646be7d8e4475c0aa85ea454 +| | | 9fd102c4 ............................. Pubkey hash +| | 88 ..................................... OP_EQUALVERIFY +| | ac ..................................... OP_CHECKSIG + +Masternode Signature +| 41 ....................................... Bytes in signature: 65 +| 1c25da47190a83937fb5ef607235703a +| 7cdda155bf5a1ae6139929024750f899 +| a90a4f57cdf9d54c9d9603c1f31009f8 +| e257355b49c0484fb4c31bc412c73dd9 +| 20 ....................................... Signature +{% endhighlight %} + +{% endautocrossref %} + +#### mnwb +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +There is no message for `mnwb` (`inv` message only). + +The following annotated hexdump shows an `inv` message with a `mnwb` +inventory entry. (The message header has been omitted.) + +{% highlight text %} +01 ................................. Count: 1 + +08000000 ........................... Type: MSG_MASTERNODE_PAYMENT_BLOCK (8) +dd6cc6c11211793b239c2e311f1496e2 +2281b200b35233eaae465d2aa3c9d537 ... Hash: mnwb +{% endhighlight %} + +{% endautocrossref %} + +#### ssc +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `ssc` message is used to track the sync status of masternode objects. This +message is sent in response to sync requests for the list of masternodes +(`dseg` message), masternode payments (`mnget` message), governance objects +(`govsync` message), and governance object votes (`govsync` message). + +| Bytes | Name | Data type | Required | Description | +| ---------- | ----------- | --------- | -------- | -------- | +| 4 | nItemID | int | Required | Masternode Sync Item ID +| 4 | nCount | int | Required | Number of items to sync + +Sync Item IDs + +| ID | Description | Response To +|------|--------------|--------------- +| 2 | MASTERNODE_SYNC_LIST | `dseg` message +| 3 | MASTERNODE_SYNC_MNW | `mnget` message +| 10 | MASTERNODE_SYNC_GOVOBJ | `govsync` message +| 11 | MASTERNODE_SYNC_GOVOBJ_VOTE | `govsync` message with non-zero hash + +The following annotated hexdump shows a `ssc` message. (The +message header has been omitted.) + +{% highlight text %} +02000000 ................................... Item ID: MASTERNODE_SYNC_LIST (2) +bf110000 ................................... Count: 4543 +{% endhighlight %} + +{% endautocrossref %} + + +### Governance Messages +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The following network messages enable the Governance features built in to Dash. +For additional details on the governance system, see this [Budget System page](https://dashpay.atlassian.net/wiki/spaces/DOC/pages/8585246/Budget+System+Funding+Voting+DGBB). + +![Overview Of P2P Protocol Governance Request And Reply Messages](/img/dev/en-p2p-governance-messages.svg) + +For additional details, refer to the Developer Guide [Governance section](developer-guide#governance). + +{% endautocrossref %} + +#### govobj +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `govobj` message contains a governance object that is generally a proposal, +contract, or setting. Masternodes ignore this request if they are not fully synced. + +| Bytes | Name | Data type | Required | Description | +| ---------- | ----------- | --------- | -------- | -------- | +| 32 | nHashParent | uint256 | Required | Parent object (a hash of all zeros here indicates this is the root object, not a child object). +| 4 | nRevision | int | Required | Object revision in the system +| 8 | nTime | int64_t | Required | Time which this object was created +| 32 | nCollateralHash | uint256 | Required | Hash of the collateral fee transaction +| 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 +| 66* | vchSig | char[] | Required | Signature of the masternode (66 bytes in most cases. Length (1 byte) + Signature (65 bytes)) + +Governance Object Types (defined by src/governance-object.h) + +| Type | Name | Description +|------|-------------------------|------------ +| 0 | GOVERNANCE_OBJECT_UNKNOWN | +| 1 | GOVERNANCE_OBJECT_PROPOSAL | Submitted proposal (requires collateral transaction - currently 5 Dash) +| 2 | GOVERNANCE_OBJECT_TRIGGER | Masternode generated. Removed after activation/execution. Used for superblocks. +| 3 | GOVERNANCE_OBJECT_WATCHDOG | Masternode generated. Two hour expiration time. + +The following annotated hexdump shows a `govobj` message. (The +message header has been omitted.) + +{% highlight text %} +00000000000000000000000000000000 +00000000000000000000000000000000 ..... Parent Hash (0 = root) +01000000 ............................. Revision: 1 +911ea85900000000 ..................... Create timestamp: 2017-08-31 14:34:57 UTC +00000000000000000000000000000000 +00000000000000000000000000000000 ..... Collateral Hash + +Data +| ae11 ............................... Data length: 4526 +| fdae11356235623 ... 376435643564 ... Data (truncated) + +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 + +41 ................................... Signature length: 65 + +1ce3b782f66be8ae9fc4158680128864 +341202b6006384083ab2d9cfa73795e2 +6000668e84af4ef6a284a52b53843524 +72037d51bd9079ffd5c087d9632865ee +75 ................................... Masternode Signature +{% endhighlight %} + +{% endautocrossref %} + +#### govobjvote +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `govobjvote` message is used to indicate the voting status of a governance +object. Voting status is comprised of the vote outcome (how the masternode +voted) and the vote signal (the network support status). A sufficient number of +yes votes results in the proposed funding being payed out in the next +superblock (assuming their are sufficient funds available in the budget). + +The initial `govobjvote` message is created by a masternode to vote on a +governance object (proposal, etc.). When the masternode votes, it broadcasts +the `govobjvote` message to all its peers. + +When a node receives a valid, **new** `govobjvote` message, it relays the message +to all its connected peers to propagate the vote. + +Additionally, nodes can request `govobjvote` messages for specific governance +objects via a `govsync` message. Masternodes ignore requests for votes if they +are not fully synced. + +| Bytes | Name | Data type | Required | Description | +| ---------- | ----------- | --------- | -------- | -------- | +| 41+ | vinMasternode | CTxIn | Required | Unspent output for the masternode 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) +| 8 | nTime | int64_t | Required | Time the vote was created +| 66* | vchSig | char[] | Required | Signature of the masternode (66 bytes in most cases. Length (1 byte) + Signature (65 bytes)) + +Governance Object Vote Signals (defined by src/governance-object.h) + +| Value | Name | Description +|------|-------|------------ +| 1 | Funding | Minimum network support has been reached for this object to be funded (doesn't mean it will for sure though) +| 2 | Valid | Minimum network support has been reached flagging this object as a valid and understood governance object (e.g, the serialized data is correct format, etc.) +| 3 | Delete | Minimum network support has been reached saying this object should be deleted from the system entirely +| 4 | Endorsed | Minimum network support has been reached flagging this object as endorsed by an elected representative body + +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 + +ad9579d5c181eee904156df1c88b050f +b8b4d39e5fda71f015996dbf14a51bff...... Parent Hash (0 = root) +01000000 ............................. Vote Outcome: VOTE_OUTCOME_NONE (1) +02000000 ............................. Vote Signal: VOTE_SIGNAL_VALID (2) +b517a85900000000 ..................... Vote Create Timestamp: 2017-08-31 14:05:41 UTC +00000000000000000000000000000000 ..... Collateral Hash + +1b049113a81fe913f061ad295561d267 +00b8135a021ab0356a1e89b18d663d0b +dc45e9c09ee0427223e332b52e8d709e +6d64e86b6435d7bdf207d8f23b6ae0db +6f ................................... Masternode Signature +{% endhighlight %} + +{% endautocrossref %} + +#### govsync +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The `govsync` message is used to request syncing of governance objects +(`govobj` message and `govobjvote` message) with peers. Masternodes ignore this +request if they are not fully synced. + +This message responds in one of two ways depending on the request: + +1. Object Sync - When a masternode receives a `govsync` message with a hash of all zeros, it +responds with one `ssc` message for `govobj` objects and one for `govobjvote` +objects. The masternode also sends an `inv` message (MSG_GOVERNANCE_OBJECT - 0x17) +for all valid `govobj` governance objects. +*Governance object votes are excluded in this type of response.* + +2. Vote Sync - When a masternode receives a `govsync` message with a specific hash, it +responds with one `ssc` message for `govobj` objects and one for `govobjvote` +objects. The masternode also sends both a `govobj` inventory message +(MSG_GOVERNANCE_OBJECT - 0x17) and `govobjvote` inventory messages +(MSG_GOVERNANCE_OBJECT_VOTE - 0x18) for the single governance object requested. + +| Bytes | Name | Data type | Required | Description | +| ---------- | ----------- | --------- | -------- | -------- | +| 32 | nHash | uint256 | Required | Hash of governance object to request
Set to all zeros to request all objects (excludes votes) +| # | filter | CBloomFilter | Required | Can be set to all zeros.
Only supported since [protocol version 70206][section protocol versions] + +{% highlight text %} +Dash Core limits how frequently the first type of sync (object sync) can be +requested. Frequent requests will result in the node being banned. +{% endhighlight %} + +The following annotated hexdump shows a `govsync` message. (The +message header has been omitted.) + +{% highlight text %} +2e46ea5418e097a3dbcccbee3cf2a911 +6fb94ba635153f276dcb2123efcb73ff ..... Hash +00000000000000000000 ................. Bloom Filter +{% endhighlight %} + +{% endautocrossref %} + + +### Deprecated Messages +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +The following network messages have been deprecated and should not longer be used. + +{% endautocrossref %} + +#### mnvs +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +Masternode Budget Sync - Deprecated since 12.1 + +{% endautocrossref %} + +#### mvote +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +Masternode Budget Vote - Deprecated since 12.1 + +{% endautocrossref %} + +#### mprop +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +Masternode Budget Proposal - Deprecated since 12.1 + +{% endautocrossref %} + +#### fbs +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +Masternode Budget Final - Deprecated since 12.1 + +{% endautocrossref %} + +#### fbvote +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +Masternode Budget Final Vote - Deprecated since 12.1 + +{% endautocrossref %} + +#### mn quorum +{% include helpers/subhead-links.md %} + +{% autocrossref %} + +Not Implemented + +{% endautocrossref %} diff --git a/_includes/devdoc/ref_transactions.md b/_includes/devdoc/ref_transactions.md index 6c4d27a2..eb3f634d 100644 --- a/_includes/devdoc/ref_transactions.md +++ b/_includes/devdoc/ref_transactions.md @@ -24,25 +24,25 @@ The opcodes used in the pubkey scripts of standard transactions are: * `OP_TRUE`/`OP_1` (0x51) and `OP_2` through `OP_16` (0x52--0x60), which push the values 1 through 16 to the stack. -* [`OP_CHECKSIG`][op_checksig]{:#term-op-checksig}{:.term} consumes a signature and a full public key, and pushes +* [`OP_CHECKSIG`][op_checksig]{:#term-op-checksig}{:.term} (0xac) consumes a signature and a full public key, and pushes true onto the stack if the transaction data specified by the SIGHASH flag was converted into the signature using the same ECDSA private key that generated the public key. Otherwise, it pushes false onto the stack. -* [`OP_DUP`][op_dup]{:#term-op-dup}{:.term} pushes a copy of the topmost stack item on to the stack. +* [`OP_DUP`][op_dup]{:#term-op-dup}{:.term} (0x76) pushes a copy of the topmost stack item on to the stack. -* [`OP_HASH160`][op_hash160]{:#term-op-hash160}{:.term} consumes the topmost item on the stack, +* [`OP_HASH160`][op_hash160]{:#term-op-hash160}{:.term} (0xa9) consumes the topmost item on the stack, computes the RIPEMD160(SHA256()) hash of that item, and pushes that hash onto the stack. -* [`OP_EQUAL`][op_equal]{:#term-op-equal}{:.term} consumes the top two items on the stack, compares them, and +* [`OP_EQUAL`][op_equal]{:#term-op-equal}{:.term} (0x87) consumes the top two items on the stack, compares them, and pushes true onto the stack if they are the same, false if not. -* [`OP_VERIFY`][op_verify]{:#term-op-verify}{:.term} consumes the topmost item on the stack. +* [`OP_VERIFY`][op_verify]{:#term-op-verify}{:.term} (0x69) consumes the topmost item on the stack. If that item is zero (false) it terminates the script in failure. -* [`OP_EQUALVERIFY`][op_equalverify]{:#term-op-equalverify}{:.term} runs `OP_EQUAL` and then `OP_VERIFY` in sequence. +* [`OP_EQUALVERIFY`][op_equalverify]{:#term-op-equalverify}{:.term} (0x88) runs `OP_EQUAL` and then `OP_VERIFY` in sequence. -* [`OP_CHECKMULTISIG`][op_checkmultisig]{:#term-op-checkmultisig}{:.term} consumes the value (n) at the top of the stack, +* [`OP_CHECKMULTISIG`][op_checkmultisig]{:#term-op-checkmultisig}{:.term} (0xae) consumes the value (n) at the top of the stack, consumes that many of the next stack levels (public keys), consumes the value (m) now at the top of the stack, and consumes that many of the next values (signatures) plus one extra value. @@ -65,11 +65,11 @@ The opcodes used in the pubkey scripts of standard transactions are: the pubkey script or redeem script. See the `OP_CHECKMULTISIG` warning below for more details. -* [`OP_RETURN`][op_return]{:#term-op-return}{:.term} terminates the script in failure when executed. +* [`OP_RETURN`][op_return]{:#term-op-return}{:.term} (0x6a) terminates the script in failure when executed. A complete list of opcodes can be found on the Bitcoin Wiki [Script Page][wiki script], with an authoritative list in the `opcodetype` enum -of the Bitcoin Core [script header file][core script.h] +of the Dash Core [script header file][core script.h] ![Warning icon](/img/icons/icon_warning.svg) **Signature script modification warning:** @@ -131,7 +131,7 @@ Failure, aborted: two signature matches required but none found so {% autocrossref %} -The hashes used in P2PKH and P2SH outputs are commonly encoded as Bitcoin +The hashes used in P2PKH and P2SH outputs are commonly encoded as Dash addresses. This is the procedure to encode those hashes and decode the addresses. @@ -142,15 +142,15 @@ format used in raw transactions (described in a [following sub-section][raw transaction format]). Taking the resulting hash: 1. Add an address version byte in front of the hash. The version -bytes commonly used by Bitcoin are: +bytes commonly used by Dash are: - * 0x00 for P2PKH addresses on the main Bitcoin network (mainnet) + * 0x4c for P2PKH addresses on the main Dash network (mainnet) - * 0x6f for P2PKH addresses on the Bitcoin testing network (testnet) + * 0x8c for P2PKH addresses on the Dash testing network (testnet) - * 0x05 for P2SH addresses on mainnet + * 0x10 for P2SH addresses on mainnet - * 0xc4 for P2SH addresses on testnet + * 0x13 for P2SH addresses on testnet 2. Create a copy of the version and hash; then hash that twice with SHA256: `SHA256(SHA256(version . hash))` @@ -160,8 +160,8 @@ bytes commonly used by Bitcoin are: 4. Append the checksum to the version and hash, and encode it as a base58 string: `BASE58(version . hash . checksum)` - -Bitcoin's base58 encoding, called [Base58Check][/en/glossary/base58check]{:#term-base58check}{:.term} may not match other implementations. Tier + +Dash's base58 encoding, called [Base58Check][/en/glossary/base58check]{:#term-base58check}{:.term} may not match other implementations. Tier Nolan provided the following example encoding algorithm to the Bitcoin Wiki [Base58Check encoding](https://en.bitcoin.it/wiki/Base58Check_encoding) page under @@ -173,7 +173,7 @@ x = convert_bytes_to_big_integer(hash_result) output_string = "" -while(x > 0) +while(x > 0) { (x, remainder) = divide(x, 58) output_string.append(code_string[remainder]) @@ -187,7 +187,7 @@ repeat(number_of_leading_zero_bytes_in_hash) output_string.reverse(); {% endhighlight %} -Bitcoin's own code can be traced using the [base58 header +Dash's own code can be traced using the [base58 header file][core base58.h]. To convert addresses back into hashes, reverse the base58 encoding, extract @@ -201,19 +201,19 @@ against the extracted checksum, and then remove the version byte. {% autocrossref %} -Bitcoin transactions are broadcast between peers +Dash transactions are broadcast between peers in a serialized byte format, called [raw format][/en/glossary/serialized-transaction]{:#term-raw-format}{:.term}. It is this form of a transaction which is SHA256(SHA256()) hashed to create the TXID and, ultimately, the merkle root of a block containing the transaction---making the transaction format part of the consensus rules. -Bitcoin Core and many other tools print and accept raw transactions +Dash Core and many other tools print and accept raw transactions encoded as hex. -As of Bitcoin Core 0.9.3 (October 2014), all transactions use the -version 1 format described below. (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 by current software.) +All transactions use the version 1 format described below. +(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 +by current software.) A raw transaction has the following top-level format: @@ -224,7 +224,7 @@ A raw transaction has the following top-level format: | *Varies* | tx_in | txIn | Transaction inputs. See description of txIn below. | *Varies* | tx_out count | compactSize uint | Number of outputs in this transaction. | *Varies* | tx_out | txOut | Transaction outputs. See description of txOut below. -| 4 | lock_time | uint32_t | A time (Unix epoch time) or block number. See the [locktime parsing rules][]. +| 4 | lock_time | uint32_t | A time (Unix epoch time) or block number. See the [locktime parsing rules][]. A transaction may have multiple inputs and outputs, so the txIn and txOut structures may recur within a transaction. CompactSize unsigned @@ -247,7 +247,7 @@ Each non-coinbase input spends an outpoint from a previous transaction. | 36 | previous_output | outpoint | The previous outpoint being spent. See description of outpoint below. | *Varies* | script bytes | compactSize uint | The number of bytes in the signature script. Maximum is 10,000 bytes. | *Varies* | signature script | char[] | A script-language script which satisfies the conditions placed in the outpoint's pubkey script. Should only contain data pushes; see the [signature script modification warning][]. -| 4 | sequence | uint32_t | Sequence number. Default for Bitcoin Core and almost all other programs is 0xffffffff. +| 4 | sequence | uint32_t | Sequence number. Default for Dash Core and almost all other programs is 0xffffffff. {% endautocrossref %} @@ -274,12 +274,12 @@ specific output. {% autocrossref %} -Each output spends a certain number of satoshis, placing them under +Each output spends a certain number of duffs, placing them under control of anyone who can satisfy the provided pubkey script. | Bytes | Name | Data Type | Description |----------|-----------------|------------------|-------------- -| 8 | value | int64_t | Number of satoshis to spend. May be zero; the sum of all outputs may not exceed the sum of satoshis previously spent to the outpoints provided in the input section. (Exception: coinbase transactions spend the block subsidy and collected transaction fees.) +| 8 | value | int64_t | Number of duffs to spend. May be zero; the sum of all outputs may not exceed the sum of duffs previously spent to the outpoints provided in the input section. (Exception: coinbase transactions spend the block subsidy and collected transaction fees.) | 1+ | pk_script bytes | compactSize uint | Number of bytes in the pubkey script. Maximum is 10,000 bytes. | *Varies* | pk_script | char[] | Defines the conditions which must be satisfied to spend this output. @@ -297,7 +297,7 @@ to a new pay-to-pubkey-hash (P2PKH) output. | | 7b1eabe0209b1fe794124575ef807057 | c77ada2138ae4fa8d6c4de0398a14f3f ......... Outpoint TXID -| 00000000 ................................. Outpoint index number +| 00000000 ................................. Outpoint index number: 0 | | 49 ....................................... Bytes in sig. script: 73 | | 48 ..................................... Push 72 bytes as data @@ -310,7 +310,7 @@ to a new pay-to-pubkey-hash (P2PKH) output. | ffffffff ................................. Sequence number: UINT32_MAX 01 ......................................... Number of outputs -| f0ca052a01000000 ......................... Satoshis (49.99990000 BTC) +| f0ca052a01000000 ......................... Duffs (49.99990000 Dash) | | 19 ....................................... Bytes in pubkey script: 25 | | 76 ..................................... OP_DUP @@ -345,10 +345,11 @@ has the following format. | *Varies* | coinbase script | *None* | The [coinbase field][/en/glossary/coinbase]{:#term-coinbase-field}{:.term}: Arbitrary data not exceeding 100 bytes minus the (4) height bytes. Miners commonly place an extra nonce in this field to update the block header merkle root during hashing. | 4 | sequence | uint32_t | Sequence number. + Although the coinbase script is arbitrary data, if it includes the bytes used by any signature-checking operations such as `OP_CHECKSIG`, those signature checks will be counted as signature operations (sigops) @@ -365,23 +366,33 @@ An itemized coinbase transaction: | 00000000000000000000000000000000 ... Previous outpoint TXID | ffffffff ............................ Previous outpoint index | -| 29 .................................. Bytes in coinbase +| 18 .................................. Bytes in coinbase: 24 | | | | 03 ................................ Bytes in height -| | | 4e0105 .......................... Height: 328014 +| | | b8240b .......................... Height: 730296 | | -| | 062f503253482f0472d35454085fffed -| | f2400000f90f54696d65202620486561 -| | 6c74682021 ........................ Arbitrary data +| | 03b8240b049d29aa59080400077efa95 +| | 0000052f6d70682f .................. Arbitrary data | 00000000 ............................ Sequence -01 .................................... Output count -| 2c37449500000000 .................... Satoshis (25.04275756 BTC) -| 1976a914a09be8040cbf399926aeb1f4 -| 70c37d1341f3b46588ac ................ P2PKH script +02 .................................... Output count +| Transaction Output 1 +| | f20cbe0a00000000 .................... Duffs (1.80227314 Dash) +| | 1976a9142cd46be3ceeacca983e0fea3 +| | b88f26b08a26c29b88ac ................ P2PKH script +| +| Transaction Output 2 +| | eb0cbe0a00000000 .................... Duffs (1.80227307 Dash) +| | 1976a914868180414905937a68fadeb0 +| | f33e64d102c9591a88ac ................ P2PKH script +| | 00000000 ............................ Locktime {% endhighlight %} +Note: currently the normal coinbase has 2 outputs (1 for the miner and 1 for +the selected masternode). Superblocks ([superblock example][superblock example]) +have multiple outputs depending on the number of proposals being funded. + {% endautocrossref %} ### CompactSize Unsigned Integers @@ -393,23 +404,23 @@ The raw transaction format and several peer-to-peer network messages use a type of variable-length integer to indicate the number of bytes in a following piece of data. -Bitcoin Core code and this document refers to these variable length +Dash Core code and this document refers to these variable length integers as compactSize. Many other documents refer to them as var_int or varInt, but this risks conflation with other variable-length integer -encodings---such as the CVarInt class used in Bitcoin Core for +encodings---such as the CVarInt class used in Dash Core for serializing data to disk. Because it's used in the transaction format, the format of compactSize unsigned integers is part of the consensus rules. -For numbers from 0 to 252, compactSize unsigned integers look like +For numbers from 0 to 252 (0xfc), compactSize unsigned integers look like regular unsigned integers. For other numbers up to 0xffffffffffffffff, a byte is prefixed to the number to indicate its length---but otherwise the numbers look like regular unsigned integers in little-endian order. | Value | Bytes Used | Format |-----------------------------------------|------------|----------------------------------------- -| >= 0 && <= 252 | 1 | uint8_t -| >= 253 && <= 0xffff | 3 | 0xfd followed by the number as uint16_t +| >= 0 && <= 0xfc (252) | 1 | uint8_t +| >= 0xfd (253) && <= 0xffff | 3 | 0xfd followed by the number as uint16_t | >= 0x10000 && <= 0xffffffff | 5 | 0xfe followed by the number as uint32_t | >= 0x100000000 && <= 0xffffffffffffffff | 9 | 0xff followed by the number as uint64_t diff --git a/_includes/helpers/subhead-links.md b/_includes/helpers/subhead-links.md index db7be114..7202fed3 100644 --- a/_includes/helpers/subhead-links.md +++ b/_includes/helpers/subhead-links.md @@ -2,9 +2,9 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %}{% if filename %} {% else %} {% die "source filename not set" %} diff --git a/_includes/helpers/summaries.md b/_includes/helpers/summaries.md index 2cc9e469..8673f879 100644 --- a/_includes/helpers/summaries.md +++ b/_includes/helpers/summaries.md @@ -3,12 +3,13 @@ This file is licensed under the terms of its source texts{%endcomment%} {% assign summary_abandonTransaction="marks an in-wallet transaction and all its in-wallet descendants as abandoned. This allows their inputs to be respent." %} {% assign summary_addMultiSigAddress="adds a P2SH multisig address to the wallet." %} {% assign summary_addNode="attempts to add or remove a node from the addnode list, or to try a connection to a node once." %} -{% assign summary_addWitnessAddress="adds a witness address for a script (with pubkey or redeemscript known)." %} +{% assign summary_addWitnessAddress="adds a witness address for a script (with pubkey or redeem script known)." %} {% assign summary_backupWallet="safely copies `wallet.dat` to the specified file, which can be a directory or a path with filename." %} {% assign summary_bumpFee="replaces an unconfirmed wallet transaction that signaled RBF with a new transaction that pays a higher fee." %} {% assign summary_clearBanned="clears list of banned nodes." %} {% assign summary_createMultiSig="creates a P2SH multi-signature address." %} {% assign summary_createRawTransaction="creates an unsigned serialized transaction that spends a previous output to a new output with a P2PKH or P2SH address. The transaction is not stored in the wallet or transmitted to the network." %} +{% assign summary_debug="changes the debug category from the console." %} {% assign summary_decodeRawTransaction="decodes a serialized transaction hex string into a JSON object describing the transaction." %} {% assign summary_decodeScript="decodes a hex-encoded P2SH redeem script." %} {% assign summary_disconnectNode="immediately disconnects from a specified node." %} @@ -16,13 +17,20 @@ This file is licensed under the terms of its source texts{%endcomment%} {% assign summary_dumpWallet="creates or overwrites a file with all wallet keys in a human-readable format." %} {% assign summary_encryptWallet="encrypts the wallet with a passphrase. This is only to enable encryption for the first time. After encryption is enabled, you will need to enter the passphrase to use private keys." %} {% assign summary_estimateFee="estimates the transaction fee per kilobyte that needs to be paid for a transaction to be included within a certain number of blocks." %} -{% 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." %} +{% assign summary_estimatePriority="estimates the priority (coin age) that a transaction needs in order to be included within a certain number of blocks as a free high-priority transaction." %} {% assign summary_fundRawTransaction="adds inputs to a transaction until it has enough in value to meet its out value." %} -{% assign summary_generate="nearly instantly generates blocks." %} +{% assign summary_gObject="provides a set of commands for managing governance objects and displaying information about them." %} +{% assign summary_gObjectCheck="." %} +{% assign summary_generate="mines blocks immediately (before the RPC call returns)." %} {% assign summary_generateToAddress="mines blocks immediately to a specified address." %} {% assign summary_getAccount="returns the name of the account associated with the given address." %} {% assign summary_getAccountAddress="returns the current Bitcoin address for receiving payments to this account. If the account doesn't exist, it creates both the account and a new address for receiving payment. Once a payment has been received to an address, future calls to this RPC for the same account will return a different address." %} {% 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." %} +{% assign summary_getAddressBalance="returns the balance for address(es)." %} +{% assign summary_getAddressDeltas="returns all changes for an address." %} +{% assign summary_getAddressMempool="returns all mempool deltas for an address." %} +{% assign summary_getAddressTxids="returns the txids for an address(es)." %} +{% assign summary_getAddressUtxos="returns all unspent outputs for an address." %} {% assign summary_getAddressesByAccount="returns a list of every address assigned to a particular account." %} {% assign summary_getBalance="gets the balance in decimal bitcoins across all accounts or for a particular account." %} {% assign summary_getBestBlockHash="returns the header hash of the most recent block on the best block chain." %} @@ -30,12 +38,15 @@ This file is licensed under the terms of its source texts{%endcomment%} {% assign summary_getBlockChainInfo="provides information about the current state of the block chain." %} {% assign summary_getBlockCount="returns the number of blocks in the local best block chain." %} {% assign summary_getBlockHash="returns the header hash of a block at the given height in the local best block chain." %} +{% assign summary_getBlockHashes="returns array of hashes of blocks within the timestamp range provided (requires `timestampindex` to be enabled)." %} {% assign summary_getBlockHeader="gets a block header with a particular header hash from the local block database either as a JSON object or as a serialized block header." %} +{% assign summary_getBlockHeaders="returns an array of items with information about the requested number of blockheaders starting from the requested hash." %} {% assign summary_getBlockTemplate="gets a block template or proposal for use with mining software." %} {% 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_getDifficultly="returns the proof-of-work difficulty as a multiple of the minimum difficulty." %} -{% assign summary_getGenerate="was removed in Bitcoin Core 0.13.0." %} +{% 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_getGovernanceInfo="returns an object containing governance parameters." %} {% assign summary_getHashesPerSec="was removed in Bitcoin Core 0.11.0." %} {% assign summary_getInfo="prints various information about the node and the network." %} {% assign summary_getMemPoolAncestors="returns all in-mempool ancestors for a transaction in the mempool." %} @@ -45,15 +56,18 @@ This file is licensed under the terms of its source texts{%endcomment%} {% assign summary_getMemoryInfo="returns information about memory usage." %} {% assign summary_getMiningInfo="returns various mining-related information." %} {% assign summary_getNetTotals="returns information about network traffic, including bytes in, bytes out, and the current time." %} -{% assign summary_getNetworkHashPS="returns the estimated current or historical network hashes per second based on the last *n* blocks." %} +{% assign summary_getNetworkHashPS="returns the estimated network hashes per second based on the last n blocks." %} {% assign summary_getNetworkInfo="returns information about the node's connection to the network." %} {% assign summary_getNewAddress="returns a new Bitcoin address for receiving payments. If an account is specified, payments received with the address will be credited to that account." %} {% assign summary_getPeerInfo="returns data about each connected network node." %} +{% assign summary_getPoolInfo="returns an object containing mixing pool related information." %} {% assign summary_getRawChangeAddress="returns a new Bitcoin address for receiving change. This is for use with raw transactions, not normal use." %} {% assign summary_getRawMemPool="returns all transaction identifiers (TXIDs) in the memory pool as a JSON array, or detailed information about each transaction in the memory pool as a JSON object." %} {% assign summary_getRawTransaction="gets a hex-encoded serialized transaction or a JSON object describing the transaction. By default, Bitcoin 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 Bitcoin Core startup settings." %} {% assign summary_getReceivedByAccount="returns the total amount received by addresses in a particular account from transactions with the specified number of confirmations. It does not count coinbase transactions." %} {% assign summary_getReceivedByAddress="returns the total amount received by the specified address in transactions with the specified number of confirmations. It does not count coinbase transactions." %} +{% assign summary_getSpentInfo="returns the txid and index where an output is spent (requires `spentindex` to be enabled)." %} +{% assign summary_getSuperblockBudget="returns the absolute maximum sum of superblock payments allowed." %} {% assign summary_getTransaction="gets detailed information about an in-wallet transaction." %} {% assign summary_getTxOut="returns details about a transaction output. Only unspent transaction outputs (UTXOs) are guaranteed to be available." %} {% assign summary_getTxOutProof="returns a hex-encoded proof that one or more specified transactions were included in a block." %} @@ -78,10 +92,15 @@ This file is licensed under the terms of its source texts{%endcomment%} {% assign summary_listTransactions="returns the most recent transactions that affect the wallet." %} {% assign summary_listUnspent="returns an array of unspent transaction outputs belonging to this wallet." %} {% assign summary_lockUnspent="temporarily locks or unlocks specified transaction outputs. A locked transaction output will not be chosen by automatic coin selection when spending bitcoins. Locks are stored in memory only, so nodes start with zero locked outputs and the locked output list is always cleared when a node stops or fails." %} +{% assign summary_masternode="" %} +{% assign summary_masternodeBroadcast="" %} +{% assign summary_masternodeList="returns a list of masternodes in different modes." %} +{% assign summary_mnSync="returns the sync status, updates to the next step or resets it entirely." %} {% assign summary_move="moves a specified amount from one account in your wallet to another using an off-block-chain transaction." %} -{% assign summary_ping-rpc="sends a P2P ping message to all connected nodes to measure ping time. Results are provided by the `getpeerinfo` RPC pingtime and pingwait fields as decimal seconds. The P2P `ping` message is handled in a queue with all other commands, so it measures processing backlog, not just network ping." %} +{% assign summary_ping-rpc="sends a P2P ping message to all connected nodes to measure ping time. Results are provided by the `getpeerinfo` RPC pingtime and pingwait fields as decimal seconds. The P2P `ping` message is handled in a queue with all other commands, so it measures processing backlog, not just network ping." %} {% assign summary_preciousBlock="treats a block as if it were received before others with the same work." %} {% assign summary_prioritiseTransaction="adds virtual priority or fee to a transaction, allowing it to be accepted into blocks mined by this node (or miners which use this node) with a lower priority or fee. (It can also remove virtual priority or fee, requiring the transaction have a higher priority or fee to be accepted into a locally-mined block.)" %} +{% assign summary_privateSend="controls the mixing process." %} {% assign summary_pruneBlockChain="prunes the blockchain up to a specified height or timestamp." %} {% assign summary_removePrunedFunds="deletes the specified transaction from the wallet. Meant for use with pruned wallets and as a companion to importprunedfunds." %} {% assign summary_restGetBlock-noTxDetails="gets a block with a particular header hash from the local block database either as a JSON object or as a serialized block. The JSON object includes TXIDs for transactions within the block rather than the complete transactions [GET block][rest get block] returns." %} @@ -98,18 +117,20 @@ This file is licensed under the terms of its source texts{%endcomment%} {% assign summary_sendToAddress="spends an amount to a given address." %} {% assign summary_setAccount="puts the specified address in the given account." %} {% assign summary_setBan="attempts add or remove a IP/Subnet from the banned list." %} -{% assign summary_setGenerate="was removed in Bitcoin Core 0.13.0." %} +{% assign summary_setGenerate="enables or disables hashing to attempt to find the next block." %} {% 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." %} {% assign summary_signMessageWithPrivKey="signs a message with a given private key." %} {% assign summary_signRawTransaction="signs a transaction in the serialized transaction format using private keys stored in the wallet or provided in the call." %} -{% assign summary_stop="safely shuts down the Bitcoin Core server." %} -{% assign summary_submitBlock="accepts a block, verifies it is a valid addition to the block chain, and broadcasts it to the network. Extra parameters are ignored by Bitcoin Core but may be used by mining pools or other programs." %} +{% assign summary_spork-rpc="" %} +{% assign summary_stop="safely shuts down the Dash Core server." %} +{% assign summary_submitBlock="accepts a block, verifies it is a valid addition to the block chain, and broadcasts it to the network. Extra parameters are ignored by Dash Core but may be used by mining pools or other programs." %} {% assign summary_validateAddress="returns information about the given Bitcoin address." %} {% assign summary_verifyChain="verifies each entry in the local block chain database." %} {% assign summary_verifyMessage="verifies a signed message." %} {% assign summary_verifyTxOutProof="verifies that a proof points to one or more transactions in a block, returning the transactions the proof commits to and throwing an RPC error if the block is not in our best block chain." %} +{% assign summary_voteRaw="" %} {% assign summary_walletLock="removes the wallet encryption key from memory, locking the wallet. After calling this method, you will need to call `walletpassphrase` again before being able to call any methods which require the wallet to be unlocked." %} {% assign summary_walletPassphrase="stores the wallet decryption key in memory for the indicated number of seconds. Issuing the `walletpassphrase` command while the wallet is already unlocked will set a new unlock time that overrides the old one." %} {% assign summary_walletPassphraseChange="changes the wallet passphrase from 'old passphrase' to 'new passphrase'." %} diff --git a/_includes/layout/base/footer-menu.html b/_includes/layout/base/footer-menu.html index 48a2969d..fe92e0c2 100644 --- a/_includes/layout/base/footer-menu.html +++ b/_includes/layout/base/footer-menu.html @@ -3,6 +3,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} +{% comment %}

Bitcoin.org is community supported: 1GwV7fPX97hmavc6iNrUZUogmjpLPrPFoE

@@ -20,3 +21,4 @@ http://opensource.org/licenses/MIT. {% translate menu-about-us layout %} Blog +{% endcomment %} diff --git a/_includes/layout/base/head-logo.html b/_includes/layout/base/head-logo.html index 1de7c8f6..43f52826 100644 --- a/_includes/layout/base/head-logo.html +++ b/_includes/layout/base/head-logo.html @@ -3,4 +3,4 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} - + diff --git a/_includes/layout/base/html-head.html b/_includes/layout/base/html-head.html index f8da1592..98f54f46 100644 --- a/_includes/layout/base/html-head.html +++ b/_includes/layout/base/html-head.html @@ -4,7 +4,7 @@ http://opensource.org/licenses/MIT. {% endcomment %} - + {% capture title %}{% translate title %}{% endcapture %}{% if title != '' %}{{ title }}{% else %}{{ page.title }}{% endif %} {% capture metadescription %}{% translate metadescription %}{% endcapture %}{% if metadescription != '' %}{% endif %} diff --git a/_includes/layout/base/pagetop-alert.html b/_includes/layout/base/pagetop-alert.html index 6e2a2836..fc9d35fb 100644 --- a/_includes/layout/base/pagetop-alert.html +++ b/_includes/layout/base/pagetop-alert.html @@ -3,8 +3,10 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} +{% comment %} {% if site.ALERT %} {% endif %} +{% endcomment %} diff --git a/_includes/layout/base/pagetop-donation.html b/_includes/layout/base/pagetop-donation.html index eb0b4e21..0bedf391 100644 --- a/_includes/layout/base/pagetop-donation.html +++ b/_includes/layout/base/pagetop-donation.html @@ -3,6 +3,7 @@ This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} +{% comment %}

@@ -69,3 +70,4 @@ http://opensource.org/licenses/MIT.

+{% endcomment %} diff --git a/_includes/references.md b/_includes/references.md index c1cb9d04..6a8267db 100644 --- a/_includes/references.md +++ b/_includes/references.md @@ -17,9 +17,28 @@ http://opensource.org/licenses/MIT. [merge]: /en/developer-guide#term-merge "Spending, in the same transaction, multiple outputs which can be traced back to different previous spenders, leaking information about how many satoshis you control" [merge avoidance]: /en/developer-guide#term-merge-avoidance "A strategy for selecting which outputs to spend that avoids merging outputs with different histories that could leak private information" [message]: /en/developer-guide#term-message "A parameter of bitcoin: URIs which allows the receiver to optionally specify a message to the spender" + [msg_tx]: /en/developer-reference#term-msg_tx "The TXID data type identifier of an inventory on the P2P network" [msg_block]: /en/developer-reference#term-msg_block "The block header hash data type identifier of an inventory on the P2P network" [msg_filtered_block]: /en/developer-reference#term-msg_block "An alternative to the block header hash data type identifier of an inventory on the P2P network used to request a merkle block" + +[msg_txlock_request]: /en/developer-reference#term-msg_txlock_request "The InstantSend TX Lock request data type identifier of an inventory on the P2P network" +[msg_txlock_vote]: /en/developer-reference#term-msg_txlock_vote "The InstantSend TX Lock vote data type identifier of an inventory on the P2P network" +[msg_spork]: /en/developer-reference#term-msg_spork "The Spork ID data type identifier of an inventory on the P2P network" +[msg_masternode_payment_vote]: /en/developer-reference#term-msg_masternode_payment_vote "Masternode Payment Vote data type identifier of an inventory on the P2P network" +[msg_masternode_payment_block]: /en/developer-reference#term-msg_masternode_payment_block "Masternode Payment Block data type identifier of an inventory on the P2P network" +[msg_budget_vote]: /en/developer-reference#term-msg_budget_vote "Deprecated budget related data type identifier of an inventory on the P2P network" +[msg_budget_proposal]: /en/developer-reference#term-msg_budget_proposal "Deprecated budget related data type identifier of an inventory on the P2P network" +[msg_budget_finalized]: /en/developer-reference#term-msg_budget_finalized "Deprecated budget related data type identifier of an inventory on the P2P network" +[msg_budget_finalized_vote]: /en/developer-reference#term-msg_budget_finalized_vote "Deprecated budget related data type identifier of an inventory on the P2P network" +[msg_masternode_quorum]: /en/developer-reference#term-msg_masternode_quorum "Not implemented" +[msg_masternode_announce]: /en/developer-reference#term-msg_masternode_announce "Masternode broadcast data type identifier of an inventory on the P2P network" +[msg_masternode_ping]: /en/developer-reference#term-msg_masternode_ping "Masternode Ping data type identifier of an inventory on the P2P network" +[msg_dstx]: /en/developer-reference#term-msg_dstx "PrivateSend TX broadcast data type identifier of an inventory on the P2P network" +[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" + [network]: /en/developer-guide#term-network "The Bitcoin 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)" [op_checksig]: /en/developer-reference#term-op-checksig "Opcode which returns true if a signature signs the correct parts of a transaction and matches a provided public key" @@ -61,7 +80,7 @@ http://opensource.org/licenses/MIT. [URI QR Code]: /en/developer-guide#term-uri-qr-code "A QR code containing a bitcoin: URI" [v2 block]: /en/developer-reference#term-v2-block "The current version of Bitcoin blocks" [verified payments]: /en/developer-guide#verifying-payment "Payments which the receiver believes won't be double spent" -[wallet support]: /en/developer-reference#term-wallet-support "A Bitcoin Core ./configure option that enables (default) or disables the wallet" +[wallet support]: /en/developer-reference#term-wallet-support "A Dash Core ./configure option that enables (default) or disables the wallet" {% comment %}{% endcomment %} [rpc abandontransaction]: /en/developer-reference#abandontransaction @@ -73,6 +92,7 @@ http://opensource.org/licenses/MIT. [rpc clearbanned]: /en/developer-reference#clearbanned [rpc createmultisig]: /en/developer-reference#createmultisig [rpc createrawtransaction]: /en/developer-reference#createrawtransaction +[rpc debug]: /en/developer-reference#debug [rpc decoderawtransaction]: /en/developer-reference#decoderawtransaction [rpc decodescript]: /en/developer-reference#decodescript [rpc disconnectnode]: /en/developer-reference#disconnectnode @@ -87,19 +107,27 @@ http://opensource.org/licenses/MIT. [rpc getaccount]: /en/developer-reference#getaccount [rpc getaccountaddress]: /en/developer-reference#getaccountaddress [rpc getaddednodeinfo]: /en/developer-reference#getaddednodeinfo +[rpc getaddressbalance]: /en/developer-reference#getaddressbalance +[rpc getaddressdeltas]: /en/developer-reference#getaddressdeltas [rpc getaddressesbyaccount]: /en/developer-reference#getaddressesbyaccount +[rpc getaddressmempool]: /en/developer-reference#getaddressmempool +[rpc getaddresstxids]: /en/developer-reference#getaddresstxids +[rpc getaddressutxos]: /en/developer-reference#getaddressutxos [rpc getbalance]: /en/developer-reference#getbalance [rpc getbestblockhash]: /en/developer-reference#getbestblockhash [rpc getblock]: /en/developer-reference#getblock [rpc getblockchaininfo]: /en/developer-reference#getblockchaininfo [rpc getblockcount]: /en/developer-reference#getblockcount [rpc getblockhash]: /en/developer-reference#getblockhash +[rpc getblockhashes]: /en/developer-reference#getblockhashes [rpc getblockheader]: /en/developer-reference#getblockheader +[rpc getblockheaders]: /en/developer-reference#getblockheaders [rpc getblocktemplate]: /en/developer-reference#getblocktemplate [rpc getchaintips]: /en/developer-reference#getchaintips [rpc getconnectioncount]: /en/developer-reference#getconnectioncount [rpc getdifficulty]: /en/developer-reference#getdifficulty [rpc getgenerate]: /en/developer-reference#getgenerate +[rpc getgovernanceinfo]: /en/developer-reference#getgovernanceinfo [rpc gethashespersec]: /en/developer-reference#gethashespersec [rpc getinfo]: /en/developer-reference#getinfo [rpc getmemoryinfo]: /en/developer-reference#getmemoryinfo @@ -113,11 +141,14 @@ http://opensource.org/licenses/MIT. [rpc getnetworkinfo]: /en/developer-reference#getnetworkinfo [rpc getnewaddress]: /en/developer-reference#getnewaddress [rpc getpeerinfo]: /en/developer-reference#getpeerinfo +[rpc getpoolinfo]: /en/developer-reference#getpoolinfo [rpc getrawchangeaddress]: /en/developer-reference#getrawchangeaddress [rpc getrawmempool]: /en/developer-reference#getrawmempool [rpc getrawtransaction]: /en/developer-reference#getrawtransaction [rpc getreceivedbyaccount]: /en/developer-reference#getreceivedbyaccount [rpc getreceivedbyaddress]: /en/developer-reference#getreceivedbyaddress +[rpc getspentinfo]: /en/developer-reference#getspentinfo +[rpc getsuperblockbudget]: /en/developer-reference#getsuperblockbudget [rpc gettransaction]: /en/developer-reference#gettransaction [rpc gettxout]: /en/developer-reference#gettxout [rpc gettxoutproof]: /en/developer-reference#gettxoutproof @@ -125,6 +156,7 @@ http://opensource.org/licenses/MIT. [rpc getunconfirmedbalance]: /en/developer-reference#getunconfirmedbalance [rpc getwalletinfo]: /en/developer-reference#getwalletinfo [rpc getwork]: /en/developer-reference#getwork +[rpc gobject]: /en/developer-reference#gobject [rpc help]: /en/developer-reference#help [rpc importaddress]: /en/developer-reference#importaddress [rpc importmulti]: /en/developer-reference#importmulti @@ -142,11 +174,16 @@ http://opensource.org/licenses/MIT. [rpc listtransactions]: /en/developer-reference#listtransactions [rpc listunspent]: /en/developer-reference#listunspent [rpc lockunspent]: /en/developer-reference#lockunspent +[rpc masternode]: /en/developer-reference#masternode +[rpc masternodebroadcast]: /en/developer-reference#masternodebroadcast +[rpc masternodelist]: /en/developer-reference#masternodelist +[rpc mnsync]: /en/developer-reference#mnsync [rpc move]: /en/developer-reference#move [rpc ping]: /en/developer-reference#ping-rpc [rpc preciousblock]: /en/developer-reference#preciousblock [rpc pruneblockchain]: /en/developer-reference#pruneblockchain [rpc prioritisetransaction]: /en/developer-reference#prioritisetransaction +[rpc privatesend]: /en/developer-reference#privatesend [rpc removeprunedfunds]: /en/developer-reference#removeprunedfunds [rpc sendfrom]: /en/developer-reference#sendfrom [rpc sendmany]: /en/developer-reference#sendmany @@ -160,12 +197,14 @@ http://opensource.org/licenses/MIT. [rpc signmessage]: /en/developer-reference#signmessage [rpc signmessagewithprivkey]: /en/developer-reference#signmessagewithprivkey [rpc signrawtransaction]: /en/developer-reference#signrawtransaction +[rpc spork]: /en/developer-reference#spork-rpc [rpc stop]: /en/developer-reference#stop [rpc submitblock]: /en/developer-reference#submitblock [rpc validateaddress]: /en/developer-reference#validateaddress [rpc verifychain]: /en/developer-reference#verifychain [rpc verifymessage]: /en/developer-reference#verifymessage [rpc verifytxoutproof]: /en/developer-reference#verifytxoutproof +[rpc voteraw]: /en/developer-reference#voteraw [rpc walletlock]: /en/developer-reference#walletlock [rpc walletpassphrase]: /en/developer-reference#walletpassphrase [rpc walletpassphrasechange]: /en/developer-reference#walletpassphrasechange @@ -184,6 +223,15 @@ 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" +[dsa message]: /en/developer-reference#dsa "A P2P network message used to reply to a P2P network dsq message" +[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 to indicate the queue is ready and the user is expected to send the entry inputs to start mixing" +[dsi message]: /en/developer-reference#dsi "A P2P network message sent as the final mixing transaction in a PrivateSend mixing session" +[dseg message]: /en/developer-reference#dseg "A P2P network message which requests either the entire masternode list or a specific masternode entry" +[dss message]: /en/developer-reference#dss "A P2P network message which sends the user’s signed inputs for a group transaction in a mixing session" +[dssu message]: /en/developer-reference#dssu "A P2P network message providing a mixing pool status update" +[dsq message]: /en/developer-reference#dsq "A P2P network message asking users to sign a final mixing TX messages" +[dstx message]: /en/developer-reference#dstx "A P2P network message sent by masternodes to broadcast subsidized transactions without fees (provides security in mixing)" [feefilter message]: /en/developer-reference#feefilter "The P2P network message which requests the receiving peer not relay any transactions below the specified fee rate" [filteradd message]: /en/developer-reference#filteradd "A P2P protocol message used to add a data element to an existing bloom filter." [filterclear message]: /en/developer-reference#filterclear "A P2P protocol message used to remove an existing bloom filter." @@ -192,16 +240,29 @@ http://opensource.org/licenses/MIT. [getblocks message]: /en/developer-reference#getblocks "A P2P protocol message used to request an inv message containing a range of block header hashes" [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" +[govobj message]: /en/developer-reference#govobj "A P2P network message used to send governance objects (proposals, etc.)" +[govobjvote message]: /en/developer-reference#govobjvote "A P2P network message used to send governance object votes" +[govsync message]: /en/developer-reference#govsync "A P2P network message used to synchronize governance objects" [headers message]: /en/developer-reference#headers "A P2P protocol message containing one or more block headers" [inv message]: /en/developer-reference#inv "A P2P protocol message used to send inventories of transactions and blocks known to the transmitting peer" +[ix message]: /en/developer-reference#ix "A P2P protocol message which sends a single serialized transaction via InstantSend" [mempool message]: /en/developer-reference#mempool "A P2P protocol message used to request one or more inv messages with currently-unconfirmed transactions" [merkleblock message]: /en/developer-reference#merkleblock "A P2P protocol message used to request a filtered block useful for SPV proofs" +[mnb message]: /en/developer-reference#mnb "A P2P protocol message used to describe the masternode entry and how to validate messages from it" +[mnget message]: /en/developer-reference#mnget "A P2P protocol message that requests masternode payment sync" +[mnp message]: /en/developer-reference#mnp "A P2P protocol message sent by masternodes every few minutes to ping the network with a message that propagates across the whole network" +[mnv message]: /en/developer-reference#mnv "A P2P protocol message used by masternodes to verify other masternode's IP Addresses." +[mnw message]: /en/developer-reference#mnw "A P2P protocol message used to pick the next winning masternode (payee)" [notfound message]: /en/developer-reference#notfound "A P2P protocol message sent to indicate that the requested data was not available" [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" [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 ()" [tx message]: /en/developer-reference#tx "A P2P protocol message which sends a single serialized transaction" +[txlvote message]: /en/developer-reference#txlvote "A P2P protocol message which masternodes send in response to an ix (transaction lock request) message if the transaction inputs can be locked." [verack message]: /en/developer-reference#verack "A P2P network message sent in reply to a version message to confirm a connection has been established" [version message]: /en/developer-reference#version "A P2P network message sent at the begining of a connection to allow protocol version negotiation" @@ -261,8 +322,8 @@ http://opensource.org/licenses/MIT. [bitcoinpdf]: https://bitcoin.org/en/bitcoin-paper [choose your wallet]: /en/choose-your-wallet [communities]: /en/community -[core executable]: /en/download -[dev communities]: /en/development#devcommunities +[core executable]: https://www.dash.org/wallets/#wallets +[dev communities]: https://www.dash.org/community/ [developer documentation]: /en/developer-documentation [devex complex raw transaction]: /en/developer-examples#complex-raw-transaction [devex payment protocol]: /en/developer-examples#payment-protocol @@ -324,6 +385,7 @@ http://opensource.org/licenses/MIT. [BIP50]: https://github.com/bitcoin/bips/blob/master/bip-0050.mediawiki [BIP61]: https://github.com/bitcoin/bips/blob/master/bip-0061.mediawiki [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 [BIP70]: https://github.com/bitcoin/bips/blob/master/bip-0070.mediawiki [BIP71]: https://github.com/bitcoin/bips/blob/master/bip-0071.mediawiki @@ -347,12 +409,12 @@ http://opensource.org/licenses/MIT. [#bitcoin-mining]: https://webchat.freenode.net/?channels=bitcoin-mining&uio=d4 [#bitcoin-wiki]: https://webchat.freenode.net/?channels=bitcoin-wiki&uio=d4 [0bin]: http://0bin.net/ -[bcc automated testing]: https://github.com/bitcoin/bitcoin/blob/master/README.md#automated-testing +[bcc automated testing]: https://github.com/dashpay/dash/blob/master/README.md#automated-testing [bcc configuration]: https://en.bitcoin.it/wiki/Running_Bitcoin [bcc data directory]: https://en.bitcoin.it/wiki/Data_directory -[bcc issues]: https://github.com/bitcoin/bitcoin/issues -[bcc new issue]: https://github.com/bitcoin/bitcoin/issues/new -[bcc pulls]: https://github.com/bitcoin/bitcoin/pulls +[bcc issues]: https://github.com/dashpay/dash/issues +[bcc new issue]: https://github.com/dashpay/dash/issues/new +[bcc pulls]: https://github.com/dashpay/dash/pulls [bcc tor]: https://en.bitcoin.it/wiki/Tor [bcc tor hs]: https://en.bitcoin.it/wiki/Tor#Hidden_services [core github tag]: https://github.com/bitcoin-dot-org/bitcoin.org/labels/Core @@ -364,11 +426,11 @@ http://opensource.org/licenses/MIT. [Bitcoin Core 0.3.11]: https://github.com/bitcoin/bitcoin/commit/343328c6b8db85e58a1feea85f0d10e62967fa19 [Bitcoin Core 0.3.15]: https://github.com/bitcoin/bitcoin/commit/c891967b6fcab2e8dc4ce0c787312b36c07efa4d [Bitcoin Core 0.3.18]: https://github.com/bitcoin/bitcoin/commit/82201801336f64ee77851b9eaab9383ee4e442f0 -[Bitcoin Core build unix]: https://github.com/bitcoin/bitcoin/blob/master/doc/build-unix.md -[Bitcoin Core docs directory]: https://github.com/bitcoin/bitcoin/tree/master/doc +[Bitcoin Core build unix]: https://github.com/dashpay/dash/blob/master/doc/build-unix.md +[Bitcoin Core docs directory]: https://github.com/dashpay/dash/tree/master/doc [bitcoin core fee drop commit]: https://github.com/bitcoin/bitcoin/commit/6a4c196dd64da2fd33dc7ae77a8cdd3e4cf0eff1 [Bitcoin Core issue #2381]: https://github.com/bitcoin/bitcoin/issues/2381 -[Bitcoin Core master]: https://github.com/bitcoin/bitcoin +[Bitcoin Core master]: https://github.com/dashpay/dash [Bitcoin Core pull #4468]: https://github.com/bitcoin/bitcoin/pull/4468 [Bitcoin core transifex]: https://www.transifex.com/projects/p/bitcoin/ [Bitcoin reddit]: http://www.reddit.com/r/Bitcoin @@ -376,28 +438,29 @@ http://opensource.org/licenses/MIT. [Bitcoin Seeder]: https://github.com/sipa/bitcoin-seeder [Bitcoin stackexchange]: http://bitcoin.stackexchange.com [Bitcoin stackexchange tag bitcoin-qt]: http://bitcoin.stackexchange.com/questions/tagged/bitcoin-qt -[bitcoin-documentation mailing list]: https://groups.google.com/forum/#!forum/bitcoin-documentation + [BitcoinJ]: http://bitcoinj.github.io [BitcoinJ documentation about pending transaction safety]: https://bitcoinj.github.io/security-model#pending-transactions [bitcoinj micropayment tutorial]: https://bitcoinj.github.io/working-with-micropayments [block170]: https://www.biteasy.com/block/00000000d1145790a8694403d4063f323d499e655c83426834d4ce2f8dd4a2ee [casascius address utility]: https://github.com/casascius/Bitcoin-Address-Utility -[core base58.h]: https://github.com/bitcoin/bitcoin/blob/master/src/base58.h -[core chainparams.cpp]: https://github.com/bitcoin/bitcoin/blob/master/src/chainparams.cpp -[core git]: https://github.com/bitcoin/bitcoin -[core paymentrequest.proto]: https://github.com/bitcoin/bitcoin/blob/master/src/qt/paymentrequest.proto -[core script.h]: https://github.com/bitcoin/bitcoin/blob/master/src/script/script.h +[core alert.cpp]: https://github.com/dashpay/dash/blob/master/src/alert.cpp +[core base58.h]: https://github.com/dashpay/dash/blob/master/src/base58.h +[core chainparams.cpp]: https://github.com/dashpay/dash/blob/master/src/chainparams.cpp +[core git]: https://github.com/dashpay/dash/ +[core paymentrequest.proto]: https://github.com/dashpay/dash/blob/master/src/qt/paymentrequest.proto +[core script.h]: https://github.com/dashpay/dash/blob/master/src/script/script.h [creative commons attribution 3.0 license]: https://creativecommons.org/licenses/by/3.0/ [DER]: https://en.wikipedia.org/wiki/X.690#DER_encoding [dig command]: https://en.wikipedia.org/wiki/Dig_%28Unix_command%29 [DNS A records]: http://tools.ietf.org/html/rfc1035#section-3.2.2 -[DNS Seed Policy]: https://github.com/bitcoin/bitcoin/blob/master/doc/dnsseed-policy.md -[docs issue]: https://github.com/bitcoin-dot-org/bitcoin.org/issues +[DNS Seed Policy]: https://github.com/dashpay/dash/blob/master/doc/dnsseed-policy.md +[docs issue]: https://github.com/thephez/dash.org/issues [ECDSA]: https://en.wikipedia.org/wiki/Elliptic_Curve_DSA [edit bandwidth sharing guide]: https://github.com/bitcoin-dot-org/bitcoin.org/edit/master/en/full-node.md [Electrum server]: https://github.com/spesmilo/electrum-server [Eloipool]: https://github.com/luke-jr/eloipool -[errors in docs]: https://github.com/bitcoin-dot-org/bitcoin.org/issues?q=is%3Aissue+label%3A%22Dev+Docs%22 +[errors in docs]: https://github.com/thephez/dash.org/issues?q=is%3Aissue+label%3A%22Dev+Docs%22 [fake satoshi transaction]: https://www.reddit.com/r/Bitcoin/comments/3fv42j/blockchaininfo_spoofed_transactions_problem_aug_4/ [forum tech support]: https://bitcointalk.org/index.php?board=4.0 [ghash betcoin double spend]: https://bitcointalk.org/index.php?topic=321630.msg3445371 @@ -417,7 +480,7 @@ http://opensource.org/licenses/MIT. [libblkmaker]: https://github.com/bitcoin/libblkmaker [localhost]: https://en.wikipedia.org/wiki/Localhost [lying consistently is hard]: https://groups.google.com/forum/#!msg/bitcoinj/Ys13qkTwcNg/9qxnhwnkeoIJ -[makeseeds script]: https://github.com/bitcoin/bitcoin/tree/master/contrib/seeds +[makeseeds script]: https://github.com/dashpay/dash/tree/master/contrib/seeds [mozilla's bug reporting documentation]: https://developer.mozilla.org/en-US/docs/Mozilla/QA/Bug_writing_guidelines#Writing_precise_steps_to_reproduce [murmur3]: https://en.wikipedia.org/wiki/MurmurHash [man-in-the-middle]: https://en.wikipedia.org/wiki/Man-in-the-middle_attack @@ -428,8 +491,8 @@ http://opensource.org/licenses/MIT. [netcat]: https://en.wikipedia.org/wiki/Netcat [nop opcodes]: https://en.bitcoin.it/wiki/Script#Reserved_words [offline transactions]: http://bitcoin.stackexchange.com/a/34122/21052 -[open a pull request]: https://github.com/bitcoin-dot-org/bitcoin.org#working-with-github -[open an issue]: https://github.com/bitcoin-dot-org/bitcoin.org/issues/new +[open a pull request]: https://github.com/thephez/dash.org#working-with-github +[open an issue]: https://github.com/thephez/dash.org/issues/new [Payment Request Generator]: https://github.com/gavinandresen/paymentrequest/blob/master/php/demo_website/createpaymentrequest.php [Piotr Piasecki's testnet faucet]: https://tpfaucet.appspot.com/ [prime symbol]: https://en.wikipedia.org/wiki/Prime_%28symbol%29 @@ -441,6 +504,7 @@ http://opensource.org/licenses/MIT. [SHA256]: https://en.wikipedia.org/wiki/SHA-2 [Stratum mining protocol]: http://mining.bitcoin.cz/stratum-mining [study of SPV privacy over tor]: http://arxiv.org/abs/1410.6079 +[superblock example]: https://chainz.cryptoid.info/dash/block.dws?731104.htm [Tor]: https://en.wikipedia.org/wiki/Tor_%28anonymity_network%29 [transifex]: https://www.transifex.com/projects/p/bitcoinorg/ [unix epoch time]: https://en.wikipedia.org/wiki/Unix_time @@ -457,7 +521,11 @@ http://opensource.org/licenses/MIT. {% comment %} {% endcomment %} -[core bloom.cpp hash]: https://github.com/bitcoin/bitcoin/blob/cbf28c6619fe348a258dfd7d08bdbd2392d07511/src/bloom.cpp#L46 -[MAX_SIZE]: https://github.com/bitcoin/bitcoin/blob/60abd463ac2eaa8bc1d616d8c07880dc53d97211/src/serialize.h#L23 -[rpcprotocol.h]: https://github.com/bitcoin/bitcoin/blob/f914f1a746d7f91951c1da262a4a749dd3ebfa71/src/rpcprotocol.h +periodically to point to recent code. Last update: 2017-09-05 --> {% endcomment %} +[core bloom.cpp hash]: https://github.com/dashpay/dash/blob/333e1eaeea80344e5a28db6efbce2691c85e2b25/src/bloom.cpp#L58 +[MAX_SIZE]: https://github.com/dashpay/dash/blob/c31ba8ba4c07e72620bd71753f2103ca103bb1c2/src/serialize.h#L26 +[rpcprotocol.h]: https://github.com/dashpay/dash/blob/3e0eee4c84f40b3cf277e8d03e004249d03c081d/src/rpcprotocol.h +[spork.h]: https://github.com/dashpay/dash/blob/e1702cd4eca5f276c75cae9de0eb274369b031f6/src/spork.h#L22 +[spork pubkey]: https://github.com/dashpay/dash/blob/eaf90b77177efbaf9cbed46e822f0d794f1a0ee5/src/chainparams.cpp#L158 +[masternode payments pubkey]: https://github.com/dashpay/dash/blob/eaf90b77177efbaf9cbed46e822f0d794f1a0ee5/src/chainparams.cpp#L159 +[block subsidy]: https://github.com/dashpay/dash/blob/9ed9474a9eb007bba70278ce19df68e84aeeb712/src/main.cpp#L1741 diff --git a/_layouts/post.html b/_layouts/post.html index 646e44f8..697195fc 100644 --- a/_layouts/post.html +++ b/_layouts/post.html @@ -9,8 +9,8 @@ lang: en +| Post history +| Report issue
diff --git a/_plugins/glossary.rb b/_plugins/glossary.rb index b09b3f06..4d031703 100644 --- a/_plugins/glossary.rb +++ b/_plugins/glossary.rb @@ -22,8 +22,8 @@ module Jekyll ## Pass in the full path to enable edit-on-github links self.data["filename"] = srcdir + '/' + src - ## Page Title: - Bitcoin Glossary - self.data["title"] = self.data["required"]["title_max_40_characters_no_formatting"] + " - Bitcoin Glossary" + ## Page Title: <title> - Dash Glossary + self.data["title"] = self.data["required"]["title_max_40_characters_no_formatting"] + " - Dash Glossary" ## Output file is v<version>.md (converted later to HTML) @name = output_file diff --git a/_templates/events.html b/_templates/events.html index 545856dc..f7e6f806 100644 --- a/_templates/events.html +++ b/_templates/events.html @@ -30,7 +30,7 @@ id: events {% for p in date_sorted_conferences %} <div><div>{{ p.date | date:"%Y-%m-%d" }}</div><div><a href="{{ p.link | htmlescape }}">{{ p.title | htmlescape }}</a></div><div>{{ p.city | htmlescape }}, {{ p.country | htmlescape }}</div></div> {% endfor %} - <span><a href="https://github.com/bitcoin-dot-org/bitcoin.org/issues/new?title=New%20event&body=%20%20%20%20-%20date%3A%20YYYY-MM-DD%0A%20%20%20%20%20%20title%3A%20%22%22%0A%20%20%20%20%20%20venue%3A%20%22%22%0A%20%20%20%20%20%20address%3A%20%22%22%0A%20%20%20%20%20%20city%3A%20%22%22%0A%20%20%20%20%20%20country%3A%20%22%22%0A%20%20%20%20%20%20link%3A%20%22%22">{% translate eventsubmit %}</a></span> + <span><a href="https://github.com/thephez/dash.org/issues/new?title=New%20event&body=%20%20%20%20-%20date%3A%20YYYY-MM-DD%0A%20%20%20%20%20%20title%3A%20%22%22%0A%20%20%20%20%20%20venue%3A%20%22%22%0A%20%20%20%20%20%20address%3A%20%22%22%0A%20%20%20%20%20%20city%3A%20%22%22%0A%20%20%20%20%20%20country%3A%20%22%22%0A%20%20%20%20%20%20link%3A%20%22%22">{% translate eventsubmit %}</a></span> </div> <p>{% translate meetupgroup %}</p> diff --git a/_translations/en.yml b/_translations/en.yml index fd3a79f7..948a8d1b 100644 --- a/_translations/en.yml +++ b/_translations/en.yml @@ -587,7 +587,7 @@ en: readmore: "Going down the rabbit hole" readmoretxt: "This is only a very short and concise summary of the system. If you want to get into the details, you can <a href=\"#bitcoin-paper#\">read the original paper</a> that describes the system's design, read the <a href=\"/en/developer-documentation\">developer documentation</a>, and explore the <a href=\"https://en.bitcoin.it/wiki/Main_Page\">Bitcoin wiki</a>." index: - title: "Bitcoin - Open source P2P money" + title: "Dash - Open source P2P money" metadescription: "Bitcoin is an innovative payment network and a new kind of money. Find all you need to know and get started with Bitcoin on bitcoin.org." listintro: "Bitcoin is an innovative payment network and a new kind of money." list1: "Fast peer-to-peer<br>transactions" diff --git a/en/developer-documentation.md b/en/developer-documentation.md index aaa68744..79d74eca 100644 --- a/en/developer-documentation.md +++ b/en/developer-documentation.md @@ -5,7 +5,7 @@ layout: base lang: en id: developer-documentation -title: "Developer Documentation - Bitcoin" +title: "Developer Documentation - Dash" breadcrumbs: - bitcoin - Developer Documentation diff --git a/en/developer-examples.md b/en/developer-examples.md index 2377bd0d..d3676e75 100644 --- a/en/developer-examples.md +++ b/en/developer-examples.md @@ -7,7 +7,7 @@ lang: en id: developer-examples title: "Developer Examples - Bitcoin" breadcrumbs: - - bitcoin +# - bitcoin - dev docs - Examples end_of_page: | diff --git a/en/developer-glossary.html b/en/developer-glossary.html index 78420ff0..f31f729c 100644 --- a/en/developer-glossary.html +++ b/en/developer-glossary.html @@ -2,11 +2,10 @@ # This file is licensed under the MIT License (MIT) available on # http://opensource.org/licenses/MIT. -title: Developer Glossary - Bitcoin +title: Developer Glossary - Dash layout: base lang: en breadcrumbs: - - bitcoin - dev docs - Glossary end_of_page: | @@ -17,7 +16,7 @@ end_of_page: | <link rel="stylesheet" href="/css/jquery-ui.min.css"> {% capture markdown_content %} -# Bitcoin Developer Glossary +# Dash Developer Glossary <input id="glossary_term" class="glossary_term" placeholder="Search the glossary, RPCs, and more"> @@ -74,7 +73,7 @@ page](/en/vocabulary).</span> {% when 'p' %} See also: [P2P protocol messages](/en/developer-reference#data-messages) {% when 'r' %} - See also: [Bitcoin Core RPCs](/en/developer-reference#rpc-quick-reference) + See also: [Dash Core RPCs](/en/developer-reference#rpc-quick-reference) {% endcase %} <ul class="wrapped_list"> @@ -91,7 +90,7 @@ page](/en/vocabulary).</span> new term][] for the glossary!</span> </div> -[suggest a new term]: https://github.com/bitcoin-dot-org/bitcoin.org/issues/new?title=New%20glossary%20term%20suggestion: +[suggest a new term]: https://github.com/thephez/dash.org/issues/new?title=New%20glossary%20term%20suggestion: {% include references.md %} {{site.glossary_links}} {% endcapture %} diff --git a/en/developer-guide.md b/en/developer-guide.md index 0161a5de..1d5ff8af 100644 --- a/en/developer-guide.md +++ b/en/developer-guide.md @@ -7,7 +7,7 @@ lang: en id: developer-guide title: "Developer Guide - Bitcoin" breadcrumbs: - - bitcoin +# - bitcoin - dev docs - Guide end_of_page: | diff --git a/en/developer-reference.md b/en/developer-reference.md index f71320a7..53140573 100644 --- a/en/developer-reference.md +++ b/en/developer-reference.md @@ -5,9 +5,9 @@ layout: base lang: en id: developer-reference -title: "Developer Reference - Bitcoin" +title: "Developer Reference - Dash" breadcrumbs: - - bitcoin +# - bitcoin - dev docs - Reference end_of_page: | @@ -20,7 +20,7 @@ end_of_page: | <!-- This should be empty, but comment it out just in case: {% include helpers/vars.md %} --> -# Bitcoin Developer Reference +# Dash Developer Reference <p class="summary">Find technical details and API documentation.</p> @@ -30,8 +30,8 @@ end_of_page: | {:toc} <ul class="goback"><li><a href="/en/developer-documentation">Return To Overview</a></li></ul> -<ul class="reportissue"><li><a href="https://github.com/bitcoin-dot-org/bitcoin.org/issues/new" onmouseover="updateIssue(event);">Report An Issue</a></li></ul> -<ul class="editsource"><li><a href="https://github.com/bitcoin-dot-org/bitcoin.org/tree/master/_includes" onmouseover="updateSource(event);">Edit On GitHub</a></li></ul> +<ul class="reportissue"><li><a href="https://github.com/thephez/dash.org/issues/new" onmouseover="updateIssue(event);">Report An Issue</a></li></ul> +<ul class="editsource"><li><a href="https://github.com/thephez/dash.org/tree/master/_includes" onmouseover="updateSource(event);">Edit On GitHub</a></li></ul> </div></div> <div markdown="1" class="toccontent"> @@ -50,11 +50,11 @@ end_of_page: | {% include devdoc/ref_p2p_networking.md %} -{% include devdoc/bitcoin-core/api-intro.md %} +{% include devdoc/dash-core/api-intro.md %} -{% include devdoc/bitcoin-core/rpcs/intro.md %} +{% include devdoc/dash-core/rpcs/intro.md %} -{% include devdoc/bitcoin-core/rpcs/quick-reference.md %} +{% include devdoc/dash-core/rpcs/quick-reference.md %} #### RPCs <!-- no subhead-links here --> @@ -68,219 +68,259 @@ create a cross-site scripting (XSS) exploit. To avoid problems, please treat block chain and memory pool data as an arbitrary input from an untrusted source. -{% include devdoc/bitcoin-core/rpcs/rpcs/abandontransaction.md %} +{% include devdoc/dash-core/rpcs/rpcs/abandontransaction.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/addmultisigaddress.md %} +{% include devdoc/dash-core/rpcs/rpcs/addmultisigaddress.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/addnode.md %} +{% include devdoc/dash-core/rpcs/rpcs/addnode.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/addwitnessaddress.md %} +{% include devdoc/dash-core/rpcs/rpcs/addwitnessaddress.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/backupwallet.md %} +{% include devdoc/dash-core/rpcs/rpcs/backupwallet.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/bumpfee.md %} +{% include devdoc/dash-core/rpcs/rpcs/bumpfee.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/clearbanned.md %} +{% include devdoc/dash-core/rpcs/rpcs/clearbanned.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/createmultisig.md %} +{% include devdoc/dash-core/rpcs/rpcs/createmultisig.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/createrawtransaction.md %} +{% include devdoc/dash-core/rpcs/rpcs/debug.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/decoderawtransaction.md %} +{% include devdoc/dash-core/rpcs/rpcs/createrawtransaction.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/decodescript.md %} +{% include devdoc/dash-core/rpcs/rpcs/decoderawtransaction.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/disconnectnode.md %} +{% include devdoc/dash-core/rpcs/rpcs/decodescript.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/dumpprivkey.md %} +{% include devdoc/dash-core/rpcs/rpcs/disconnectnode.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/dumpwallet.md %} +{% include devdoc/dash-core/rpcs/rpcs/dumpprivkey.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/encryptwallet.md %} +{% include devdoc/dash-core/rpcs/rpcs/dumpwallet.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/estimatefee.md %} +{% include devdoc/dash-core/rpcs/rpcs/encryptwallet.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/estimatepriority.md %} +{% include devdoc/dash-core/rpcs/rpcs/estimatefee.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/fundrawtransaction.md %} +{% include devdoc/dash-core/rpcs/rpcs/estimatepriority.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/generate.md %} +{% include devdoc/dash-core/rpcs/rpcs/fundrawtransaction.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/generatetoaddress.md %} +{% include devdoc/dash-core/rpcs/rpcs/generate.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getaccountaddress.md %} +{% include devdoc/dash-core/rpcs/rpcs/generatetoaddress.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getaccount.md %} +{% include devdoc/dash-core/rpcs/rpcs/getaccountaddress.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getaddednodeinfo.md %} +{% include devdoc/dash-core/rpcs/rpcs/getaccount.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getaddressesbyaccount.md %} +{% include devdoc/dash-core/rpcs/rpcs/getaddednodeinfo.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getbalance.md %} +{% include devdoc/dash-core/rpcs/rpcs/getaddressbalance.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getbestblockhash.md %} +{% include devdoc/dash-core/rpcs/rpcs/getaddressdeltas.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getblock.md %} +{% include devdoc/dash-core/rpcs/rpcs/getaddressesbyaccount.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getblockchaininfo.md %} +{% include devdoc/dash-core/rpcs/rpcs/getaddressmempool.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getblockcount.md %} +{% include devdoc/dash-core/rpcs/rpcs/getaddresstxids.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getblockhash.md %} +{% include devdoc/dash-core/rpcs/rpcs/getaddressutxos.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getblockheader.md %} +{% include devdoc/dash-core/rpcs/rpcs/getbalance.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getblocktemplate.md %} +{% include devdoc/dash-core/rpcs/rpcs/getbestblockhash.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getchaintips.md %} +{% include devdoc/dash-core/rpcs/rpcs/getblock.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getconnectioncount.md %} +{% include devdoc/dash-core/rpcs/rpcs/getblockchaininfo.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getdifficulty.md %} +{% include devdoc/dash-core/rpcs/rpcs/getblockcount.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getgenerate.md %} +{% include devdoc/dash-core/rpcs/rpcs/getblockhash.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/gethashespersec.md %} +{% include devdoc/dash-core/rpcs/rpcs/getblockhashes.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getinfo.md %} +{% include devdoc/dash-core/rpcs/rpcs/getblockheader.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getmemoryinfo.md %} +{% include devdoc/dash-core/rpcs/rpcs/getblockheaders.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getmempoolancestors.md %} +{% include devdoc/dash-core/rpcs/rpcs/getblocktemplate.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getmempooldescendants.md %} +{% include devdoc/dash-core/rpcs/rpcs/getchaintips.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getmempoolentry.md %} +{% include devdoc/dash-core/rpcs/rpcs/getconnectioncount.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getmempoolinfo.md %} +{% include devdoc/dash-core/rpcs/rpcs/getdifficulty.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getmininginfo.md %} +{% include devdoc/dash-core/rpcs/rpcs/getgenerate.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getnettotals.md %} +{% include devdoc/dash-core/rpcs/rpcs/getgovernanceinfo.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getnetworkhashps.md %} +{% include devdoc/dash-core/rpcs/rpcs/gethashespersec.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getnetworkinfo.md %} +{% include devdoc/dash-core/rpcs/rpcs/getinfo.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getnewaddress.md %} +{% include devdoc/dash-core/rpcs/rpcs/getmemoryinfo.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getpeerinfo.md %} +{% include devdoc/dash-core/rpcs/rpcs/getmempoolancestors.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getrawchangeaddress.md %} +{% include devdoc/dash-core/rpcs/rpcs/getmempooldescendants.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getrawmempool.md %} +{% include devdoc/dash-core/rpcs/rpcs/getmempoolentry.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getrawtransaction.md %} +{% include devdoc/dash-core/rpcs/rpcs/getmempoolinfo.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getreceivedbyaccount.md %} +{% include devdoc/dash-core/rpcs/rpcs/getmininginfo.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getreceivedbyaddress.md %} +{% include devdoc/dash-core/rpcs/rpcs/getnettotals.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/gettransaction.md %} +{% include devdoc/dash-core/rpcs/rpcs/getnetworkhashps.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/gettxout.md %} +{% include devdoc/dash-core/rpcs/rpcs/getnetworkinfo.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/gettxoutproof.md %} +{% include devdoc/dash-core/rpcs/rpcs/getnewaddress.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/gettxoutsetinfo.md %} +{% include devdoc/dash-core/rpcs/rpcs/getpeerinfo.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getunconfirmedbalance.md %} +{% include devdoc/dash-core/rpcs/rpcs/getpoolinfo.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getwalletinfo.md %} +{% include devdoc/dash-core/rpcs/rpcs/getrawchangeaddress.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/getwork.md %} +{% include devdoc/dash-core/rpcs/rpcs/getrawmempool.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/help.md %} +{% include devdoc/dash-core/rpcs/rpcs/getrawtransaction.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/importaddress.md %} +{% include devdoc/dash-core/rpcs/rpcs/getreceivedbyaccount.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/importmulti.md %} +{% include devdoc/dash-core/rpcs/rpcs/getreceivedbyaddress.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/importprivkey.md %} +{% include devdoc/dash-core/rpcs/rpcs/getspentinfo.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/importprunedfunds.md %} +{% include devdoc/dash-core/rpcs/rpcs/getsuperblockbudget.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/importwallet.md %} +{% include devdoc/dash-core/rpcs/rpcs/gettransaction.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/keypoolrefill.md %} +{% include devdoc/dash-core/rpcs/rpcs/gettxout.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/listaccounts.md %} +{% include devdoc/dash-core/rpcs/rpcs/gettxoutproof.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/listaddressgroupings.md %} +{% include devdoc/dash-core/rpcs/rpcs/gettxoutsetinfo.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/listbanned.md %} +{% include devdoc/dash-core/rpcs/rpcs/getunconfirmedbalance.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/listlockunspent.md %} +{% include devdoc/dash-core/rpcs/rpcs/getwalletinfo.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/listreceivedbyaccount.md %} +{% include devdoc/dash-core/rpcs/rpcs/getwork.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/listreceivedbyaddress.md %} +{% include devdoc/dash-core/rpcs/rpcs/gobject.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/listsinceblock.md %} +{% include devdoc/dash-core/rpcs/rpcs/help.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/listtransactions.md %} +{% include devdoc/dash-core/rpcs/rpcs/importaddress.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/listunspent.md %} +{% include devdoc/dash-core/rpcs/rpcs/importmulti.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/lockunspent.md %} +{% include devdoc/dash-core/rpcs/rpcs/importprivkey.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/move.md %} +{% include devdoc/dash-core/rpcs/rpcs/importprunedfunds.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/ping.md %} +{% include devdoc/dash-core/rpcs/rpcs/importwallet.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/preciousblock.md %} +{% include devdoc/dash-core/rpcs/rpcs/keypoolrefill.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/prioritisetransaction.md %} +{% include devdoc/dash-core/rpcs/rpcs/listaccounts.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/pruneblockchain.md %} +{% include devdoc/dash-core/rpcs/rpcs/listaddressgroupings.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/removeprunedfunds.md %} +{% include devdoc/dash-core/rpcs/rpcs/listbanned.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/sendfrom.md %} +{% include devdoc/dash-core/rpcs/rpcs/listlockunspent.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/sendmany.md %} +{% include devdoc/dash-core/rpcs/rpcs/listreceivedbyaccount.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/sendrawtransaction.md %} +{% include devdoc/dash-core/rpcs/rpcs/listreceivedbyaddress.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/sendtoaddress.md %} +{% include devdoc/dash-core/rpcs/rpcs/listsinceblock.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/setaccount.md %} +{% include devdoc/dash-core/rpcs/rpcs/listtransactions.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/setban.md %} +{% include devdoc/dash-core/rpcs/rpcs/listunspent.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/setgenerate.md %} +{% include devdoc/dash-core/rpcs/rpcs/lockunspent.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/setnetworkactive.md %} +{% include devdoc/dash-core/rpcs/rpcs/masternode.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/settxfee.md %} +{% include devdoc/dash-core/rpcs/rpcs/masternodebroadcast.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/signmessage.md %} +{% include devdoc/dash-core/rpcs/rpcs/masternodelist.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/signmessagewithprivkey.md %} +{% include devdoc/dash-core/rpcs/rpcs/mnsync.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/signrawtransaction.md %} +{% include devdoc/dash-core/rpcs/rpcs/move.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/stop.md %} +{% include devdoc/dash-core/rpcs/rpcs/ping.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/submitblock.md %} +{% include devdoc/dash-core/rpcs/rpcs/preciousblock.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/validateaddress.md %} +{% include devdoc/dash-core/rpcs/rpcs/privatesend.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/verifychain.md %} +{% include devdoc/dash-core/rpcs/rpcs/prioritisetransaction.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/verifymessage.md %} +{% include devdoc/dash-core/rpcs/rpcs/pruneblockchain.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/verifytxoutproof.md %} +{% include devdoc/dash-core/rpcs/rpcs/removeprunedfunds.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/walletlock.md %} +{% include devdoc/dash-core/rpcs/rpcs/sendfrom.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/walletpassphrase.md %} +{% include devdoc/dash-core/rpcs/rpcs/sendmany.md %} -{% include devdoc/bitcoin-core/rpcs/rpcs/walletpassphrasechange.md %} +{% include devdoc/dash-core/rpcs/rpcs/sendrawtransaction.md %} -{% include devdoc/bitcoin-core/rest/intro.md %} +{% include devdoc/dash-core/rpcs/rpcs/sendtoaddress.md %} -{% include devdoc/bitcoin-core/rest/quick-reference.md %} +{% include devdoc/dash-core/rpcs/rpcs/setaccount.md %} + +{% include devdoc/dash-core/rpcs/rpcs/setban.md %} + +{% include devdoc/dash-core/rpcs/rpcs/setgenerate.md %} + +{% include devdoc/dash-core/rpcs/rpcs/setnetworkactive.md %} + +{% include devdoc/dash-core/rpcs/rpcs/settxfee.md %} + +{% include devdoc/dash-core/rpcs/rpcs/signmessage.md %} + +{% include devdoc/dash-core/rpcs/rpcs/signmessagewithprivkey.md %} + +{% include devdoc/dash-core/rpcs/rpcs/signrawtransaction.md %} + +{% include devdoc/dash-core/rpcs/rpcs/spork.md %} + +{% include devdoc/dash-core/rpcs/rpcs/stop.md %} + +{% include devdoc/dash-core/rpcs/rpcs/submitblock.md %} + +{% include devdoc/dash-core/rpcs/rpcs/validateaddress.md %} + +{% include devdoc/dash-core/rpcs/rpcs/verifychain.md %} + +{% include devdoc/dash-core/rpcs/rpcs/verifymessage.md %} + +{% include devdoc/dash-core/rpcs/rpcs/verifytxoutproof.md %} + +{% include devdoc/dash-core/rpcs/rpcs/voteraw.md %} + +{% include devdoc/dash-core/rpcs/rpcs/walletlock.md %} + +{% include devdoc/dash-core/rpcs/rpcs/walletpassphrase.md %} + +{% include devdoc/dash-core/rpcs/rpcs/walletpassphrasechange.md %} + +{% include devdoc/dash-core/rest/intro.md %} + +{% include devdoc/dash-core/rest/quick-reference.md %} #### Requests <!-- no subhead-links here --> @@ -294,21 +334,21 @@ create a cross-site scripting (XSS) exploit. To avoid problems, please treat block chain and memory pool data as an arbitrary input from an untrusted source. -{% include devdoc/bitcoin-core/rest/requests/get_block.md %} +{% include devdoc/dash-core/rest/requests/get_block.md %} -{% include devdoc/bitcoin-core/rest/requests/get_block-notxdetails.md %} +{% include devdoc/dash-core/rest/requests/get_block-notxdetails.md %} -{% include devdoc/bitcoin-core/rest/requests/get_chaininfo.md %} +{% include devdoc/dash-core/rest/requests/get_chaininfo.md %} -{% include devdoc/bitcoin-core/rest/requests/get_getutxos.md %} +{% include devdoc/dash-core/rest/requests/get_getutxos.md %} -{% include devdoc/bitcoin-core/rest/requests/get_headers.md %} +{% include devdoc/dash-core/rest/requests/get_headers.md %} -{% include devdoc/bitcoin-core/rest/requests/get_mempool-contents.md %} +{% include devdoc/dash-core/rest/requests/get_mempool-contents.md %} -{% include devdoc/bitcoin-core/rest/requests/get_mempool-info.md %} +{% include devdoc/dash-core/rest/requests/get_mempool-info.md %} -{% include devdoc/bitcoin-core/rest/requests/get_tx.md %} +{% include devdoc/dash-core/rest/requests/get_tx.md %} {% include references.md %} {{site.glossary_links}} diff --git a/favicon.ico b/favicon.ico index 2534bce7..ec583c12 100644 Binary files a/favicon.ico and b/favicon.ico differ diff --git a/favicon.png b/favicon.png index 4a753d98..375f9a9c 100644 Binary files a/favicon.png and b/favicon.png differ diff --git a/img/dev/en-p2p-governance-messages.png b/img/dev/en-p2p-governance-messages.png new file mode 100644 index 00000000..2f9fc6d4 Binary files /dev/null and b/img/dev/en-p2p-governance-messages.png differ diff --git a/img/dev/en-p2p-governance-messages.svg b/img/dev/en-p2p-governance-messages.svg new file mode 100644 index 00000000..f8f1959f --- /dev/null +++ b/img/dev/en-p2p-governance-messages.svg @@ -0,0 +1,544 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> +<!-- Generated by graphviz version 2.26.3 (20100126.1600) + --> + +<!-- Title: _anonymous_0 Pages: 1 --> + +<svg + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:cc="http://creativecommons.org/ns#" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns="http://www.w3.org/2000/svg" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + width="450pt" + height="190pt" + viewBox="0 0 450 189.66202" + id="svg3743" + version="1.1" + inkscape:version="0.91 r13725" + sodipodi:docname="en-p2p-governance-messages.svg" + inkscape:export-filename="/home/phez/code/dash.org/img/dev/en-p2p-governance-messages.png" + inkscape:export-xdpi="90" + inkscape:export-ydpi="90"> + <metadata + id="metadata3892"> + <rdf:RDF> + <cc:Work + rdf:about=""> + <dc:format>image/svg+xml</dc:format> + <dc:type + rdf:resource="http://purl.org/dc/dcmitype/StillImage" /> + <dc:title></dc:title> + </cc:Work> + </rdf:RDF> + </metadata> + <defs + id="defs3890"> + <marker + inkscape:stockid="Arrow2Mend" + orient="auto" + refY="0" + refX="0" + id="Arrow2Mend" + style="overflow:visible" + inkscape:isstock="true"> + <path + id="path4438" + style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1" + d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z" + transform="scale(-0.6,-0.6)" + inkscape:connector-curvature="0" /> + </marker> + <marker + inkscape:stockid="Arrow2Lend" + orient="auto" + refY="0" + refX="0" + id="Arrow2Lend" + style="overflow:visible" + inkscape:isstock="true"> + <path + id="path4432" + style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1" + d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z" + transform="matrix(-1.1,0,0,-1.1,-1.1,0)" + inkscape:connector-curvature="0" /> + </marker> + <marker + inkscape:stockid="Arrow2Mend" + orient="auto" + refY="0" + refX="0" + id="Arrow2Mend-0" + style="overflow:visible" + inkscape:isstock="true"> + <path + inkscape:connector-curvature="0" + id="path4438-4" + style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1" + d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z" + transform="scale(-0.6,-0.6)" /> + </marker> + </defs> + <sodipodi:namedview + pagecolor="#ffffff" + bordercolor="#666666" + borderopacity="1" + objecttolerance="10" + gridtolerance="10" + guidetolerance="10" + inkscape:pageopacity="1" + inkscape:pageshadow="2" + inkscape:window-width="1920" + inkscape:window-height="1023" + id="namedview3888" + showgrid="false" + inkscape:zoom="1.5431111" + inkscape:cx="264.46778" + inkscape:cy="126.1599" + inkscape:window-x="0" + inkscape:window-y="31" + inkscape:window-maximized="1" + inkscape:current-layer="g3426" /> + <g + transform="matrix(0.755034,0,0,0.755034,1.4648364,-23.35123)" + class="graph" + id="g3426"> + <title + id="title3428">_anonymous_0 + + Overview Of P2P Protocol Governance Request And Reply Messages + + + + getblocks + + + govsync + + + + + + + + getdata + + + getdata->block + + + + + + + + + + block + + + govobj + + + + + + merkleblock + + + govobjvote + + + + + getdata->merkleblock + + + + + + + + headers + + + + + Request For + Governance Sync + + + + Reply With + Count / Inventory + + + + + label3 + + Request For + Specific Data + + + + + + label4 + + Reply With + Requested Data + + + + + inv->getdata + + + + inv->getdata + + + + + + govsync_response + + ssc + + + ssc + + + + inv + + + inv + + + + getheaders->headers + + + + + govsync_response + + ssc + + + ssc + + + + inv + + + inv + + + + getheaders->headers + + + + + govobjvote + + + govobj + + + + diff --git a/img/icons/logotop.png b/img/icons/logotop.png index dd828830..cc107519 100644 Binary files a/img/icons/logotop.png and b/img/icons/logotop.png differ diff --git a/img/icons/logotop.svg b/img/icons/logotop.svg index 7d852c83..2266fca3 100644 --- a/img/icons/logotop.svg +++ b/img/icons/logotop.svg @@ -1,17 +1,3411 @@ - - - - - - - - - - - - - - - - - + + + + + + + + + + +]> + diff --git a/index.html b/index.html index c36b958e..a4d5e8f2 100755 --- a/index.html +++ b/index.html @@ -5,6 +5,6 @@ layout: base lang: en id: index -title: Bitcoin +title: Dash --- {% include templates/index.html %} diff --git a/init_env.sh b/init_env.sh new file mode 100755 index 00000000..5275f936 --- /dev/null +++ b/init_env.sh @@ -0,0 +1,9 @@ +#!/bin/bash +# Run before building to initialize Ruby stuff +# See docs/setting-up-your-environment.md for more info + +source ~/.rvm/scripts/rvm + +# Set default Ruby +rvm alias create default ruby-2.0.0 +rvm use default diff --git a/js/main.js b/js/main.js index df8385c7..40365744 100644 --- a/js/main.js +++ b/js/main.js @@ -311,7 +311,7 @@ function updateToc() { function updateIssue(e) { // Update GitHub issue link pre-filled with current page location. var t = getEvent(e, 'target'); - t.href = 'https://github.com/bitcoin-dot-org/bitcoin.org/issues/new?body=' + encodeURIComponent('Location: ' + window.location.href.toString() + "\n\n"); + t.href = 'https://github.com/thephez/dash.org/issues/new?body=' + encodeURIComponent('Location: ' + window.location.href.toString() + "\n\n"); } function updateSource(e) { @@ -336,7 +336,7 @@ function updateSource(e) { if (pageoffset < first[1]) closer = [first[0], first[1]]; if (windowy + pageoffset >= getHeight(document.body)) closer = [last[0], last[1]]; // Set updated url to source file. - t.href = 'https://github.com/bitcoin-dot-org/bitcoin.org/edit/master/' + closer[0].getAttribute('data-sourcefile'); + t.href = 'https://github.com/thephez/dash.org/edit/master/' + closer[0].getAttribute('data-sourcefile'); } function disclaimerClose(e) { diff --git a/scripts/build_preview.sh b/scripts/build_preview.sh new file mode 100755 index 00000000..09e33d7e --- /dev/null +++ b/scripts/build_preview.sh @@ -0,0 +1,15 @@ +#!/bin/bash +# Note: run init_env.sh first to prepare Ruby + +# See docs/setting-up-your-environment.md for more info +export BITCOINORG_BUILD_TYPE=preview + +# Update summaries.md +make manual-update-summaries-file + +# Build preview with minimal plugins +ENABLED_PLUGINS="glossary" ENABLED_LANGS="" make preview + +## Fast build and tests, takes less than 50 seconds +## Some tests may fail in fast mode; use -i to continue despite them +#ENABLED_PLUGINS="" ENABLED_LANGS="" make -i valid diff --git a/scripts/build_publish_preview.sh b/scripts/build_publish_preview.sh new file mode 100644 index 00000000..2178d4e3 --- /dev/null +++ b/scripts/build_publish_preview.sh @@ -0,0 +1,11 @@ +#!/bin/bash +# Build static preview site that can be hosted on Github pages (https://pages.github.com/) +# Note: run init_env.sh first to prepare Ruby + +export BITCOINORG_BUILD_TYPE=preview + +# Update summaries.md +make manual-update-summaries-file + +# Build preview with all plugins, but minimal language support +ENABLED_LANGS="" make preview diff --git a/scripts/create_empty_rpc_md.sh b/scripts/create_empty_rpc_md.sh new file mode 100644 index 00000000..ebff0739 --- /dev/null +++ b/scripts/create_empty_rpc_md.sh @@ -0,0 +1,81 @@ +#!/bin/bash +#echo "$# parameters" +#echo "$@"; + +PARAMCOUNT=$# +#echo "$PARAMCOUNT parameters" + +if [ "$PARAMCOUNT" == 1 ]; then + FILENAME=${1,,}.md + RPCNAME=$1 + + echo "{% comment %}" >> $FILENAME + echo "This file is licensed under the MIT License (MIT) available on" >> $FILENAME + echo "http://opensource.org/licenses/MIT." >> $FILENAME + echo "{% endcomment %}" >> $FILENAME + echo '{% assign filename="_includes/devdoc/dash-core/rpcs/rpcs/'$FILENAME'" %}' >> $FILENAME + echo "" >> $FILENAME + + echo "##### $RPCNAME" >> $FILENAME + echo "{% include helpers/subhead-links.md %}" >> $FILENAME + echo "" >> $FILENAME + echo "{% assign summary_${RPCNAME,}=\"\""" %}" >> $FILENAME + echo "" >> $FILENAME + echo "{% autocrossref %}" >> $FILENAME + echo "" >> $FILENAME + echo "The \`${RPCNAME,,}\` RPC {{summary_${RPCNAME,}}}" >> $FILENAME + echo "" >> $FILENAME + + # Parameters + echo "*Parameter #1---PARAMETER DESCRIPTION*" >> $FILENAME + echo "" >> $FILENAME + + # Results + echo "*Result---RESULT DESCRIPTION*" >> $FILENAME + echo "" >> $FILENAME + + echo "*Example from Dash Core 0.12.2*" >> $FILENAME + echo "" >> $FILENAME + + # Example + echo "{% highlight bash %}" >> $FILENAME + echo "dash-cli -testnet ${RPCNAME,,}" >> $FILENAME + echo "{% endhighlight %}" >> $FILENAME + echo "" >> $FILENAME + + # Example results + echo "Result:" >> $FILENAME + echo "{% highlight json %}" >> $FILENAME + echo " *INSERT RESULTS HERE*" >> $FILENAME + echo "{% endhighlight %}" >> $FILENAME + echo "" >> $FILENAME + + echo "*See also:*" >> $FILENAME + echo "" >> $FILENAME + + echo "{% endautocrossref %}" >> $FILENAME + + cat $FILENAME + + echo " " + echo "Next copy the created file ('$FILENAME') to ../_includes/devdoc/dash-core/rpcs/rpcs" +else + echo "Incorrect number of parameters (Should be exactly 1)" + echo "Usage: create_empty_rpc_md RPCNAME" + echo "Example: create_empty_rpc_md GetBlock" +fi + +#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/getaddressutxos.md" %}# +# +###### GetAddressUtxos +#{% include helpers/subhead-links.md %} +# +#{% autocrossref %} +# +#{% assign summary_getAddressUtxos="" %} +# +# +#{% endautocrossref %}