package cometbft.types.v1beta1

Get desktop application:
View/edit binary Protocol Buffers messages

Block defines the structure of a block in the CometBFT blockchain.

Used in: blocksync.v1beta1.BlockResponse

• optional Header header = 1

• optional Data data = 2

• optional EvidenceList evidence = 3

• optional Commit last_commit = 4

BlockID defines the unique ID of a block as its hash and its `PartSetHeader`.

Used in: consensus.v1beta1.VoteSetBits, consensus.v1beta1.VoteSetMaj23, state.v1beta1.State, state.v1beta2.State, state.v1beta3.State, BlockMeta, Commit, Header, Proposal, Vote

• bytes hash = 1

• optional PartSetHeader part_set_header = 2

BlockIdFlag indicates which BlockID the signature is for

Used in: abci.v1beta3.ExtendedVoteInfo, abci.v1beta3.VoteInfo, CommitSig

• BLOCK_ID_FLAG_UNKNOWN = 0

  Indicates an error condition

• BLOCK_ID_FLAG_ABSENT = 1

  The vote was not received

• BLOCK_ID_FLAG_COMMIT = 2

  Voted for the block that received the majority

• BLOCK_ID_FLAG_NIL = 3

  Voted for nil

BlockMeta contains meta information about a block.

• optional BlockID block_id = 1

• int64 block_size = 2

• optional Header header = 3

• int64 num_txs = 4

BlockParams contains limits on the block size.

Used in: ConsensusParams

• int64 max_bytes = 1

  Max block size, in bytes. Note: must be greater than 0

• int64 max_gas = 2

  Max gas per block. Note: must be greater or equal to -1

• int64 time_iota_ms = 3

  Minimum time increment between consecutive blocks (in milliseconds) If the block header timestamp is ahead of the system clock, decrease this value. Not exposed to the application.

CanonicalBlockID is a canonical representation of a BlockID, which gets serialized and signed.

Used in: CanonicalProposal, CanonicalVote

• bytes hash = 1

• optional CanonicalPartSetHeader part_set_header = 2

CanonicalPartSetHeader is a canonical representation of a PartSetHeader, which gets serialized and signed.

Used in: CanonicalBlockID

• uint32 total = 1

• bytes hash = 2

CanonicalProposal is a canonical representation of a Proposal, which gets serialized and signed.

• SignedMsgType type = 1

  type alias for byte

• sfixed64 height = 2

  canonicalization requires fixed size encoding here

• sfixed64 round = 3

  canonicalization requires fixed size encoding here

• int64 pol_round = 4

• optional CanonicalBlockID block_id = 5

• optional google.protobuf.Timestamp timestamp = 6

• string chain_id = 7

CanonicalVote is a canonical representation of a Vote, which gets serialized and signed.

• SignedMsgType type = 1

  type alias for byte

• sfixed64 height = 2

  canonicalization requires fixed size encoding here

• sfixed64 round = 3

  canonicalization requires fixed size encoding here

• optional CanonicalBlockID block_id = 4

• optional google.protobuf.Timestamp timestamp = 5

• string chain_id = 6

Commit contains the evidence that a block was committed by a set of validators.

Used in: Block, SignedHeader

• int64 height = 1

• int32 round = 2

• optional BlockID block_id = 3

• repeated CommitSig signatures = 4

CommitSig is a part of the Vote included in a Commit.

Used in: Commit

• BlockIDFlag block_id_flag = 1

• bytes validator_address = 2

• optional google.protobuf.Timestamp timestamp = 3

• bytes signature = 4

ConsensusParams contains consensus critical parameters that determine the validity of blocks.

Used in: state.v1beta1.ConsensusParamsInfo, state.v1beta1.State

• optional BlockParams block = 1

• optional EvidenceParams evidence = 2

• optional ValidatorParams validator = 3

• optional VersionParams version = 4

Data contains the set of transactions included in the block

Used in: Block

• repeated bytes txs = 1

  Txs that will be applied by state @ block.Height+1. NOTE: not all txs here are valid. We're just agreeing on the order first. This means that block.AppHash does not include these txs.

DuplicateVoteEvidence contains evidence of a validator signed two conflicting votes.

Used in: Evidence

• optional Vote vote_a = 1

• optional Vote vote_b = 2

• int64 total_voting_power = 3

• int64 validator_power = 4

• optional google.protobuf.Timestamp timestamp = 5

EventDataRoundState is emitted with each new round step.

Used in: consensus.v1beta1.WALMessage

• int64 height = 1

• int32 round = 2

• string step = 3

Evidence is a generic type for wrapping evidence of misbehavior by a validator.

Used in: EvidenceList

• oneof sum

  The type of evidence.

  • DuplicateVoteEvidence duplicate_vote_evidence = 1

  • LightClientAttackEvidence light_client_attack_evidence = 2

EvidenceList is a list of evidence.

Used in: Block

• repeated Evidence evidence = 1

EvidenceParams determine how we handle evidence of malfeasance.

Used in: abci.v1beta1.ConsensusParams, ConsensusParams, v1beta2.ConsensusParams

• int64 max_age_num_blocks = 1

  Max age of evidence, in blocks. The basic formula for calculating this is: MaxAgeDuration / {average block time}.

• optional google.protobuf.Duration max_age_duration = 2

  Max age of evidence, in time. It should correspond with an app's "unbonding period" or other similar mechanism for handling [Nothing-At-Stake attacks](https://github.com/ethereum/wiki/wiki/Proof-of-Stake-FAQ#what-is-the-nothing-at-stake-problem-and-how-can-it-be-fixed).

• int64 max_bytes = 3

  This sets the maximum size of total evidence in bytes that can be committed in a single block. and should fall comfortably under the max block bytes. Default is 1048576 or 1MB

HashedParams is a subset of ConsensusParams. It is hashed into the Header.ConsensusHash.

• int64 block_max_bytes = 1

• int64 block_max_gas = 2

Header defines the structure of a block header.

Used in: abci.v1beta1.RequestBeginBlock, abci.v1beta2.RequestBeginBlock, Block, BlockMeta, SignedHeader

• optional version.v1.Consensus version = 1

  basic block info

• string chain_id = 2

• int64 height = 3

• optional google.protobuf.Timestamp time = 4

• optional BlockID last_block_id = 5

  prev block info

• bytes last_commit_hash = 6

  hashes of block data

  commit from validators from the last block

• bytes data_hash = 7

  transactions

• bytes validators_hash = 8

  hashes from the app output from the prev block

  validators for the current block

• bytes next_validators_hash = 9

  validators for the next block

• bytes consensus_hash = 10

  consensus params for current block

• bytes app_hash = 11

  state after txs from the previous block

• bytes last_results_hash = 12

  root hash of all results from the txs from the previous block

• bytes evidence_hash = 13

  consensus info

  evidence included in the block

• bytes proposer_address = 14

  original proposer of the block

LightBlock is a combination of SignedHeader and ValidatorSet. It is used by light clients.

Used in: LightClientAttackEvidence

• optional SignedHeader signed_header = 1

• optional ValidatorSet validator_set = 2

LightClientAttackEvidence contains evidence of a set of validators attempting to mislead a light client.

Used in: Evidence

• optional LightBlock conflicting_block = 1

• int64 common_height = 2

• repeated Validator byzantine_validators = 3

• int64 total_voting_power = 4

• optional google.protobuf.Timestamp timestamp = 5

Part of the block.

Used in: consensus.v1beta1.BlockPart

• uint32 index = 1

• bytes bytes = 2

• optional crypto.v1.Proof proof = 3

Header of the parts set for a block.

Used in: consensus.v1beta1.NewValidBlock, BlockID

• uint32 total = 1

• bytes hash = 2

Block proposal.

Used in: consensus.v1beta1.Proposal, privval.v1beta1.SignProposalRequest, privval.v1beta1.SignedProposalResponse

• SignedMsgType type = 1

• int64 height = 2

• int32 round = 3

• int32 pol_round = 4

• optional BlockID block_id = 5

• optional google.protobuf.Timestamp timestamp = 6

• bytes signature = 7

SignedHeader contains a Header(H) and Commit(H+1) with signatures of validators who signed it.

Used in: LightBlock

• optional Header header = 1

• optional Commit commit = 2

SignedMsgType is a type of signed message in the consensus.

Used in: consensus.v1beta1.HasVote, consensus.v1beta1.VoteSetBits, consensus.v1beta1.VoteSetMaj23, CanonicalProposal, CanonicalVote, Proposal, Vote

• SIGNED_MSG_TYPE_UNKNOWN = 0

  Unknown

• SIGNED_MSG_TYPE_PREVOTE = 1

  Prevote

• SIGNED_MSG_TYPE_PRECOMMIT = 2

  Precommit

• SIGNED_MSG_TYPE_PROPOSAL = 32

  Proposal

SimpleValidator is a Validator, which is serialized and hashed in consensus. Address is removed because it's redundant with the pubkey. Proposer priority is removed because it changes every round.

• optional crypto.v1.PublicKey pub_key = 1

• int64 voting_power = 2

TxProof represents a Merkle proof of the presence of a transaction in the Merkle tree.

• bytes root_hash = 1

• bytes data = 2

• optional crypto.v1.Proof proof = 3

Validator represents a node participating in the consensus protocol.

Used in: LightClientAttackEvidence, ValidatorSet

• bytes address = 1

• optional crypto.v1.PublicKey pub_key = 2

• int64 voting_power = 3

• int64 proposer_priority = 4

ValidatorParams restrict the public key types validators can use. NOTE: uses ABCI pubkey naming, not Amino names.

Used in: abci.v1beta1.ConsensusParams, ConsensusParams, v1beta2.ConsensusParams

• repeated string pub_key_types = 1

ValidatorSet defines a set of validators.

Used in: state.v1beta1.State, state.v1beta1.ValidatorsInfo, state.v1beta2.State, state.v1beta3.State, LightBlock

• repeated Validator validators = 1

• optional Validator proposer = 2

• int64 total_voting_power = 3

VersionParams contains the ABCI application version.

Used in: abci.v1beta1.ConsensusParams, ConsensusParams, v1beta2.ConsensusParams

• uint64 app = 1

  Was named app_version in Tendermint 0.34

Vote represents a prevote or precommit vote from validators for consensus.

Used in: consensus.v1beta1.Vote, privval.v1beta1.SignVoteRequest, privval.v1beta1.SignedVoteResponse, DuplicateVoteEvidence

• SignedMsgType type = 1

• int64 height = 2

• int32 round = 3

• optional BlockID block_id = 4

  zero if vote is nil.

• optional google.protobuf.Timestamp timestamp = 5

• bytes validator_address = 6

• int32 validator_index = 7

• bytes signature = 8