hmy_getValidatorInformation

hmy_getValidatorInformation

Get staking validator information.

Parameters

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"
    }
  }
}