You can interact with your validator directly via HMY CLI. Check the links below for more information on how to do this.

Option 1: Using Keybase (Recommended)

1. Login to your Keybase account or create a new one.

2. On your profile, if you don't have a PGP key set yet, just click on "Add a PGP key" to create or import an existing one.

3. Once you have created it just click on it like it is shown on the example below:

Once you click on it, Keybase will open a new page. Click on the link "this key":

This will open a new page with the PGP public key finger print:

Use the following command to update your validator identity with the keybase fingerprint.

./hmy --node="https://api.s0.t.hmny.io" staking edit-validator --validator-addr [YOUR VALIDATOR ONE ADDRESS] --identity [YOUR KEYBASE FINGERPRINT] --passphrase

Enter the passphrase when prompted. Just wait 10 min and your Keybase profile picture will automatically be used for your validator image on the Staking Dashboard!

Option 2: Using Github (Deprecated)

1. Fork this github repo: https://github.com/harmony-one/validator-logos​

2. Add your logo by creating the logo image name using your Harmony one address as the file name and placing it inside "validators" folder. The logo image needs to be a .jpg file with 256x256 pixels or 512x512 pixels. Example: validators/one1pdv9lrdwl0rg5vglh4xtyrv3wjk3wsqket7zxy.jpg

3. Create a pull request for your changes. A Harmony team member will review the image & approve it.

You can collect your rewards with the following command:

Example:

The CLI will prompt your for the passphrase of the delegation account.

--delegator-addr is the account to collect rewards for

You can edit your validator’s information using the CLI with the following command:

The CLI will prompt you to enter your BLS key file password. Only the --validator-addr field is required; all other fields are optional.

• --validator-addr is the validator ONE address that you want to edit (string)

• --active to set validator as eligible or not to be elected (bool)

• --name to change the name displayed on the Staking Explorer (string)

• --identity to change the identity field (string)

• --website to change the website field (string)

• --details to change the details field (string)

• --security-contact to change the security contact field (string)

• --rate to change the current commission rate (float)

• --min-self-delegation to change the minimum stake by the validator (float)

• --max-total-delegation to change the maximum stake that the validator can take (float)

• --remove-bls-key to remove a BLS public key associated with your validator (string)

• --add-bls-key to add another BLS public key to your validator (string)

You can delegate tokens to a validator using the following command:

./hmy --node="https://api.s0.t.hmny.io" staking delegate \
    --delegator-addr [ONE ADDRESS] --validator-addr [ONE ADDRESS] \
    --amount [AMOUNT] --passphrase

./hmy --node="https://api.s0.b.hmny.io" staking delegate \
    --delegator-addr [ONE ADDRESS] --validator-addr [ONE ADDRESS] \
    --amount [AMOUNT] --passphrase

Example:

./hmy --node="https://api.s0.t.hmny.io" staking delegate \
    --delegator-addr one1km7xg8e3xjys7azp9f4xp8hkw79vm2h3f2lade --validator-addr one1km7xg8e3xjys7azp9f4xp8hkw79vm2h3f2lade \
    --amount 10000 --passphrase

The CLI will ask for the passphrase for the delegator-addr keystore file.

--delegator-addr is the ONE address of the delegator (string)

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

--amount is the number of ONE tokens to delegate to the validator (float)

You can un-delegate tokens from a validator using the following command:

./hmy --node="https://api.s0.t.hmny.io" staking undelegate \
    --delegator-addr [ONE ADDRESS] --validator-addr [ONE ADDRESS] \ 
    --amount [AMOUNT] --passphrase

./hmy --node="https://api.s0.b.hmny.io" staking undelegate \
    --delegator-addr [ONE ADDRESS] --validator-addr [ONE ADDRESS] \ 
    --amount [AMOUNT] --passphrase

Example:

./hmy.sh -- node="https://api.s0.t.hmny.io" staking undelegate \
    --delegator-addr one1km7xg8e3xjys7azp9f4xp8hkw79vm2h3f2lade --validator-addr one1km7xg8e3xjys7azp9f4xp8hkw79vm2h3f2lade \ 
    --amount 10000 --passphrase

The CLI will ask for the passphrase for the delegator-addr keystore file.

--delegator-addr is the ONE address of the delegator (string)

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

--amount is the number of ONE tokens to un-delegate (float)

When will I get my tokens back after un-delegating?

When you decide to un-delegate your tokens from a validator, your tokens will be released at the end of the epoch from when you un-delegate.

This means that you will NOT have access to these tokens and can NOT transfer them after choosing to un-delegate your tokens from a validator until the tokens are in your account.

If your validator didn't get elected in the last epoch, you will get the token back at the end of current epoch.

You can see the number of delegations to your validator with the following command:

./hmy blockchain delegation by-validator [VALIDATOR ADDRESS] --node="https://api.s0.t.hmny.io"

./hmy blockchain delegation by-validator [VALIDATOR ADDRESS] --node="https://api.s0.b.hmny.io"

Example:

./hmy blockchain delegation by-validator one1km7xg8e3xjys7azp9f4xp8hkw79vm2h3f2lade --node="https://api.s0.t.hmny.io"

Output:

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": [
    {
      "Undelegations": [],
      "amount": 93000000000000000000,
      "delegator_address": "one1ctr58xue32peagud620tmthc95w5ch94vfhfgp",
      "reward": 193348691324709180000,
      "validator_address": "one1ctr58xue32peagud620tmthc95w5ch94vfhfgp"
    },
    {
      "Undelegations": [],
      "amount": 1.01e+22,
      "delegator_address": "one1cg5d67v28m3s0xuph46y8w842yu9dzd7094zr5",
      "reward": 646413329184000700000,
      "validator_address": "one1ctr58xue32peagud620tmthc95w5ch94vfhfgp"
    }
  ]
}

You can check your validator’s information using the CLI with the following command:

./hmy blockchain validator information [ONE ADDRESS] --node="https://api.s0.t.hmny.io"

./hmy blockchain validator information [ONE ADDRESS] --node="https://api.s0.b.hmny.io"

Example:

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

Output:

{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "current-epoch-performance": {
      "current-epoch-signing-percent": {
        "current-epoch-blocks-left": 9,
        "current-epoch-signed": 29,
        "current-epoch-signing-percentage": "1.000000000000000000",
        "current-epoch-to-sign": 29
      }
    },
    "currently-in-committee": true,
    "epos-status": "currently elected and signing enough blocks to be eligible for election next epoch",
    "lifetime": {
      "apr": "0.000000000000000000",
      "blocks": {
        "signed": 5879,
        "to-sign": 5880
      },
      "reward-accumulated": 6.966841018353012e+21
    },
    "metrics": {
      "by-shard": [
        {
          "bls-public-key": "3a26c230170cb295a20931661967ebc3bd817859e11d1eecda5cabb9ad372cd6cbba7843a72a24f24352dc3757aad014",
          "earning-account": "one1925zlp5celp8r8jj3utpcxpjtncuuv2nu2449v",
          "effective-stake": "250000000000000000000000.000000000000000000",
          "group-percent": "0.035843835577157440",
          "overall-percent": "0.011470027384690381",
          "shard-id": 0
        }
      ],
      "total-effective-stake": "250000000000000000000000.000000000000000000"
    },
    "total-delegation": 2.5e+23,
    "validator": {
      "address": "one1925zlp5celp8r8jj3utpcxpjtncuuv2nu2449v",
      "bls-public-keys": [
        "3a26c230170cb295a20931661967ebc3bd817859e11d1eecda5cabb9ad372cd6cbba7843a72a24f24352dc3757aad014"
      ],
      "creation-height": 12037,
      "delegations": [
        {
          "amount": 1.5e+23,
          "delegator-address": "one1925zlp5celp8r8jj3utpcxpjtncuuv2nu2449v",
          "reward": 6.149775864909033e+21,
          "undelegations": []
        },
        {
          "amount": 1e+23,
          "delegator-address": "one1jjq5pl4le0fhhu3n2znkkt9tydrzjcyzaljtnl",
          "reward": 620363080921910600000,
          "undelegations": []
        }
      ],
      "details": "S0",
      "identity": "J",
      "last-epoch-in-committee": 471,
      "max-change-rate": "0.100000000000000000",
      "max-rate": "0.500000000000000000",
      "max-total-delegation": 1e+25,
      "min-self-delegation": 1e+22,
      "name": "[R]",
      "rate": "0.100000000000000000",
      "security-contact": "J",
      "update-height": 12037,
      "website": "harmony.one"
    }
  }
}