docs2 icon indicating copy to clipboard operation
docs2 copied to clipboard

docs: clarify epoch seed in Delegation Program Tiebreak System

Open barriebyron opened this issue 2 years ago • 0 comments

Updates are required for the seed references in https://docs.minaprotocol.com/node-operators/delegation-tiebreak

From Nathan's PR review comment https://github.com/o1-labs/docs2/pull/605/files#r1344350482

In general, it's a bit confusing to keep on referring to the seed you need as "the seed from the last epoch of the previous cycle". This is a partially inaccurate description of an Ouroboros implementation detail that users need not be aware of.

This concept is called the "epoch seed", and the specific instance we want to query for a given epoch is the "active staking epoch seed". The query below is querying exactly this -- it looks at the latest canonical block in the chain at the specified epoch you are querying, and it returns the staking epoch seed for that block. The fact that this epoch seed was determined at some point in a prior epoch isn't an important detail for users to be aware of.

barriebyron avatar Oct 03 '23 21:10 barriebyron