Struct PoWChallenge 

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

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

Nonce format: [Timestamp (8 bytes) | HMAC(Timestamp + ClientID, Secret) (24 bytes)]

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.