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

📚 Plan validator onboarding flow and create guideline #391

Open
hacheigriega opened this issue Oct 21, 2024 · 0 comments
Open

📚 Plan validator onboarding flow and create guideline #391

hacheigriega opened this issue Oct 21, 2024 · 0 comments
Labels
priority: medium Should be fixed soon type: documentation 📚 Improvements or additions to documentation

Comments

@hacheigriega
Copy link
Member

hacheigriega commented Oct 21, 2024

📚 Documentation

The validator onboarding process now has an additional component of batching key generation and registration.

The most straightforward flow would be:

  1. If we are upgrading an existing chain, first perform an upgrade to the new binary version that contains the batching feature.
  2. The parameter for vote extension enable height is set at some height H in the future.
  3. The validators are asked to use the add-keys transaction to generate and register the required keys before H is reached.
  4. If more than 2/3 of validators have fulfilled the task, the batching is enabled successfully. If not, the chain halts.

To avoid the possibility of chain halt, we could take the following steps instead:

  1. If we are upgrading an existing chain, first perform an upgrade to the new binary version that contains the batching feature.
  2. Add a boolean state IsBatchingEnabled for indicating whether batching has been enabled or not. Its initial value is false, and, once switched to true, it will never revert to false. The voting power check in PrepareProposal and ProcessProposal are disabled until the voting power of the votes with extensions reach 2/3, at which point IsBatchingEnabled is switched to true and the voting power check is enabled.

This way, the batching sequence is enabled at whichever height more than 2/3 of validators have generated and registered the SEDA keys.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
priority: medium Should be fixed soon type: documentation 📚 Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

2 participants