GetCandidateStatus

post

Returns the status of the candidate of given COINBASE_ADDRESS at a specific epoch

Parameters

  • COINBASE_ADDRESS [required] - a string representing a COINBASE_ADDRESS (length: 40, start with 0x )

  • EPOCH_NUMBER [required] - a hex code of an integer representing the EPOCH_NUMBER or the following special param:

  • latest: get the status of candidate at the current time

Example

params: [ '0x1d50df657b6dce50bac634bf18e2d986d807e940', 'latest' ]

Returns

  • STATUS - a string representing status of the candicate of given COINBASE_ADDRESS

    • MASTERNODE - if the candidate is a masternode

    • SLASHED - if the candidate is slashed

    • PROPOSED - if the candidate is proposed, have not been a masternode yet

    • empty string - if it's not a candidate

  • CAPACITY - capacity of the candidate

  • EPOCH - the epoch number of the query of this request

  • SUCCESS - true if the request is successful, otherwise it's false

Body
jsonrpcstringRequired
methodstringRequired
paramsstring[]Required
idinteger · int32Required
Responses
200
Successful Operation
post
POST //getCandidateStatus HTTP/1.1
Host: tomo.nownodes.io
Content-Type: application/json
Accept: */*
Content-Length: 123

{
  "jsonrpc": "2.0",
  "method": "eth_getCandidateStatus",
  "params": [
    "0x1d50df657b6dce50bac634bf18e2d986d807e940",
    "latest"
  ],
  "id": 1
}
No content
PreviousGetCandidatesNextGetTransactionByHash