package cometbft.abci.v1beta2

Get desktop application:
View/edit binary Protocol Buffers messages

ABCIApplication is a service for an ABCI application.

• rpc Echo (v1beta1.RequestEcho, v1beta1.ResponseEcho)

  types.proto:293

  Echo returns back the same message it is sent.

• rpc Flush (v1beta1.RequestFlush, v1beta1.ResponseFlush)

  types.proto:295

  Flush flushes the write buffer.

• rpc Info (RequestInfo, v1beta1.ResponseInfo)

  types.proto:297

  Info returns information about the application state.

• rpc DeliverTx (v1beta1.RequestDeliverTx, ResponseDeliverTx)

  types.proto:299

  DeliverTx applies a transaction.

• rpc CheckTx (v1beta1.RequestCheckTx, ResponseCheckTx)

  types.proto:301

  CheckTx validates a transaction.

• rpc Query (v1beta1.RequestQuery, v1beta1.ResponseQuery)

  types.proto:303

  Query queries the application state.

• rpc Commit (v1beta1.RequestCommit, v1beta1.ResponseCommit)

  types.proto:305

  Commit commits a block of transactions.

• rpc InitChain (RequestInitChain, ResponseInitChain)

  types.proto:307

  InitChain initializes the blockchain.

• rpc BeginBlock (RequestBeginBlock, ResponseBeginBlock)

  types.proto:309

  BeginBlock signals the beginning of a block.

• rpc EndBlock (v1beta1.RequestEndBlock, ResponseEndBlock)

  types.proto:311

  EndBlock signals the end of a block, returns changes to the validator set.

• rpc ListSnapshots (v1beta1.RequestListSnapshots, v1beta1.ResponseListSnapshots)

  types.proto:313

  ListSnapshots lists all the available snapshots.

• rpc OfferSnapshot (v1beta1.RequestOfferSnapshot, v1beta1.ResponseOfferSnapshot)

  types.proto:315

  OfferSnapshot sends a snapshot offer.

• rpc LoadSnapshotChunk (v1beta1.RequestLoadSnapshotChunk, v1beta1.ResponseLoadSnapshotChunk)

  types.proto:317

  LoadSnapshotChunk returns a chunk of snapshot.

• rpc ApplySnapshotChunk (v1beta1.RequestApplySnapshotChunk, v1beta1.ResponseApplySnapshotChunk)

  types.proto:320

  ApplySnapshotChunk applies a chunk of snapshot.

• rpc PrepareProposal (RequestPrepareProposal, ResponsePrepareProposal)

  types.proto:323

  PrepareProposal returns a proposal for the next block.

• rpc ProcessProposal (RequestProcessProposal, ResponseProcessProposal)

  types.proto:325

  ProcessProposal validates a proposal.

CommitInfo contains votes for the particular round.

Used in: RequestBeginBlock, RequestProcessProposal

• int32 round = 1

• repeated v1beta1.VoteInfo votes = 2

Event allows application developers to attach additional information to ResponseFinalizeBlock (defined in .v1beta3) and ResponseCheckTx. Up to 0.37, this could also be used in ResponseBeginBlock, ResponseEndBlock, and ResponseDeliverTx. Later, transactions may be queried using these events.

Used in: ResponseBeginBlock, ResponseCheckTx, ResponseDeliverTx, ResponseEndBlock, v1beta3.ExecTxResult, v1beta3.ResponseCheckTx, v1beta3.ResponseFinalizeBlock, state.v1beta3.ResponseBeginBlock, state.v1beta3.ResponseEndBlock

• 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

ExtendedCommitInfo is similar to CommitInfo except that it is only used in the PrepareProposal request such that Tendermint 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.

ExtendedVoteInfo extends VoteInfo with the vote extensions (non-deterministic).

Used in: ExtendedCommitInfo

• optional v1beta1.Validator validator = 1

  The validator that sent the vote.

• bool signed_last_block = 2

  Indicates whether the validator signed the last block, allowing for rewards based on validator availability.

• bytes vote_extension = 3

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

Misbehavior is a type of misbehavior committed by a validator.

Used in: RequestBeginBlock, RequestPrepareProposal, RequestProcessProposal, v1beta3.RequestExtendVote, v1beta3.RequestFinalizeBlock, v1beta3.RequestPrepareProposal, v1beta3.RequestProcessProposal

• MisbehaviorType type = 1

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

The type of misbehavior committed by a validator.

Used in: Misbehavior

• UNKNOWN = 0

  Unknown

• DUPLICATE_VOTE = 1

  Duplicate vote

• LIGHT_CLIENT_ATTACK = 2

  Light client attack

Request represents a request to the ABCI application.

• oneof value

  Sum of all possible messages.

  • v1beta1.RequestEcho echo = 1

  • v1beta1.RequestFlush flush = 2

  • RequestInfo info = 3

  • RequestInitChain init_chain = 5

  • v1beta1.RequestQuery query = 6

  • RequestBeginBlock begin_block = 7

  • v1beta1.RequestCheckTx check_tx = 8

  • v1beta1.RequestDeliverTx deliver_tx = 9

  • v1beta1.RequestEndBlock end_block = 10

  • v1beta1.RequestCommit commit = 11

  • v1beta1.RequestListSnapshots list_snapshots = 12

  • v1beta1.RequestOfferSnapshot offer_snapshot = 13

  • v1beta1.RequestLoadSnapshotChunk load_snapshot_chunk = 14

  • v1beta1.RequestApplySnapshotChunk apply_snapshot_chunk = 15

  • RequestPrepareProposal prepare_proposal = 16

  • RequestProcessProposal process_proposal = 17

RequestBeginBlock indicates the beginning of committing the block.

Used as request type in: ABCIApplication.BeginBlock

Used as field type in: Request

• bytes hash = 1

• optional types.v1beta1.Header header = 2

• optional CommitInfo last_commit_info = 3

• repeated Misbehavior byzantine_validators = 4

RequestInfo is a request for the ABCI application version.

Used as request type in: ABCIApplication.Info, v1beta3.ABCI.Info

Used as field type in: Request, v1beta3.Request

• string version = 1

• uint64 block_version = 2

• uint64 p2p_version = 3

• string abci_version = 4

RequestInitChain is a request to initialize the blockchain.

Used as request type in: ABCIApplication.InitChain

Used as field type in: Request

• optional google.protobuf.Timestamp time = 1

• string chain_id = 2

• optional types.v1beta2.ConsensusParams consensus_params = 3

• repeated v1beta1.ValidatorUpdate validators = 4

• bytes app_state_bytes = 5

• int64 initial_height = 6

RequestPrepareProposal is a request for the ABCI application to prepare a new block proposal.

Used as request type in: ABCIApplication.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.

RequestProcessProposal is a request for the ABCI application to process proposal.

Used as request type in: ABCIApplication.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.

Response represents a response from the ABCI application.

• oneof value

  Sum of all possible messages.

  • v1beta1.ResponseException exception = 1

  • v1beta1.ResponseEcho echo = 2

  • v1beta1.ResponseFlush flush = 3

  • v1beta1.ResponseInfo info = 4

  • ResponseInitChain init_chain = 6

  • v1beta1.ResponseQuery query = 7

  • ResponseBeginBlock begin_block = 8

  • ResponseCheckTx check_tx = 9

  • ResponseDeliverTx deliver_tx = 10

  • ResponseEndBlock end_block = 11

  • v1beta1.ResponseCommit commit = 12

  • v1beta1.ResponseListSnapshots list_snapshots = 13

  • v1beta1.ResponseOfferSnapshot offer_snapshot = 14

  • v1beta1.ResponseLoadSnapshotChunk load_snapshot_chunk = 15

  • v1beta1.ResponseApplySnapshotChunk apply_snapshot_chunk = 16

  • ResponsePrepareProposal prepare_proposal = 17

  • ResponseProcessProposal process_proposal = 18

ResponseBeginBlock contains a list of block-level events.

Used as response type in: ABCIApplication.BeginBlock

Used as field type in: Response, state.v1beta2.ABCIResponses

• repeated Event events = 1

ResponseCheckTx shows if the transaction was deemed valid by the ABCI application.

Used as response type in: ABCIApplication.CheckTx

Used as field type in: Response, rpc.grpc.v1beta2.ResponseBroadcastTx

• 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

• string sender = 9

• int64 priority = 10

• string mempool_error = 11

  mempool_error is set by CometBFT. ABCI applications creating a ResponseCheckTX should not set mempool_error.

ResponseDeliverTx contains a result of committing the given transaction and a list of events.

Used as response type in: ABCIApplication.DeliverTx

Used as field type in: Response, rpc.grpc.v1beta2.ResponseBroadcastTx, state.v1beta2.ABCIResponses

• 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

ResponseEndBlock contains updates to consensus params and/or validator set changes, if any.

Used as response type in: ABCIApplication.EndBlock

Used as field type in: Response, state.v1beta2.ABCIResponses

• repeated v1beta1.ValidatorUpdate validator_updates = 1

• optional types.v1beta2.ConsensusParams consensus_param_updates = 2

• repeated Event events = 3

ResponseInitChain contains the ABCI application's hash and updates to the validator set and/or the consensus params, if any.

Used as response type in: ABCIApplication.InitChain

Used as field type in: Response

• optional types.v1beta2.ConsensusParams consensus_params = 1

• repeated v1beta1.ValidatorUpdate validators = 2

• bytes app_hash = 3

ResponsePrepareProposal contains the list of transactions that will be included in the proposal.

Used as response type in: ABCIApplication.PrepareProposal, v1beta3.ABCI.PrepareProposal

Used as field type in: Response, v1beta3.Response

• repeated bytes txs = 1

ResponseProcessProposal contains the result of processing a proposal.

Used as response type in: ABCIApplication.ProcessProposal, v1beta3.ABCI.ProcessProposal

Used as field type in: Response, v1beta3.Response

• ResponseProcessProposal.ProposalStatus status = 1

The status.

Used in: ResponseProcessProposal

• UNKNOWN = 0

  Unknown

• ACCEPT = 1

  Accepted

• REJECT = 2

  Rejected