content - Mempool related RPC updates

- Add getmempoolancestors, getmempooldescendants, and getmempoolentry
RPCs
 - Update Ref and Table
This commit is contained in:
thephez 2018-02-20 16:33:30 -05:00
parent d8c79f3876
commit 5f6008d276
5 changed files with 84 additions and 130 deletions

View file

@ -106,6 +106,9 @@ These RPCs are all Dash-specific and not found in Bitcoin Core
* [GetBlockHeaders][rpc getblockheaders]: {{summary_getBlockHeaders}} {{DASH_NEW0_12_1}} * [GetBlockHeaders][rpc getblockheaders]: {{summary_getBlockHeaders}} {{DASH_NEW0_12_1}}
* [GetChainTips][rpc getchaintips]: {{summary_getChainTips}} {{DASH_UPDATED0_12_1}} * [GetChainTips][rpc getchaintips]: {{summary_getChainTips}} {{DASH_UPDATED0_12_1}}
* [GetDifficulty][rpc getdifficulty]: {{summary_getDifficulty}} * [GetDifficulty][rpc getdifficulty]: {{summary_getDifficulty}}
* [GetMemPoolAncestors][rpc getmempoolancestors]: {{summary_getMemPoolAncestors}} {{DASH_NEW0_12_3}} {{NEW0_13_0}}
* [GetMemPoolDescendants][rpc getmempooldescendants]: {{summary_getMemPoolDescendants}} {{DASH_NEW0_12_3}} {{NEW0_13_0}}
* [GetMemPoolEntry][rpc getmempoolentry]: {{summary_getMemPoolEntry}} {{DASH_NEW0_12_3}} {{NEW0_13_0}}
* [GetMemPoolInfo][rpc getmempoolinfo]: {{summary_getMemPoolInfo}} {{UPDATED0_12_0}} * [GetMemPoolInfo][rpc getmempoolinfo]: {{summary_getMemPoolInfo}} {{UPDATED0_12_0}}
* [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}} {{UPDATED0_13_0}} * [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}} {{UPDATED0_13_0}}
* [GetSpentInfo][rpc getspentinfo]: {{summary_getSpentInfo}} {{DASH_NEW0_12_1}} * [GetSpentInfo][rpc getspentinfo]: {{summary_getSpentInfo}} {{DASH_NEW0_12_1}}
@ -121,9 +124,6 @@ These RPCs are all Dash-specific and not found in Bitcoin Core
{% autocrossref %} {% 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}} [PreciousBlock][rpc preciousblock]: {{summary_preciousBlock}} {{NEW0_14_0}}
* {{DASH_NOT_IMPLEMENTED}} [PruneBlockChain][rpc pruneblockchain]: {{summary_pruneBlockChain}} {{NEW0_14_0}} * {{DASH_NOT_IMPLEMENTED}} [PruneBlockChain][rpc pruneblockchain]: {{summary_pruneBlockChain}} {{NEW0_14_0}}

View file

@ -9,22 +9,21 @@ http://opensource.org/licenses/MIT.
{% assign summary_getMemPoolAncestors="returns all in-mempool ancestors for a transaction in the mempool." %} {% assign summary_getMemPoolAncestors="returns all in-mempool ancestors for a transaction in the mempool." %}
<!-- __ -->
{% autocrossref %} {% autocrossref %}
*Added in Bitcoin Core 0.13.0* *Added in Dash Core 0.12.3*
**_Not implemented in Dash Core (as of 0.12.2)_**
{% comment %}
The `getmempoolancestors` RPC {{summary_getMemPoolAncestors}} The `getmempoolancestors` RPC {{summary_getMemPoolAncestors}}
*Parameter #1---a transaction identifier (TXID)* *Parameter #1---a transaction identifier (TXID)*
{% itemplate ntpd1 %} {% itemplate ntpd1 %}
- n: "Address" - n: "TXID"
t: "string" t: "string (hex)"
p: "Required<br>(exactly 1)" p: "Required<br>(exactly 1)"
d: "The address whose transactions should be tallied" d: "The TXID of a transaction in the memory pool, encoded as hex in RPC byte order"
{% enditemplate %} {% enditemplate %}
@ -143,66 +142,48 @@ The `getmempoolancestors` RPC {{summary_getMemPoolAncestors}}
{% enditemplate %} {% enditemplate %}
*Examples from Bitcoin Core 0.13.1* *Examples from Dash Core 0.12.3*
The default (`false`): The default (`false`):
{% highlight bash %} {% highlight bash %}
bitcoin-cli getmempoolancestors 52273e0ce6cf3452932cfbc1c517c0ce\ dash-cli getmempoolancestors 49a512c3d567effd4f605a6023df8b4b523\
1af1d255fda67a6e3bd63ba1d908c8c2 ac0ae7bccbaeed1c8a7db1e05e15a
{% endhighlight %} {% endhighlight %}
Result: Result:
{% highlight json %} {% highlight json %}
[ [
"b104586f229e330caf42c475fd52684e9eb5e2d02f0fcd216d9554c5347b0873", "d1eefe8a006e2c21b55bc97c1f5b10000d63aa6a777bb11abc0daf62e4296660"
"094f7dcbc7494510d4daeceb2941ed73b1bd011bf527f6c3b7c897fee85c11d4"
] ]
{% endhighlight %} {% endhighlight %}
Verbose output (`true`): Verbose output (`true`):
{% highlight bash %} {% highlight bash %}
bitcoin-cli getmempoolancestors 52273e0ce6cf3452932cfbc1c517c0ce\ dash-cli getmempoolancestors 49a512c3d567effd4f605a6023df8b4b523\
1af1d255fda67a6e3bd63ba1d908c8c2 true ac0ae7bccbaeed1c8a7db1e05e15a true
{% endhighlight %} {% endhighlight %}
Result: Result:
{% highlight json %} {% highlight json %}
{ {
"b104586f229e330caf42c475fd52684e9eb5e2d02f0fcd216d9554c5347b0873": { "d1eefe8a006e2c21b55bc97c1f5b10000d63aa6a777bb11abc0daf62e4296660": {
"size": 485, "size": 963,
"fee": 0.00009700, "fee": 0.00000966,
"modifiedfee": 0.00009700, "modifiedfee": 0.00000966,
"time": 1479423635, "time": 1519160516,
"height": 439431, "height": 79045,
"startingpriority": 15327081.81818182, "startingpriority": 4514051697.115385,
"currentpriority": 21536936.36363636, "currentpriority": 4520474899.74359,
"descendantcount": 1, "descendantcount": 2,
"descendantsize": 485, "descendantsize": 1189,
"descendantfees": 9700, "descendantfees": 1192,
"ancestorcount": 1, "ancestorcount": 1,
"ancestorsize": 485, "ancestorsize": 963,
"ancestorfees": 9700, "ancestorfees": 966,
"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,
"depends": [ "depends": [
] ]
} }
@ -214,6 +195,4 @@ Result:
* [GetMemPoolDescendants][rpc getmempooldescendants]: {{summary_getMemPoolDescendants}} * [GetMemPoolDescendants][rpc getmempooldescendants]: {{summary_getMemPoolDescendants}}
* [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}} * [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}}
{% endcomment %}
{% endautocrossref %} {% endautocrossref %}

View file

@ -9,23 +9,21 @@ http://opensource.org/licenses/MIT.
{% assign summary_getMemPoolDescendants="returns all in-mempool descendants for a transaction in the mempool." %} {% assign summary_getMemPoolDescendants="returns all in-mempool descendants for a transaction in the mempool." %}
<!-- __ -->
{% autocrossref %} {% autocrossref %}
*Added in Bitcoin Core 0.13.0* *Added in Dash Core 0.12.3*
**_Not implemented in Dash Core (as of 0.12.2)_**
{% comment %}
The `getmempooldescendants` RPC {{summary_getMemPoolDescendants}} The `getmempooldescendants` RPC {{summary_getMemPoolDescendants}}
*Parameter #1---a transaction identifier (TXID)* *Parameter #1---a transaction identifier (TXID)*
{% itemplate ntpd1 %} {% itemplate ntpd1 %}
- n: "Address" - n: "TXID"
t: "string" t: "string (hex)"
p: "Required<br>(exactly 1)" p: "Required<br>(exactly 1)"
d: "The address whose transactions should be tallied" d: "The TXID of a transaction in the memory pool, encoded as hex in RPC byte order"
{% enditemplate %} {% enditemplate %}
@ -144,67 +142,50 @@ The `getmempooldescendants` RPC {{summary_getMemPoolDescendants}}
{% enditemplate %} {% enditemplate %}
*Examples from Bitcoin Core 0.13.1* *Examples from Dash Core 0.12.3*
The default (`false`): The default (`false`):
{% highlight bash %} {% highlight bash %}
bitcoin-cli getmempooldescendants 52273e0ce6cf3452932cfbc1c517c0\ dash-cli getmempooldescendants 49a512c3d567effd4f605a6023df8b4b5\
ce1af1d255fda67a6e3bd63ba1d908c8c2 23ac0ae7bccbaeed1c8a7db1e05e15a
{% endhighlight %} {% endhighlight %}
Result: Result:
{% highlight json %} {% highlight json %}
[ [
"b104586f229e330caf42c475fd52684e9eb5e2d02f0fcd216d9554c5347b0873", "49a512c3d567effd4f605a6023df8b4b523ac0ae7bccbaeed1c8a7db1e05e15a"
"094f7dcbc7494510d4daeceb2941ed73b1bd011bf527f6c3b7c897fee85c11d4"
] ]
{% endhighlight %} {% endhighlight %}
Verbose output (`true`): Verbose output (`true`):
{% highlight bash %} {% highlight bash %}
bitcoin-cli getmempooldescendants 52273e0ce6cf3452932cfbc1c517c0\ dash-cli getmempooldescendants 49a512c3d567effd4f605a6023df8b4b5\
ce1af1d255fda67a6e3bd63ba1d908c8c2 true 23ac0ae7bccbaeed1c8a7db1e05e15a true
{% endhighlight %} {% endhighlight %}
Result: Result:
{% highlight json %} {% highlight json %}
{ {
"b104586f229e330caf42c475fd52684e9eb5e2d02f0fcd216d9554c5347b0873": { "49a512c3d567effd4f605a6023df8b4b523ac0ae7bccbaeed1c8a7db1e05e15a": {
"size": 485, "size": 226,
"fee": 0.00009700, "fee": 0.00000226,
"modifiedfee": 0.00009700, "modifiedfee": 0.00000226,
"time": 1479423635, "time": 1519160551,
"height": 439431, "height": 79046,
"startingpriority": 15327081.81818182, "startingpriority": 0,
"currentpriority": 21536936.36363636, "currentpriority": 0,
"descendantcount": 1, "descendantcount": 1,
"descendantsize": 485, "descendantsize": 226,
"descendantfees": 9700, "descendantfees": 226,
"ancestorcount": 1, "ancestorcount": 2,
"ancestorsize": 485, "ancestorsize": 1189,
"ancestorfees": 9700, "ancestorfees": 1192,
"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,
"depends": [ "depends": [
"d1eefe8a006e2c21b55bc97c1f5b10000d63aa6a777bb11abc0daf62e4296660"
] ]
} }
} }
@ -215,6 +196,4 @@ Result:
* [GetMemPoolAncestors][rpc getmempoolancestors]: {{summary_getMemPoolAncestors}} * [GetMemPoolAncestors][rpc getmempoolancestors]: {{summary_getMemPoolAncestors}}
* [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}} * [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}}
{% endcomment %}
{% endautocrossref %} {% endautocrossref %}

View file

@ -9,23 +9,21 @@ http://opensource.org/licenses/MIT.
{% assign summary_getMemPoolEntry="returns mempool data for given transaction (must be in mempool)." %} {% assign summary_getMemPoolEntry="returns mempool data for given transaction (must be in mempool)." %}
<!-- __ -->
{% autocrossref %} {% autocrossref %}
*Added in Bitcoin Core 0.13.0* *Added in Dash Core 0.12.3*
**_Not implemented in Dash Core (as of 0.12.2)_**
{% comment %}
The `getmempoolentry` RPC {{summary_getMemPoolEntry}} The `getmempoolentry` RPC {{summary_getMemPoolEntry}}
*Parameter #1---a transaction identifier (TXID)* *Parameter #1---a transaction identifier (TXID)*
{% itemplate ntpd1 %} {% itemplate ntpd1 %}
- n: "Address" - n: "TXID"
t: "string" t: "string (hex)"
p: "Required<br>(exactly 1)" p: "Required<br>(exactly 1)"
d: "The address whose transactions should be tallied" d: "The TXID of a transaction in the memory pool, encoded as hex in RPC byte order"
{% enditemplate %} {% enditemplate %}
@ -114,30 +112,30 @@ The `getmempoolentry` RPC {{summary_getMemPoolEntry}}
{% enditemplate %} {% enditemplate %}
*Examples from Bitcoin Core 0.13.1* *Examples from Dash Core 0.12.3*
{% highlight bash %} {% highlight bash %}
bitcoin-cli getmempoolentry 52273e0ce6cf3452932cfbc1c517c0ce1af1\ dash-cli getmempoolentry d1eefe8a006e2c21b55bc97c1f5b10000d63aa6\
d255fda67a6e3bd63ba1d908c8c2 a777bb11abc0daf62e4296660
{% endhighlight %} {% endhighlight %}
Result: Result:
{% highlight json %} {% highlight json %}
{ {
"size": 485, "size": 226,
"fee": 0.00009700, "fee": 0.00000226,
"modifiedfee": 0.00009700, "modifiedfee": 0.00000226,
"time": 1479423635, "time": 1519159538,
"height": 439431, "height": 79036,
"startingpriority": 15327081.81818182, "startingpriority": 0,
"currentpriority": 21536936.36363636, "currentpriority": 0,
"descendantcount": 1, "descendantcount": 2,
"descendantsize": 485, "descendantsize": 452,
"descendantfees": 9700, "descendantfees": 452,
"ancestorcount": 1, "ancestorcount": 1,
"ancestorsize": 485, "ancestorsize": 226,
"ancestorfees": 9700, "ancestorfees": 226,
"depends": [ "depends": [
] ]
} }
@ -149,6 +147,4 @@ Result:
* [GetMemPoolDescendants][rpc getmempooldescendants]: {{summary_getMemPoolDescendants}} * [GetMemPoolDescendants][rpc getmempooldescendants]: {{summary_getMemPoolDescendants}}
* [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}} * [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}}
{% endcomment %}
{% endautocrossref %} {% endautocrossref %}

View file

@ -124,20 +124,20 @@ th.tg-sort-header::-moz-selection { background:transparent; }th.tg-sort-header::
<tr> <tr>
<td class="tg-yw4l">Blockchain</td> <td class="tg-yw4l">Blockchain</td>
<td class="tg-yw4l"><a href="#getmempoolancestors">GetMemPoolAncestors</a></td> <td class="tg-yw4l"><a href="#getmempoolancestors">GetMemPoolAncestors</a></td>
<td class="tg-baqh">N</td> <td class="tg-baqh">Y</td>
<td class="tg-baqh">N/A</td> <td class="tg-baqh">0.12.3.0+</td>
</tr> </tr>
<tr> <tr>
<td class="tg-b7b8">Blockchain</td> <td class="tg-b7b8">Blockchain</td>
<td class="tg-b7b8"><a href="#getmempooldescendants">GetMemPoolDescendants</a></td> <td class="tg-b7b8"><a href="#getmempooldescendants">GetMemPoolDescendants</a></td>
<td class="tg-dzk6">N</td> <td class="tg-dzk6">Y</td>
<td class="tg-dzk6">N/A</td> <td class="tg-dzk6">0.12.3.0+</td>
</tr> </tr>
<tr> <tr>
<td class="tg-yw4l">Blockchain</td> <td class="tg-yw4l">Blockchain</td>
<td class="tg-yw4l"><a href="#getmempoolentry">GetMemPoolEntry</a></td> <td class="tg-yw4l"><a href="#getmempoolentry">GetMemPoolEntry</a></td>
<td class="tg-baqh">N</td> <td class="tg-baqh">Y</td>
<td class="tg-baqh">N/A</td> <td class="tg-baqh">0.12.3.0+</td>
</tr> </tr>
<tr> <tr>
<td class="tg-b7b8">Blockchain</td> <td class="tg-b7b8">Blockchain</td>