Struct challenge_bypass_ristretto::voprf::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 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.