Struct ProtocolTimelines 

pub struct ProtocolTimelines {
    pub genesis_ts: u64,
    pub era: NonZeroU64,
    pub election: u64,
    pub slot: NonZeroU64,
}

GearExe network timelines configuration. Parameters fetched the Router contract. This struct stores in the database, because of using in the multiple places.

Fields

genesis_ts: u64

era: NonZeroU64

election: u64

The election duration in seconds before the end of an era when the next set of validators elected. (start of era)[ - - - - - - - - - - - - + - - - - ] (end of era) ^ election

slot: NonZeroU64

The slot duration in seconds.

Implementations

impl ProtocolTimelines

pub fn block_coordinator_at( &self, validators: &ValidatorsVec, timestamp: u64, ) -> Option<Address>

Calculates the coordinator address for a given Ethereum block timestamp.

The coordinator is the validator picked once per Ethereum block to aggregate finalized MBs into a BatchCommitment and submit it on-chain. Block production itself is driven by Malachite — coordinator election is independent.

Arguments

• validators - A non-empty vector of validator addresses.
• timestamp - The timestamp for which to calculate the coordinator.

Returns None if timestamp is before genesis.

pub fn block_coordinator_index_at( &self, validators_amount: NonZeroUsize, timestamp: u64, ) -> Option<usize>

Calculates the coordinator index for a given Ethereum block timestamp.

Arguments

• validators_amount - The number of validators in the protocol.
• timestamp - The timestamp for which to calculate the coordinator index.

Returns None if timestamp is before genesis.

impl ProtocolTimelines

pub fn era_from_ts(&self, ts: u64) -> Option<u64>

Returns the era index for the given timestamp. Eras starts from 0.

Returns None if ts < genesis_ts

pub fn era_start_ts(&self, era_index: u64) -> Option<u64>

Returns the timestamp since which the given era started.

Returns None if overflows u64.

pub fn era_election_start_ts(&self, era_index: u64) -> Option<u64>

Returns the timestamp when election starts in the given era. NOTE: election starts for the next era validators.

Returns None if overflows u64.

Panics

Panics if era duration < election duration

pub fn slot_from_ts(&self, ts: u64) -> Option<u64>

Returns the slot index for the given timestamp. Slots starts from 0.

Returns None if ts < genesis_ts

Trait Implementations

impl Clone for ProtocolTimelines

fn clone(&self) -> ProtocolTimelines

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ProtocolTimelines

impl Debug for ProtocolTimelines

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

Formats the value using the given formatter.

impl Decode for ProtocolTimelines

fn decode<__CodecInputEdqy: Input>( __codec_input_edqy: &mut __CodecInputEdqy, ) -> Result<Self, Error>

Attempt to deserialise the value from input.

fn decode_into<I>( input: &mut I, dst: &mut MaybeUninit<Self>, ) -> Result<DecodeFinished, Error>

where I: Input,

Attempt to deserialize the value from input into a pre-allocated piece of memory.

fn skip<I>(input: &mut I) -> Result<(), Error>

where I: Input,

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl Encode for ProtocolTimelines

fn size_hint(&self) -> usize

If possible give a hint of expected size of the encoding.

fn encode_to<__CodecOutputEdqy: Output + ?Sized>( &self, __codec_dest_edqy: &mut __CodecOutputEdqy, )

Convert self to a slice and append it to the destination.

fn encode(&self) -> Vec<u8>

Convert self to an owned vector.

fn using_encoded<R, F>(&self, f: F) -> R

where F: FnOnce(&[u8]) -> R,

Convert self to a slice and then invoke the given closure with it.

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl EncodeLike for ProtocolTimelines

impl Eq for ProtocolTimelines

impl PartialEq for ProtocolTimelines

fn eq(&self, other: &ProtocolTimelines) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ProtocolTimelines

impl TypeInfo for ProtocolTimelines

type Identity = ProtocolTimelines

The type identifying for which type info is provided.

fn type_info() -> Type

Returns the static type identifier for Self.