diff --git a/docs/glossary.adoc b/docs/glossary.adoc index 217476e9b4..d1bbebaed7 100644 --- a/docs/glossary.adoc +++ b/docs/glossary.adoc @@ -1,18 +1,30 @@ = Glossary +Stake:: An amount of KEEP that is bonded in order to participate in the + threshold relay and, optionally, the Keep network. Part or all of this can be + removed from escrow as penalties for misbehavior, while part or all of it can + be refunded if and when a participant chooses to withdraw in orderly fashion + from the network and relay. + Staker:: A staking client that has a stake, but may not yet be in a signing - group. + group. -Minimum Stake Amount:: The minimum stake that will make a staking client a - staker. +Minimum Stake Amount:: The minimum stake amount that will make a staking client + a staker, as required by the staking smart contract. Stake Amount:: Total KEEP deposited for a single stake. Signing Member:: One member of one complete signing group in the threshold - relay. + relay. Signing Group:: One complete signing group in the threshold relay. +Lead Signing Group:: The signing group that will produce the next relay entry + candidate (due to being the result of $E_i mod N$ with $E_i$ being the + current entry and $N$ being the number of groups). If this group fails to + respond to the request in time, the lead responsibility may shift to another + group. + Relay Entry Candidate:: A random number generated by the threshold relay that has not yet been finalized on the blockchain; may be invalid. @@ -51,12 +63,20 @@ Keep Owner, Delegate, Requester are described in the whitepaper. == Verbs -The system *assigns* one *seat* of one *keep* to a *keep provider*. +The network *assigns* one *seat* of one *keep* to a *keep provider*. One *keep provider* can only be assigned one *seat* for any given *keep*. One *keep* has 1 or more *seats*, which correspond to unique *keep providers*. +One *staker* becomes a *signing member* on the threshold relay when the *signing +group* they are a member of is *complete*. + +One *signing group* is *activated* once it is *complete* (meaning, it has a +number of stakers assigned to it equal to the *signing group size*), +*initialized* (meaning, the stakers have generated their key shares and the +group has a public key registered), and the *activation delay* has elapsed. + == Relationships A greater *stake amount* leads to a greater probability of being *assigned* a @@ -64,6 +84,13 @@ A greater *stake amount* leads to a greater probability of being *assigned* a A greater number of *seats* costs more *native token* over time. +The *threshold relay* generates one or more new *relay entry candidates* on +request. One block on the chain can contain one or more requests for new relay +entries. + +The pending *relay entry candidates* are finalized on the chain into *relay +entries*. + == Paying The Threshold Relay needs to be sustainable on its own.