Skip to content

Added information about suspending a validator #1226

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Feb 18, 2025
33 changes: 33 additions & 0 deletions source/mainnet/docs/protocol/concepts-baker.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ A validator needs to :term:`stake<staked amount>` a part of its CCD balance on t

All validators automatically take part in a *lottery* every round to decide who will produce the next block, see :term:`leader election<leader election>`. The greater the validator's stake, the greater the validator's chance of :term:`winning the lottery<lottery power>` and being selected to produce a block.


Overview of the validation process
==================================

Expand Down Expand Up @@ -104,3 +105,35 @@ A block is final when it cannot be rolled back any more, i.e., part of the autho

A block is final at a minimum of two seconds after its creation. A new block has to be created descended from that block for the new block to be final.

Validator Suspension
====================

A validator may be suspended if it remains inactive and fails to produce blocks when selected as a round leader. This mechanism, introduced in Protocol 8, helps maintain the blockchain's performance and reliability by excluding inactive validators.

A validator faces :term:`suspension` if it reaches a threshold of missed rounds. The size of a validator's stake affects how long the validator's node has to be inactive before reaching the threshold:

* High-stake validators may reach the suspension threshold within hours due to their frequent selection as round leaders.
* Low-stake validators may take several days to reach the threshold due to fewer opportunities to produce blocks.

When a validator misses multiple blocks in succession and reaches the inactivity threshold by a payday, it becomes *primed for suspension*. The validator then has until the next snapshot epoch to demonstrate activity by either:

* Producing a block
* Having their signature included in a quorum certificate

If the validator remains inactive through the snapshot epoch, the suspension takes effect at the following payday epoch.

.. note::

A high-stake validator could face suspension after approximately 23 hours of inactivity, while low-stake validators typically require a longer period of inactivity before reaching the threshold.


A suspended validator:

* Can resume validation through a manual transaction
* Incurs no specific penalties beyond the suspension period
* Maintains its delegators unless the delegators choose to update their delegation

.. note::

The protocol includes safeguards to prevent more than one-third of the total stake from being suspended simultaneously as this would halt the blockchain. This suspension mechanism protects against accidental or careless inactivity but does not protect against malicious behavior.

4 changes: 4 additions & 0 deletions source/mainnet/docs/resources/glossary.rst
Original file line number Diff line number Diff line change
Expand Up @@ -413,6 +413,10 @@ Also see the Concordium `Whitepaper <https://developer.concordium.software/gover

A list presented to a wallet by a dApp or service whose items are either attributes to reveal, or properties of attributes to prove.

Suspension

A state where a validator is temporarily excluded from block production due to prolonged inactivity. The suspension threshold varies based on the validator's stake size and remains in effect for at least one epoch until manually resumed.

Tally

Tally (noun) is the number of votes obtained by every candidate computed by summing all weighted votes for every candidate. Also, tally (verb) is the process of calculating the number of votes.
Expand Down