mirror of
https://github.com/tendermint/tendermint.git
synced 2026-01-05 04:55:18 +00:00
c4f7256766
Before we were storing trustedHeader (height=1) and trustedNextVals (height=2). After this change, we will be storing trustedHeader (height=1) and trustedVals (height=1). This a) simplifies the code b) fixes #4399 inconsistent pairing issue c) gives a relayer access to the current validator set #4470. The only downside is more jumps during bisection. If validator set changes between trustedHeader and the next header (by 2/3 or more), the light client will be forced to download the next header and check that 2/3+ signed the transition. But we don't expect validator set change too much and too often, so it's an acceptable compromise. Closes #4470 and #4399
49 lines
1.6 KiB
Go
49 lines
1.6 KiB
Go
package store
|
|
|
|
import "github.com/tendermint/tendermint/types"
|
|
|
|
// Store is anything that can persistenly store headers.
|
|
type Store interface {
|
|
// SaveSignedHeaderAndValidatorSet saves a SignedHeader (h: sh.Height) and a
|
|
// ValidatorSet (h: sh.Height).
|
|
//
|
|
// height must be > 0.
|
|
SaveSignedHeaderAndValidatorSet(sh *types.SignedHeader, valSet *types.ValidatorSet) error
|
|
|
|
// DeleteSignedHeaderAndValidatorSet deletes SignedHeader (h: height) and
|
|
// ValidatorSet (h: height).
|
|
//
|
|
// height must be > 0.
|
|
DeleteSignedHeaderAndValidatorSet(height int64) error
|
|
|
|
// SignedHeader returns the SignedHeader that corresponds to the given
|
|
// height.
|
|
//
|
|
// height must be > 0.
|
|
//
|
|
// If SignedHeader is not found, ErrSignedHeaderNotFound is returned.
|
|
SignedHeader(height int64) (*types.SignedHeader, error)
|
|
|
|
// ValidatorSet returns the ValidatorSet that corresponds to height.
|
|
//
|
|
// height must be > 0.
|
|
//
|
|
// If ValidatorSet is not found, ErrValidatorSetNotFound is returned.
|
|
ValidatorSet(height int64) (*types.ValidatorSet, error)
|
|
|
|
// LastSignedHeaderHeight returns the last (newest) SignedHeader height.
|
|
//
|
|
// If the store is empty, -1 and nil error are returned.
|
|
LastSignedHeaderHeight() (int64, error)
|
|
|
|
// FirstSignedHeaderHeight returns the first (oldest) SignedHeader height.
|
|
//
|
|
// If the store is empty, -1 and nil error are returned.
|
|
FirstSignedHeaderHeight() (int64, error)
|
|
|
|
// SignedHeaderAfter returns the SignedHeader after the certain height.
|
|
//
|
|
// height must be > 0 && <= LastSignedHeaderHeight.
|
|
SignedHeaderAfter(height int64) (*types.SignedHeader, error)
|
|
}
|