keeper

package
v0.55.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 14, 2026 License: Apache-2.0 Imports: 34 Imported by: 3,031

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func NewMsgServerImpl added in v0.40.0

func NewMsgServerImpl(keeper *Keeper) types.MsgServer

NewMsgServerImpl returns an implementation of the staking MsgServer interface for the provided Keeper.

func TestingUpdateValidator

func TestingUpdateValidator(keeper *Keeper, ctx sdk.Context, validator types.Validator, apply bool) types.Validator

TestingUpdateValidator updates a validator for testing

func ValidatorByPowerIndexExists

func ValidatorByPowerIndexExists(ctx context.Context, keeper *Keeper, power []byte) bool

ValidatorByPowerIndexExists does a certain by-power index record exist

Types

type Keeper

type Keeper struct {
	// contains filtered or unexported fields
}

Keeper of the x/staking store

func NewKeeper

func NewKeeper(
	cdc codec.BinaryCodec,
	storeService storetypes.KVStoreService,
	ak types.AccountKeeper,
	bk types.BankKeeper,
	authority string,
	validatorAddressCodec addresscodec.Codec,
	consensusAddressCodec addresscodec.Codec,
) *Keeper

NewKeeper creates a new staking Keeper instance

func (Keeper) AddValidatorTokensAndShares

func (k Keeper) AddValidatorTokensAndShares(ctx context.Context, validator types.Validator,
	tokensToAdd math.Int,
) (valOut types.Validator, addedShares math.LegacyDec, err error)

AddValidatorTokensAndShares updates the tokens of an existing validator, updates the validators power index key

func (Keeper) ApplyAndReturnValidatorSetUpdates

func (k Keeper) ApplyAndReturnValidatorSetUpdates(ctx context.Context) (updates []abci.ValidatorUpdate, err error)

ApplyAndReturnValidatorSetUpdates applies and return accumulated updates to the bonded validator set. Also, * Updates the active valset as keyed by LastValidatorPowerKey. * Updates the total power as keyed by LastTotalPowerKey. * Updates validator status' according to updated powers. * Updates the fee pool bonded vs not-bonded tokens. * Updates relevant indices. It gets called once after genesis, another time maybe after genesis transactions, then once at every EndBlock.

CONTRACT: Only validators with non-zero power or zero-power that were bonded at the previous block height or were removed from the validator set entirely are returned to CometBFT.

func (Keeper) ApplyConsKeyRotation added in v0.55.0

func (k Keeper) ApplyConsKeyRotation(ctx context.Context, valAddr sdk.ValAddress, newPubKey cryptotypes.PubKey) error

ApplyConsKeyRotation swaps the validator's ConsensusPubkey to newPubKey and updates the byConsAddr index. Returns nil silently if the validator no longer exists.

func (Keeper) ApplyConsKeyRotations added in v0.55.0

func (k Keeper) ApplyConsKeyRotations(ctx context.Context) (err error)

ApplyConsKeyRotations iterates every apply queue entry whose applyHeight has been reached, performs the state swap, and clears the queue entry plus the new addr rotation lock.

func (*Keeper) BeginBlocker added in v0.50.1

func (k *Keeper) BeginBlocker(ctx context.Context) error

BeginBlocker will persist the current header and validator set as a historical entry and prune the oldest entry based on the HistoricalEntries parameter

func (Keeper) BeginRedelegation

func (k Keeper) BeginRedelegation(
	ctx context.Context, delAddr sdk.AccAddress, valSrcAddr, valDstAddr sdk.ValAddress, sharesAmount math.LegacyDec,
) (completionTime time.Time, err error)

BeginRedelegation begins unbonding / redelegation and creates a redelegation record.

func (Keeper) BeginUnbondingValidator added in v0.47.0

func (k Keeper) BeginUnbondingValidator(ctx context.Context, validator types.Validator) (types.Validator, error)

BeginUnbondingValidator performs all the store operations for when a validator begins unbonding

func (Keeper) BlockValidatorUpdates

func (k Keeper) BlockValidatorUpdates(ctx context.Context) ([]abci.ValidatorUpdate, error)

BlockValidatorUpdates calculates the ValidatorUpdates for the current block Called in each EndBlock

func (Keeper) BondDenom

func (k Keeper) BondDenom(ctx context.Context) (string, error)

BondDenom - Bondable coin denomination

func (Keeper) BondedRatio

func (k Keeper) BondedRatio(ctx context.Context) (math.LegacyDec, error)

BondedRatio the fraction of the staking tokens which are currently bonded

func (Keeper) CompleteRedelegation

func (k Keeper) CompleteRedelegation(
	ctx context.Context, delAddr sdk.AccAddress, valSrcAddr, valDstAddr sdk.ValAddress,
) (sdk.Coins, error)

CompleteRedelegation completes the redelegations of all mature entries in the retrieved redelegation object and returns the total redelegation (initial) balance or an error upon failure.

func (Keeper) CompleteUnbonding

func (k Keeper) CompleteUnbonding(ctx context.Context, delAddr sdk.AccAddress, valAddr sdk.ValAddress) (sdk.Coins, error)

CompleteUnbonding completes the unbonding of all mature entries in the retrieved unbonding delegation object and returns the total unbonding balance or an error upon failure.

func (Keeper) ConsKeyRotationUpdate added in v0.55.0

func (k Keeper) ConsKeyRotationUpdate(validator types.Validator, newPubKey cryptotypes.PubKey, powerReduction math.Int) (abci.ValidatorUpdates, error)

ConsKeyRotationUpdate builds the (old@0, new@power) ABCI ValidatorUpdate pair that announces a cons key rotation to CometBFT. It does not mutate state.

func (Keeper) ConsensusAddressCodec added in v0.50.1

func (k Keeper) ConsensusAddressCodec() addresscodec.Codec

ConsensusAddressCodec returns the app consensus address codec.

func (Keeper) Delegate

func (k Keeper) Delegate(
	ctx context.Context, delAddr sdk.AccAddress, bondAmt math.Int, tokenSrc types.BondStatus,
	validator types.Validator, subtractAccount bool,
) (newShares math.LegacyDec, err error)

Delegate performs a delegation, set/update everything necessary within the store. tokenSrc indicates the bond status of the incoming funds.

func (Keeper) Delegation

func (k Keeper) Delegation(ctx context.Context, addrDel sdk.AccAddress, addrVal sdk.ValAddress) (types.DelegationI, error)

Delegation gets the delegation interface for a particular set of delegator and validator addresses

func (Keeper) DeleteHistoricalInfo

func (k Keeper) DeleteHistoricalInfo(ctx context.Context, height int64) error

DeleteHistoricalInfo deletes the historical info at a given height

func (Keeper) DeleteLastValidatorPower

func (k Keeper) DeleteLastValidatorPower(ctx context.Context, operator sdk.ValAddress) error

DeleteLastValidatorPower deletes the last validator power.

func (Keeper) DeleteUnbondingIndex added in v0.47.0

func (k Keeper) DeleteUnbondingIndex(ctx context.Context, id uint64) error

DeleteUnbondingIndex removes a mapping from UnbondingId to unbonding operation

func (Keeper) DeleteValidatorByPowerIndex

func (k Keeper) DeleteValidatorByPowerIndex(ctx context.Context, validator types.Validator) error

DeleteValidatorByPowerIndex deletes a record by power index

func (Keeper) DeleteValidatorQueue

func (k Keeper) DeleteValidatorQueue(ctx context.Context, val types.Validator) error

DeleteValidatorQueue removes a validator by address from the unbonding queue indexed by a given height and time.

func (Keeper) DeleteValidatorQueueTimeSlice

func (k Keeper) DeleteValidatorQueueTimeSlice(ctx context.Context, endTime time.Time, endHeight int64) error

DeleteValidatorQueueTimeSlice deletes all entries in the queue indexed by a given height and time.

func (Keeper) DequeueAllMatureRedelegationQueue

func (k Keeper) DequeueAllMatureRedelegationQueue(ctx context.Context, currTime time.Time) (matureRedelegations []types.DVVTriplet, err error)

DequeueAllMatureRedelegationQueue returns a concatenated list of all the timeslices inclusively previous to currTime, and deletes the timeslices from the queue.

func (Keeper) DequeueAllMatureUBDQueue

func (k Keeper) DequeueAllMatureUBDQueue(ctx context.Context, currTime time.Time) (matureUnbonds []types.DVPair, err error)

DequeueAllMatureUBDQueue returns a concatenated list of all the timeslices inclusively previous to currTime, and deletes the timeslices from the queue.

func (*Keeper) EndBlocker added in v0.50.1

func (k *Keeper) EndBlocker(ctx context.Context) ([]abci.ValidatorUpdate, error)

EndBlocker called at every block, update validator set

func (Keeper) ExportConsKeyRotationHistory added in v0.55.0

func (k Keeper) ExportConsKeyRotationHistory(ctx context.Context) (histories []types.ConsensusKeyRotationHistory, err error)

ExportConsKeyRotationHistory returns one record per rotated-away consensus key whose evidence lock has not yet been retired, plus each validator's still active re-rotation gate maturity. It walks the evidence-lock retirement queue because that outlives the unbonding-keyed maturity queue.

func (Keeper) ExportGenesis added in v0.46.0

func (k Keeper) ExportGenesis(ctx sdk.Context) *types.GenesisState

ExportGenesis returns a GenesisState for a given context and keeper. The GenesisState will contain the pool, params, validators, and bonds found in the keeper.

func (Keeper) ExportPendingConsKeyRotations added in v0.55.0

func (k Keeper) ExportPendingConsKeyRotations(ctx context.Context, exportedInitialHeight int64) (rotations []types.PendingConsensusKeyRotation, err error)

ExportPendingConsKeyRotations returns consensus key rotations whose deferred SDK side state update has not been applied yet. Rotations that are not active at exportedInitialHeight are pushed forward so an imported chain can reemit their validator update before applying the SDK side key swap.

func (Keeper) GetAllDelegations

func (k Keeper) GetAllDelegations(ctx context.Context) (delegations []types.Delegation, err error)

GetAllDelegations returns all delegations used during genesis dump.

func (Keeper) GetAllDelegatorDelegations

func (k Keeper) GetAllDelegatorDelegations(ctx context.Context, delegator sdk.AccAddress) ([]types.Delegation, error)

GetAllDelegatorDelegations returns all delegations of a delegator

func (Keeper) GetAllHistoricalInfo

func (k Keeper) GetAllHistoricalInfo(ctx context.Context) ([]types.HistoricalInfo, error)

GetAllHistoricalInfo returns all stored HistoricalInfo objects.

func (Keeper) GetAllRedelegations

func (k Keeper) GetAllRedelegations(
	ctx context.Context, delegator sdk.AccAddress, srcValAddress, dstValAddress sdk.ValAddress,
) ([]types.Redelegation, error)

GetAllRedelegations returns all redelegations of a delegator

func (Keeper) GetAllSDKDelegations

func (k Keeper) GetAllSDKDelegations(ctx context.Context) (delegations []types.Delegation, err error)

GetAllSDKDelegations returns all delegations used during genesis dump TODO: remove this func, change all usage for iterate functionality

func (Keeper) GetAllUnbondingDelegations

func (k Keeper) GetAllUnbondingDelegations(ctx context.Context, delegator sdk.AccAddress) ([]types.UnbondingDelegation, error)

GetAllUnbondingDelegations returns all unbonding-delegations of a delegator

func (Keeper) GetAllValidators

func (k Keeper) GetAllValidators(ctx context.Context) (validators []types.Validator, err error)

GetAllValidators gets the set of all validators with no limits, used during genesis dump

func (Keeper) GetAuthority added in v0.47.0

func (k Keeper) GetAuthority() string

GetAuthority returns the x/staking module's authority.

func (Keeper) GetBondedPool

func (k Keeper) GetBondedPool(ctx context.Context) (bondedPool sdk.ModuleAccountI)

GetBondedPool returns the bonded tokens pool's module account

func (Keeper) GetBondedValidatorsByPower

func (k Keeper) GetBondedValidatorsByPower(ctx context.Context) ([]types.Validator, error)

GetBondedValidatorsByPower gets the current group of bonded validators sorted by power-rank

func (Keeper) GetDelegation

func (k Keeper) GetDelegation(ctx context.Context, delAddr sdk.AccAddress, valAddr sdk.ValAddress) (types.Delegation, error)

GetDelegation returns a specific delegation.

func (Keeper) GetDelegatorBonded added in v0.45.4

func (k Keeper) GetDelegatorBonded(ctx context.Context, delegator sdk.AccAddress) (math.Int, error)

GetDelegatorBonded returns the total amount a delegator has bonded.

func (Keeper) GetDelegatorDelegations

func (k Keeper) GetDelegatorDelegations(ctx context.Context, delegator sdk.AccAddress, maxRetrieve uint16) (delegations []types.Delegation, err error)

GetDelegatorDelegations returns a given amount of all the delegations from a delegator.

func (Keeper) GetDelegatorUnbonding added in v0.45.4

func (k Keeper) GetDelegatorUnbonding(ctx context.Context, delegator sdk.AccAddress) (math.Int, error)

GetDelegatorUnbonding returns the total amount a delegator has unbonding.

func (Keeper) GetDelegatorValidator

func (k Keeper) GetDelegatorValidator(
	ctx context.Context, delegatorAddr sdk.AccAddress, validatorAddr sdk.ValAddress,
) (validator types.Validator, err error)

GetDelegatorValidator returns a validator that a delegator is bonded to

func (Keeper) GetDelegatorValidators

func (k Keeper) GetDelegatorValidators(
	ctx context.Context, delegatorAddr sdk.AccAddress, maxRetrieve uint32,
) (types.Validators, error)

GetDelegatorValidators returns all validators that a delegator is bonded to. If maxRetrieve is supplied, the respective amount will be returned.

func (Keeper) GetHistoricalInfo

func (k Keeper) GetHistoricalInfo(ctx context.Context, height int64) (types.HistoricalInfo, error)

GetHistoricalInfo gets the historical info at a given height

func (Keeper) GetKeyRotationFeePool added in v0.55.0

func (k Keeper) GetKeyRotationFeePool(ctx context.Context) (keyRotationFeePool sdk.ModuleAccountI)

GetKeyRotationFeePool returns the key rotation fee pool's module account. Consensus key rotation fees are routed through this account before being burned.

func (Keeper) GetLastTotalPower

func (k Keeper) GetLastTotalPower(ctx context.Context) (math.Int, error)

GetLastTotalPower loads the last total validator power.

func (Keeper) GetLastValidatorPower

func (k Keeper) GetLastValidatorPower(ctx context.Context, operator sdk.ValAddress) (power int64, err error)

GetLastValidatorPower loads the last validator power. Returns zero if the operator was not a validator last block.

func (Keeper) GetLastValidators

func (k Keeper) GetLastValidators(ctx context.Context) (validators []types.Validator, err error)

GetLastValidators gets the group of the bonded validators

func (Keeper) GetNotBondedPool

func (k Keeper) GetNotBondedPool(ctx context.Context) (notBondedPool sdk.ModuleAccountI)

GetNotBondedPool returns the not bonded tokens pool's module account

func (Keeper) GetParams

func (k Keeper) GetParams(ctx context.Context) (params types.Params, err error)

GetParams gets the x/staking module parameters.

func (Keeper) GetPubKeyByConsAddr added in v0.50.1

func (k Keeper) GetPubKeyByConsAddr(ctx context.Context, addr sdk.ConsAddress) (cmtprotocrypto.PublicKey, error)

GetPubKeyByConsAddr returns the consensus public key by consensus address.

func (Keeper) GetRedelegation

func (k Keeper) GetRedelegation(ctx context.Context, delAddr sdk.AccAddress, valSrcAddr, valDstAddr sdk.ValAddress) (red types.Redelegation, err error)

GetRedelegation returns a redelegation.

func (Keeper) GetRedelegationByUnbondingID added in v0.47.0

func (k Keeper) GetRedelegationByUnbondingID(ctx context.Context, id uint64) (red types.Redelegation, err error)

GetRedelegationByUnbondingID returns a redelegation that has a redelegation entry with a certain ID

func (Keeper) GetRedelegationQueueTimeSlice

func (k Keeper) GetRedelegationQueueTimeSlice(ctx context.Context, timestamp time.Time) (dvvTriplets []types.DVVTriplet, err error)

GetRedelegationQueueTimeSlice gets a specific redelegation queue timeslice. A timeslice is a slice of DVVTriplets corresponding to redelegations that expire at a certain time.

func (Keeper) GetRedelegations

func (k Keeper) GetRedelegations(ctx context.Context, delegator sdk.AccAddress, maxRetrieve uint16) (redelegations []types.Redelegation, err error)

GetRedelegations returns a given amount of all the delegator redelegations.

func (Keeper) GetRedelegationsFromSrcValidator

func (k Keeper) GetRedelegationsFromSrcValidator(ctx context.Context, valAddr sdk.ValAddress) (reds []types.Redelegation, err error)

GetRedelegationsFromSrcValidator returns all redelegations from a particular validator.

func (Keeper) GetRotationLockedConsAddr added in v0.55.0

func (k Keeper) GetRotationLockedConsAddr(
	ctx context.Context,
	consAddr sdk.ConsAddress,
) (kind types.ConsAddrLockType, valAddr sdk.ValAddress, found bool, err error)

GetRotationLockedConsAddr returns the lock record for a consensus address used in a key rotation.

func (Keeper) GetUBDQueueTimeSlice

func (k Keeper) GetUBDQueueTimeSlice(ctx context.Context, timestamp time.Time) (dvPairs []types.DVPair, err error)

GetUBDQueueTimeSlice gets a specific unbonding queue timeslice. A timeslice is a slice of DVPairs corresponding to unbonding delegations that expire at a certain time.

func (Keeper) GetUnbondingDelegation

func (k Keeper) GetUnbondingDelegation(ctx context.Context, delAddr sdk.AccAddress, valAddr sdk.ValAddress) (ubd types.UnbondingDelegation, err error)

GetUnbondingDelegation returns a unbonding delegation.

func (Keeper) GetUnbondingDelegationByUnbondingID added in v0.47.0

func (k Keeper) GetUnbondingDelegationByUnbondingID(ctx context.Context, id uint64) (ubd types.UnbondingDelegation, err error)

GetUnbondingDelegationByUnbondingID returns an unbonding delegation that has an unbonding delegation entry with a certain ID

func (Keeper) GetUnbondingDelegations

func (k Keeper) GetUnbondingDelegations(ctx context.Context, delegator sdk.AccAddress, maxRetrieve uint16) (unbondingDelegations []types.UnbondingDelegation, err error)

GetUnbondingDelegations returns a given amount of all the delegator unbonding-delegations.

func (Keeper) GetUnbondingDelegationsFromValidator

func (k Keeper) GetUnbondingDelegationsFromValidator(ctx context.Context, valAddr sdk.ValAddress) (ubds []types.UnbondingDelegation, err error)

GetUnbondingDelegationsFromValidator returns all unbonding delegations from a particular validator.

func (Keeper) GetUnbondingType added in v0.47.0

func (k Keeper) GetUnbondingType(ctx context.Context, id uint64) (unbondingType types.UnbondingType, err error)

GetUnbondingType returns the enum type of unbonding which is any of {UnbondingDelegation | Redelegation | ValidatorUnbonding}

func (Keeper) GetUnbondingValidators added in v0.40.0

func (k Keeper) GetUnbondingValidators(ctx context.Context, endTime time.Time, endHeight int64) ([]string, error)

GetUnbondingValidators returns a slice of mature validator addresses that complete their unbonding at a given time and height.

func (Keeper) GetValidator

func (k Keeper) GetValidator(ctx context.Context, addr sdk.ValAddress) (validator types.Validator, err error)

GetValidator gets a single validator

func (Keeper) GetValidatorByConsAddr

func (k Keeper) GetValidatorByConsAddr(ctx context.Context, consAddr sdk.ConsAddress) (validator types.Validator, err error)

GetValidatorByConsAddr gets a single validator by consensus address

func (Keeper) GetValidatorByUnbondingID added in v0.47.0

func (k Keeper) GetValidatorByUnbondingID(ctx context.Context, id uint64) (val types.Validator, err error)

GetValidatorByUnbondingID returns the validator that is unbonding with a certain unbonding op ID

func (Keeper) GetValidatorDelegations

func (k Keeper) GetValidatorDelegations(ctx context.Context, valAddr sdk.ValAddress) (delegations []types.Delegation, err error)

GetValidatorDelegations returns all delegations to a specific validator. Useful for querier.

func (Keeper) GetValidatorSet

func (k Keeper) GetValidatorSet() types.ValidatorSet

GetValidatorSet returns self as it is both a validatorset and delegationset

func (Keeper) GetValidatorUpdates added in v0.47.0

func (k Keeper) GetValidatorUpdates(ctx context.Context) ([]abci.ValidatorUpdate, error)

GetValidatorUpdates returns the ABCI validator power updates within the current block.

func (Keeper) GetValidators

func (k Keeper) GetValidators(ctx context.Context, maxRetrieve uint32) (validators []types.Validator, err error)

GetValidators returns a given amount of all the validators

func (Keeper) HasConsKeyRotationApplyQueueEntry added in v0.55.0

func (k Keeper) HasConsKeyRotationApplyQueueEntry(ctx context.Context, applyHeight int64, valAddr sdk.ValAddress) (bool, error)

HasConsKeyRotationApplyQueueEntry returns whether the apply queue holds an entry at the given apply height for the given validator.

func (Keeper) HasConsKeyRotationInUnbondingWindow added in v0.55.0

func (k Keeper) HasConsKeyRotationInUnbondingWindow(ctx context.Context, valAddr sdk.ValAddress) (bool, error)

HasConsKeyRotationInUnbondingWindow returns whether the validator has performed a consensus key rotation inside current the unbonding window.

func (Keeper) HasConsKeyRotationQueueEntry added in v0.55.0

func (k Keeper) HasConsKeyRotationQueueEntry(ctx context.Context, maturity time.Time, valAddr sdk.ValAddress) (bool, error)

HasConsKeyRotationQueueEntry returns whether the maturity queue holds an entry at the given maturity for the given validator.

func (Keeper) HasMaxRedelegationEntries

func (k Keeper) HasMaxRedelegationEntries(ctx context.Context, delegatorAddr sdk.AccAddress, validatorSrcAddr, validatorDstAddr sdk.ValAddress) (bool, error)

HasMaxRedelegationEntries checks if the redelegation entries reached maximum limit.

func (Keeper) HasMaxUnbondingDelegationEntries

func (k Keeper) HasMaxUnbondingDelegationEntries(ctx context.Context, delegatorAddr sdk.AccAddress, validatorAddr sdk.ValAddress) (bool, error)

HasMaxUnbondingDelegationEntries checks if unbonding delegation has maximum number of entries.

func (Keeper) HasReceivingRedelegation

func (k Keeper) HasReceivingRedelegation(ctx context.Context, delAddr sdk.AccAddress, valDstAddr sdk.ValAddress) (bool, error)

HasReceivingRedelegation checks if validator is receiving a redelegation.

func (Keeper) HistoricalEntries

func (k Keeper) HistoricalEntries(ctx context.Context) (uint32, error)

HistoricalEntries = number of historical info entries to persist in store

func (*Keeper) Hooks added in v0.47.0

func (k *Keeper) Hooks() types.StakingHooks

Hooks gets the hooks for staking.

func (Keeper) ImportConsKeyRotations added in v0.55.0

func (k Keeper) ImportConsKeyRotations(ctx context.Context, histories []types.ConsensusKeyRotationHistory, pending []types.PendingConsensusKeyRotation) error

ImportConsKeyRotations restores consensus key rotation indexes and queues from genesis.

func (Keeper) IncrementUnbondingID added in v0.47.0

func (k Keeper) IncrementUnbondingID(ctx context.Context) (unbondingID uint64, err error)

IncrementUnbondingID increments and returns a unique ID for an unbonding operation

func (Keeper) InitGenesis added in v0.46.0

func (k Keeper) InitGenesis(ctx context.Context, data *types.GenesisState) (res []abci.ValidatorUpdate)

InitGenesis sets the pool and parameters for the provided keeper. For each validator in data, it sets that validator in the keeper along with manually setting the indexes. In addition, it also sets any delegations found in data. Finally, it updates the bonded validators. Returns final validator set after applying all declaration and delegations

func (Keeper) InsertRedelegationQueue

func (k Keeper) InsertRedelegationQueue(ctx context.Context, red types.Redelegation, completionTime time.Time) error

InsertRedelegationQueue insert an redelegation delegation to the appropriate timeslice in the redelegation queue.

func (Keeper) InsertUBDQueue

func (k Keeper) InsertUBDQueue(ctx context.Context, ubd types.UnbondingDelegation, completionTime time.Time) error

InsertUBDQueue inserts an unbonding delegation to the appropriate timeslice in the unbonding queue.

func (Keeper) InsertUnbondingValidatorQueue added in v0.40.0

func (k Keeper) InsertUnbondingValidatorQueue(ctx context.Context, val types.Validator) error

InsertUnbondingValidatorQueue inserts a given unbonding validator address into the unbonding validator queue for a given height and time.

func (Keeper) IsConsAddrLockedByRotation added in v0.55.0

func (k Keeper) IsConsAddrLockedByRotation(ctx context.Context, consAddr sdk.ConsAddress) (bool, error)

IsConsAddrLockedByRotation returns whether the given consensus address is locked by a key rotation, either because some validator previously rotated away from it (and evidence for the old key can still be admitted) or because some validator has enqueued a pending rotation targeting it.

func (Keeper) IsValidatorJailed added in v0.47.0

func (k Keeper) IsValidatorJailed(ctx context.Context, addr sdk.ConsAddress) (bool, error)

IsValidatorJailed checks and returns boolean of a validator status jailed or not.

func (Keeper) IterateAllDelegations

func (k Keeper) IterateAllDelegations(ctx context.Context, cb func(delegation types.Delegation) (stop bool)) error

IterateAllDelegations iterates through all of the delegations.

func (Keeper) IterateBondedValidatorsByPower

func (k Keeper) IterateBondedValidatorsByPower(ctx context.Context, fn func(index int64, validator types.ValidatorI) (stop bool)) error

IterateBondedValidatorsByPower iterates through the bonded validator set and perform the provided function

func (Keeper) IterateDelegations

func (k Keeper) IterateDelegations(ctx context.Context, delAddr sdk.AccAddress,
	fn func(index int64, del types.DelegationI) (stop bool),
) error

IterateDelegations iterates through all of the delegations from a delegator

func (Keeper) IterateDelegatorDelegations added in v0.45.4

func (k Keeper) IterateDelegatorDelegations(ctx context.Context, delegator sdk.AccAddress, cb func(delegation types.Delegation) (stop bool)) error

IterateDelegatorDelegations iterates through one delegator's delegations.

func (Keeper) IterateDelegatorRedelegations added in v0.45.4

func (k Keeper) IterateDelegatorRedelegations(ctx context.Context, delegator sdk.AccAddress, cb func(red types.Redelegation) (stop bool)) error

IterateDelegatorRedelegations iterates through one delegator's redelegations.

func (Keeper) IterateDelegatorUnbondingDelegations added in v0.45.4

func (k Keeper) IterateDelegatorUnbondingDelegations(ctx context.Context, delegator sdk.AccAddress, cb func(ubd types.UnbondingDelegation) (stop bool)) error

IterateDelegatorUnbondingDelegations iterates through a delegator's unbonding delegations.

func (Keeper) IterateHistoricalInfo

func (k Keeper) IterateHistoricalInfo(ctx context.Context, cb func(types.HistoricalInfo) bool) error

IterateHistoricalInfo provides an iterator over all stored HistoricalInfo objects. For each HistoricalInfo object, cb will be called. If the cb returns true, the iterator will break and close.

func (Keeper) IterateLastValidatorPowers

func (k Keeper) IterateLastValidatorPowers(ctx context.Context, handler func(operator sdk.ValAddress, power int64) (stop bool)) error

IterateLastValidatorPowers iterates over last validator powers.

func (Keeper) IterateLastValidators

func (k Keeper) IterateLastValidators(ctx context.Context, fn func(index int64, validator types.ValidatorI) (stop bool)) error

IterateLastValidators iterates through the active validator set and perform the provided function

func (Keeper) IterateRedelegations

func (k Keeper) IterateRedelegations(ctx context.Context, fn func(index int64, red types.Redelegation) (stop bool)) error

IterateRedelegations iterates through all redelegations.

func (Keeper) IterateUnbondingDelegations

func (k Keeper) IterateUnbondingDelegations(ctx context.Context, fn func(index int64, ubd types.UnbondingDelegation) (stop bool)) error

IterateUnbondingDelegations iterates through all of the unbonding delegations.

func (Keeper) IterateValidators

func (k Keeper) IterateValidators(ctx context.Context, fn func(index int64, validator types.ValidatorI) (stop bool)) error

IterateValidators iterates through the validator set and perform the provided function

func (Keeper) Jail

func (k Keeper) Jail(ctx context.Context, consAddr sdk.ConsAddress) error

Jail jails a validator by its current consensus address.

func (Keeper) KeyRotationFee added in v0.55.0

func (k Keeper) KeyRotationFee(ctx context.Context) (sdk.Coin, error)

KeyRotationFee - Fee charged to rotate a validator's consensus key

func (Keeper) LastValidatorsIterator

func (k Keeper) LastValidatorsIterator(ctx context.Context) (corestore.Iterator, error)

LastValidatorsIterator returns an iterator for the consensus validators in the last block

func (Keeper) Logger

func (k Keeper) Logger(ctx context.Context) log.Logger

Logger returns a module-specific logger.

func (Keeper) MaxEntries

func (k Keeper) MaxEntries(ctx context.Context) (uint32, error)

MaxEntries - Maximum number of simultaneous unbonding delegations or redelegations (per pair/trio)

func (Keeper) MaxValidators

func (k Keeper) MaxValidators(ctx context.Context) (uint32, error)

MaxValidators - Maximum number of validators

func (Keeper) MinCommissionRate added in v0.46.0

func (k Keeper) MinCommissionRate(ctx context.Context) (math.LegacyDec, error)

MinCommissionRate - Minimum validator commission rate

func (Keeper) PendingConsKeyRotationUpdates added in v0.55.0

func (k Keeper) PendingConsKeyRotationUpdates(ctx context.Context, last map[string]int64) (updates []PendingConsKeyRotationUpdate, err error)

PendingConsKeyRotationUpdates returns rotation metadata for in-flight rotations whose CometBFT update has been or should be emitted by the current EndBlock. It must be called after ApplyConsKeyRotations so matured entries have already been drained.

func (Keeper) PendingConsKeyRotations added in v0.55.0

func (k Keeper) PendingConsKeyRotations(ctx context.Context) (rotations PendingRotations, err error)

PendingConsKeyRotations scans the apply queue once and returns every rotation still in flight, keyed by string(valAddr). It is intended to be called once per EndBlock after ProcessConsKeyRotations so the bonded loop can substitute the new cons key on per-validator emits via an O(1) map lookup instead of repeated store reads.

func (Keeper) PowerReduction added in v0.43.0

func (k Keeper) PowerReduction(ctx context.Context) math.Int

PowerReduction - is the amount of staking tokens required for 1 unit of consensus-engine power. Currently, this returns a global variable that the app developer can tweak. TODO: we might turn this into an on-chain param: https://github.com/cosmos/cosmos-sdk/issues/8365

func (Keeper) PrepareConsKeyRotationsForZeroHeightExport added in v0.55.0

func (k Keeper) PrepareConsKeyRotationsForZeroHeightExport(ctx context.Context) error

PrepareConsKeyRotationsForZeroHeightExport rewrites pending rotation apply queue entries so a zero-height restarted chain can emit the Comet validator update from its first block before the SDK-side key swap is applied.

func (Keeper) ProcessValidatorUpdatesForConsKeyRotations added in v0.55.0

func (k Keeper) ProcessValidatorUpdatesForConsKeyRotations(
	ctx context.Context,
	rotations []PendingConsKeyRotationUpdate,
	updates []abci.ValidatorUpdate,
) ([]abci.ValidatorUpdate, error)

ProcessValidatorUpdatesForConsKeyRotations rewrites validator updates that reference old consensus keys so the returned batch matches CometBFT's key-rotation timeline.

func (Keeper) PruneMaturedConsKeyRotations added in v0.55.0

func (k Keeper) PruneMaturedConsKeyRotations(ctx context.Context) error

PruneMaturedConsKeyRotations retires consensus key rotation state whose windows have elapsed at the current block. It removes the maturity-queue entry and the per validator re-rotation gate once a rotation leaves the unbonding window, and separately retires a rotated-away key's historical evidence lock once equivocation evidence for it can no longer be admitted (both the time and the block-height window closed).

func (Keeper) PutUnbondingOnHold added in v0.47.0

func (k Keeper) PutUnbondingOnHold(ctx context.Context, id uint64) error

PutUnbondingOnHold allows an external module to stop an unbonding operation, such as an unbonding delegation, a redelegation, or a validator unbonding. In order for the unbonding operation with `id` to eventually complete, every call to PutUnbondingOnHold(id) must be matched by a call to UnbondingCanComplete(id).

func (Keeper) RedelegationQueueIterator

func (k Keeper) RedelegationQueueIterator(ctx context.Context, endTime time.Time) (storetypes.Iterator, error)

RedelegationQueueIterator returns all the redelegation queue timeslices from time 0 until endTime.

func (Keeper) RemoveDelegation

func (k Keeper) RemoveDelegation(ctx context.Context, delegation types.Delegation) error

RemoveDelegation removes a delegation

func (Keeper) RemoveRedelegation

func (k Keeper) RemoveRedelegation(ctx context.Context, red types.Redelegation) error

RemoveRedelegation removes a redelegation object and associated index.

func (Keeper) RemoveUnbondingDelegation

func (k Keeper) RemoveUnbondingDelegation(ctx context.Context, ubd types.UnbondingDelegation) error

RemoveUnbondingDelegation removes the unbonding delegation object and associated index.

func (Keeper) RemoveValidator

func (k Keeper) RemoveValidator(ctx context.Context, address sdk.ValAddress) error

RemoveValidator removes the validator record and associated indexes except for the bonded validator index which is only handled in ApplyAndReturnTendermintUpdates

func (Keeper) RemoveValidatorTokens

func (k Keeper) RemoveValidatorTokens(ctx context.Context,
	validator types.Validator, tokensToRemove math.Int,
) (types.Validator, error)

RemoveValidatorTokens updates the tokens of an existing validator, updates the validators power index key

func (Keeper) RemoveValidatorTokensAndShares

func (k Keeper) RemoveValidatorTokensAndShares(ctx context.Context, validator types.Validator,
	sharesToRemove math.LegacyDec,
) (valOut types.Validator, removedTokens math.Int, err error)

RemoveValidatorTokensAndShares updates the tokens of an existing validator, updates the validators power index key

func (Keeper) RotationEvidenceExpiry added in v0.55.0

func (k Keeper) RotationEvidenceExpiry(ctx context.Context, valAddr sdk.ValAddress) (types.ConsKeyEvidenceExpiry, error)

RotationEvidenceExpiry returns when a rotation should expire from an evidence perspective. A rotation is expired once equivocation evidence cannot be submitted against the validator on a different key than the key they are rotating away from.

Known limitation: the horizon is fixed from the evidence params at rotation time and is never revised. A later governance change that lengthens the evidence window does not extend already-enqueued rotations, so evidence re-admitted by such a change after this lock has expired is not attributable.

func (Keeper) RotationMaturityTime added in v0.55.0

func (k Keeper) RotationMaturityTime(ctx context.Context) (time.Time, error)

RotationMaturityTime returns the time that a rotation will mature at given the current context. A rotation matures once the unbonding period has elapsed.

func (Keeper) SetConsKeyRotation added in v0.55.0

func (k Keeper) SetConsKeyRotation(ctx context.Context, valAddr sdk.ValAddress, oldPubKey, newPubKey cryptotypes.PubKey) error

SetConsKeyRotation writes the indexes that track a pending consensus key rotation and sets a default rotation maturity and evidence expiration time.

func (Keeper) SetConsKeyRotationWithExpirations added in v0.55.0

func (k Keeper) SetConsKeyRotationWithExpirations(
	ctx context.Context,
	valAddr sdk.ValAddress,
	oldPubKey cryptotypes.PubKey,
	newPubKey cryptotypes.PubKey,
	maturesAt time.Time,
	expiresAt types.ConsKeyEvidenceExpiry,
) error

SetConsKeyRotationWithExpirations writes the indexes that track a pending consensus key rotation.

func (Keeper) SetDelegation

func (k Keeper) SetDelegation(ctx context.Context, delegation types.Delegation) error

SetDelegation sets a delegation.

func (Keeper) SetHistoricalInfo

func (k Keeper) SetHistoricalInfo(ctx context.Context, height int64, hi *types.HistoricalInfo) error

SetHistoricalInfo sets the historical info at a given height

func (*Keeper) SetHooks

func (k *Keeper) SetHooks(sh types.StakingHooks)

SetHooks sets the validator hooks. In contrast to other receivers, this method must take a pointer due to nature of the hooks interface and SDK start up sequence.

func (Keeper) SetLastTotalPower

func (k Keeper) SetLastTotalPower(ctx context.Context, power math.Int) error

SetLastTotalPower sets the last total validator power.

func (Keeper) SetLastValidatorPower

func (k Keeper) SetLastValidatorPower(ctx context.Context, operator sdk.ValAddress, power int64) error

SetLastValidatorPower sets the last validator power.

func (Keeper) SetNewValidatorByPowerIndex

func (k Keeper) SetNewValidatorByPowerIndex(ctx context.Context, validator types.Validator) error

SetNewValidatorByPowerIndex adds new entry by power index

func (Keeper) SetParams

func (k Keeper) SetParams(ctx context.Context, params types.Params) error

SetParams sets the x/staking module parameters. CONTRACT: This method performs no validation of the parameters.

func (Keeper) SetRedelegation

func (k Keeper) SetRedelegation(ctx context.Context, red types.Redelegation) error

SetRedelegation sets a redelegation and associated index.

func (Keeper) SetRedelegationByUnbondingID added in v0.47.0

func (k Keeper) SetRedelegationByUnbondingID(ctx context.Context, red types.Redelegation, id uint64) error

SetRedelegationByUnbondingID sets an index to look up an Redelegation by the unbondingID of an RedelegationEntry that it contains Note, it does not set the redelegation itself, use SetRedelegation(ctx, red) for that

func (Keeper) SetRedelegationEntry

func (k Keeper) SetRedelegationEntry(ctx context.Context,
	delegatorAddr sdk.AccAddress, validatorSrcAddr,
	validatorDstAddr sdk.ValAddress, creationHeight int64,
	minTime time.Time, balance math.Int,
	sharesSrc, sharesDst math.LegacyDec,
) (types.Redelegation, error)

SetRedelegationEntry adds an entry to the redelegation at the given addresses. It creates the redelegation if it does not exist.

func (Keeper) SetRedelegationQueueTimeSlice

func (k Keeper) SetRedelegationQueueTimeSlice(ctx context.Context, timestamp time.Time, keys []types.DVVTriplet) error

SetRedelegationQueueTimeSlice sets a specific redelegation queue timeslice.

func (Keeper) SetRotationLockedConsAddr added in v0.55.0

func (k Keeper) SetRotationLockedConsAddr(
	ctx context.Context,
	consAddr sdk.ConsAddress,
	valAddr sdk.ValAddress,
	kind types.ConsAddrLockType,
) error

SetRotationLockedConsAddr sets the lock record for a consensus address used in a key rotation.

func (Keeper) SetUBDQueueTimeSlice

func (k Keeper) SetUBDQueueTimeSlice(ctx context.Context, timestamp time.Time, keys []types.DVPair) error

SetUBDQueueTimeSlice sets a specific unbonding queue timeslice.

func (Keeper) SetUnbondingDelegation

func (k Keeper) SetUnbondingDelegation(ctx context.Context, ubd types.UnbondingDelegation) error

SetUnbondingDelegation sets the unbonding delegation and associated index.

func (Keeper) SetUnbondingDelegationByUnbondingID added in v0.47.0

func (k Keeper) SetUnbondingDelegationByUnbondingID(ctx context.Context, ubd types.UnbondingDelegation, id uint64) error

SetUnbondingDelegationByUnbondingID sets an index to look up an UnbondingDelegation by the unbondingID of an UnbondingDelegationEntry that it contains Note, it does not set the unbonding delegation itself, use SetUnbondingDelegation(ctx, ubd) for that

func (Keeper) SetUnbondingDelegationEntry

func (k Keeper) SetUnbondingDelegationEntry(
	ctx context.Context, delegatorAddr sdk.AccAddress, validatorAddr sdk.ValAddress,
	creationHeight int64, minTime time.Time, balance math.Int,
) (types.UnbondingDelegation, error)

SetUnbondingDelegationEntry adds an entry to the unbonding delegation at the given addresses. It creates the unbonding delegation if it does not exist.

func (Keeper) SetUnbondingType added in v0.47.0

func (k Keeper) SetUnbondingType(ctx context.Context, id uint64, unbondingType types.UnbondingType) error

SetUnbondingType sets the enum type of unbonding which is any of {UnbondingDelegation | Redelegation | ValidatorUnbonding}

func (Keeper) SetUnbondingValidatorsQueue added in v0.40.0

func (k Keeper) SetUnbondingValidatorsQueue(ctx context.Context, endTime time.Time, endHeight int64, addrs []string) error

SetUnbondingValidatorsQueue sets a given slice of validator addresses into the unbonding validator queue by a given height and time.

func (Keeper) SetValidator

func (k Keeper) SetValidator(ctx context.Context, validator types.Validator) error

SetValidator sets the main record holding validator details

func (Keeper) SetValidatorByConsAddr

func (k Keeper) SetValidatorByConsAddr(ctx context.Context, validator types.Validator) error

SetValidatorByConsAddr sets a validator by consensus address

func (Keeper) SetValidatorByPowerIndex

func (k Keeper) SetValidatorByPowerIndex(ctx context.Context, validator types.Validator) error

SetValidatorByPowerIndex sets a validator by power index

func (Keeper) SetValidatorByUnbondingID added in v0.47.0

func (k Keeper) SetValidatorByUnbondingID(ctx context.Context, val types.Validator, id uint64) error

SetValidatorByUnbondingID sets an index to look up a Validator by the unbondingID corresponding to its current unbonding Note, it does not set the validator itself, use SetValidator(ctx, val) for that

func (Keeper) SetValidatorUpdates added in v0.47.0

func (k Keeper) SetValidatorUpdates(ctx context.Context, valUpdates []abci.ValidatorUpdate) error

SetValidatorUpdates sets the ABCI validator power updates for the current block.

func (Keeper) Slash

func (k Keeper) Slash(ctx context.Context, consAddr sdk.ConsAddress, infractionHeight, power int64, slashFactor math.LegacyDec) (math.Int, error)

Slash a validator for an infraction committed at a known height. The consensus address must be the validator's current consensus address; callers handling historical evidence must resolve it before calling Slash. Find the contributing stake at that height and burn the specified slashFactor of it, updating unbonding delegations & redelegations appropriately

CONTRACT:

slashFactor is non-negative

CONTRACT:

Infraction was committed equal to or less than an unbonding period in the past,
so all unbonding delegations and redelegations from that height are stored

CONTRACT:

Slash will not slash unbonded validators (for the above reason)

CONTRACT:

Infraction was committed at the current height or at a past height,
but not at a height in the future

func (Keeper) SlashRedelegation

func (k Keeper) SlashRedelegation(ctx context.Context, srcValidator types.Validator, redelegation types.Redelegation,
	infractionHeight int64, slashFactor math.LegacyDec,
) (totalSlashAmount math.Int, err error)

SlashRedelegation slashes a redelegation and update the pool return the amount that would have been slashed assuming the redelegation had enough stake to slash (the amount actually slashed may be less if there's insufficient stake remaining) NOTE this is only slashing for prior infractions from the source validator

func (Keeper) SlashUnbondingDelegation

func (k Keeper) SlashUnbondingDelegation(ctx context.Context, unbondingDelegation types.UnbondingDelegation,
	infractionHeight int64, slashFactor math.LegacyDec,
) (totalSlashAmount math.Int, err error)

SlashUnbondingDelegation slashes an unbonding delegation and update the pool return the amount that would have been slashed assuming the unbonding delegation had enough stake to slash (the amount actually slashed may be less if there's insufficient stake remaining)

func (Keeper) SlashWithInfractionReason added in v0.47.0

func (k Keeper) SlashWithInfractionReason(ctx context.Context, consAddr sdk.ConsAddress, infractionHeight, power int64, slashFactor math.LegacyDec, _ types.Infraction) (math.Int, error)

SlashWithInfractionReason slashes a validator using the validator's current consensus address. The infraction reason is required by Interchain Security.

func (Keeper) StakingTokenSupply

func (k Keeper) StakingTokenSupply(ctx context.Context) (math.Int, error)

StakingTokenSupply staking tokens from the total supply

func (Keeper) TokensFromConsensusPower added in v0.43.0

func (k Keeper) TokensFromConsensusPower(ctx context.Context, power int64) math.Int

TokensFromConsensusPower converts input power to tokens

func (Keeper) TokensToConsensusPower added in v0.43.0

func (k Keeper) TokensToConsensusPower(ctx context.Context, tokens math.Int) int64

TokensToConsensusPower converts input tokens to potential consensus-engine power

func (Keeper) TotalValidatorPower added in v0.54.0

func (k Keeper) TotalValidatorPower(ctx context.Context) (math.Int, error)

TotalValidatorPower total validator power based on the bonded supply for the staking implementation

func (Keeper) TrackHistoricalInfo

func (k Keeper) TrackHistoricalInfo(ctx context.Context) error

TrackHistoricalInfo saves the latest historical-info and deletes the oldest heights that are below pruning height. NOTE: HistoricalInfo headers are partial and omit fields such as: Version, LastBlockID, LastCommitHash, DataHash, ValidatorsHash, ConsensusHash, LastResultsHash, and EvidenceHash. As a result hashing the Header will not produce the correct result.

func (Keeper) UBDQueueIterator

func (k Keeper) UBDQueueIterator(ctx context.Context, endTime time.Time) (corestore.Iterator, error)

UBDQueueIterator returns all the unbonding queue timeslices from time 0 until endTime.

func (Keeper) Unbond

func (k Keeper) Unbond(
	ctx context.Context, delAddr sdk.AccAddress, valAddr sdk.ValAddress, shares math.LegacyDec,
) (amount math.Int, err error)

Unbond unbonds a particular delegation and perform associated store operations.

func (Keeper) UnbondAllMatureValidators added in v0.40.0

func (k Keeper) UnbondAllMatureValidators(ctx context.Context) error

UnbondAllMatureValidators unbonds all the mature unbonding validators that have finished their unbonding period.

func (Keeper) UnbondingCanComplete added in v0.47.0

func (k Keeper) UnbondingCanComplete(ctx context.Context, id uint64) error

UnbondingCanComplete allows a stopped unbonding operation, such as an unbonding delegation, a redelegation, or a validator unbonding to complete. In order for the unbonding operation with `id` to eventually complete, every call to PutUnbondingOnHold(id) must be matched by a call to UnbondingCanComplete(id).

func (Keeper) UnbondingTime

func (k Keeper) UnbondingTime(ctx context.Context) (time.Duration, error)

UnbondingTime - The time duration for unbonding

func (Keeper) UnbondingToUnbonded

func (k Keeper) UnbondingToUnbonded(ctx context.Context, validator types.Validator) (types.Validator, error)

UnbondingToUnbonded switches a validator from unbonding state to unbonded state

func (Keeper) Undelegate

func (k Keeper) Undelegate(
	ctx context.Context, delAddr sdk.AccAddress, valAddr sdk.ValAddress, sharesAmount math.LegacyDec,
) (time.Time, math.Int, error)

Undelegate unbonds an amount of delegator shares from a given validator. It will verify that the unbonding entries between the delegator and validator are not exceeded and unbond the staked tokens (based on shares) by creating an unbonding object and inserting it into the unbonding queue which will be processed during the staking EndBlocker.

func (Keeper) Unjail

func (k Keeper) Unjail(ctx context.Context, consAddr sdk.ConsAddress) error

Unjail unjails a validator

func (Keeper) UpdateValidatorCommission

func (k Keeper) UpdateValidatorCommission(ctx context.Context,
	validator types.Validator, newRate math.LegacyDec,
) (types.Commission, error)

UpdateValidatorCommission attempts to update a validator's commission rate. An error is returned if the new commission rate is invalid.

func (Keeper) ValidateUnbondAmount

func (k Keeper) ValidateUnbondAmount(
	ctx context.Context, delAddr sdk.AccAddress, valAddr sdk.ValAddress, amt math.Int,
) (shares math.LegacyDec, err error)

ValidateUnbondAmount validates that a given unbond or redelegation amount is valid based on upon the converted shares. If the amount is valid, the total amount of respective shares is returned, otherwise an error is returned.

func (Keeper) Validator

func (k Keeper) Validator(ctx context.Context, address sdk.ValAddress) (types.ValidatorI, error)

Validator gets the Validator interface for a particular address

func (Keeper) ValidatorAddressCodec added in v0.50.1

func (k Keeper) ValidatorAddressCodec() addresscodec.Codec

ValidatorAddressCodec returns the app validator address codec.

func (Keeper) ValidatorByConsAddr

func (k Keeper) ValidatorByConsAddr(ctx context.Context, addr sdk.ConsAddress) (types.ValidatorI, error)

ValidatorByConsAddr gets the validator interface for a particular pubkey

func (Keeper) ValidatorByHistoricalConsAddr added in v0.55.0

func (k Keeper) ValidatorByHistoricalConsAddr(ctx context.Context, historicalConsAddr sdk.ConsAddress) (types.Validator, error)

ValidatorByHistoricalConsAddr resolves a consensus address that a validator rotated away from and that is still retained for historical infractions. It intentionally does not fall back to the live consensus address index.

func (Keeper) ValidatorQueueIterator

func (k Keeper) ValidatorQueueIterator(ctx context.Context, endTime time.Time, endHeight int64) (corestore.Iterator, error)

ValidatorQueueIterator returns an iterator ranging over validators that are unbonding whose unbonding completion occurs at the given height and time.

func (Keeper) ValidatorsPowerStoreIterator

func (k Keeper) ValidatorsPowerStoreIterator(ctx context.Context) (corestore.Iterator, error)

ValidatorsPowerStoreIterator returns an iterator for the current validator power store

type Migrator added in v0.43.0

type Migrator struct {
	// contains filtered or unexported fields
}

Migrator is a struct for handling in-place store migrations.

func NewMigrator added in v0.43.0

func NewMigrator(keeper *Keeper) Migrator

NewMigrator returns a new Migrator instance.

func (Migrator) Migrate5to6 added in v0.55.0

func (m Migrator) Migrate5to6(ctx sdk.Context) error

Migrate5to6 migrates the x/staking module state from consensus version 5 to version 6. Specifically, it adds the KeyRotationFee param.

type PendingConsKeyRotationUpdate added in v0.55.0

type PendingConsKeyRotationUpdate struct {
	// OldPubKey is the consensus key currently stored in SDK validator state.
	OldPubKey cryptotypes.PubKey

	// NewPubKey is the pending consensus key CometBFT should track for the
	// validator once the rotation update is emitted.
	NewPubKey cryptotypes.PubKey

	// EmitHeight is the EndBlock height that should emit the old@0,new@power
	// rotation pair.
	EmitHeight int64

	// LastPower is the validator power from the last Comet-visible validator
	// set, keyed by operator address.
	LastPower int64
}

PendingConsKeyRotationUpdate stores the rotation metadata needed to align staking-side validator updates with CometBFT's delayed key-rotation view.

type PendingRotation added in v0.55.0

type PendingRotation struct {
	NewPubKey   cryptotypes.PubKey
	ApplyHeight int64
}

type PendingRotations added in v0.55.0

type PendingRotations map[string]PendingRotation

func (PendingRotations) EffectiveKeyForABCIUpdate added in v0.55.0

func (pr PendingRotations) EffectiveKeyForABCIUpdate(valAddr sdk.ValAddress, validator types.Validator) (cryptotypes.PubKey, error)

EffectiveKeyForABCIUpdate returns the consensus pub key that should be used for a validator when emitting an ABCI update, given the current set of pending rotations.

func (PendingRotations) EffectiveKeyForGenesis added in v0.55.0

func (pr PendingRotations) EffectiveKeyForGenesis(valAddr sdk.ValAddress, validator types.ValidatorI, exportedInitialHeight int64) (cryptotypes.PubKey, error)

EffectiveKeyForGenesis returns the consensus pub key that should be written into genesis validator output for an exported initial height. Use this for genesis export and InitGenesis validator updates, where a pending rotation is only effective if its apply height is at or before the imported chain's initial height. Use EffectiveKeyForABCIUpdate instead during end blocker validator update emission, where a currently pending rotation should be announced with its new key even before the SDK side state swap is applied.

type Querier added in v0.40.0

type Querier struct {
	*Keeper
}

Querier is used as Keeper will have duplicate methods if used directly, and gRPC names take precedence over keeper

func NewQuerier

func NewQuerier(keeper *Keeper) Querier

func (Querier) Delegation added in v0.40.0

Delegation queries delegate info for given validator delegator pair

func (Querier) DelegatorDelegations added in v0.40.0

DelegatorDelegations queries all delegations of a given delegator address

func (Querier) DelegatorUnbondingDelegations added in v0.40.0

DelegatorUnbondingDelegations queries all unbonding delegations of a given delegator address

func (Querier) DelegatorValidator added in v0.40.0

DelegatorValidator queries validator info for given delegator validator pair

func (Querier) DelegatorValidators added in v0.40.0

DelegatorValidators queries all validators info for given delegator address

func (Querier) HistoricalInfo added in v0.40.0

HistoricalInfo queries the historical info for given height

func (Querier) Params added in v0.40.0

Params queries the staking parameters

func (Querier) Pool added in v0.40.0

Pool queries the pool info

func (Querier) Redelegations added in v0.40.0

Redelegations queries redelegations of given address

func (Querier) UnbondingDelegation added in v0.40.0

UnbondingDelegation queries unbonding info for given validator delegator pair

func (Querier) Validator added in v0.40.0

Validator queries validator info for given validator address

func (Querier) ValidatorDelegations added in v0.40.0

ValidatorDelegations queries delegate info for given validator

func (Querier) ValidatorUnbondingDelegations added in v0.40.0

ValidatorUnbondingDelegations queries unbonding delegations of a validator

func (Querier) Validators added in v0.40.0

Validators queries all validators that match the given status

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
⌂ 换网址