Struct HybridClock 

pub struct HybridClock { /* private fields */ }

A Hybrid Logical Clock instance.

Each node in the EXOCHAIN network maintains its own HybridClock. The clock is driven by a deterministic physical source and a logical counter. The default constructor does not read host time; runtime adapters that need deployment-specific physical metadata must inject an explicit HLC source.

Implementations

impl HybridClock

pub fn new() -> Self

Create a new clock driven by EXOCHAIN’s deterministic default source.

pub fn with_wall_clock( physical_source: impl Fn() -> u64 + Send + 'static, ) -> Self

Create a clock with a custom physical source.

pub fn with_wall_clock_and_max_drift( physical_source: impl Fn() -> u64 + Send + 'static, max_drift_ms: u64, ) -> Self

Create a clock with a custom physical source and drift tolerance.

pub fn with_fallible_wall_clock( physical_source: impl Fn() -> Result<u64> + Send + 'static, ) -> Self

Create a clock with a fallible physical source.

pub fn with_fallible_wall_clock_and_max_drift( physical_source: impl Fn() -> Result<u64> + Send + 'static, max_drift_ms: u64, ) -> Self

Create a clock with a fallible physical source and drift tolerance.

pub fn max_drift_ms(&self) -> u64

Return this clock’s configured maximum forward drift in milliseconds.

pub fn now(&mut self) -> Result<Timestamp>

Generate the next timestamp.

Guarantees: the returned timestamp is strictly greater than any previously returned by this clock.

pub fn update(&mut self, remote: &Timestamp) -> Result<Timestamp>

Merge a remote timestamp and advance the local clock.

The returned timestamp is guaranteed to be greater than both the local state and the remote timestamp.

Errors

Returns ExoError::ClockDrift if the remote timestamp is unreasonably far ahead of the local physical source.

pub fn is_before(a: &Timestamp, b: &Timestamp) -> bool

Causal ordering check: returns true if a happened-before b.

pub fn current(&self) -> Timestamp

Return the current state as a Timestamp without advancing.

Trait Implementations

impl Debug for HybridClock

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

Formats the value using the given formatter.

impl Default for HybridClock

fn default() -> Self

Returns the “default value” for a type.