Struct dryoc::kdf::Kdf

pub struct Kdf<Key: ByteArray<CRYPTO_KDF_KEYBYTES>, Context: ByteArray<CRYPTO_KDF_CONTEXTBYTES>> { /* private fields */ }

Key derivation implementation based on Blake2b, compatible with libsodium’s crypto_kdf_* functions.

Implementations

impl<Key: NewByteArray<CRYPTO_KDF_KEYBYTES>, Context: NewByteArray<CRYPTO_KDF_CONTEXTBYTES>> Kdf<Key, Context>

pub fn gen() -> Self

Randomly generates a new pair of main key and context.

impl<Key: ByteArray<CRYPTO_KDF_KEYBYTES>, Context: ByteArray<CRYPTO_KDF_CONTEXTBYTES>> Kdf<Key, Context>

pub fn derive_subkey<Subkey: NewByteArray<CRYPTO_KDF_KEYBYTES>>(
    &self,
    subkey_id: u64
) -> Result<Subkey, Error>

Derives a subkey for subkey_id, returning it.

pub fn derive_subkey_to_vec(&self, subkey_id: u64) -> Result<Vec<u8>, Error>

Derives a subkey for subkey_id, returning it as a Vec. Provided for convenience.

pub fn from_parts(main_key: Key, context: Context) -> Self

Constructs a new instance from key and context, consuming them both.

pub fn into_parts(self) -> (Key, Context)

Moves the key and context out of this instance, returning them as a tuple.

impl Kdf<Key, Context>

pub fn gen_with_defaults() -> Self

Randomly generates a new pair of main key and context.

Trait Implementations

impl<Key: Clone + ByteArray<CRYPTO_KDF_KEYBYTES>, Context: Clone + ByteArray<CRYPTO_KDF_CONTEXTBYTES>> Clone for Kdf<Key, Context>

fn clone(&self) -> Kdf<Key, Context>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Key: Debug + ByteArray<CRYPTO_KDF_KEYBYTES>, Context: Debug + ByteArray<CRYPTO_KDF_CONTEXTBYTES>> Debug for Kdf<Key, Context>

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

Formats the value using the given formatter.

impl<'de, Key: ByteArray<CRYPTO_KDF_KEYBYTES>, Context: ByteArray<CRYPTO_KDF_CONTEXTBYTES>> Deserialize<'de> for Kdf<Key, Context>where
    Key: Deserialize<'de>,
    Context: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
    __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<Key: ByteArray<CRYPTO_KDF_KEYBYTES>, Context: ByteArray<CRYPTO_KDF_CONTEXTBYTES>> Serialize for Kdf<Key, Context>where
    Key: Serialize,
    Context: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where
    __S: Serializer,

Serialize this value into the given Serde serializer.

impl<Key: ByteArray<CRYPTO_KDF_KEYBYTES>, Context: ByteArray<CRYPTO_KDF_CONTEXTBYTES>> Zeroize for Kdf<Key, Context>where
    Key: Zeroize,
    Context: Zeroize,

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.