You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

38 lines
1.1 KiB

lite2: light client with weak subjectivity (#3989) Refs #1771 ADR: https://github.com/tendermint/tendermint/blob/master/docs/architecture/adr-044-lite-client-with-weak-subjectivity.md ## Commits: * add Verifier and VerifyCommitTrusting * add two more checks make trustLevel an option * float32 for trustLevel * check newHeader time * started writing lite Client * unify Verify methods * ensure h2.Header.bfttime < h1.Header.bfttime + tp * move trust checks into Verify function * add more comments * more docs * started writing tests * unbonding period failures * tests are green * export ErrNewHeaderTooFarIntoFuture * make golangci happy * test for non-adjusted headers * more precision * providers and stores * VerifyHeader and VerifyHeaderAtHeight funcs * fix compile errors * remove lastVerifiedHeight, persist new trusted header * sequential verification * remove TrustedStore option * started writing tests for light client * cover basic cases for linear verification * bisection tests PASS * rename BisectingVerification to SkippingVerification * refactor the code * add TrustedHeader method * consolidate sequential verification tests * consolidate skipping verification tests * rename trustedVals to trustedNextVals * start writing docs * ValidateTrustLevel func and ErrOldHeaderExpired error * AutoClient and example tests * fix errors * update doc * remove ErrNewHeaderTooFarIntoFuture This check is unnecessary given existing a) ErrOldHeaderExpired b) h2.Time > now checks. * return an error if we're at more recent height * add comments * add LastSignedHeaderHeight method to Store I think it's fine if Store tracks last height * copy over proxy from old lite package * make TrustedHeader return latest if height=0 * modify LastSignedHeaderHeight to return an error if no headers exist * copy over proxy impl * refactor proxy and start http lite client * Tx and BlockchainInfo methods * Block method * commit method * code compiles again * lite client compiles * extract updateLiteClientIfNeededTo func * move final parts * add placeholder for tests * force usage of lite http client in proxy * comment out query tests for now * explicitly mention tp: trusting period * verify nextVals in VerifyHeader * refactor bisection * move the NextValidatorsHash check into updateTrustedHeaderAndVals + update the comment * add ConsensusParams method to RPC client * add ConsensusParams to rpc/mock/client * change trustLevel type to a new cmn.Fraction type + update SkippingVerification comment * stress out trustLevel is only used for non-adjusted headers * fixes after Fede's review Co-authored-by: Federico Kunze <31522760+fedekunze@users.noreply.github.com> * compare newHeader with a header from an alternative provider * save pivot header Refs https://github.com/tendermint/tendermint/pull/3989#discussion_r349122824 * check header can still be trusted in TrustedHeader Refs https://github.com/tendermint/tendermint/pull/3989#discussion_r349101424 * lite: update Validators and Block endpoints - Block no longer contains BlockMeta - Validators now accept two additional params: page and perPage * make linter happy
5 years ago
  1. package store
  2. import "github.com/tendermint/tendermint/types"
  3. // Store is anything that can persistenly store headers.
  4. type Store interface {
  5. // SaveSignedHeader saves a SignedHeader.
  6. //
  7. // height must be > 0.
  8. SaveSignedHeader(sh *types.SignedHeader) error
  9. // SaveValidatorSet saves a ValidatorSet.
  10. //
  11. // height must be > 0.
  12. SaveValidatorSet(valSet *types.ValidatorSet, height int64) error
  13. // SignedHeader returns the SignedHeader that corresponds to the given
  14. // height.
  15. //
  16. // height must be > 0.
  17. //
  18. // If the store is empty and the latest SignedHeader is requested, an error
  19. // is returned.
  20. SignedHeader(height int64) (*types.SignedHeader, error)
  21. // ValidatorSet returns the ValidatorSet that corresponds to height.
  22. //
  23. // height must be > 0.
  24. //
  25. // If the store is empty and the latest ValidatorSet is requested, an error
  26. // is returned.
  27. ValidatorSet(height int64) (*types.ValidatorSet, error)
  28. // LastSignedHeaderHeight returns the last SignedHeader height.
  29. //
  30. // If the store is empty, an error is returned.
  31. LastSignedHeaderHeight() (int64, error)
  32. }