IntersectMBO / IntersectMBO/ouroboros-consensus
Provide functionality for assessing stake shift for Genesis peer snapshots
- Dominant language
- Haskell
- Stars
- 67
- Forks
- 43
- Avg merge
- 5d 13h
- Merged PRs (30d)
- 43
Description
Genesis requires a peer snapshot file for the Network layer to sample big ledger peers in order to satisfy the Honest Availability Assumption.
However, the stake quantities in this peer snapshot file might be stale compared to the current stake distribution ; this staleness can be quantified by the *stake shift*, see https://github.com/IntersectMBO/ouroboros-consensus/pull/1421#discussion_r1995448755 for references.
For monitoring purposes (in order to detect big stake shifts, eg due to exchanges), in order to decide when we should provide a new peer snapshot file, we decided to add a cardano-cli command that can compute this stake shift (reading a peer snapshot file, and comparing it to a stake distribution fetched from the node).
Then, this tool can be easily integrated into existing monitoring systems, raising an alarm if the stake shift increases abruptly.
The goal of this ticket is to expose the necessary functionality such that it can be easily exposed as a cardano-cli command downstream.
Contributor guide
Assessment
This issue has not been assessed yet.