Struct NonceStore 

pub struct NonceStore { /* private fields */ }

Per-address pending nonce (issued at /siwe/nonce, consumed at /siwe/verify). Single-use, 5-min TTL.

Implementations

impl NonceStore

pub fn new() -> Self

pub fn issue(&self, address: &str) -> String

Mint + stash a nonce for address. Overwrites any existing nonce for that address (reissue is fine — only one in-flight challenge per address).

pub fn take(&self, address: &str) -> Option<String>

Consume the stored nonce for address (single-use). Returns None for unknown OR expired entries — but DOESN’T remove an expired entry early (an attacker repeatedly posting expired nonces would otherwise burn the slot and DoS legitimate retries).

pub fn peek(&self, address: &str) -> Option<String>

Peek at the pending nonce WITHOUT consuming it. Used by the verify path so a wrong-nonce / bad-signature attempt doesn’t burn the legit nonce (Wave-5 codex P1: nonce-bombing DoS). Returns None for unknown / expired entries.

Trait Implementations

impl Default for NonceStore

fn default() -> Self

Returns the “default value” for a type.