Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 32 additions & 5 deletions docs/glossary.adoc
Original file line number Diff line number Diff line change
@@ -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
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Something about being required by the contract, maybe?

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.

Expand Down Expand Up @@ -51,19 +63,34 @@ 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
*keep*.

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.
Expand Down