Struct Preamble 

#[non_exhaustive]
pub struct Preamble {
    pub lifetime: Lifetime,
    pub client_versions: Vec<String>,
    pub server_versions: Vec<String>,
    pub proto_statuses: Arc<ProtoStatuses>,
    pub params: NetParams<i32>,
    pub voting_delay: Option<(u32, u32)>,
    pub consensus_method: u32,
    pub shared_rand_previous_value: Option<SharedRandStatus>,
    pub shared_rand_current_value: Option<SharedRandStatus>,
}

Available on crate feature plain-consensus only.

The preamble of a network status document, except for the intro and vote-status items.

https://spec.torproject.org/dir-spec/consensus-formats.html#section:preable

Does not include network-status-version and vote-status. In the old parser this is not represented directly; instead, in Consensus.flavor, there’s just the ConsensusFlavor. parse2 doesn’t (currently) support subdocuments which contain the parent’s intro item (ie, #[deftly(netdoc(flatten))] is not supported on the first field.)

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

lifetime: Lifetime

Over what time is this consensus valid? (For votes, this is the time over which the voted-upon consensus should be valid.)

client_versions: Vec<String>

List of recommended Tor client versions.

server_versions: Vec<String>

List of recommended Tor relay versions.

proto_statuses: Arc<ProtoStatuses>

Lists of recommended and required subprotocols.

{recommended,required}-{client,relay}-protocols

params: NetParams<i32>

Declared parameters for tunable settings about how to the network should operator. Some of these adjust timeouts and whatnot; some features things on and off.

voting_delay: Option<(u32, u32)>

How long in seconds should voters wait for votes and signatures (respectively) to propagate?

consensus_method: u32

What “method” was used to produce this consensus? (A consensus method is a version number used by authorities to upgrade the consensus algorithm.)

shared_rand_previous_value: Option<SharedRandStatus>

Global shared-random value for the previous shared-random period.

shared_rand_current_value: Option<SharedRandStatus>

Global shared-random value for the current shared-random period.

Trait Implementations

impl Clone for Preamble

fn clone(&self) -> Preamble

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Preamble

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

Formats the value using the given formatter.