package tendermint.types

Get desktop application:
View/edit binary Protocol Buffers messages

ABCIParams configure functionality specific to the Application Blockchain Interface.

Used in: ConsensusParams

• int64 vote_extensions_enable_height = 1

  vote_extensions_enable_height configures the first height during which vote extensions will be enabled. During this specified height, and for all subsequent heights, precommit messages that do not contain valid extension data will be considered invalid. Prior to this height, vote extensions will not be used or accepted by validators on the network. Once enabled, vote extensions will be created by the application in ExtendVote, passed to the application for validation in VerifyVoteExtension and given to the application to use when proposing a block during PrepareProposal.

BlockID

Used in: BlockMeta, Commit, ExtendedCommit, Header, Proposal, Vote

• bytes hash = 1

• optional PartSetHeader part_set_header = 2

BlockIdFlag indicates which BlockID the signature is for

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

• 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

• 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

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

Used in: 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: abci.RequestInitChain, abci.ResponseFinalizeBlock, abci.ResponseInitChain

• optional BlockParams block = 1

• optional EvidenceParams evidence = 2

• optional ValidatorParams validator = 3

• optional VersionParams version = 4

• optional ABCIParams abci = 5

Data contains the set of transactions included in the 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.

EvidenceParams determine how we handle evidence of malfeasance.

Used in: 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

• int64 height = 1

• int32 round = 2

• optional BlockID block_id = 3

• repeated ExtendedCommitSig extended_signatures = 4

ExtendedCommitSig retains all the same fields as CommitSig but adds vote extension-related fields. We use two signatures to ensure backwards compatibility. That is the digest of the original signature is still the same in prior versions

Used in: ExtendedCommit

• BlockIDFlag block_id_flag = 1

• bytes validator_address = 2

• optional google.protobuf.Timestamp timestamp = 3

• bytes signature = 4

• bytes extension = 5

  Vote extension data

• bytes extension_signature = 6

  Vote extension signature

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: BlockMeta, SignedHeader

• optional version.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

• optional SignedHeader signed_header = 1

• optional ValidatorSet validator_set = 2

• uint32 index = 1

• bytes bytes = 2

• optional crypto.Proof proof = 3

PartsetHeader

Used in: BlockID

• uint32 total = 1

• bytes hash = 2

• 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

Used in: LightBlock

• optional Header header = 1

• optional Commit commit = 2

SignedMsgType is a type of signed message in the consensus.

Used in: 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

• optional crypto.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.Proof proof = 3

Used in: ValidatorSet

• bytes address = 1

• optional crypto.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: ConsensusParams

• repeated string pub_key_types = 1

Used in: LightBlock

• repeated Validator validators = 1

• optional Validator proposer = 2

• int64 total_voting_power = 3

VersionParams contains the ABCI application version.

Used in: ConsensusParams

• uint64 app = 1

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

• 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

  Vote signature by the validator if they participated in consensus for the associated block.

• bytes extension = 9

  Vote extension provided by the application. Only valid for precommit messages.

• bytes extension_signature = 10

  Vote extension signature by the validator if they participated in consensus for the associated block. Only valid for precommit messages.