package tendermint.abci

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc Echo (RequestEcho, ResponseEcho)

  types.proto:17

• rpc Flush (RequestFlush, ResponseFlush)

  types.proto:18

• rpc Info (RequestInfo, ResponseInfo)

  types.proto:19

• rpc CheckTx (RequestCheckTx, ResponseCheckTx)

  types.proto:20

• rpc Query (RequestQuery, ResponseQuery)

  types.proto:21

• rpc Commit (RequestCommit, ResponseCommit)

  types.proto:22

• rpc InitChain (RequestInitChain, ResponseInitChain)

  types.proto:23

• rpc ListSnapshots (RequestListSnapshots, ResponseListSnapshots)

  types.proto:24

• rpc OfferSnapshot (RequestOfferSnapshot, ResponseOfferSnapshot)

  types.proto:25

• rpc LoadSnapshotChunk (RequestLoadSnapshotChunk, ResponseLoadSnapshotChunk)

  types.proto:26

• rpc ApplySnapshotChunk (RequestApplySnapshotChunk, ResponseApplySnapshotChunk)

  types.proto:28

• rpc PrepareProposal (RequestPrepareProposal, ResponsePrepareProposal)

  types.proto:30

• rpc ProcessProposal (RequestProcessProposal, ResponseProcessProposal)

  types.proto:31

• rpc ExtendVote (RequestExtendVote, ResponseExtendVote)

  types.proto:32

• rpc VerifyVoteExtension (RequestVerifyVoteExtension, ResponseVerifyVoteExtension)

  types.proto:33

• rpc FinalizeBlock (RequestFinalizeBlock, ResponseFinalizeBlock)

  types.proto:34

Used in: RequestCheckTx

• NEW = 0

• RECHECK = 1

Used in: RequestExtendVote, RequestFinalizeBlock, RequestProcessProposal

• int32 round = 1

• repeated VoteInfo votes = 2

Event allows application developers to attach additional information to ResponseFinalizeBlock and ResponseCheckTx. Later, transactions may be queried using these events.

Used in: ExecTxResult, ResponseCheckTx, ResponseFinalizeBlock

• string type = 1

• repeated EventAttribute attributes = 2

EventAttribute is a single key-value pair, associated with an event.

Used in: Event

• string key = 1

• string value = 2

• bool index = 3

  nondeterministic

ExecTxResult contains results of executing one individual transaction. * Its structure is equivalent to #ResponseDeliverTx which will be deprecated/deleted

Used in: ResponseFinalizeBlock, TxResult

• uint32 code = 1

• bytes data = 2

• string log = 3

  nondeterministic

• string info = 4

  nondeterministic

• int64 gas_wanted = 5

• int64 gas_used = 6

• repeated Event events = 7

  nondeterministic

• string codespace = 8

ExtendedCommitInfo is similar to CommitInfo except that it is only used in the PrepareProposal request such that CometBFT can provide vote extensions to the application.

Used in: RequestPrepareProposal

• int32 round = 1

  The round at which the block proposer decided in the previous height.

• repeated ExtendedVoteInfo votes = 2

  List of validators' addresses in the last validator set with their voting information, including vote extensions.

Used in: ExtendedCommitInfo

• optional Validator validator = 1

  The validator that sent the vote.

• bytes vote_extension = 3

  Non-deterministic extension provided by the sending validator's application.

• bytes extension_signature = 4

  Vote extension signature created by CometBFT

• types.BlockIDFlag block_id_flag = 5

  block_id_flag indicates whether the validator voted for a block, nil, or did not vote at all

Used in: RequestExtendVote, RequestFinalizeBlock, RequestPrepareProposal, RequestProcessProposal

• MisbehaviorType type = 1

• optional Validator validator = 2

  The offending validator

• int64 height = 3

  The height when the offense occurred

• optional google.protobuf.Timestamp time = 4

  The corresponding time where the offense occurred

• int64 total_voting_power = 5

  Total voting power of the validator set in case the ABCI application does not store historical validators. https://github.com/tendermint/tendermint/issues/4581

Used in: Misbehavior

• UNKNOWN = 0

• DUPLICATE_VOTE = 1

• LIGHT_CLIENT_ATTACK = 2

• oneof value

  • RequestEcho echo = 1

  • RequestFlush flush = 2

  • RequestInfo info = 3

  • RequestInitChain init_chain = 5

  • RequestQuery query = 6

  • RequestCheckTx check_tx = 8

  • RequestCommit commit = 11

  • RequestListSnapshots list_snapshots = 12

  • RequestOfferSnapshot offer_snapshot = 13

  • RequestLoadSnapshotChunk load_snapshot_chunk = 14

  • RequestApplySnapshotChunk apply_snapshot_chunk = 15

  • RequestPrepareProposal prepare_proposal = 16

  • RequestProcessProposal process_proposal = 17

  • RequestExtendVote extend_vote = 18

  • RequestVerifyVoteExtension verify_vote_extension = 19

  • RequestFinalizeBlock finalize_block = 20

Applies a snapshot chunk

Used as request type in: ABCI.ApplySnapshotChunk

Used as field type in: Request

• uint32 index = 1

• bytes chunk = 2

• string sender = 3

Used as request type in: ABCI.CheckTx

Used as field type in: Request

• bytes tx = 1

• CheckTxType type = 2

Used as request type in: ABCI.Commit

Used as field type in: Request

(message has no fields)

Used as request type in: ABCI.Echo

Used as field type in: Request

• string message = 1

Extends a vote with application-injected data

Used as request type in: ABCI.ExtendVote

Used as field type in: Request

• bytes hash = 1

  the hash of the block that this vote may be referring to

• int64 height = 2

  the height of the extended vote

• optional google.protobuf.Timestamp time = 3

  info of the block that this vote may be referring to

• repeated bytes txs = 4

• optional CommitInfo proposed_last_commit = 5

• repeated Misbehavior misbehavior = 6

• bytes next_validators_hash = 7

• bytes proposer_address = 8

  address of the public key of the original proposer of the block.

Used as request type in: ABCI.FinalizeBlock

Used as field type in: Request

• repeated bytes txs = 1

• optional CommitInfo decided_last_commit = 2

• repeated Misbehavior misbehavior = 3

• bytes hash = 4

  hash is the merkle root hash of the fields of the decided block.

• int64 height = 5

• optional google.protobuf.Timestamp time = 6

• bytes next_validators_hash = 7

• bytes proposer_address = 8

  proposer_address is the address of the public key of the original proposer of the block.

Used as request type in: ABCI.Flush

Used as field type in: Request

(message has no fields)

Used as request type in: ABCI.Info

Used as field type in: Request

• string version = 1

• uint64 block_version = 2

• uint64 p2p_version = 3

• string abci_version = 4

Used as request type in: ABCI.InitChain

Used as field type in: Request

• optional google.protobuf.Timestamp time = 1

• string chain_id = 2

• optional types.ConsensusParams consensus_params = 3

• repeated ValidatorUpdate validators = 4

• bytes app_state_bytes = 5

• int64 initial_height = 6

lists available snapshots

Used as request type in: ABCI.ListSnapshots

Used as field type in: Request

(message has no fields)

loads a snapshot chunk

Used as request type in: ABCI.LoadSnapshotChunk

Used as field type in: Request

• uint64 height = 1

• uint32 format = 2

• uint32 chunk = 3

offers a snapshot to the application

Used as request type in: ABCI.OfferSnapshot

Used as field type in: Request

• optional Snapshot snapshot = 1

  snapshot offered by peers

• bytes app_hash = 2

  light client-verified app hash for snapshot height

Used as request type in: ABCI.PrepareProposal

Used as field type in: Request

• int64 max_tx_bytes = 1

  the modified transactions cannot exceed this size.

• repeated bytes txs = 2

  txs is an array of transactions that will be included in a block, sent to the app for possible modifications.

• optional ExtendedCommitInfo local_last_commit = 3

• repeated Misbehavior misbehavior = 4

• int64 height = 5

• optional google.protobuf.Timestamp time = 6

• bytes next_validators_hash = 7

• bytes proposer_address = 8

  address of the public key of the validator proposing the block.

Used as request type in: ABCI.ProcessProposal

Used as field type in: Request

• repeated bytes txs = 1

• optional CommitInfo proposed_last_commit = 2

• repeated Misbehavior misbehavior = 3

• bytes hash = 4

  hash is the merkle root hash of the fields of the proposed block.

• int64 height = 5

• optional google.protobuf.Timestamp time = 6

• bytes next_validators_hash = 7

• bytes proposer_address = 8

  address of the public key of the original proposer of the block.

Used as request type in: ABCI.Query

Used as field type in: Request

• bytes data = 1

• string path = 2

• int64 height = 3

• bool prove = 4

Verify the vote extension

Used as request type in: ABCI.VerifyVoteExtension

Used as field type in: Request

• bytes hash = 1

  the hash of the block that this received vote corresponds to

• bytes validator_address = 2

  the validator that signed the vote extension

• int64 height = 3

• bytes vote_extension = 4

• oneof value

  • ResponseException exception = 1

  • ResponseEcho echo = 2

  • ResponseFlush flush = 3

  • ResponseInfo info = 4

  • ResponseInitChain init_chain = 6

  • ResponseQuery query = 7

  • ResponseCheckTx check_tx = 9

  • ResponseCommit commit = 12

  • ResponseListSnapshots list_snapshots = 13

  • ResponseOfferSnapshot offer_snapshot = 14

  • ResponseLoadSnapshotChunk load_snapshot_chunk = 15

  • ResponseApplySnapshotChunk apply_snapshot_chunk = 16

  • ResponsePrepareProposal prepare_proposal = 17

  • ResponseProcessProposal process_proposal = 18

  • ResponseExtendVote extend_vote = 19

  • ResponseVerifyVoteExtension verify_vote_extension = 20

  • ResponseFinalizeBlock finalize_block = 21

Used as response type in: ABCI.ApplySnapshotChunk

Used as field type in: Response

• ResponseApplySnapshotChunk.Result result = 1

• repeated uint32 refetch_chunks = 2

  Chunks to refetch and reapply

• repeated string reject_senders = 3

  Chunk senders to reject and ban

Used in: ResponseApplySnapshotChunk

• UNKNOWN = 0

  Unknown result, abort all snapshot restoration

• ACCEPT = 1

  Chunk successfully accepted

• ABORT = 2

  Abort all snapshot restoration

• RETRY = 3

  Retry chunk (combine with refetch and reject)

• RETRY_SNAPSHOT = 4

  Retry snapshot (combine with refetch and reject)

• REJECT_SNAPSHOT = 5

  Reject this snapshot, try others

Used as response type in: ABCI.CheckTx

Used as field type in: Response

• uint32 code = 1

• bytes data = 2

• string log = 3

  nondeterministic

• string info = 4

  nondeterministic

• int64 gas_wanted = 5

• int64 gas_used = 6

• repeated Event events = 7

• string codespace = 8

Used as response type in: ABCI.Commit

Used as field type in: Response

• int64 retain_height = 3

Used as response type in: ABCI.Echo

Used as field type in: Response

• string message = 1

nondeterministic

Used in: Response

• string error = 1

Used as response type in: ABCI.ExtendVote

Used as field type in: Response

• bytes vote_extension = 1

Used as response type in: ABCI.FinalizeBlock

Used as field type in: Response

• repeated Event events = 1

  set of block events emitted as part of executing the block

• repeated ExecTxResult tx_results = 2

  the result of executing each transaction including the events the particular transaction emitted. This should match the order of the transactions delivered in the block itself

• repeated ValidatorUpdate validator_updates = 3

  a list of updates to the validator set. These will reflect the validator set at current height + 2.

• optional types.ConsensusParams consensus_param_updates = 4

  updates to the consensus params, if any.

• bytes app_hash = 5

  app_hash is the hash of the applications' state which is used to confirm that execution of the transactions was deterministic. It is up to the application to decide which algorithm to use.

Used as response type in: ABCI.Flush

Used as field type in: Response

(message has no fields)

Used as response type in: ABCI.Info

Used as field type in: Response

• string data = 1

• string version = 2

• uint64 app_version = 3

• int64 last_block_height = 4

• bytes last_block_app_hash = 5

Used as response type in: ABCI.InitChain

Used as field type in: Response

• optional types.ConsensusParams consensus_params = 1

• repeated ValidatorUpdate validators = 2

• bytes app_hash = 3

Used as response type in: ABCI.ListSnapshots

Used as field type in: Response

• repeated Snapshot snapshots = 1

Used as response type in: ABCI.LoadSnapshotChunk

Used as field type in: Response

• bytes chunk = 1

Used as response type in: ABCI.OfferSnapshot

Used as field type in: Response

• ResponseOfferSnapshot.Result result = 1

Used in: ResponseOfferSnapshot

• UNKNOWN = 0

  Unknown result, abort all snapshot restoration

• ACCEPT = 1

  Snapshot accepted, apply chunks

• ABORT = 2

  Abort all snapshot restoration

• REJECT = 3

  Reject this specific snapshot, try others

• REJECT_FORMAT = 4

  Reject all snapshots of this format, try others

• REJECT_SENDER = 5

  Reject all snapshots from the sender(s), try others

Used as response type in: ABCI.PrepareProposal

Used as field type in: Response

• repeated bytes txs = 1

Used as response type in: ABCI.ProcessProposal

Used as field type in: Response

• ResponseProcessProposal.ProposalStatus status = 1

Used in: ResponseProcessProposal

• UNKNOWN = 0

• ACCEPT = 1

• REJECT = 2

Used as response type in: ABCI.Query

Used as field type in: Response

• uint32 code = 1

• string log = 3

  bytes data = 2; // use "value" instead.

  nondeterministic

• string info = 4

  nondeterministic

• int64 index = 5

• bytes key = 6

• bytes value = 7

• optional crypto.ProofOps proof_ops = 8

• int64 height = 9

• string codespace = 10

Used as response type in: ABCI.VerifyVoteExtension

Used as field type in: Response

• ResponseVerifyVoteExtension.VerifyStatus status = 1

Used in: ResponseVerifyVoteExtension

• UNKNOWN = 0

• ACCEPT = 1

• REJECT = 2

  Rejecting the vote extension will reject the entire precommit by the sender. Incorrectly implementing this thus has liveness implications as it may affect CometBFT's ability to receive 2/3+ valid votes to finalize the block. Honest nodes should never be rejected.

Used in: RequestOfferSnapshot, ResponseListSnapshots

• uint64 height = 1

  The height at which the snapshot was taken

• uint32 format = 2

  The application-specific snapshot format

• uint32 chunks = 3

  Number of chunks in the snapshot

• bytes hash = 4

  Arbitrary snapshot hash, equal only if identical

• bytes metadata = 5

  Arbitrary application metadata

TxResult contains results of executing the transaction. One usage is indexing transaction results.

• int64 height = 1

• uint32 index = 2

• bytes tx = 3

• optional ExecTxResult result = 4

Used in: ExtendedVoteInfo, Misbehavior, VoteInfo

• bytes address = 1

  The first 20 bytes of SHA256(public key)

• int64 power = 3

  PubKey pub_key = 2 [(gogoproto.nullable)=false];

  The voting power

Used in: RequestInitChain, ResponseFinalizeBlock, ResponseInitChain

• optional crypto.PublicKey pub_key = 1

• int64 power = 2

Used in: CommitInfo

• optional Validator validator = 1

• types.BlockIDFlag block_id_flag = 3