package tendermint.types

Get desktop application:
View/edit binary Protocol Buffers messages

Used in: Evidence

• optional PotentialAmnesiaEvidence potential_amnesia_evidence = 1

• optional ProofOfLockChange polc = 2

BlockID

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

• bytes hash = 1

• optional PartSetHeader part_set_header = 2

BlockIdFlag indicates which BlcokID the signature is for

Used in: CommitSig

• BLOCK_ID_FLAG_UNKNOWN = 0

• BLOCK_ID_FLAG_ABSENT = 1

• BLOCK_ID_FLAG_COMMIT = 2

• BLOCK_ID_FLAG_NIL = 3

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

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

• bytes hash = 5

• optional libs.bits.BitArray bit_array = 6

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

Used in: Evidence

• optional SignedHeader h1 = 1

• optional SignedHeader h2 = 2

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

• 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

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

• bytes hash = 2

  Volatile

DuplicateVoteEvidence contains evidence a validator signed two conflicting votes.

Used in: Evidence

• optional Vote vote_a = 1

• optional Vote vote_b = 2

• optional google.protobuf.Timestamp timestamp = 3

Used in: EvidenceData

• oneof sum

  • DuplicateVoteEvidence duplicate_vote_evidence = 1

  • ConflictingHeadersEvidence conflicting_headers_evidence = 2

  • LunaticValidatorEvidence lunatic_validator_evidence = 3

  • PotentialAmnesiaEvidence potential_amnesia_evidence = 4

  • AmnesiaEvidence amnesia_evidence = 5

EvidenceData contains any evidence of malicious wrong-doing by validators

• repeated Evidence evidence = 1

• bytes hash = 2

EvidenceParams determine how we handle evidence of malfeasance.

Used in: abci.ConsensusParams, 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).

• uint32 max_num = 3

  This sets the maximum number of evidence that can be committed in a single block. and should fall comfortably under the max block bytes when we consider the size of each evidence (See MaxEvidenceBytes). The maximum number is MaxEvidencePerBlock. Default is 50

• int64 proof_trial_period = 4

  Proof trial period dictates the time given for nodes accused of amnesia evidence, incorrectly voting twice in two different rounds to respond with their respective proofs. Default is half the max age in blocks: 50,000

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 Tendermint block header.

Used in: abci.RequestBeginBlock, BlockMeta, LunaticValidatorEvidence, 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

Used in: Evidence

• optional Header header = 1

• optional Vote vote = 2

• string invalid_header_field = 3

• optional google.protobuf.Timestamp timestamp = 4

• uint32 index = 1

• bytes bytes = 2

• optional crypto.Proof proof = 3

PartsetHeader

Used in: BlockID

• uint32 total = 1

• bytes hash = 2

Used in: AmnesiaEvidence, Evidence

• optional Vote vote_a = 1

• optional Vote vote_b = 2

• int64 height_stamp = 3

• optional google.protobuf.Timestamp timestamp = 4

Used in: AmnesiaEvidence

• repeated Vote votes = 1

• optional crypto.PublicKey pub_key = 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: ConflictingHeadersEvidence

• 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

• SIGNED_MSG_TYPE_PREVOTE = 1

  Votes

• SIGNED_MSG_TYPE_PRECOMMIT = 2

• SIGNED_MSG_TYPE_PROPOSAL = 32

  Proposals

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

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

Used in: abci.ConsensusParams, ConsensusParams

• repeated string pub_key_types = 1

VersionParams contains the ABCI application version.

Used in: abci.ConsensusParams, ConsensusParams

• uint64 app_version = 1

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

Used in: DuplicateVoteEvidence, LunaticValidatorEvidence, PotentialAmnesiaEvidence, ProofOfLockChange

• 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