serai/docs/protocol/Staking.md
Luke Parker e979883f2d
Initial validator sets pallet (#187)
* Initial work on a Validator Sets pallet

* Update Validator Set docs per current discussions

* Update validator-sets primitives and storage handling

* Add validator set pallets to deny.toml

* Remove Curve from primitives

Since we aren't reusing keys across coins, there's no reason for it to be
on-chain (as previously planned).

* Update documentation on Validator Sets

* Use Twox64Concat instead of Identity

Ensures an even distribution of keys. While xxhash is breakable, these keys
aren't manipulatable by users.

* Add math ops on Amount and define a coin as 1e8

* Add validator-sets to the runtime and remove contracts

Also removes the randomness pallet which was only required by the contracts
runtime.

Does not remove the contracts folder yet so they can still be referred to while
validator-sets is under development. Does remove them from Cargo.toml.

* Add vote function to validator-sets

* Remove contracts folder

* Create an event for the Validator Sets pallet

* Remove old contracts crates from deny.toml

* Remove line from staking branch

* Remove staking from runtime

* Correct VS Config in runtime

* cargo update

* Resolve a few PR comments on terminology

* Create a serai-primitives crate

Move types such as Amount/Coin out of validator-sets. Will be expanded in the
future.

* Fixes for last commit

* Don't reserve set 0

* Further fixes

* Add files meant for last commit

* Remove Staking transfer
2023-01-04 22:52:41 -05:00

699 B

Staking

Serai's staking pallet offers a DPoS system. All stake which enters the system is delegated somewhere. Delegates can then bond their stake to different validator sets, justifying their inclusion and providing financial security.

Delegators may transfer stake whenever, so long as that stake isn't actively bonded. Delegators may also unstake whenever, so long as the prior condition is still met.

Stake (message)

  • delegate (Address): Address to delegate the newly added stake to.
  • amount (Amount): Amount to stake and delegate.

Unstake (message)

  • delegate (Address): Address the stake is currently delegated to.
  • amount (Amount): Amount to unstake.