Struct NonceLedger 

pub struct NonceLedger { /* private fields */ }

Nonce management for tracking local and on-chain nonces.

Maintains two nonce counters per address:

• confirmed — the last nonce known to be mined on-chain.
• pending — the highest nonce assigned locally but not yet confirmed.

Implementations

impl NonceLedger

pub fn new() -> Self

Create a new, empty ledger.

pub fn set_confirmed(&self, address: &str, nonce: u64)

Set the on-chain confirmed nonce for an address.

pub fn next(&self, address: &str) -> u64

Get the next available nonce — the maximum of (confirmed + 1) and (pending + 1), falling back to 0 when neither is set.

pub fn mark_pending(&self, address: &str, nonce: u64)

Mark a nonce as used (pending).

pub fn confirm(&self, address: &str, nonce: u64)

Confirm a nonce — updates confirmed and clears pending when the pending nonce is at or below the confirmed nonce.

pub fn confirmed_nonce(&self, address: &str) -> Option<u64>

Get the current confirmed nonce.

pub fn pending_nonce(&self, address: &str) -> Option<u64>

Get the current pending nonce.

pub fn gaps(&self, address: &str) -> Vec<u64>

Get gap nonces — nonces between confirmed and pending that have not been observed.

For example, if confirmed = 3 and pending = 7, the gaps are [4, 5, 6]. Returns an empty vec if there are no gaps or either value is unset.

Trait Implementations

impl Default for NonceLedger

fn default() -> Self

Returns the “default value” for a type.