package cometbft.abci.v1beta3
Get desktop application:
View/edit binary Protocol Buffers messages
service ABCI
types.proto:19ABCIService is a service for an ABCI application.
rpc Echo (, )
types.proto:21Echo returns back the same message it is sent.
rpc Flush (, )
types.proto:23Flush flushes the write buffer.
rpc Info (, )
types.proto:25Info returns information about the application state.
rpc CheckTx (, )
types.proto:27CheckTx validates a transaction.
rpc Query (, )
types.proto:29Query queries the application state.
rpc Commit (, )
types.proto:31Commit commits a block of transactions.
rpc InitChain (, )
types.proto:33InitChain initializes the blockchain.
rpc ListSnapshots (, )
types.proto:35ListSnapshots lists all the available snapshots.
rpc OfferSnapshot (, )
types.proto:37OfferSnapshot sends a snapshot offer.
rpc LoadSnapshotChunk (, )
types.proto:39LoadSnapshotChunk returns a chunk of snapshot.
rpc ApplySnapshotChunk (, )
types.proto:42ApplySnapshotChunk applies a chunk of snapshot.
rpc PrepareProposal (, )
types.proto:45PrepareProposal returns a proposal for the next block.
rpc ProcessProposal (, )
types.proto:47ProcessProposal validates a proposal.
rpc ExtendVote (, )
types.proto:49ExtendVote extends a vote with application-injected data (vote extensions).
rpc VerifyVoteExtension (, )
types.proto:51VerifyVoteExtension verifies a vote extension.
rpc FinalizeBlock (, )
types.proto:53FinalizeBlock finalizes a block.
message
types.proto:297CommitInfo contains votes for the particular round.
Used in: , ,
int32 round = 1
repeated votes = 2
message
types.proto:316ExecTxResult contains results of executing one individual transaction. * Its structure is equivalent to #ResponseDeliverTx which will be deprecated/deleted
Used in: , , ,
uint32 code = 1
bytes data = 2
string log = 3
nondeterministic
string info = 4
nondeterministic
int64 gas_wanted = 5
int64 gas_used = 6
repeated events = 7
nondeterministic
string codespace = 8
message
types.proto:305ExtendedCommitInfo 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:
int32 round = 1
The round at which the block proposer decided in the previous height.
repeated votes = 2
List of validators' addresses in the last validator set with their voting information, including vote extensions.
message
types.proto:280ExtendedVoteInfo extends VoteInfo with the vote extensions (non-deterministic).
Used in:
optional 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.v1beta1.BlockIDFlag block_id_flag = 5
block_id_flag indicates whether the validator voted for a block, nil, or did not vote at all
message
types.proto:60Request represents a request to the ABCI application.
oneof value
Sum of all possible messages.
echo = 1
flush = 2
info = 3
init_chain = 5
query = 6
check_tx = 8
commit = 11
list_snapshots = 12
offer_snapshot = 13
load_snapshot_chunk = 14
apply_snapshot_chunk = 15
prepare_proposal = 16
process_proposal = 17
extend_vote = 18
verify_vote_extension = 19
finalize_block = 20
message
types.proto:126Extends a vote with application-injected data
Used as request type in: ABCI.ExtendVote
Used as field type in:
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 time = 3
info of the block that this vote may be referring to
repeated bytes txs = 4
optional proposed_last_commit = 5
repeated misbehavior = 6
bytes next_validators_hash = 7
bytes proposer_address = 8
address of the public key of the original proposer of the block.
message
types.proto:152RequestFinalizeBlock is a request to finalize the block.
Used as request type in: ABCI.FinalizeBlock
Used as field type in:
repeated bytes txs = 1
optional decided_last_commit = 2
repeated misbehavior = 3
bytes hash = 4
hash is the merkle root hash of the fields of the decided block.
int64 height = 5
optional 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.
message
types.proto:84RequestInitChain is a request to initialize the blockchain.
Used as request type in: ABCI.InitChain
Used as field type in:
optional time = 1
string chain_id = 2
optional consensus_params = 3
repeated validators = 4
bytes app_state_bytes = 5
int64 initial_height = 6
message
types.proto:96RequestPrepareProposal is a request for the ABCI application to prepare a new block proposal.
Used as request type in: ABCI.PrepareProposal
Used as field type in:
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 local_last_commit = 3
repeated misbehavior = 4
int64 height = 5
optional time = 6
bytes next_validators_hash = 7
bytes proposer_address = 8
address of the public key of the validator proposing the block.
message
types.proto:112RequestProcessProposal is a request for the ABCI application to process proposal.
Used as request type in: ABCI.ProcessProposal
Used as field type in:
repeated bytes txs = 1
optional proposed_last_commit = 2
repeated misbehavior = 3
bytes hash = 4
hash is the merkle root hash of the fields of the proposed block.
int64 height = 5
optional time = 6
bytes next_validators_hash = 7
bytes proposer_address = 8
address of the public key of the original proposer of the block.
message
types.proto:142Verify the vote extension
Used as request type in: ABCI.VerifyVoteExtension
Used as field type in:
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
message
types.proto:169Response represents a response from the ABCI application.
oneof value
Sum of all possible messages.
exception = 1
echo = 2
flush = 3
info = 4
init_chain = 6
query = 7
check_tx = 9
commit = 12
list_snapshots = 13
offer_snapshot = 14
load_snapshot_chunk = 15
apply_snapshot_chunk = 16
prepare_proposal = 17
process_proposal = 18
extend_vote = 19
verify_vote_extension = 20
finalize_block = 21
message
types.proto:203ResponseCheckTx shows if the transaction was deemed valid by the ABCI application.
Used as response type in: ABCI.CheckTx
Used as field type in: ,
uint32 code = 1
bytes data = 2
string log = 3
nondeterministic
string info = 4
nondeterministic
int64 gas_wanted = 5
int64 gas_used = 6
repeated events = 7
string codespace = 8
message
types.proto:221ResponseCommit indicates how much blocks should CometBFT retain.
Used as response type in: ABCI.Commit
Used as field type in:
int64 retain_height = 3
message
types.proto:227ResponseExtendVote is the result of extending a vote with application-injected data.
Used as response type in: ABCI.ExtendVote
Used as field type in:
bytes vote_extension = 1
message
types.proto:250FinalizeBlockResponse contains the result of executing the block.
Used as response type in: ABCI.FinalizeBlock
Used as field type in: ,
repeated events = 1
set of block events emitted as part of executing the block
repeated 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 validator_updates = 3
a list of updates to the validator set. These will reflect the validator set at current height + 2.
optional 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.
message
types.proto:195ResponseInitChain contains the ABCI application's hash and updates to the validator set and/or the consensus params, if any.
Used as response type in: ABCI.InitChain
Used as field type in:
optional consensus_params = 1
repeated validators = 2
bytes app_hash = 3
message
types.proto:232ResponseVerifyVoteExtension is the result of verifying a vote extension.
Used as response type in: ABCI.VerifyVoteExtension
Used as field type in:
ResponseVerifyVoteExtension.VerifyStatus status = 1
Verification status.
Used in:
UNKNOWN = 0
Unknown
ACCEPT = 1
Accepted
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.
message
types.proto:331TxResult contains results of executing the transaction. One usage is indexing transaction results.
int64 height = 1
uint32 index = 2
bytes tx = 3
optional result = 4
message
types.proto:272VoteInfo contains the information about the vote.
Used in:
optional validator = 1
types.v1beta1.BlockIDFlag block_id_flag = 3