Struct Parameters

pub struct Parameters {

    pub db_path: PathBuf,
    pub leader_timeout: Duration,
    pub min_block_delay: Duration,
    pub max_forward_time_drift: Duration,
    pub max_headers_per_commit_sync_fetch: usize,
    pub max_headers_per_regular_sync_fetch: usize,
    pub max_transactions_per_fetch: usize,
    pub sync_last_known_own_block_timeout: Duration,
    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 max_headers_per_bundle: usize,
    pub max_shards_per_bundle: usize,
    pub tonic: TonicParameters,
}

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, from when parent round has a quorum.

min_block_delay: Duration

Minimum delay between own blocks. This avoids 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_headers_per_commit_sync_fetch: usize

Number of block headers to fetch per commit sync request.

max_headers_per_regular_sync_fetch: usize

Number of block headers to fetch per periodic or live sync request

max_transactions_per_fetch: usize

Number of transactions to fetch per request.

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.

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

max_headers_per_bundle: usize

Maximum number of headers to be included in a bundle. Headers exceeding the max allowed limit will be truncated.

max_shards_per_bundle: usize

Maximum number of transaction shards to be included in a bundle. Shards exceeding the max allowed limit will be truncated.

tonic: TonicParameters

Tonic network settings.

Trait Implementations

impl Clone for Parameters

fn clone(&self) -> Parameters

Returns a duplicate 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.