Struct NonceManager 

pub struct NonceManager { /* private fields */ }

Thread-safe sequential nonce allocator keyed by (wallet, subaccount_id).

Implementations

impl NonceManager

pub fn new() -> Self

Constructs an empty manager.

pub fn next_nonce( &self, wallet: &str, subaccount_id: u64, ) -> Result<u64, NonceError>

Allocates the next nonce for (wallet, subaccount_id) using the system clock as the millisecond reference.

Errors

Returns NonceError::ClockBeforeEpoch when the system clock is invalid.

pub fn next_nonce_at( &self, wallet: &str, subaccount_id: u64, now_ms: u64, ) -> u64

Allocates the next nonce for (wallet, subaccount_id) with an injected now_ms, suitable for deterministic testing.

pub fn refresh(&self, wallet: &str, subaccount_id: u64, last_seen_nonce: u64)

Aligns the local last-issued state with a venue-reported nextNonce, monotonically. The stored value advances to last_seen_nonce only when it is strictly greater than the current state, otherwise the call is a no-op.

Monotonicity matters because rewinding would re-issue nonces already dispatched on the wire, which the venue rejects as replays. A stale or out-of-date venue snapshot must never clobber more recent local allocations.

pub fn last_issued(&self, wallet: &str, subaccount_id: u64) -> Option<u64>

Returns the most recently issued nonce for a key, if any.

Trait Implementations

impl Debug for NonceManager

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

Formats the value using the given formatter.

impl Default for NonceManager

fn default() -> NonceManager

Returns the “default value” for a type.