Skip to content

Simplex reconfiguration mechanism specification #4124

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

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

yacovm
Copy link
Contributor

@yacovm yacovm commented Jul 27, 2025

Why this should be merged

Specifies the Simplex reconfiguration mechanism.

Preview is available here.

How this works

Just documentation

How this was tested

CI

Need to be documented in RELEASES.md?

No

@Copilot Copilot AI review requested due to automatic review settings July 27, 2025 21:16
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR introduces comprehensive documentation for the Simplex L1 reconfiguration mechanism, detailing how the consensus protocol handles validator set changes and epoch management.

  • Defines the distinction between ICM epochs and Simplex epochs with their respective purposes and behaviors
  • Introduces the Metadata State-Machine (MSM) for managing consensus protocol state transitions
  • Specifies the onboarding process for new nodes to validate blocks across different epochs
Comments suppressed due to low confidence (1)

simplex/reconfiguration.md:97

  • The reference to PChainHeight should be PChainReferenceHeight to match the field name defined in the structure above
- The validator set of the epoch numbered `EpochNumber` is therefore derived from `PChainHeight`.

Signed-off-by: Yacov Manevich <yacov.manevich@avalabs.org>
@yacovm yacovm force-pushed the simplex-reconfig branch from fe15094 to ffb7341 Compare July 27, 2025 21:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: No status
Development

Successfully merging this pull request may close these issues.

1 participant