Skip to content
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

[R4R] BEP-127: Temporary Maintenance Mode for Validators #127

Merged
merged 6 commits into from
May 5, 2022

Conversation

SolidityGo
Copy link
Contributor

@SolidityGo SolidityGo commented Dec 30, 2021

BEP-127: Temporary Maintenance Mode for Validators

1. Summary

This BEP introduces the Temporary Maintenance mode for validators on the BNB Smart Chain.

2. Abstract

Temporary Maintenance is supposed to last one or a few hours. The validator seat will be temporarily dropped from the block producing rotation during the maintenance. Since long-time offline maintenance is not encouraged, the validator will still be slashed if the maintenance lasts too long. To lower the impact from poorly-operating validators who forget to claim its maintenance, they will be forced to enter Temporary Maintenance mode too.

3. Status

Draft.

4. Motivation

Due to the design of Parlia consensus, the absence of the validator, even if it is due to scheduled maintenance, will cause instability and capacity loss of BSC due to the extra waiting time and chain reorganization for other validators. Introducing Temporary Maintenance mode will stabilize the blocking rotation and maintain the capacity of BSC.

5. Specification

Current Slash Mechanisms

The slash contract will record the missed blocking metrics of each validator.

  • Once the metrics are above the predefined threshold, the blocking reward for validator will not be relayed to BC for distribution but shared with other better validators.
  • If the metrics remain above another higher level of threshold, the validator will be dropped from the rotation, and put as “in jail”. This will be propagated back to BNB Beacon Chain, where a predefined amount of BNB would be slashed from the self-delegated BNB of the validator.

Temporary Maintenance Mode

Proactive Maintenance

Validator can claim itself to enter scheduled maintenance by sending a transaction signed by the consensus key. The validator can claim itself to exit maintenance by sending another transaction. The slash cleaning work will be done within the exit transaction:

SlashCount = (MaintenanceEndHeight - MaintenanceStartHeight)/len(currentValidatorSet)/Scale

Scale is a governable parameter, the initial setting is 2, usually it should be larger than 1. If SlashCount is larger than a predefined value, the validator will still be slashed. The validator can get more time to bring the node back before being slashed if it claims itself to enter maintenance. Validator is encouraged to claim itself to exit maintenance even if it will be put in jail, since it can send the unjail transaction earlier.

Passive Maintenance

Once the number of missed blocks is above a predefined threshold, the validator will enter maintenance automatically. The validator still gets a chance to catch up and claim itself online again.

Limit

  1. The number of maintained validators has an upper limit at the same time. Once exceeded, the following proactive/passive claim request will be rejected.
  2. A validator can only enter maintenance once per day.

ValidatorSet Change

The validators election will repeat every 24 hours, the maintenance will end immediately once election happens.

Impact to Validator Maintainers

Validator maintainers can claim the validator to enter maintenance mode once the node runs into unexpected issues. Validator maintainers need to send transactions to exit maintenance mode even if the validator is enforced into maintenance, otherwise, the validator may be put in jail.

6. License

The content is licensed under CC0.

@unclezoro unclezoro changed the title [WIP] BEP-99: Temporary Maintenance Mode for Validators [R4R] BEP-99: Temporary Maintenance Mode for Validators Jan 10, 2022
@unclezoro unclezoro changed the title [R4R] BEP-99: Temporary Maintenance Mode for Validators [R4R] BEP-127: Temporary Maintenance Mode for Validators Jan 10, 2022
Copy link

@jonesk7734 jonesk7734 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

😀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants