Struct TimeManager

pub struct TimeManager {
    offset: Arc<RwLock<i128>>,
    last_timestamp: Arc<RwLock<u64>>,
    next_exact_timestamp: Arc<RwLock<Option<u64>>>,
    interval: Arc<RwLock<Option<u64>>>,
}

Manages block time

Fields

offset: Arc<RwLock<i128>>

tracks the overall applied timestamp offset

last_timestamp: Arc<RwLock<u64>>

The timestamp of the last block header

next_exact_timestamp: Arc<RwLock<Option<u64>>>

Contains the next timestamp to use if this is set then the next time [TimeManager::current_timestamp()] is called this value will be taken and returned. After which the offset will be updated accordingly

interval: Arc<RwLock<Option<u64>>>

The interval to use when determining the next block’s timestamp

Implementations

impl TimeManager

pub fn new(start_timestamp: u64) -> Self

pub fn reset(&self, start_timestamp: u64)

Resets the current time manager to the given timestamp, resetting the offsets and next block timestamp option

pub fn offset(&self) -> i128

fn add_offset(&self, offset: i128) -> i128

Adds the given offset to the already tracked offset and returns the result

pub fn increase_time(&self, seconds: u64) -> i128

Jumps forward in time by the given seconds

This will apply a permanent offset to the natural UNIX Epoch timestamp

pub fn set_next_block_timestamp( &self, timestamp: u64, ) -> Result<(), BlockchainError>

Sets the exact timestamp to use in the next block Fails if it’s before (or at the same time) the last timestamp

pub fn set_block_timestamp_interval(&self, interval: u64)

Sets an interval to use when computing the next timestamp

If an interval already exists, this will update the interval, otherwise a new interval will be set starting with the current timestamp.

pub fn remove_block_timestamp_interval(&self) -> bool

Removes the interval if it exists

fn compute_next_timestamp(&self) -> (u64, Option<i128>)

Computes the next timestamp without updating internals

pub fn next_timestamp(&self) -> u64

Returns the current timestamp and updates the underlying offset and interval accordingly

pub fn current_call_timestamp(&self) -> u64

Returns the current timestamp for a call that does not update the value

Trait Implementations

impl Clone for TimeManager

fn clone(&self) -> TimeManager

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TimeManager

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

Formats the value using the given formatter.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 32 bytes