Skip to main content

Validators FAQ

How to add/remove a validator?


Adding/removing validators is done by voting. You can find here a full guide about this.


You can find a guide on how to stake funds here, so that a node can become a validator, and how to unstake (remove the validator).

Please note that:

  • You can use the genesis flag --max-validator-count to set a maximum number of stakers that can join the validator set.
  • You can use the genesis flag --min-validator-count to set the minimum number of stakers needed to join the validator set(1 by default).
  • When the maximum validator number is met, you cannot add another validator until you remove an existing one from the set (doesn't matter if the staked amount of the new one is higher). If you remove a validator, the number of validators remaining cannot be lower than --min-validator-count.
  • There is a default threshold of 1 unit of native network(gas) currency for becoming a validator.

We recommend starting with 100G as a conservatively estimated runway, and making sure that it is possible to scale the disk afterwards.

Is there a limit to the number of validators?

If we are talking about technical limitations, Polygon Edge doesn't explicitly have the cap on the number of nodes you can have in a network. You can set connection caps (inbound / outbound connection counts) on a per-node basis.

If we are talking about practical limitations, you're going to see a more degraded performance with a 100 node cluster than with a 10 node cluster. By increasing the number of nodes in your cluster, you increase the communication complexity and just the networking overhead in general. It all depends on what kind of network you are running, and what kind of network topology you have.

How to switch from PoA to PoS?

PoA is the default consensus mechanism. For a new cluster, to switch to PoS, you will need to add the --pos flag when generating the genesis file. If you have a running cluster, you can find here how to make the switch. All the info you need about our consensus mechanisms and setup can be found on our consensus section.

How do I update my nodes when there's a breaking change?

You can find a detailed guide on how to do this procedure here.