mirror of
https://github.com/QuilibriumNetwork/ceremonyclient.git
synced 2026-02-21 10:27:26 +08:00
c797d482f9
* wip: conversion of hotstuff from flow into Q-oriented model * bulk of tests * remaining non-integration tests * add integration test, adjust log interface, small tweaks * further adjustments, restore full pacemaker shape * add component lifecycle management+supervisor * further refinements * resolve timeout hanging * mostly finalized state for consensus * bulk of engine swap out * lifecycle-ify most types * wiring nearly complete, missing needed hooks for proposals * plugged in, vetting message validation paths * global consensus, plugged in and verified * app shard now wired in too * do not decode empty keys.yml (#456) * remove obsolete engine.maxFrames config parameter (#454) * default to Info log level unless debug is enabled (#453) * respect config's "logging" section params, remove obsolete single-file logging (#452) * Trivial code cleanup aiming to reduce Go compiler warnings (#451) * simplify range traversal * simplify channel read for single select case * delete rand.Seed() deprecated in Go 1.20 and no-op as of Go 1.24 * simplify range traversal * simplify channel read for single select case * remove redundant type from array * simplify range traversal * simplify channel read for single select case * RC slate * finalize 2.1.0.5 * Update comments in StrictMonotonicCounter Fix comment formatting and clarify description. --------- Co-authored-by: Black Swan <3999712+blacks1ne@users.noreply.github.com>
24 lines
1.1 KiB
Go
24 lines
1.1 KiB
Go
package consensus
|
|
|
|
import "source.quilibrium.com/quilibrium/monorepo/consensus/models"
|
|
|
|
// Finalizer is used by the consensus algorithm to inform other components for
|
|
// (such as the protocol state) about finalization of states.
|
|
//
|
|
// Since we have two different protocol states: one for the main consensus,
|
|
// the other for the collection cluster consensus, the Finalizer interface
|
|
// allows the two different protocol states to provide different implementations
|
|
// for updating its state when a state has been finalized.
|
|
//
|
|
// Updating the protocol state should always succeed when the data is
|
|
// consistent. However, in case the protocol state is corrupted, error should be
|
|
// returned and the consensus algorithm should halt. So the error returned from
|
|
// MakeFinal is for the protocol state to report exceptions.
|
|
type Finalizer interface {
|
|
|
|
// MakeFinal will declare a state and all of its ancestors as finalized, which
|
|
// makes it an immutable part of the time reel. Returning an error indicates
|
|
// some fatal condition and will cause the finalization logic to terminate.
|
|
MakeFinal(stateID models.Identity) error
|
|
}
|