Skip to content

docs: technical spec and execution flows - #27

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

docs: technical spec and execution flows#27
olegshmuelov wants to merge 3 commits into
feat/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

@MatheusFranco99 MatheusFranco99 left a comment

Copy link
Copy Markdown

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

@MatheusFranco99 MatheusFranco99 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Good work :)

@iurii-ssv iurii-ssv left a comment

Copy link
Copy Markdown

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