Creating A Validator

Wait for your node to sync before creating a validator.

Check your current block height with ./hmy blockchain latest-headers

Check chain block height with ./hmy blockchain latest-header --node=[endpoint]

Creating a Validator

Replace everything in [ ] with your own data:

./hmy --node="https://api.s0.t.hmny.io" staking create-validator \
--validator-addr [ONE ADDRESS] --amount 10000 \
--bls-pubkeys [BLS PUBLIC KEY1],[BLS PUBLIC KEY2] \
--name "[NAME]" --identity "[IDENTITY]" --details "DETAILS" \
--security-contact "CONTACT" --website "YOUR-WEBSITE.COM" \
--max-change-rate 0.1 --max-rate 0.1 --rate 0.1 \
--max-total-delegation 100000000 --min-self-delegation 10000 --passphrase

Copy the entire command. Extra white spaces in the command could cause errors.

Name, identity, details, security-contact and website need to be put in double quotes if there are more than one word separated by space (example --name "John the validator").

The CLI will prompt you to enter your BLS key file password.

--validator-addr is the validator ONE address (string)

--amount is the initial amount of ONE you want to stake (float)

--bls-pubkeys takes a comma-separated list of BLS public keys (string)

--name will be the name displayed on the Staking Explorer (string)

--identity is additional information for the validator (string)

--details is the description of the validator (string)

--security-contact is security contact for the validator (string)

--website will be the website displayed on the Staking Explorer (string)

--max-change-rate is the maximum rate change the validator can do to their commission rate every epoch (float)

--max-rate is the maximum commission rate that the validator can set (float)

--rate is the commission rate of the validator (float)

--max-total-delegation is the maximum amount of ONE that can be delegated to this validator (float)

--min-self-delegation is the minimum amount of ONE the validator must stake to itself (float)

--max-rate and --max-change-rate cannot be changed later.

--min-self-delegation has to be at least 10,000 ONE.

rate, max-rate max-change-rate takes value between 0 and 1 with 0.1 = 10%

When does the validator participate in election?

A new validator will be eligible for the election for next epoch. You can see the time until the next epoch on the Staking Dashboard.

Once your validator is elected, the validator will receive rewards and you will be able to see "BINGO" in the logs.

tail -n 1000 latest/zerolog-validator-*.log | grep -i BINGO

Example output:

{"level":"info","port":"9000","ip":"213.136.79.89","blockNum":3916,"epochNum":26,"ViewId":3916,"blockHash":"0xca71fc9aa92f694f664aa34d7e3e82cf9b678e3a062d3bbbabebfbc5f0598d84","numTxns":0,"numStakingTxns":0,"caller":"/mnt/jenkins/workspace/harmony-release/harmony/node/node_handler.go:359","time":"2019-12-11T14:49:08.983338784+01:00","message":"BINGO !!! Reached Consensus"}

If you don't want to participate in the election anymore, you can turn your validator inactive using an Edit Validator transaction with--active false.

Checking Validator Information

Use the format command ./hmy --node="https://api.s0.t.hmny.io" blockchain validator information [ONE ADDRESS] to check your validator information:

./hmy --node="https://api.s0.t.hmny.io" blockchain validator information one1u6c4wer2dkm767hmjeehnwu6tqqur62gx9vqsd

Example output:

{
"id": "0",
"jsonrpc": "2.0",
"result": {
"booted-status": null,
"current-epoch-performance": {
"current-epoch-signing-percent": {
"current-epoch-signed": 95,
"current-epoch-signing-percentage": "1.000000000000000000",
"current-epoch-to-sign": 95,
"num-beacon-blocks-until-next-epoch": 21
}
},
"currently-in-committee": true,
"epos-status": "currently elected",
"epos-winning-stake": "6846745750000000000000000.000000000000000000",
"lifetime": {
"apr": "6.268807306506151937",
"blocks": {
"signed": 8602,
"to-sign": 8621
},
"reward-accumulated": 7.076705797578808e+21
},
"metrics": {
"by-bls-key": [
{
"earned-reward": 17373723528937510000,
"key": {
"bls-public-key": "1227f1ef2ba879562c693c2f99af023a9a127b25bfe21fa41c637039bfbd9cc68919d0edce4f2aa57983ffcbc39b1b01",
"earning-account": "one1u6c4wer2dkm767hmjeehnwu6tqqur62gx9vqsd",
"effective-stake": "1369349150000000000000000.000000000000000000",
"group-percent": "0.032657375054393815",
"overall-percent": "0.010450360017406021",
"shard-id": 1
}
}
]
},
"total-delegation": 4.184679e+24,
"validator": {
"address": "one1u6c4wer2dkm767hmjeehnwu6tqqur62gx9vqsd",
"bls-public-keys": [
"1227f1ef2ba879562c693c2f99af023a9a127b25bfe21fa41c637039bfbd9cc68919d0edce4f2aa57983ffcbc39b1b01"
],
"creation-height": 489,
"delegations": [
{
"amount": 1.184679e+24,
"delegator-address": "one1u6c4wer2dkm767hmjeehnwu6tqqur62gx9vqsd",
"reward": 4.383229639373062e+21,
"undelegations": []
},
{
"amount": 3e+24,
"delegator-address": "one167gc5t3f4uvupns2h8fsem9xzdgn2egra9w8d3",
"reward": 2.1040394698378544e+21,
"undelegations": []
}
],
"details": "Soph #P-OPS Validator node",
"identity": "Soph",
"last-epoch-in-committee": 58,
"max-change-rate": "0.050000000000000000",
"max-rate": "0.900000000000000000",
"max-total-delegation": 1e+27,
"min-self-delegation": 1e+22,
"name": "Soph #P-OPS Validator node",
"rate": "0.100000000000000000",
"security-contact": "Soph",
"update-height": 489,
"website": "soph.harmony.one"
}
}
}

If your validator does not sign more than 2/3 of the blocks in an epoch, the validator will be removed from the pool of eligible validators.

In order to be included in the pool again, you will have to use send an Edit Validator transaction with --active true.