comet

Documentation

Overview

Package comet defines the Comet Service interface and BlockInfo types which applications should use in order to get access to the current block's evidence, validators hash, proposer address.

This information is specific to Comet

Index

• type BlockIDFlag
• type BlockInfo
• type BlockInfoService
• type CommitInfo
• type Evidence
• type EvidenceList
• type MisbehaviorType
• type Validator
• type VoteInfo
• type VoteInfos

Types

type BlockIDFlag

type BlockIDFlag int32

BlockIDFlag indicates which BlockID the signature is for

const (
	BlockIDFlagUnknown BlockIDFlag = 0
	// BlockIDFlagAbsent - no vote was received from a validator.
	BlockIDFlagAbsent BlockIDFlag = 1
	// BlockIDFlagCommit - voted for the Commit.BlockID.
	BlockIDFlagCommit BlockIDFlag = 2
	// BlockIDFlagNil - voted for nil.
	BlockIDFlagNil BlockIDFlag = 3
)

type BlockInfo

type BlockInfo interface {
	GetEvidence() EvidenceList // Evidence misbehavior of the block
	// ValidatorsHash returns the hash of the validators
	// For Comet, it is the hash of the next validator set
	GetValidatorsHash() []byte
	GetProposerAddress() []byte // ProposerAddress returns the address of the block proposer
	GetLastCommit() CommitInfo  // DecidedLastCommit returns the last commit info
}

BlockInfo is the information comet provides apps in ABCI

type BlockInfoService

type BlockInfoService interface {
	GetCometBlockInfo(context.Context) BlockInfo
}

BlockInfoService is an interface that can be used to get information specific to Comet

type CommitInfo

type CommitInfo interface {
	Round() int32
	Votes() VoteInfos
}

CommitInfo is the commit information of ABCI

type Evidence

type Evidence interface {
	Type() MisbehaviorType
	Validator() Validator
	Height() int64
	Time() time.Time
	TotalVotingPower() int64
}

Evidence is the misbehavior information of ABCI

type EvidenceList

type EvidenceList interface {
	Len() int
	Get(int) Evidence
}

type MisbehaviorType

type MisbehaviorType int32

MisbehaviorType is the type of misbehavior for a validator

const (
	Unknown           MisbehaviorType = 0
	DuplicateVote     MisbehaviorType = 1
	LightClientAttack MisbehaviorType = 2
)

type Validator

type Validator interface {
	Address() []byte
	Power() int64
}

Validator is the validator information of ABCI

type VoteInfo

type VoteInfo interface {
	Validator() Validator
	GetBlockIDFlag() BlockIDFlag
}

VoteInfo is the vote information of ABCI

type VoteInfos

type VoteInfos interface {
	Len() int
	Get(int) VoteInfo
}

VoteInfos is an interface to get specific votes in an efficient way