diff --git a/_autocrossref.yaml b/_autocrossref.yaml index 5d9e6f50..7294e6ca 100644 --- a/_autocrossref.yaml +++ b/_autocrossref.yaml @@ -399,6 +399,8 @@ DIP8: '`getmempoolentry` RPC': rpc getmempoolentry '`getmempoolinfo`': rpc getmempoolinfo '`getmempoolinfo` RPC': rpc getmempoolinfo +'`getmerkleblocks`': rpc getmerkleblocks +'`getmerkleblocks` RPC': rpc getmerkleblocks '`getmininginfo`': rpc getmininginfo '`getmininginfo` RPC': rpc getmininginfo '`getnettotals`': rpc getnettotals diff --git a/_config.yml b/_config.yml index 872f1e83..c83aebc4 100644 --- a/_config.yml +++ b/_config.yml @@ -221,6 +221,7 @@ devsearches: - 'GetMempoolDescendants': "/en/developer-reference#getmempooldescendants" - 'GetMempoolEntry': "/en/developer-reference#getmempoolentry" - 'GetMempoolInfo': "/en/developer-reference#getmempoolinfo" + - 'GetMerkleBlocks': "/en/developer-reference#getmerkleblocks" - 'GetMiningInfo': "/en/developer-reference#getmininginfo" - 'GetNetTotals': "/en/developer-reference#getnettotals" - 'GetNetworkHashPS': "/en/developer-reference#getnetworkhashps" diff --git a/_includes/devdoc/dash-core/rpcs/quick-reference.md b/_includes/devdoc/dash-core/rpcs/quick-reference.md index 6bcee4c2..0623f20c 100644 --- a/_includes/devdoc/dash-core/rpcs/quick-reference.md +++ b/_includes/devdoc/dash-core/rpcs/quick-reference.md @@ -127,6 +127,7 @@ These RPCs are all Dash-specific and not found in Bitcoin Core * [GetMemPoolEntry][rpc getmempoolentry]: {{summary_getMemPoolEntry}} {{DASH_NEW0_12_3}} {{NEW0_13_0}} * [GetMemPoolInfo][rpc getmempoolinfo]: {{summary_getMemPoolInfo}} {{UPDATED0_12_0}} * [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}} {{DASH_UPDATED0_12_3}} {{UPDATED0_13_0}} +* [GetMerkleBlocks][rpc getmerkleblocks]: {{summary_getMerkleBlocks}} {{DASH_NEW0_14_1}} * [GetSpecialTxes][rpc getspecialtxes]: {{summary_getSpecialTxes}} {{DASH_NEW0_13_1}} * [GetSpentInfo][rpc getspentinfo]: {{summary_getSpentInfo}} {{DASH_NEW0_12_1}} * [GetTxOut][rpc gettxout]: {{summary_getTxOut}} diff --git a/_includes/devdoc/dash-core/rpcs/rpcs/getmerkleblocks.md b/_includes/devdoc/dash-core/rpcs/rpcs/getmerkleblocks.md new file mode 100644 index 00000000..5a3904b7 --- /dev/null +++ b/_includes/devdoc/dash-core/rpcs/rpcs/getmerkleblocks.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/getmerkleblocks.md" %} + + +##### GetMerkleBlocks +{% include helpers/subhead-links.md %} + +{% assign summary_getMerkleBlocks="returns an array of hex-encoded merkleblocks for blocks starting from which match ." %} + +{% autocrossref %} + +*Added in Dash Core 0.14.1* + +The `getmerkleblocks` RPC {{summary_getMerkleBlocks}} + +*Parameter #1---filter* + +{% itemplate ntpd1 %} +- n: "filter" + t: "string" + p: "Required
(exactly 1)" + d: "The hex encoded bloom filter" + +{% enditemplate %} + +*Parameter #2---hash* + +{% itemplate ntpd1 %} +- n: "hash" + t: "string" + p: "Required
(exactly 1)" + d: "The block hash" + +{% enditemplate %} + +*Parameter #3---count* + +{% itemplate ntpd1 %} +- n: "count" + t: "number (int)" + p: "Optional
Default/max=2000" + d: "" + +{% enditemplate %} + +*Result---the list of merkleblocks* + +{% itemplate ntpd1 %} +- n: "`result`" + t: "array" + p: "Required
(exactly 1)" + d: "An array of merkleblocks" + +- n: "→
Merkle Block" + t: "string (hex)" + p: "Optional
(1 or more)" + d: "A serialized, hex-encoded merkleblock" +{% enditemplate %} + +*Example from Dash Core 0.14.1* + +{% highlight bash %} +dash-cli getmerkleblocks \ + "2303028005802040100040000008008400048141010000f8400420800080025004000004130000000000000001" \ + "00000000007e1432d2af52e8463278bf556b55cf5049262f25634557e2e91202" + 2000 +{% endhighlight %} + +Result (truncated): +{% highlight json %} +[ + "000000202c...aefc440107", + "0000002058...9a17830103" +] +{% endhighlight %} + +*See also: none* + +{% endautocrossref %} diff --git a/_includes/helpers/summaries.md b/_includes/helpers/summaries.md index f09fbb1a..38acc124 100644 --- a/_includes/helpers/summaries.md +++ b/_includes/helpers/summaries.md @@ -57,6 +57,7 @@ This file is licensed under the terms of its source texts{%endcomment%} {% assign summary_getMemPoolEntry="returns mempool data for given transaction (must be in mempool)." %} {% assign summary_getMemPoolInfo="returns information about the node's current transaction memory pool." %} {% assign summary_getMemoryInfo="returns information about memory usage." %} +{% assign summary_getMerkleBlocks="returns an array of hex-encoded merkleblocks for blocks starting from which match ." %} {% 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 network hashes per second based on the last n blocks." %} diff --git a/_includes/layout/base/rpc-table.html b/_includes/layout/base/rpc-table.html index 9625857f..53e04b3e 100644 --- a/_includes/layout/base/rpc-table.html +++ b/_includes/layout/base/rpc-table.html @@ -145,6 +145,12 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header:: Y + + Blockchain + GetMerkleBlocks + Y + Add in 0.14.1.0 + Blockchain GetRawMemPool diff --git a/_includes/references.md b/_includes/references.md index 73739d4f..9d685bfc 100644 --- a/_includes/references.md +++ b/_includes/references.md @@ -124,6 +124,7 @@ http://opensource.org/licenses/MIT. [rpc getmempooldescendants]: /en/developer-reference#getmempooldescendants [rpc getmempoolentry]: /en/developer-reference#getmempoolentry [rpc getmempoolinfo]: /en/developer-reference#getmempoolinfo +[rpc getmerkleblocks]: /en/developer-reference#getmerkleblocks [rpc getmininginfo]: /en/developer-reference#getmininginfo [rpc getnettotals]: /en/developer-reference#getnettotals [rpc getnetworkhashps]: /en/developer-reference#getnetworkhashps diff --git a/en/developer-reference.md b/en/developer-reference.md index 3fb85fb0..79035489 100644 --- a/en/developer-reference.md +++ b/en/developer-reference.md @@ -182,6 +182,8 @@ untrusted source. {% include devdoc/dash-core/rpcs/rpcs/getmempoolinfo.md %} +{% include devdoc/dash-core/rpcs/rpcs/getmerkleblocks.md %} + {% include devdoc/dash-core/rpcs/rpcs/getmininginfo.md %} {% include devdoc/dash-core/rpcs/rpcs/getnettotals.md %}