Import Validator Keys

Your validator keys are used for validating and attesting to the correctness of blocks in the Gnosis blockchain. Validators also use the keys to propose and sign for new blocks, maintaining the integrity of the network.

You will need to import your validator keys into your Consensus Client (Gnosis Teku). Your validator keys are contained in the keystore files which you obtained from the key generation process.

Before you Begin

  1. Make sure your Execution and Consensus Clients are up and running. You can import the validator keys even if the clients are still in the process of syncing.

  2. Make sure you have your keystore files with you. There will be one keystore file per each validator you intend to run. Make sure also that you have the password to decrypt the keystore.

The Steps

On your AVADO, open Gnosis Teku on the Home Page.

On the Main page, click the Add validator field to expand it.

Steps to add a validator:

  1. Click Choose keystore file… and browse to the keystore file (.json) you obtained from the key generation process.

  2. Enter your keystore password.

  3. (Optional) If you have a slashing protection file, upload the file here. For most users, this is not necessary.

  4. Finally click Add validator to add the validator.

What is "slashing protection"?

Slashing protection prevents validators from signing blocks or attestations based on what it has already signed. It is useful when switching Consensus Clients or machines. Note that slashing protection does not provide protection if the same validator key is inadvertently being used by multiple nodes.

For most users, the easier option is to wait for a minimum of 5 finalized epochs before importing their keys into the target Consensus Client. Given the current network conditions, this waiting period amounts to approximately 30 minutes. To err on the side of caution and ensure absolute safety, we recommend waiting for 10 finalized epochs. This precaution is necessary to prevent the risk of slashing due to premature activation.

The Validator Dashboard

Once you have added your validator(s) to Gnosis Teku, they will appear on the Main page:

Here's a breakdown of the displayed items, from left to right:

  1. Gnosischain icon: Click this link to access your validator's page on web site. It provides valuable information about your validator's status and serves as your primary resource for monitoring its performance.

  2. Index and Public Key: These identifiers help you locate and access your validator's information on the website.

  3. Balance: This shows your validator's current balance, in mGNO (1 GNO = 32 mGNO), including the initial 1 GNO stake and any accrued Consensus Layer rewards. Amounts over 1 GNO are periodically sent to your Withdrawal Address.

  4. Effective Balance: This is the basis for calculating your Consensus Layer rewards and is capped at 1 GNO (32 mGNO). If your validator is penalized and the balance drops below 1 GNO, the Effective Balance will also decrease. Your validator can continue to validate even if your balance drops slightly below 1 GNO, though your rewards will be proportionally reduced. Your validator will be "kicked out" of the network if the Effective Balance drops below 0.5 GNO (16 mGNO).

  5. Fee Recipient: This is an Gnosis Address you can set to receive Execution Layer rewards. It defaults to the Fee Recipient Address you provided during Gnosis Teku setup. You can change this address for individual validators if needed.

  6. Withdrawals: This indicates the status of your Withdrawal Address. If set, withdrawals are enabled. If not, it will show as todo.

  7. Status: This displays the current status of your validator. It will show as pending_initialized while the deposit is waiting to be recognized, pending_queued while waiting for activation, and active_ongoing once active.

  8. Trash Bin: This removes the validator entry from the dashboard but does not delete it from the Beacon Chain. It is useful for moving validators between Consensus Clients or machines.

  9. Exit Button: This will show up once the validator becomes active. Click this button when you decide to exit the validator. For the detailed exit steps, see Exit from a Gnosis Validator.

These elements help you monitor and manage your validators efficiently within the Gnosis Teku interface.

Last updated