Browse Source

abci: add basic description of ABCI Commit.ResponseHeight (#85)

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.
pull/7804/head
Erik Grinaker 5 years ago
committed by GitHub
parent
commit
ebda9dcac5
No known key found for this signature in database GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 7 additions and 0 deletions
  1. +7
    -0
      spec/abci/abci.md

+ 7
- 0
spec/abci/abci.md View File

@ -369,6 +369,8 @@ Commit are included in the header of the next block.
- **Response**: - **Response**:
- `Data ([]byte)`: The Merkle root hash of the application state - `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**: - **Usage**:
- Persist the application state. - Persist the application state.
- Return an (optional) Merkle root hash of the application state - Return an (optional) Merkle root hash of the application state
@ -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 constant string, etc.), so long as it is deterministic - it must not be a
function of anything that did not come from the function of anything that did not come from the
BeginBlock/DeliverTx/EndBlock methods. 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 ## Data Types


Loading…
Cancel
Save