Enum tendermint::abci::Request
source[−]pub enum Request {
Show 14 variants
Echo(Echo),
Flush,
Info(Info),
InitChain(InitChain),
Query(Query),
BeginBlock(BeginBlock),
CheckTx(CheckTx),
DeliverTx(DeliverTx),
EndBlock(EndBlock),
Commit,
ListSnapshots,
OfferSnapshot(OfferSnapshot),
LoadSnapshotChunk(LoadSnapshotChunk),
ApplySnapshotChunk(ApplySnapshotChunk),
}
Expand description
All possible ABCI requests.
Variants
Echo(Echo)
Tuple Fields
0: Echo
Echoes a string to test an ABCI implementation.
Flush
Indicates that any pending requests should be completed and their responses flushed.
Info(Info)
Tuple Fields
0: Info
Requests information about the application state.
InitChain(InitChain)
Tuple Fields
0: InitChain
Called on genesis to initialize chain state.
Query(Query)
Tuple Fields
0: Query
Queries for data from the application at current or past height.
BeginBlock(BeginBlock)
Tuple Fields
0: BeginBlock
Signals the beginning of a new block.
Called prior to any DeliverTx
s. The header
contains the height,
timestamp, and more – it exactly matches the Tendermint block header.
CheckTx(CheckTx)
Tuple Fields
0: CheckTx
Check whether a transaction should be included in the mempool.
CheckTx
is not involved in processing blocks, only in deciding whether a
transaction should be included in the mempool. Every node runs CheckTx
before adding a transaction to its local mempool. The transaction may come
from an external user or another node. CheckTx
need not execute the
transaction in full, but can instead perform lightweight or statateful
validation (e.g., checking signatures or account balances) instead of more
expensive checks (like running code in a virtual machine).
DeliverTx(DeliverTx)
Tuple Fields
0: DeliverTx
Execute a transaction against the application state.
EndBlock(EndBlock)
Tuple Fields
0: EndBlock
Signals the end of a block.
Called after all transactions, and prior to each Commit
.
Commit
Signals the application that it can write the queued state transitions from the block to its state.
ListSnapshots
Asks the application for a list of snapshots.
OfferSnapshot(OfferSnapshot)
Tuple Fields
Offers a list of snapshots to the application.
OfferSnapshot
is called when bootstrapping a node using state sync. The
application may accept or reject snapshots as appropriate. Upon accepting,
Tendermint will retrieve and apply snapshot chunks via
ApplySnapshotChunk
. The application may also choose to reject a snapshot
in the chunk response, in which case it should be prepared to accept further
OfferSnapshot
calls.
Only app_hash
can be trusted, as it has been verified by the light client.
Any other data can be spoofed by adversaries, so applications should employ
additional verification schemes to avoid denial-of-service attacks. The
verified app_hash
is automatically checked against the restored application
at the end of snapshot restoration.
See also the Snapshot
data type and the ABCI state sync documentation.
LoadSnapshotChunk(LoadSnapshotChunk)
Tuple Fields
Used during state sync to retrieve snapshot chunks from peers.
ApplySnapshotChunk(ApplySnapshotChunk)
Tuple Fields
Applies a snapshot chunk.
The application can choose to refetch chunks and/or ban P2P peers as appropriate. Tendermint will not do this unless instructed by the application.
The application may want to verify each chunk, e.g., by attaching chunk
hashes in Snapshot::metadata
and/or incrementally verifying contents
against app_hash
.
When all chunks have been accepted, Tendermint will make an ABCI Info
request to verify that last_block_app_hash
and last_block_height
match
the expected values, and record the app_version
in the node state. It then
switches to fast sync or consensus and joins the network.
If Tendermint is unable to retrieve the next chunk after some time (e.g.,
because no suitable peers are available), it will reject the snapshot and try
a different one via OfferSnapshot
. The application should be prepared to
reset and accept it or abort as appropriate.
Implementations
Get the method kind for this request.
Trait Implementations
Performs the conversion.
Performs the conversion.
Performs the conversion.
Performs the conversion.
Encode into a buffer in Protobuf format. Read more
Encode with a length-delimiter to a buffer in Protobuf format. Read more
Constructor that attempts to decode an instance from a buffer. Read more
Constructor that attempts to decode a length-delimited instance from the buffer. Read more
Returns the encoded length of the message without a length delimiter. Read more
Encodes into a Protobuf-encoded Vec<u8>
.
Constructor that attempts to decode a Protobuf-encoded instance from a
Vec<u8>
(or equivalent). Read more
Encode with a length-delimiter to a Vec<u8>
Protobuf-encoded message.
Auto Trait Implementations
impl RefUnwindSafe for Request
impl UnwindSafe for Request
Blanket Implementations
Mutably borrows from an owned value. Read more