2018-05-17 07:35:51 -07:00
|
|
|
# Stores
|
|
|
|
|
|
|
|
This document provided a bit more insight as to the purpose of several related
|
|
|
|
prefixed areas of the staking store which are accessed in `x/stake/keeper.go`.
|
|
|
|
|
|
|
|
|
|
|
|
## Validators
|
|
|
|
- Prefix Key Space: ValidatorsKey
|
|
|
|
- Key/Sort: Validator Owner Address
|
2018-05-22 16:34:31 -07:00
|
|
|
- Value: Validator Object
|
2018-05-17 12:48:47 -07:00
|
|
|
- Contains: All Validator records independent of being bonded or not
|
2018-05-17 07:35:51 -07:00
|
|
|
- Used For: Retrieve validator from owner address, general validator retrieval
|
|
|
|
|
|
|
|
## Validators By Power
|
|
|
|
- Prefix Key Space: ValidatorsByPowerKey
|
|
|
|
- Key/Sort: Validator Power (equivalent bonded shares) then Block
|
|
|
|
Height then Transaction Order
|
2018-05-22 16:34:31 -07:00
|
|
|
- Value: Validator Owner Address
|
2018-05-17 12:48:47 -07:00
|
|
|
- Contains: All Validator records independent of being bonded or not
|
2018-05-17 07:35:51 -07:00
|
|
|
- Used For: Determining who the top validators are whom should be bonded
|
|
|
|
|
2018-05-22 16:34:31 -07:00
|
|
|
## Validators Cliff Power
|
|
|
|
- Prefix Key Space: ValidatorCliffKey
|
|
|
|
- Key/Sort: single-record
|
|
|
|
- Value: Validator Power Key (as above store)
|
|
|
|
- Contains: The cliff validator (ex. 100th validator) power
|
|
|
|
- Used For: Efficient updates to validator status
|
|
|
|
|
2018-05-17 07:35:51 -07:00
|
|
|
## Validators Bonded
|
|
|
|
- Prefix Key Space: ValidatorsBondedKey
|
|
|
|
- Key/Sort: Validator PubKey Address (NOTE same as Tendermint)
|
2018-05-22 16:34:31 -07:00
|
|
|
- Value: Validator Owner Address
|
2018-05-17 07:35:51 -07:00
|
|
|
- Contains: Only currently bonded Validators
|
|
|
|
- Used For: Retrieving the list of all currently bonded validators when updating
|
|
|
|
for a new validator entering the validator set we may want to loop
|
|
|
|
through this set to determine who we've kicked out.
|
|
|
|
retrieving validator by tendermint index
|
|
|
|
|
|
|
|
## Tendermint Updates
|
|
|
|
- Prefix Key Space: TendermintUpdatesKey
|
|
|
|
- Key/Sort: Validator Owner Address
|
2018-05-22 16:34:31 -07:00
|
|
|
- Value: Tendermint ABCI Validator
|
2018-05-17 07:35:51 -07:00
|
|
|
- Contains: Validators are queued to affect the consensus validation set in Tendermint
|
2018-05-17 12:48:47 -07:00
|
|
|
- Used For: Informing Tendermint of the validator set updates, is used only intra-block, as the
|
|
|
|
updates are applied then cleared on endblock
|