2018-05-08 14:35:24 -07:00
|
|
|
# Staking module specification
|
|
|
|
|
|
|
|
## Abstract
|
|
|
|
|
2018-05-18 11:26:32 -07:00
|
|
|
This paper specifies the Staking module of the Cosmos-SDK, which was first
|
|
|
|
described in the [Cosmos Whitepaper](https://cosmos.network/about/whitepaper)
|
|
|
|
in June 2016.
|
2018-05-08 14:35:24 -07:00
|
|
|
|
2018-05-18 11:26:32 -07:00
|
|
|
The module enables Cosmos-SDK based blockchain to support an advanced
|
|
|
|
Proof-of-Stake system. In this system, holders of the native staking token of
|
|
|
|
the chain can become validators and can delegate tokens to validator
|
|
|
|
validators, ultimately determining the effective validator set for the system.
|
2018-05-08 14:35:24 -07:00
|
|
|
|
2018-05-18 11:26:32 -07:00
|
|
|
This module will be used in the Cosmos Hub, the first Hub in the Cosmos
|
|
|
|
network.
|
2018-05-08 14:35:24 -07:00
|
|
|
|
|
|
|
## Contents
|
|
|
|
|
2018-05-18 11:26:32 -07:00
|
|
|
The following specification uses *Atom* as the native staking token. The module
|
|
|
|
can be adapted to any Proof-Of-Stake blockchain by replacing *Atom* with the
|
|
|
|
native staking token of the chain.
|
2018-05-08 14:35:24 -07:00
|
|
|
|
2019-01-21 16:52:03 -08:00
|
|
|
1. **[State](state.md)**
|
|
|
|
- Pool
|
|
|
|
- Params
|
|
|
|
- Validator
|
|
|
|
- Delegation
|
|
|
|
- UnbondingDelegation
|
|
|
|
- Redelegation
|
2019-02-08 15:57:33 -08:00
|
|
|
- Queues
|
|
|
|
2. **[State Transistions](state_transitions.md)**
|
|
|
|
- Validator
|
|
|
|
- Delegation
|
|
|
|
- Slashing
|
|
|
|
3. **[Messages](messages.md)**
|
2019-01-21 16:52:03 -08:00
|
|
|
- MsgCreateValidator
|
|
|
|
- MsgEditValidator
|
|
|
|
- MsgDelegate
|
|
|
|
- MsgBeginUnbonding
|
|
|
|
- MsgBeginRedelegate
|
2019-02-08 15:57:33 -08:00
|
|
|
4. **[End-Block](end_block.md)**
|
2019-01-21 16:52:03 -08:00
|
|
|
- Validator Set Changes
|
|
|
|
- Queues
|
|
|
|
- Unbonding Validators
|
|
|
|
- Unbonding Delegations
|
|
|
|
- Redelegations
|
2019-02-08 15:57:33 -08:00
|
|
|
5. **[Hooks](hooks.md)**
|
|
|
|
6. **[Tags](tags.md)**
|
2019-01-21 16:52:03 -08:00
|
|
|
|