Struct diem_crypto::hkdf::Hkdf

pub struct Hkdf<D> where
    D: Update + BlockInput + FixedOutput + Reset + Default + Clone,
    D::BlockSize: ArrayLength<u8>,
    D::OutputSize: ArrayLength<u8>,
    D::OutputSize: IsGreaterOrEqual<U32, Output = True>,  { /* fields omitted */ }

Structure representing the HKDF, capable of HKDF-Extract and HKDF-Expand operations, as defined in RFC 5869.

Implementations

impl<D> Hkdf<D> where
    D: Update + BlockInput + FixedOutput + Reset + Default + Clone,
    D::BlockSize: ArrayLength<u8> + Clone,
    D::OutputSize: ArrayLength<u8>,
    D::OutputSize: IsGreaterOrEqual<U32, Output = True>, 

pub fn extract(salt: Option<&[u8]>, ikm: &[u8]) -> Result<Vec<u8>, HkdfError>

The RFC5869 HKDF-Extract operation.

pub fn expand(
    prk: &[u8],
    info: Option<&[u8]>,
    length: usize
) -> Result<Vec<u8>, HkdfError>

The RFC5869 HKDF-Expand operation.

pub fn extract_then_expand(
    salt: Option<&[u8]>,
    ikm: &[u8],
    info: Option<&[u8]>,
    length: usize
) -> Result<Vec<u8>, HkdfError>

HKDF Extract then Expand operation as a single step.

pub fn extract_then_expand_no_ikm(
    salt: Option<&[u8]>,
    info: Option<&[u8]>,
    length: usize
) -> Result<Vec<u8>, HkdfError>

CAUTION: This is not recommended because it does not take an ikm (seed) as an input and thus, it is not fully compliant with the HKDF RFC (which always expects a non-zero ikm). Please use extract_then_expand instead, unless you know what you are doing.

This api is currently required by the Noise protocol HKDF specs.

HKDF Extract then Expand operation as a single step, but without an ikm input.

Trait Implementations

impl<D: Clone> Clone for Hkdf<D> where
    D: Update + BlockInput + FixedOutput + Reset + Default + Clone,
    D::BlockSize: ArrayLength<u8>,
    D::OutputSize: ArrayLength<u8>,
    D::OutputSize: IsGreaterOrEqual<U32, Output = True>, 

fn clone(&self) -> Hkdf<D>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<D: Debug> Debug for Hkdf<D> where
    D: Update + BlockInput + FixedOutput + Reset + Default + Clone,
    D::BlockSize: ArrayLength<u8>,
    D::OutputSize: ArrayLength<u8>,
    D::OutputSize: IsGreaterOrEqual<U32, Output = True>, 

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

Formats the value using the given formatter.