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.

Sign up for GitHub

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

docs: committee rotation sequence diagram #314

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open

docs: committee rotation sequence diagram #314

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
dec5dcb
docs: committee rotation sequence diagram
mpskowron Dec 10, 2024
cb3a3e2
docs: add cardano node participant
mpskowron Dec 11, 2024
fda86b6
Merge branch 'master' into docs-committee-rotation-sequence
mpskowron Dec 16, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 33 additions & 0 deletions docs/diagrams/committee_rotation.mmd
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
sequenceDiagram
participant Mainchain as Cardano Node
participant Follower as Main Chain Follower
participant Inherent as Inherent Data Provider
participant Session as Session Manager
participant Aura as Aura
participant Grandpa as Grandpa

loop Runs forever asynchronously
Mainchain-)Follower: Get New Block
Follower-)Follower: Update internal ledger state
end

opt Epoch Start
Session->>Session: Rotate Committee
Session->>Aura: Rotate Committee
Session->>Grandpa: Rotate Committee
end
Session->>Inherent: Get next PC epoch with unknown committee
Inherent->>Inherent: Convert PC epoch to MC epoch

rect rgb(230,230,230)
Note over Follower,Inherent: Committee Selection Inputs
Follower->>Inherent: Get D-Parameter for the MC epoch
Follower->>Inherent: Get Permissioned Committee Candidates for the MC epoch
Follower->>Inherent: Get Registered Committee Candidates for the MC epoch
Follower->>Inherent: Get nonce for the MC epoch
end

opt Committee for next epoch is unknown
Inherent->>Session: Get Committee Selection Inputs<br>for next PC epoch
Session->>Session: Calculate and set committee for next PC epoch
end
Loading