Skip to content
This repository has been archived by the owner on Feb 23, 2022. It is now read-only.

Commit

Permalink
abci: add basic description of ABCI Commit.ResponseHeight (#85)
Browse files Browse the repository at this point in the history
Documentation for block pruning, once it's merged: tendermint/tendermint#4588.

Minimum documentation, for now - we probably shouldn't encourage using this feature too much until we release state sync.
  • Loading branch information
erikgrinaker committed Apr 14, 2020
1 parent 15b15d2 commit ebda9dc
Showing 1 changed file with 7 additions and 0 deletions.
7 changes: 7 additions & 0 deletions spec/abci/abci.md
Original file line number Diff line number Diff line change
Expand Up @@ -369,6 +369,8 @@ Commit are included in the header of the next block.

- **Response**:
- `Data ([]byte)`: The Merkle root hash of the application state
- `RetainHeight (int64)`: Blocks below this height may be removed. Defaults
to `0` (retain all).
- **Usage**:
- Persist the application state.
- Return an (optional) Merkle root hash of the application state
Expand All @@ -380,6 +382,11 @@ Commit are included in the header of the next block.
constant string, etc.), so long as it is deterministic - it must not be a
function of anything that did not come from the
BeginBlock/DeliverTx/EndBlock methods.
- Use `RetainHeight` with caution! If all nodes in the network remove historical
blocks then this data is permanently lost, and no new nodes will be able to
join the network and bootstrap. Historical blocks may also be required for
other purposes, e.g. auditing, replay of non-persisted heights, light client
verification, and so on.

## Data Types

Expand Down

0 comments on commit ebda9dc

Please sign in to comment.