Skip to main content

Agora-cl's validator client

Although [beacon nodes](./agora-cl node) handle network synchronisation, drawing consensus and performing several other low-level functions, the role of validators whom stake BOA to in order to perform block proposals and attestations are an equally critical component of the Ethereum Agora chain.

As mentioned, validators have two responsibilities: to propose (or produce) blocks known as beacon blocks, which contain consensus information about shards across the network, or to attest (or vote on) the validity of blocks that have already been produced.

Validator

How does it work?​

A validator instance is permitted to begin participating in the network once 40,000 BOA is locked up in a validator deposit contract. Validators are tasked with correctly proposing or attesting to blocks on the Agora chain, and receive either rewards or penalties to the initial deposit based upon their overall performance.

If validators act against the protocol, their locked up deposit will be cut in a process known as 'slashing'. Validators that are intermittently offline or do not have reliable uptime will gradually lose their deposit, eventually leaking enough to be automatically removed from the network entirely. More on this topic can be found in the Ethereum proof-of-stake economics outline.

Validator client functionality​

Validators are quite lightweight pieces of software and perform only a small number of tasks, though it is critical that they are performed properly. They run in a single function that effectively summarizes every step of their lifecycle succinctly.

In order of operations, the client:

  1. Waits for the event log signaling a start to have occurred in the validator deposit contract.
  2. Checks if public key corresponding to the validator instance has been activated on the Agora chain.
  3. A validator is assigned to a shard either as a proposer (creator) or attester (voter).
  4. The validator then has a ticker that works every slot (6 seconds). If the slot ticks at the validator's assigned slot, a beacon block is either proposed or attested, depending on assigned role.
  5. This repeats forever until the validator decides to exit the system voluntarily, or is penalized by the system for either acting maliciously or being idle when assigned tasks to perform.

As mentioned, every validator instance represents 40,000 BOA being staked in the network. In Agora-cl, this is currently the default; however, the Agora-cl validator also supports running multiple keypairs that correspond to multiple validators in a single runtime, simplifying the process of deploying several validator instances for those whom want to stake more funds to help secure the network. To run multiple keypairs, they must be encrypted with the same password and kept in the same directory.

Proposing a beacon block​

A block proposal must include several items to meet the minimum requirements for verification by the protocol. In chronological order, these steps are:

  1. The canonical head block is fetched from the Agora node and its root is used as the parent root of the new block.
  2. All pending deposits which have not yet been included in the chain are fetched.
  3. ETH1 data used to vote on deposit objects is fetched.
  4. All pending slashings and validator voluntary exits are fetched.
  5. The latest fork data from the Agora chain is retrieved.
  6. A randao reveal is generated by BLS signing the epoch.
  7. All pending attestations from the Agora node are fetched.
  8. The block object is constructed by packaging the above items into a block data structure.
  9. The state root hash is computed, signing the block with the validator's private key.
  10. The block is proposed by sending it to the Agora node via gRPC.

Attesting to a Beacon Block​

Attesting to a block is a similar process to proposing, albeit with a few slightly different steps:

  1. An attestation data structure is assembled and the validator's assigned shard is fetched.
  2. A request is made to the Agora node for the information required to attest a block.
  3. An attestation bitfield is constructed using the validator index.
  4. The attestation key is then signed with a validator's private key.
  5. Halfway through the slot duration, the attestation is sent to the Agora node via gRPC.