Struct HlcClock 

pub struct HlcClock {
    physical: AtomicU64,
    logical: AtomicU64,
    node_id: u64,
    max_drift_us: u64,
}

Hybrid Logical Clock for generating causally-ordered timestamps.

Thread-safe implementation using atomics for the state.

Fields

physical: AtomicU64

Current physical time (atomically updated).

logical: AtomicU64

Current logical counter (atomically updated).

node_id: u64

Node identifier.

max_drift_us: u64

Maximum allowed clock drift in microseconds.

Implementations

impl HlcClock

pub fn new(node_id: u64) -> Self

Create a new HLC clock with the given node ID.

pub fn with_max_drift(node_id: u64, max_drift_ms: u64) -> Self

Create a new HLC clock with custom max drift.

pub fn node_id(&self) -> u64

Get the node ID.

pub fn now(&self) -> HlcTimestamp

Get current timestamp without advancing the clock.

pub fn tick(&self) -> HlcTimestamp

Generate a new timestamp, advancing the clock.

pub fn update(&self, received: &HlcTimestamp) -> Result<HlcTimestamp>

Update clock on receiving a message with the given timestamp.

Returns the new local timestamp that causally follows the received timestamp.

fn wall_time() -> u64

Get current wall clock time in microseconds.

Trait Implementations

impl Debug for HlcClock

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

Formats the value using the given formatter.