Struct DecapsulationKey 

pub struct DecapsulationKey<P>
where
    P: KemParams,
{ /* private fields */ }

A DecapsulationKey provides the ability to generate a new key pair, and decapsulate an encapsulated shared key.

Implementations

impl<P> DecapsulationKey<P>

where P: KemParams,

pub fn from_seed(seed: Seed) -> Self

Create a DecapsulationKey instance from a 64-byte random seed value.

pub fn to_seed(&self) -> Option<Seed>

Serialize the Seed value: 64-bytes which can be used to reconstruct the DecapsulationKey.

⚠️Warning!

This value is key material. Please treat it with care.

Returns

• Some if the DecapsulationKey was initialized using from_seed or generate.
• None if the DecapsulationKey was initialized from the expanded form.

pub fn encapsulation_key(&self) -> &EncapsulationKey<P>

Get the EncapsulationKey which corresponds to this DecapsulationKey.

Trait Implementations

impl<P> AssociatedAlgorithmIdentifier for DecapsulationKey<P>

where P: KemParams + AssociatedAlgorithmIdentifier<Params = AnyRef<'static>>,

Available on crate feature pkcs8 only.

const ALGORITHM_IDENTIFIER: AlgorithmIdentifier<Self::Params> = P::ALGORITHM_IDENTIFIER

AlgorithmIdentifier for this structure.

type Params = <P as AssociatedAlgorithmIdentifier>::Params

Algorithm parameters.

impl<P> Clone for DecapsulationKey<P>

where P: KemParams + Clone,

fn clone(&self) -> DecapsulationKey<P>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P> Debug for DecapsulationKey<P>

where P: KemParams + Debug,

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

Formats the value using the given formatter.

impl<P> Decapsulate<Array<u8, <P as PkeParams>::CiphertextSize>, Array<u8, UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>>> for DecapsulationKey<P>

where P: KemParams,

type Encapsulator = EncapsulationKey<P>

Encapsulator which corresponds to this decapsulator.

type Error = Infallible

Decapsulation error

fn decapsulate( &self, encapsulated_key: &Array<u8, <P as PkeParams>::CiphertextSize>, ) -> Result<B32, Self::Error>

Decapsulates the given encapsulated key

fn encapsulator(&self) -> EncapsulationKey<P>

Retrieve the encapsulator associated with this decapsulator.

impl<P> Drop for DecapsulationKey<P>

where P: KemParams,

Available on crate feature zeroize only.

fn drop(&mut self)

Executes the destructor for this type.

impl<P> EncodePrivateKey for DecapsulationKey<P>

where P: KemParams + AssociatedAlgorithmIdentifier<Params = AnyRef<'static>>,

Available on crate features pkcs8 and alloc only.

fn to_pkcs8_der(&self) -> Result<SecretDocument>

Serialize the given DecapsulationKey into DER format. Returns a SecretDocument which wraps the DER document in case of success.

fn to_pkcs8_pem( &self, line_ending: LineEnding, ) -> Result<Zeroizing<String>, Error>

Serialize this private key as PEM-encoded PKCS#8 with the given LineEnding.

impl<P> EncodedSizeUser for DecapsulationKey<P>

where P: KemParams,

type EncodedSize = <P as KemParams>::DecapsulationKeySize

The size of an encoded object

fn from_bytes(enc: &Encoded<Self>) -> Self

Parse an object from its encoded form

fn as_bytes(&self) -> Encoded<Self>

Serialize an object to its encoded form

impl<P> From<Array<u8, UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>>> for DecapsulationKey<P>

where P: KemParams,

fn from(seed: Seed) -> Self

Converts to this type from the input type.

impl<P> KeyInit for DecapsulationKey<P>

where P: KemParams,

fn new(seed: &Seed) -> Self

Create new value from fixed size key.

fn weak_key_test(_key: &Array<u8, Self::KeySize>) -> Result<(), WeakKeyError>

Check if the key might be considered weak.

fn new_checked(key: &Array<u8, Self::KeySize>) -> Result<Self, WeakKeyError>

Create new value from fixed size key after checking it for weakness.

fn new_from_slice(key: &[u8]) -> Result<Self, InvalidLength>

Create new value from variable size key.

fn generate_key_with_rng<R>(rng: &mut R) -> Array<u8, Self::KeySize>

where R: CryptoRng + ?Sized,

Generate random key using the provided CryptoRng.

fn try_generate_key_with_rng<R>( rng: &mut R, ) -> Result<Array<u8, Self::KeySize>, <R as TryRngCore>::Error>

where R: TryCryptoRng + ?Sized,

Generate random key using the provided TryCryptoRng.

impl<P> KeySizeUser for DecapsulationKey<P>

where P: KemParams,

type KeySize = UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>

Key size in bytes.

fn key_size() -> usize

Return key size in bytes.

impl<P> PartialEq for DecapsulationKey<P>

where P: KemParams,

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<P> TryFrom<PrivateKeyInfo<AnyRef<'_>, &OctetStringRef, BitStringRef<'_>>> for DecapsulationKey<P>

where P: KemParams + AssociatedAlgorithmIdentifier<Params = AnyRef<'static>>,

Available on crate feature pkcs8 only.

fn try_from( private_key_info_ref: PrivateKeyInfoRef<'_>, ) -> Result<Self, Self::Error>

Deserialize the decapsulation key from DER format found in spki.private_key. Returns a DecapsulationKey containing dk_{pke}, ek, and z in case of success.

type Error = Error

The type returned in the event of a conversion error.

impl<P> ZeroizeOnDrop for DecapsulationKey<P>

where P: KemParams,

Available on crate feature zeroize only.