IntersectMBO / IntersectMBO/ouroboros-consensus

Provide functionality for assessing stake shift for Genesis peer snapshots

Open
#1,508 0 comments 1 reaction 0 assignees View on GitHub
Genesis
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.