certusone
/
cosmos-sdk
mirror of https://github.com/certusone/cosmos-sdk.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

update x/stake/store.md

This commit is contained in:
rigelrozanski 2018-05-22 19:34:31 -04:00
parent 26695afe9f
commit cf2d5306c2
1 changed files with 11 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
x/stake/store.md
View File

@ -7,6 +7,7 @@ prefixed areas of the staking store which are accessed in `x/stake/keeper.go`.
## Validators ## Validators
- Prefix Key Space: ValidatorsKey - Prefix Key Space: ValidatorsKey
- Key/Sort: Validator Owner Address - Key/Sort: Validator Owner Address
- Value: Validator Object
- Contains: All Validator records independent of being bonded or not - Contains: All Validator records independent of being bonded or not
- Used For: Retrieve validator from owner address, general validator retrieval - Used For: Retrieve validator from owner address, general validator retrieval
@ -14,12 +15,21 @@ prefixed areas of the staking store which are accessed in `x/stake/keeper.go`.
- Prefix Key Space: ValidatorsByPowerKey - Prefix Key Space: ValidatorsByPowerKey
- Key/Sort: Validator Power (equivalent bonded shares) then Block - Key/Sort: Validator Power (equivalent bonded shares) then Block
Height then Transaction Order Height then Transaction Order
- Value: Validator Owner Address
- Contains: All Validator records independent of being bonded or not - Contains: All Validator records independent of being bonded or not
- Used For: Determining who the top validators are whom should be bonded - Used For: Determining who the top validators are whom should be bonded
## 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
## Validators Bonded ## Validators Bonded
- Prefix Key Space: ValidatorsBondedKey - Prefix Key Space: ValidatorsBondedKey
- Key/Sort: Validator PubKey Address (NOTE same as Tendermint) - Key/Sort: Validator PubKey Address (NOTE same as Tendermint)
- Value: Validator Owner Address
- Contains: Only currently bonded Validators - Contains: Only currently bonded Validators
- Used For: Retrieving the list of all currently bonded validators when updating - 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 for a new validator entering the validator set we may want to loop
@ -29,6 +39,7 @@ prefixed areas of the staking store which are accessed in `x/stake/keeper.go`.
## Tendermint Updates ## Tendermint Updates
- Prefix Key Space: TendermintUpdatesKey - Prefix Key Space: TendermintUpdatesKey
- Key/Sort: Validator Owner Address - Key/Sort: Validator Owner Address
- Value: Tendermint ABCI Validator
- Contains: Validators are queued to affect the consensus validation set in Tendermint - Contains: Validators are queued to affect the consensus validation set in Tendermint
- Used For: Informing Tendermint of the validator set updates, is used only intra-block, as the - Used For: Informing Tendermint of the validator set updates, is used only intra-block, as the
updates are applied then cleared on endblock updates are applied then cleared on endblock