mirror of
https://github.com/seigler/dash-docs
synced 2025-07-27 09:46:12 +00:00
Dash RPCs - Add details to all masternode RPC sub-commands
This commit is contained in:
parent
980061a1d4
commit
fb98f6f2f2
3 changed files with 683 additions and 48 deletions
|
@ -119,7 +119,7 @@ The `gobject prepare` RPC prepares a governance object by signing and creating a
|
|||
*Example from Dash Core 0.12.2*
|
||||
|
||||
{% highlight bash %}
|
||||
gobject prepare 0 1 1509548445 5b5b2270726f706f73616c222c7b22656e645f65706f6\
|
||||
dash-cli -testnet gobject prepare 0 1 1509548445 5b5b2270726f706f73616c222c7b22656e645f65706f6\
|
||||
368223a313530393638303337392c226e616d65223a22746573742d70726f706f73616c2d646\
|
||||
173682d646f6373222c227061796d656e745f61646472657373223a2279554b447a353950745\
|
||||
0577348596b56346537424337416263454c72346a52787371222c227061796d656e745f616d6\
|
||||
|
@ -201,7 +201,7 @@ The `gobject submit` RPC submits a governance object to network (objects must fi
|
|||
*Example from Dash Core 0.12.2*
|
||||
|
||||
{% highlight bash %}
|
||||
gobject submit 0 1 1509548445 5b5b2270726f706f73616c222c7b22656e645f65706f6\
|
||||
dash-cli -testnet gobject submit 0 1 1509548445 5b5b2270726f706f73616c222c7b22656e645f65706f6\
|
||||
368223a313530393638303337392c226e616d65223a22746573742d70726f706f73616c2d646\
|
||||
173682d646f6373222c227061796d656e745f61646472657373223a2279554b447a353950745\
|
||||
0577348596b56346537424337416263454c72346a52787371222c227061796d656e745f616d6\
|
||||
|
|
|
@ -19,77 +19,712 @@ The `masternode` RPC {{summary_masternode}}
|
|||
|
||||
The `masternode count` RPC prints the number of all known masternodes.
|
||||
|
||||
*Parameter #1---mode*
|
||||
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "Mode"
|
||||
t: "string (hex)"
|
||||
p: "Optional<br>(exactly 1)"
|
||||
d: "Which masternodes to count:<br>`ps` - PrivateSend capable,<br>`enabled` - Enabled,<br>`all` - All,<br>`qualify` - Eligible for payment"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
*Result---number of known masternodes*
|
||||
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "`result`"
|
||||
t: "string (hex)"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Transaction ID for the collateral transaction"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
*Example from Dash Core 0.12.2*
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode count
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight bash %}
|
||||
120
|
||||
{% endhighlight %}
|
||||
|
||||
Get summarized count of all masternode nodes
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode count all
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight bash %}
|
||||
Total: 129 (PS Compatible: 97 / Enabled: 97 / Qualify: 90)
|
||||
{% endhighlight %}
|
||||
|
||||
|
||||
###### Masternode Current
|
||||
|
||||
The `masternode current` RPC prints info on current masternode winner to be paid the next block (calculated locally).
|
||||
|
||||
*Parameters: none*
|
||||
|
||||
*Result---current winning masternode info*
|
||||
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "Result"
|
||||
t: "object"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Winning masternode info"
|
||||
|
||||
- n: "→<br>`height`"
|
||||
t: "int"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Block height"
|
||||
|
||||
- n: "→<br>`IP:port`"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "The IP address/port of the masternode"
|
||||
|
||||
- n: "→<br>`protocol`"
|
||||
t: "number (int)"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "The protocol version number used by this node. See the [protocol versions section][section protocol versions] for more information"
|
||||
|
||||
- n: "→<br>`outpoint`"
|
||||
t: "string"
|
||||
p: "Required<br>(1 or more)"
|
||||
d: "The masternode's outpoint"
|
||||
|
||||
- n: "→<br>`payee`"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Payee address"
|
||||
|
||||
- n: "→<br>`lastseen`"
|
||||
t: "number (int)"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "The Unix epoch time when the masternode was last seen"
|
||||
|
||||
- n: "→<br>`activeseconds`"
|
||||
t: "number (int)"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "The number of seconds the masternode has been active"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
*Example from Dash Core 0.12.2*
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode current
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight json %}
|
||||
{
|
||||
"height": 37375,
|
||||
"IP:port": "108.61.192.47:19999",
|
||||
"protocol": 70208,
|
||||
"outpoint": "3df7fb192e21c34da99bdd10c34e58ecaf3f3c37d6b2289f0ffedba5050188cc-1",
|
||||
"payee": "ydGgePy4a3zza37Zm4D44B99czyo6TftU1",
|
||||
"lastseen": 1512482630,
|
||||
"activeseconds": 3170434
|
||||
}
|
||||
{% endhighlight %}
|
||||
|
||||
|
||||
###### Masternode Debug
|
||||
|
||||
The `masternode debug` RPC prints masternode status.
|
||||
|
||||
{{WARNING}} `masternode debug` will be removed in Dash Core 0.12.3.
|
||||
|
||||
*Parameters: none*
|
||||
|
||||
*Result---masternode status*
|
||||
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "Result"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Masternode status"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
*Example from Dash Core 0.12.2*
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode debug
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight bash %}
|
||||
Masternode successfully started
|
||||
{% endhighlight %}
|
||||
|
||||
|
||||
###### Masternode Genkey
|
||||
|
||||
The `masternode check` RPC generates a new masternodeprivkey.
|
||||
The `masternode genkey` RPC generates a new masternodeprivkey.
|
||||
|
||||
*Parameters: none*
|
||||
|
||||
###### Masternode Outputs
|
||||
*Result---masternode private key*
|
||||
|
||||
The `masternode check` RPC prints masternode compatible outputs.
|
||||
|
||||
|
||||
###### Masternode Start
|
||||
|
||||
The `masternode check` RPC starts a local hot masternode configure in dash.conf.
|
||||
|
||||
|
||||
###### Masternode Start-alias
|
||||
|
||||
The `masternode check` starts a single remote masternode by assigned alias configured in masternode.conf.
|
||||
|
||||
|
||||
###### Masternode Start-mode (all, missing, disabled)
|
||||
|
||||
The `masternode check` RPC starts remote masternodes configured in masternode.conf (<mode>: 'all', 'missing', 'disabled').
|
||||
|
||||
|
||||
###### Masternode Status
|
||||
|
||||
The `masternode check` RPC prints masternode status information.
|
||||
|
||||
|
||||
###### Masternode List
|
||||
|
||||
The `masternode check` prints a list of all known masternodes (see the `masternodelist` RPC for more info).
|
||||
|
||||
|
||||
###### Masternode List-conf
|
||||
|
||||
The `masternode check` RPC prints masternode.conf in JSON format.
|
||||
|
||||
|
||||
###### Masternode Winner
|
||||
|
||||
The `masternode check` RPC prints info on the next masternode winner to vote for.
|
||||
|
||||
|
||||
###### Masternode Winners
|
||||
|
||||
The `masternode check` RPC prints the list of masternode winners.
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "Result"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Masternode private key"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
*Example from Dash Core 0.12.2*
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode
|
||||
dash-cli -testnet masternode genkey
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight bash %}
|
||||
92Mn5DQpnBHjFPbS3ZXcX3EdhuET18u3eXTTtVsdDzdcAMaXqtG
|
||||
{% endhighlight %}
|
||||
|
||||
|
||||
###### Masternode Outputs<!--noref-->
|
||||
|
||||
The `masternode outputs` RPC prints masternode compatible outputs.
|
||||
|
||||
*Parameters: none*
|
||||
|
||||
*Result---masternode outputs*
|
||||
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "Result"
|
||||
t: "object"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Masternode compatible outputs"
|
||||
|
||||
- n: "→<br>Output"
|
||||
t: "string"
|
||||
p: "Required<br>(1 or more)"
|
||||
d: "Masternode compatible output (TXID:Index)"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
*Example from Dash Core 0.12.2*
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode outputs
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight json %}
|
||||
*INSERT RESULTS HERE*
|
||||
{
|
||||
"f6c83fd96bfaa47887c4587cceadeb9af6238a2c86fe36b883c4d7a6867eab0f": "1"
|
||||
}
|
||||
{% endhighlight %}
|
||||
|
||||
|
||||
###### Masternode Start
|
||||
|
||||
The `masternode start` RPC starts a local hot masternode configure in dash.conf.
|
||||
|
||||
{{WARNING}} `masternode start` will be removed in Dash Core 0.12.3. Local
|
||||
masternode support is being removed for security reasons.
|
||||
|
||||
*Parameters: none*
|
||||
|
||||
*Result---masternode status*
|
||||
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "Result"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Masternode status"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
*Example from Dash Core 0.12.2*
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode start
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight bash %}
|
||||
Masternode successfully started
|
||||
{% endhighlight %}
|
||||
|
||||
|
||||
###### Masternode Start-alias
|
||||
|
||||
The `masternode start-alias` starts a single remote masternode by assigned alias configured in masternode.conf.
|
||||
|
||||
*Parameter #1---masternode alias*
|
||||
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "Alias"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Alias of the masternode to start"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
*Result---masternode status*
|
||||
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "Result"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Masternode status"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
*Example from Dash Core 0.12.2*
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode start-alias MN01
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight json %}
|
||||
{
|
||||
"alias": "MN01",
|
||||
"result": "successful"
|
||||
}
|
||||
{% endhighlight %}
|
||||
|
||||
###### Masternode Start-mode
|
||||
|
||||
The `masternode start-<mode>` RPC starts remote masternodes configured in
|
||||
masternode.conf. Valid modes are: `all`, `missing`, or `disabled`.
|
||||
|
||||
*Parameters: none*
|
||||
|
||||
*Result---masternode status*
|
||||
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "Result"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Masternode status"
|
||||
|
||||
- n: "→<br>`overall`"
|
||||
t: "string"
|
||||
p: "Required<br>(1 or more)"
|
||||
d: "Reports masternode start successes/failures"
|
||||
|
||||
- n: "→<br>`detail`"
|
||||
t: "object"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Start details"
|
||||
|
||||
- n: "→ →<br>`status`"
|
||||
t: "object"
|
||||
p: "Required<br>(1 or more)"
|
||||
d: "Name of the masternode alias"
|
||||
|
||||
- n: "→ → →<br>`alias`"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Masternode alias"
|
||||
|
||||
- n: "→ → →<br>`result`"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Start result"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
|
||||
*Example from Dash Core 0.12.2*
|
||||
|
||||
Start all masternodes in masternodes.conf
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode start-all
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight json %}
|
||||
{
|
||||
"overall": "Successfully started 1 masternodes, failed to start 0, total 1",
|
||||
"detail": {
|
||||
"status": {
|
||||
"alias": "MN01",
|
||||
"result": "successful"
|
||||
}
|
||||
}
|
||||
}
|
||||
{% endhighlight %}
|
||||
|
||||
|
||||
Start missing masternodes in masternodes.conf
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode start-missing
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight json %}
|
||||
{
|
||||
"overall": "Successfully started 0 masternodes, failed to start 0, total 0",
|
||||
"detail": {
|
||||
}
|
||||
}
|
||||
{% endhighlight %}
|
||||
|
||||
|
||||
Start disabled masternodes in masternodes.conf
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode start-disabled
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight json %}
|
||||
{
|
||||
"overall": "Successfully started 1 masternodes, failed to start 0, total 1",
|
||||
"detail": {
|
||||
"status": {
|
||||
"alias": "MN01",
|
||||
"result": "successful"
|
||||
}
|
||||
}
|
||||
}
|
||||
{% endhighlight %}
|
||||
|
||||
|
||||
###### Masternode Status
|
||||
|
||||
The `masternode status` RPC prints masternode status information.
|
||||
|
||||
*Parameters: none*
|
||||
|
||||
*Result---masternode status info*
|
||||
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "Result"
|
||||
t: "object"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Masternode status info"
|
||||
|
||||
- n: "→<br>`outpoint`"
|
||||
t: "string"
|
||||
p: "Required<br>(1 or more)"
|
||||
d: "The masternode's outpoint"
|
||||
|
||||
- n: "→<br>`service`"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "The IP address/port of the masternode"
|
||||
|
||||
- n: "→<br>`payee`"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Payee address"
|
||||
|
||||
- n: "→<br>`status`"
|
||||
t: "string"
|
||||
p: "Required<br>(1 or more)"
|
||||
d: "The masternode's status"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
*Example from Dash Core 0.12.2*
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode status
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight json %}
|
||||
{
|
||||
"outpoint": "f6c83fd96bfaa47887c4587cceadeb9af6238a2c86fe36b883c4d7a6867eab0f-1",
|
||||
"service": "45.32.237.77:19999",
|
||||
"payee": "yY6AmGopsZS31wy1JLHR9P6AC6owFaXwuh",
|
||||
"status": "Masternode successfully started"
|
||||
}
|
||||
{% endhighlight %}
|
||||
|
||||
|
||||
###### Masternode List
|
||||
|
||||
The `masternode list` prints a list of all known masternodes.
|
||||
|
||||
This RPC uses the same parameters and returns the same data as
|
||||
[masternodelist][rpc masternodelist]. Please reference it for full details.
|
||||
|
||||
*Example from Dash Core 0.12.2*
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode list \
|
||||
rank f6c83fd96bfaa47887c4587cceadeb9af6238a2c86fe36b883c4d7a6867eab0f
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight json %}
|
||||
{
|
||||
"f6c83fd96bfaa47887c4587cceadeb9af6238a2c86fe36b883c4d7a6867eab0f-1": 11
|
||||
}
|
||||
{% endhighlight %}
|
||||
|
||||
|
||||
###### Masternode List-conf
|
||||
|
||||
The `masternode list-conf` RPC prints masternode.conf in JSON format.
|
||||
|
||||
*Parameters: none*
|
||||
|
||||
*Result---masternode info*
|
||||
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "Result"
|
||||
t: "object"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Masternode status info"
|
||||
|
||||
- n: "→<br>`masternode`"
|
||||
t: "object"
|
||||
p: "Required<br>(1 or more)"
|
||||
d: "Object containing masternode info"
|
||||
|
||||
- n: "→ →<br>`alias`"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Masternode alias"
|
||||
|
||||
- n: "→ →<br>`address`"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "The IP address/port of the masternode"
|
||||
|
||||
- n: "→ →<br>`privateKey`"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Masternode private key"
|
||||
|
||||
- n: "→ →<br>`txHash`"
|
||||
t: "string (hex)"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Masternode collateral transaction hash"
|
||||
|
||||
- n: "→ →<br>`outputIndex`"
|
||||
t: "int"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Masternode collateral transaction index"
|
||||
|
||||
- n: "→ →<br>`status`"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "The masternode's status"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
*Example from Dash Core 0.12.2*
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode status
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight json %}
|
||||
{
|
||||
"masternode": {
|
||||
"alias": "MN01",
|
||||
"address": "45.32.237.77:19999",
|
||||
"privateKey": "92woG282ZQMASn8BAah6H8QmiE5NsPwucv7cu9eTVG1uU63fcfs",
|
||||
"txHash": "f6c83fd96bfaa47887c4587cceadeb9af6238a2c86fe36b883c4d7a6867eab0f",
|
||||
"outputIndex": "1",
|
||||
"status": "ENABLED"
|
||||
},
|
||||
"masternode": {
|
||||
"alias": "MN02",
|
||||
"address": "45.32.237.78:19999",
|
||||
"privateKey": "92woG282ZQMASn8BAah6H8QmiE5NsPwucv7cu9eTVG1uU63fcfs",
|
||||
"txHash": "f6c83fd96bfaa47887c4587cceadeb9af6238a2c86fe36b883c4d7a6867eab0f",
|
||||
"outputIndex": "1",
|
||||
"status": "ENABLED"
|
||||
}
|
||||
}
|
||||
{% endhighlight %}
|
||||
|
||||
|
||||
###### Masternode Winner
|
||||
|
||||
The `masternode winner` RPC prints info on the next masternode winner to vote for.
|
||||
|
||||
*Parameters: none*
|
||||
|
||||
*Result---next masternode winner info*
|
||||
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "Result"
|
||||
t: "object"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Winning masternode info"
|
||||
|
||||
- n: "→<br>`height`"
|
||||
t: "int"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Block height"
|
||||
|
||||
- n: "→<br>`IP:port`"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "The IP address/port of the masternode"
|
||||
|
||||
- n: "→<br>`protocol`"
|
||||
t: "number (int)"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "The protocol version number used by this node. See the [protocol versions section][section protocol versions] for more information"
|
||||
|
||||
- n: "→<br>`outpoint`"
|
||||
t: "string"
|
||||
p: "Required<br>(1 or more)"
|
||||
d: "The masternode's outpoint"
|
||||
|
||||
- n: "→<br>`payee`"
|
||||
t: "string"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Payee address"
|
||||
|
||||
- n: "→<br>`lastseen`"
|
||||
t: "number (int)"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "The Unix epoch time when the masternode was last seen"
|
||||
|
||||
- n: "→<br>`activeseconds`"
|
||||
t: "number (int)"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "The number of seconds the masternode has been active"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
*Example from Dash Core 0.12.2*
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode winner
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight json %}
|
||||
{
|
||||
"height": 37384,
|
||||
"IP:port": "145.239.235.17:29999",
|
||||
"protocol": 70208,
|
||||
"outpoint": "66eddd00e5927d0a03437d5b8a2f15367c978ef7951c80ae1608a45b1bf64318-1",
|
||||
"payee": "yY3q6wqRe1y7xzHbGE88YfRg4t97GU7BJ6",
|
||||
"lastseen": 1512482474,
|
||||
"activeseconds": 1180019
|
||||
}
|
||||
{% endhighlight %}
|
||||
|
||||
|
||||
###### Masternode Winners
|
||||
|
||||
The `masternode winners` RPC prints the list of masternode winners.
|
||||
|
||||
By default, the 10 previous block winners, the current block winner, and the
|
||||
next 20 block winners are displayed. More past block winners can be requested
|
||||
via the optional `count` parameter.
|
||||
|
||||
*Parameter #1---count*
|
||||
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "Count"
|
||||
t: "string (hex)"
|
||||
p: "Optional<br>(exactly 1)"
|
||||
d: "Number of previous block winners to display (default: 10)"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
*Parameter #2---filter*
|
||||
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "Filter"
|
||||
t: "string"
|
||||
p: "Optional<br>(exactly 1)"
|
||||
d: "Payment address to filter by"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
*Result---masternode winners*
|
||||
|
||||
{% itemplate ntpd1 %}
|
||||
- n: "Result"
|
||||
t: "object"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Winning masternode info"
|
||||
|
||||
- n: "→<br>Masternode Winner"
|
||||
t: "int"
|
||||
p: "Required<br>(exactly 1)"
|
||||
d: "Key: Block height<br>Value: payee address"
|
||||
|
||||
{% enditemplate %}
|
||||
|
||||
*Example from Dash Core 0.12.2*
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode winners
|
||||
{% endhighlight %}
|
||||
|
||||
Result (current block - 37458):
|
||||
{% highlight json %}
|
||||
{
|
||||
"37448": "ygSWwhyzU61FNEta8gDh8gfoH5EZZUvc5m:8",
|
||||
"37449": "yjGZLzSSoFfTFgLDJrgniXfYxu3xF9xKQg:5",
|
||||
"37450": "yRTo1wXWoNnPFWcQVepKGXuLsoypnPkGWj:7",
|
||||
"37451": "yYMFRAYZ25XspHZ1EXC39wUMx9FhoC5VT2:9",
|
||||
"37452": "yX5y3otE4LitGYiSfZhVH4LdbwHShdzQ8v:7",
|
||||
"37453": "yX5y3otE4LitGYiSfZhVH4LdbwHShdzQ8v:4",
|
||||
"37454": "yUamtYUFhqUxCMny3JTcZJTyttVt8SYFug:9",
|
||||
"37455": "yU35XcdGMnj8Exa2ZZqCg4ongiNqQwpeUZ:9",
|
||||
"37456": "yaJc6tADbEjxQBAC69ugWNoTFpzxqkcgWd:7",
|
||||
"37457": "yf4WpwRX17p7YRkHJPQpHMXTwzi5s2VDcR:7",
|
||||
"37458": "ydbfUYWfLm6xg7Y5aBLjy38DvksrvNcHEc:9",
|
||||
"37459": "yYp9k2iuDptT2MB7qVZtVy6ModHtLXFjio:6",
|
||||
"37460": "yP1UHNx26ShYLej56SbHiTiPAUv2QppbUv:6",
|
||||
"37461": "yaCtZRpiYnVFMyWELHZF74v9ayLKCLPcC9:8",
|
||||
"37462": "ygYFnLHoVRyhRoxd6fXQ9nmEafX4eLoWkB:6",
|
||||
"37463": "yM5kTThWi8MnAFtZqx98Zipp1BbyypUZGK:7",
|
||||
"37464": "yeDY39aiqbBHbJft5F6rokR23EaZca6UTU:9",
|
||||
"37465": "yMME1ns1xfpGS2XbFPktsNyp7Cjr1BoJxb:8",
|
||||
"37466": "ycn5RWc4Ruo35FTS8bJwugVyCEkfVcrw9a:6",
|
||||
"37467": "yUTDkKKhbvDrnwkiaoP8HvqxTNC6rNnUe2:6",
|
||||
"37468": "yTstes2nSaSpvu9nTapiCGnjCLvLD5fUqt:5",
|
||||
"37469": "Unknown",
|
||||
"37470": "Unknown",
|
||||
"37471": "Unknown",
|
||||
"37472": "Unknown",
|
||||
"37473": "Unknown",
|
||||
"37474": "Unknown",
|
||||
"37475": "Unknown",
|
||||
"37476": "Unknown",
|
||||
"37477": "Unknown"
|
||||
}
|
||||
{% endhighlight %}
|
||||
|
||||
Get a filtered list of masternode winners
|
||||
|
||||
{% highlight bash %}
|
||||
dash-cli -testnet masternode winners 150 "yTZ99"
|
||||
{% endhighlight %}
|
||||
|
||||
Result:
|
||||
{% highlight json %}
|
||||
{
|
||||
"37338": "yTZ99fCnjNu33RDRtawf81iwJ9uxXFmkgM:9",
|
||||
"37339": "yTZ99fCnjNu33RDRtawf81iwJ9uxXFmkgM:8",
|
||||
"37432": "yTZ99fCnjNu33RDRtawf81iwJ9uxXFmkgM:6",
|
||||
"37433": "yTZ99fCnjNu33RDRtawf81iwJ9uxXFmkgM:9"
|
||||
}
|
||||
{% endhighlight %}
|
||||
|
||||
*See also:*
|
||||
|
||||
* [MasternodeList][rpc masternodelist]: {{summary_masternodeList}}
|
||||
|
||||
{% endautocrossref %}
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue