Struct PoWChallenge 

pub struct PoWChallenge {
    pub nonce: [u8; 32],
    pub difficulty: u8,
}

Available on crate feature std only.

Proof-of-Work Challenge

Fields

nonce: [u8; 32]

difficulty: u8

Implementations

impl PoWChallenge

pub fn new_stateless( difficulty: u8, client_id: &[u8], secret: &[u8; 32], ) -> Self

Generate a new stateless challenge.

The 32-byte nonce is a self-authenticating cookie: [timestamp (8 bytes, LE) | MAC(timestamp ‖ client_id) (24 bytes)], where the MAC is a keyed BLAKE3 hash under the server’s secret (truncated to 24 bytes). Because the MAC binds the timestamp and the client id, the server need keep no per-challenge state — verify recomputes the MAC to confirm authenticity and freshness.

pub fn verify( &self, solution: &PoWSolution, client_id: &[u8], secret: &[u8; 32], ) -> bool

Verify a solution and the validity of the challenge (stateless check)

pub fn solve(&self) -> Result<PoWSolution, PowError>

Solve at the challenge’s difficulty, bounded by MAX_SOLVE_ITERATIONS (H3) so an infeasible difficulty fails closed instead of looping forever.

pub fn solve_capped(&self, max_difficulty: u8) -> Result<PoWSolution, PowError>

Like solve but rejects a difficulty above max_difficulty BEFORE doing any work (H3). The client passes MAX_CLIENT_POW_DIFFICULTY so an injected high-difficulty HelloRetryRequest cannot pin a CPU core.

Trait Implementations

impl BorshDeserialize for PoWChallenge

fn deserialize_reader<__R: Read>(reader: &mut __R) -> Result<Self, Error>

fn deserialize(buf: &mut &[u8]) -> Result<Self, Error>

Deserializes this instance from a given slice of bytes. Updates the buffer to point at the remaining bytes.

fn try_from_slice(v: &[u8]) -> Result<Self, Error>

Deserialize this instance from a slice of bytes.

fn try_from_reader<R>(reader: &mut R) -> Result<Self, Error>

where R: Read,

impl BorshSerialize for PoWChallenge

fn serialize<__W: Write>(&self, writer: &mut __W) -> Result<(), Error>

impl Clone for PoWChallenge

fn clone(&self) -> PoWChallenge

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PoWChallenge

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PoWChallenge

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PoWChallenge

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.