Skip to content

Provide functionality for assessing stake shift for Genesis peer snapshots #1508

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.

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

Open
amesgen opened this issue May 14, 2025 · 0 comments
Open
Labels
Genesis PRs related to Genesis testing and implementation

Comments

@amesgen
Copy link
Member

amesgen commented May 14, 2025

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 #1421 (comment) 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.

@amesgen amesgen added the Genesis PRs related to Genesis testing and implementation label May 14, 2025
@amesgen amesgen moved this to 🔖 Ready in Consensus Team Backlog May 14, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Genesis PRs related to Genesis testing and implementation
Projects
Status: 🔖 Ready
Development

No branches or pull requests

1 participant