Skip to content

docs: technical spec and execution flows#27

Open
olegshmuelov wants to merge 3 commits intofeat/eth-cluster-migrationfrom
docs/spec-flows
Open

docs: technical spec and execution flows#27
olegshmuelov wants to merge 3 commits intofeat/eth-cluster-migrationfrom
docs/spec-flows

Conversation

@olegshmuelov
Copy link
Copy Markdown
Contributor

Summary

  • SPEC.md: Full technical specification of the reward pipeline — data sources, sync lifecycle, reward formula, fee mechanics, dual Merkle trees (SSV/ETH), inflation cap, exclusions, redirects, output artifacts, and reproducibility guarantees
  • FLOWS.md: Step-by-step execution flows for sync, calc, and merkleization — including sync modes, migration event handling, and verifier procedure

Context

Documents the complete reward calculation system as implemented, covering all IMP revisions (DIP-16, DIP-18, DIP-27, DIP-34, DIP-39) and the DIP-50 staking upgrade (ETH-denominated clusters with dual Merkle trees).

Test plan

  • Review SPEC.md against codebase for accuracy
  • Review FLOWS.md against sync/calc execution paths

Copy link
Copy Markdown

@MatheusFranco99 MatheusFranco99 left a comment

Choose a reason for hiding this comment

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

Good work!!
Some questions before I continue reviewing :)

Comment thread docs/SPEC.md Outdated
Comment thread docs/SPEC.md
Comment thread docs/SPEC.md
Comment thread docs/SPEC.md Outdated
Comment thread docs/SPEC.md
Comment thread docs/FLOWS.md
Comment thread docs/SPEC.md
Copy link
Copy Markdown

@MatheusFranco99 MatheusFranco99 left a comment

Choose a reason for hiding this comment

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

Good work :)

Copy link
Copy Markdown

@iurii-ssv iurii-ssv left a comment

Choose a reason for hiding this comment

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

LGTM

@olegshmuelov olegshmuelov requested a review from andrew-blox April 6, 2026 09:16
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.

5 participants