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*
|
*Example from Dash Core 0.12.2*
|
||||||
|
|
||||||
{% highlight bash %}
|
{% highlight bash %}
|
||||||
gobject prepare 0 1 1509548445 5b5b2270726f706f73616c222c7b22656e645f65706f6\
|
dash-cli -testnet gobject prepare 0 1 1509548445 5b5b2270726f706f73616c222c7b22656e645f65706f6\
|
||||||
368223a313530393638303337392c226e616d65223a22746573742d70726f706f73616c2d646\
|
368223a313530393638303337392c226e616d65223a22746573742d70726f706f73616c2d646\
|
||||||
173682d646f6373222c227061796d656e745f61646472657373223a2279554b447a353950745\
|
173682d646f6373222c227061796d656e745f61646472657373223a2279554b447a353950745\
|
||||||
0577348596b56346537424337416263454c72346a52787371222c227061796d656e745f616d6\
|
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*
|
*Example from Dash Core 0.12.2*
|
||||||
|
|
||||||
{% highlight bash %}
|
{% highlight bash %}
|
||||||
gobject submit 0 1 1509548445 5b5b2270726f706f73616c222c7b22656e645f65706f6\
|
dash-cli -testnet gobject submit 0 1 1509548445 5b5b2270726f706f73616c222c7b22656e645f65706f6\
|
||||||
368223a313530393638303337392c226e616d65223a22746573742d70726f706f73616c2d646\
|
368223a313530393638303337392c226e616d65223a22746573742d70726f706f73616c2d646\
|
||||||
173682d646f6373222c227061796d656e745f61646472657373223a2279554b447a353950745\
|
173682d646f6373222c227061796d656e745f61646472657373223a2279554b447a353950745\
|
||||||
0577348596b56346537424337416263454c72346a52787371222c227061796d656e745f616d6\
|
0577348596b56346537424337416263454c72346a52787371222c227061796d656e745f616d6\
|
||||||
|
|
|
@ -19,77 +19,712 @@ The `masternode` RPC {{summary_masternode}}
|
||||||
|
|
||||||
The `masternode count` RPC prints the number of all known masternodes.
|
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
|
###### Masternode Current
|
||||||
|
|
||||||
The `masternode current` RPC prints info on current masternode winner to be paid the next block (calculated locally).
|
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
|
###### Masternode Debug
|
||||||
|
|
||||||
The `masternode debug` RPC prints masternode status.
|
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
|
###### 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.
|
{% itemplate ntpd1 %}
|
||||||
|
- n: "Result"
|
||||||
|
t: "string"
|
||||||
###### Masternode Start
|
p: "Required<br>(exactly 1)"
|
||||||
|
d: "Masternode private key"
|
||||||
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.
|
|
||||||
|
|
||||||
|
{% enditemplate %}
|
||||||
|
|
||||||
|
*Example from Dash Core 0.12.2*
|
||||||
|
|
||||||
{% highlight bash %}
|
{% 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 %}
|
{% endhighlight %}
|
||||||
|
|
||||||
Result:
|
Result:
|
||||||
{% highlight json %}
|
{% 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 %}
|
{% endhighlight %}
|
||||||
|
|
||||||
*See also:*
|
*See also:*
|
||||||
|
|
||||||
|
* [MasternodeList][rpc masternodelist]: {{summary_masternodeList}}
|
||||||
|
|
||||||
{% endautocrossref %}
|
{% endautocrossref %}
|
||||||
|
|
|
@ -99,7 +99,7 @@ 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_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_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 dash. 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_lockUnspent="temporarily locks or unlocks specified transaction outputs. A locked transaction output will not be chosen by automatic coin selection when spending dash. 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_masternode="provides a set of commands for managing masternodes and displaying information about them." %}
|
||||||
{% assign summary_masternodeBroadcast="provides a set of commands to create and relay masternode broadcast messages." %}
|
{% assign summary_masternodeBroadcast="provides a set of commands to create and relay masternode broadcast messages." %}
|
||||||
{% assign summary_masternodeList="returns a list of masternodes in different modes." %}
|
{% 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_mnSync="returns the sync status, updates to the next step or resets it entirely." %}
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue