Struct CoarseClock 

pub struct CoarseClock { /* private fields */ }

A wall clock the paid-delivery hot path can read with a single relaxed atomic load instead of a SystemTime::now() syscall (issue #1792 item 4).

Refreshed on a timer by Self::spawn_refresher; reads fall back to a live clock until (and if ever) a refresher runs. See the module docs.

Implementations

impl CoarseClock

pub const fn new() -> Self

A clock with no refresher: every read is live until Self::spawn_refresher starts stamping the cell.

pub fn unix_millis(&self) -> u64

Unix milliseconds — the refreshed value, or a live reading while the cell still holds its 0 sentinel.

pub fn unix_seconds(&self) -> u64

Unix seconds, floored from Self::unix_millis. Matches SystemTime::now().duration_since(UNIX_EPOCH).as_secs() for the same instant, so it is a drop-in for the expiry gate’s prior payment_settlement::unix_now().

pub fn spawn_refresher(clock: &Arc<Self>, interval: Duration)

Spawn a background task that refreshes clock every interval until the last strong reference to it is dropped.

The task holds only a Weak, so it is self-terminating and needs no StopHandle wiring: once every ClientHandler holding the clock is gone (runtime shutdown), the next upgrade() fails and the loop exits — at most one interval later. It also owns no queue and awaits no sender, so the detached-task hazard StopHandle exists to prevent does not apply here.

The first tick fires immediately (a fresh tokio::time::interval is ready at once), so the cell leaves its 0 sentinel as soon as the task is scheduled; reads before then are live, not wrong.

Trait Implementations

impl Debug for CoarseClock

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

Formats the value using the given formatter.

impl Default for CoarseClock

fn default() -> Self

Returns the “default value” for a type.