Struct consensus_config::Parameters

pub struct Parameters {
    pub db_path: PathBuf,
    pub leader_timeout: Duration,
    pub min_round_delay: Duration,
    pub max_forward_time_drift: Duration,
    pub max_blocks_per_fetch: usize,
    pub dag_state_cached_rounds: u32,
    pub commit_sync_parallel_fetches: usize,
    pub commit_sync_batch_size: u32,
    pub commit_sync_batches_ahead: usize,
    pub tonic: TonicParameters,
    pub sync_last_known_own_block_timeout: Duration,
}

Operational configurations of a consensus authority.

All fields should tolerate inconsistencies among authorities, without affecting safety of the protocol. Otherwise, they need to be part of Iota protocol config or epoch state on-chain.

NOTE: fields with default values are specified in the serde default functions. Most operators should not need to specify any field, except db_path.

Fields

db_path: PathBuf

Path to consensus DB for this epoch. Required when initializing consensus. This is calculated based on user configuration for base directory.

leader_timeout: Duration

Time to wait for parent round leader before sealing a block.

min_round_delay: Duration

Minimum delay between rounds, to avoid generating too many rounds when latency is low. This is especially necessary for tests running locally. If setting a non-default value, it should be set low enough to avoid reducing round rate and increasing latency in realistic and distributed configurations.

max_forward_time_drift: Duration

Maximum forward time drift (how far in future) allowed for received blocks.

max_blocks_per_fetch: usize

Number of blocks to fetch per request.

dag_state_cached_rounds: u32

The number of rounds of blocks to be kept in the Dag state cache per authority. The larger the number the more the blocks that will be kept in memory allowing minimising any potential disk access. Value should be at minimum 50 rounds to ensure node performance, but being too large can be expensive in memory usage.

commit_sync_parallel_fetches: usize

commit_sync_batch_size: u32

commit_sync_batches_ahead: usize

tonic: TonicParameters

Tonic network settings.

sync_last_known_own_block_timeout: Duration

Time to wait during node start up until the node has synced the last proposed block via the network peers. When set to 0 the sync mechanism is disabled. This property is meant to be used for amnesia recovery.

Trait Implementations

impl Clone for Parameters

fn clone(&self) -> Parameters

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Parameters

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Parameters

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Parameters

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Parameters

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.