Struct vrf_mod::vrf::VRF

pub struct VRF { /* private fields */ }

Implementations

impl VRF

pub fn from_suite(suite: VRFCipherSuite) -> Result<Self, Error>

Associated function to initialize a VRF structure with an initialized context for the given cipher suite.

Arguments:

• suite: Identifying ciphersuite

Returns:

• a VRF struct if successful

pub fn rsasp1(
    &mut self,
    secret_key: &Rsa<Private>,
    message: &BigNum
) -> Result<BigNum, Error>

RSASP1 signature primitive defined in Section 5.2.1 of [RFC8017]

Arguments:

• secret_key: Rsa private key
• message: BigNum message representation

Returns:

• a signature representative

pub fn rsavp1(
    &mut self,
    public_key: &Rsa<Public>,
    signature: &BigNum
) -> Result<BigNum, Error>

RSAVP1 verification primitive defined in Section 5.2.2 of [RFC8017]

Arguments:

• public_key: Rsa public key
• signature: signed message to extract

Returns:

• a BigNum representing the message extracted from the signature

pub fn mgf1(&mut self, mgf_seed: &[u8], mask_len: usize) -> Result<Vec<u8>, Error>

MGF1 mask generation function based on the hash function hash as defined in Section B.2.1 of [RFC8017]

Arguments:

• mgf_seed: seed from which mask is generated, an octet string
• mask_len: intended length in octets of the mask; max length 2 ^ 32

Returns:

• an octet string of length mask_len

Trait Implementations

impl VRF for VRF

fn prove(
    &mut self,
    secret_key: &Rsa<Private>,
    alpha_string: &[u8]
) -> Result<Vec<u8>, Error>

RSA-FDH-VRF prooving algorithm as defined in Section 4.1 of VRF-draft-05

Arguments:

• secret_key: RSA private key
• alpha_string: VRF hash input, an octet string

Returns:

• pi_string: proof, an octet string of length k

fn proof_to_hash(&mut self, pi_string: &[u8]) -> Result<Vec<u8>, Error>

RSA-FDH-VRF proof to hash algorithm as defined in Section 4.2 of VRF-draft-05

Arguments:

• pi_string: proof, an octet string of length k

Returns:

• beta_string: VRF hash output, an octet string of length hLen

fn verify(
    &mut self,
    public_key: &Rsa<Public>,
    alpha_string: &[u8],
    pi_string: &[u8]
) -> Result<Vec<u8>, Error>

RSA-FDH-VRF verifying algorithm as defined in Section 4.3 of VRF-draft-05

Arguments:

• public_key: RSA public key
• alpha_string: VRF hash input, an octet string
• pi_string: proof to be verified, an octet string of length n

Returns:

• beta_string: VRF hash output, an octet string of length hLen

type Error = Error