Struct challenge_bypass_ristretto::oprf::Token

#[repr(C)]
pub struct Token {
    pub(crate) t: TokenPreimage,
    r: Scalar,
}

A Token consists of a randomly chosen preimage and blinding factor.

Since a token includes the blinding factor it should be treated as a client secret and NEVER revealed to the server.

Fields

t: TokenPreimage

t is a TokenPreimage

r: Scalar

r is a Scalar which is the blinding factor

Implementations

impl Token

pub fn random<D, T>(rng: &mut T) -> Self

where D: Digest<OutputSize = U64> + Default, T: Rng + CryptoRng,

Generates a new random Token using the provided random number generator.

pub(crate) fn hash_from_bytes_with_blind<D>( bytes: &[u8], blinding_scalar: Scalar ) -> Self

where D: Digest<OutputSize = U64> + Default,

Creates a new Token, using hashing to derive a TokenPreimage and the specified blind

pub fn hash_from_bytes<D, T>(rng: &mut T, bytes: &[u8]) -> Self

where D: Digest<OutputSize = U64> + Default, T: Rng + CryptoRng,

Creates a new Token, using hashing to derive a TokenPreimage and a random blind

pub fn blind(&self) -> BlindedToken

Blinds the Token, returning a BlindedToken to be sent to the server.

pub(crate) fn unblind( &self, Q: &SignedToken ) -> Result<UnblindedToken, TokenError>

Using the blinding factor of the original Token, unblind a SignedToken returned from the server.

Returns a TokenError if the SignedToken point is not valid.

pub fn to_bytes(&self) -> [u8; 96]

Convert this Token to a byte array.

fn bytes_length_error() -> TokenError

pub fn from_bytes(bytes: &[u8]) -> Result<Token, TokenError>

Construct a Token from a slice of bytes.

Trait Implementations

impl Clone for Token

fn clone(&self) -> Token

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Token

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

Formats the value using the given formatter.

impl Drop for Token

Overwrite the token blinding factor with null when it goes out of scope.

fn drop(&mut self)

Executes the destructor for this type.