Struct CompressedDecapsulationKey 

pub struct CompressedDecapsulationKey(/* private fields */);

Compressed form of the decapsulation key (32-byte seed).

Since keypair generation from a seed is deterministic, the seed is sufficient to reconstruct the full DecapsulationKey (and its corresponding EncapsulationKey). This reduces storage from 1763 bytes to 32 bytes.

Security: The seed is equivalent to the full secret key. It must be kept secret and protected with the same care. Zeroized on drop.

Implementations

impl CompressedDecapsulationKey

pub fn generate(rng: impl CryptoRng) -> Self

Generates a random compressed decapsulation key.

Example

use sntrup761::*;
let csk = CompressedDecapsulationKey::generate(rand::rng());
let (pk, sk) = csk.expand();

pub fn expand(&self) -> (EncapsulationKey, DecapsulationKey)

Expands this seed into the full keypair.

impl CompressedDecapsulationKey

pub fn decapsulate(&self, cstr: &Ciphertext) -> SharedSecret

Convenience: expands the key and decapsulates in one step.

This recomputes the full decapsulation key each time. If decapsulating multiple ciphertexts, use expand once and call DecapsulationKey::decapsulate on each.

Trait Implementations

impl AsRef<[u8]> for CompressedDecapsulationKey

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for CompressedDecapsulationKey

fn clone(&self) -> CompressedDecapsulationKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ConstantTimeEq for CompressedDecapsulationKey

fn ct_eq(&self, other: &Self) -> Choice

Determine if two items are equal.

fn ct_ne(&self, other: &Self) -> Choice

Determine if two items are NOT equal.

impl Debug for CompressedDecapsulationKey

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

Formats the value using the given formatter.

impl Drop for CompressedDecapsulationKey

fn drop(&mut self)

Executes the destructor for this type.

impl From<[u8; 32]> for CompressedDecapsulationKey

fn from(arr: [u8; 32]) -> Self

Converts to this type from the input type.

impl PartialEq for CompressedDecapsulationKey

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryFrom<&[u8]> for CompressedDecapsulationKey

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: &[u8]) -> Result<Self, Self::Error>

Performs the conversion.

impl Zeroize for CompressedDecapsulationKey

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.

impl Eq for CompressedDecapsulationKey