Links

hmy_getValidatorInformation

hmy_getValidatorInformation
Get staking validator information.

Parameters

  1. 1.
    String - validator bech32 address.

Returns

  • current-epoch-signing-percent
    • current-epoch-signed - Number - epoch when last block was signed by validator
    • current-epoch-to-sign - Number - current epoch
    • percentage - Float - percentage of blocks signed
  • current-epoch-voting-power - Array of
    • effective-stake - Float - effective validator stake
    • shard-id - Number - shard id
    • voting-power-adjusted - Float - voting power adjusted
    • voting-power-raw - Float - voting power
  • validator
    • availability:
      • num-of-blocks-to-sign - Number - big.Int number of blocks validator should have signed in active mode
      • num-blocks-signed - Number - big.Int number of blocks validator actually signed
    • address - String - ECSDA validator address
    • bls-public-keys - []String - array of validator bls public keys
    • last-epoch-in-committee - Number - big.Int last epoch in committee
    • min-self-delegation - Number - big.Int min self delegation
      • max-total-delegation - Number - big.Int max total delegated to this validator
    • active - Bool - is valdiator currently active
    • rate - Float - validator current commission rate
    • max-rate - Float - max validator commission rate
    • max-change-rate - Float - max validator commission rate change
    • update-height - Number - big.Int last commission update block height
    • name - String - validator name
    • identity - String - validator text kyc identity
    • website - String - validator website
    • security-contact - String - validator security contact
    • details - String - additional info
    • creation-height - Number - big.Int block height when validator was created
    • banned - Bool - is validator banned
    • Delegations:
      • array of validator delegations, check out delegations format in hmy_getDelegationsBy...
Sample Curl Request
curl -d '{
"jsonrpc":"2.0",
"method":"hmy_getValidatorInformation",
"params":[
"one14438psd5vrjes7qm97jrj3t0s5l4qff5j5cn4h"
],
"id":1
}' -H 'Content-Type:application/json' -X POST 'https://api.s0.b.hmny.io'
Sample Curl Response
{
"id": "0",
"jsonrpc": "2.0",
"result": {
"current-epoch-signing-percent": {
"current-epoch-signed": 0,
"current-epoch-to-sign": 5,
"percentage": "0.000000000000000000"
},
"current-epoch-voting-power": [
{
"effective-stake": "25415000000000000000.000000000000000000",
"shard-id": 2,
"voting-power-adjusted": "0.320000000000000000",
"voting-power-raw": "1.000000000000000000"
}
],
"validator": {
"active": false,
"address": "one14438psd5vrjes7qm97jrj3t0s5l4qff5j5cn4h",
"availability": {
"num-blocks-signed": 0,
"num-blocks-to-sign": 75
},
"banned": false,
"bls-public-keys": [
"67336532c04545afc5c1c979f58b5c301af406eaa0f4c900dcd3004189936c7213ee126d9591026f65248e5f25278f02"
],
"creation-height": 240,
"delegations": [
{
"amount": 3.46e+19,
"delegator-address": "one14438psd5vrjes7qm97jrj3t0s5l4qff5j5cn4h",
"reward": 0,
"undelegations": []
},
{
"amount": 1.5e+18,
"delegator-address": "one1nqevvacj3y5ltuef05my4scwy5wuqteur72jk5",
"reward": 0,
"undelegations": []
}
],
"details": "none",
"identity": "test_account2",
"last-epoch-in-committee": 4,
"max-change-rate": "0.052212761523253600",
"max-rate": "0.179184469782137200",
"max-total-delegation": 8e+19,
"min-self-delegation": 3.2e+18,
"name": "_Test_key_validator2",
"rate": "0.127983520183826780",
"security-contact": "Edgar-VDM",
"update-height": 240,
"website": "harmony.one"
}
}
}