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>
26 lines
1.2 KiB
Go
26 lines
1.2 KiB
Go
package consensus
|
|
|
|
import "source.quilibrium.com/quilibrium/monorepo/consensus/models"
|
|
|
|
// StateProducer is responsible for producing new state proposals. It is a
|
|
// service component to HotStuff's main state machine (implemented in the
|
|
// EventHandler). The StateProducer's central purpose is to mediate concurrent
|
|
// signing requests to its embedded `hotstuff.SafetyRules` during state
|
|
// production. The actual work of producing a state proposal is delegated to the
|
|
// embedded `consensus.LeaderProvider`.
|
|
type StateProducer[StateT models.Unique, VoteT models.Unique] interface {
|
|
// MakeStateProposal builds a new HotStuff state proposal using the given
|
|
// rank, the given quorum certificate for its parent and [optionally] a
|
|
// timeout certificate for last rank (could be nil).
|
|
// Error Returns:
|
|
// - model.NoVoteError if it is not safe for us to vote (our proposal
|
|
// includes our vote) for this rank. This can happen if we have already
|
|
// proposed or timed out this rank.
|
|
// - generic error in case of unexpected failure
|
|
MakeStateProposal(
|
|
rank uint64,
|
|
qc models.QuorumCertificate,
|
|
lastRankTC models.TimeoutCertificate,
|
|
) (*models.SignedProposal[StateT, VoteT], error)
|
|
}
|