hotmint-storage

Persistent storage backends for the Hotmint BFT consensus framework.

Implements the BlockStore trait from hotmint-consensus using vsdb (a high-performance embedded KV database backed by MMDB), and provides PersistentConsensusState for crash recovery of critical consensus state.

Components

Usage

Block Store

use hotmint_consensus::store::BlockStore;
use hotmint_storage::block_store::VsdbBlockStore;

let store = VsdbBlockStore::new();
// genesis block is inserted automatically

// use as a drop-in replacement for MemoryBlockStore
use std::sync::{Arc, RwLock};

let shared_store = Arc::new(RwLock::new(Box::new(store) as Box<dyn BlockStore>));
let engine = ConsensusEngine::new(
    state,
    shared_store,
    // ...
);

Crash Recovery

use hotmint_consensus::state::ConsensusState;
use hotmint_storage::consensus_state::PersistentConsensusState;

let pstate = PersistentConsensusState::new();

// restore after restart
let mut state = ConsensusState::new(vid, validator_set);
if let Some(view) = pstate.load_current_view() {
    state.current_view = view;
}
if let Some(qc) = pstate.load_locked_qc() {
    state.locked_qc = Some(qc);
}
if let Some(qc) = pstate.load_highest_qc() {
    state.highest_qc = Some(qc);
}
if let Some(h) = pstate.load_last_committed_height() {
    state.last_committed_height = h;
}

Data Directory

vsdb stores data in the process working directory by default. Configure a custom location via environment variable or programmatically:

export VSDB_BASE_DIR=/var/lib/hotmint/data

// must be called before any vsdb operation, can only be called once
vsdb::vsdb_set_base_dir("/var/lib/hotmint/data").unwrap();

License

GPL-3.0-only