Struct elliptic_curve::ecdh::SharedSecret

pub struct SharedSecret<C: Curve + Arithmetic> { /* fields omitted */ }

This is supported on feature="ecdh" only.

Shared secret value computed via ECDH key agreement.

This value contains the raw serialized x-coordinate of the elliptic curve point computed from a Diffie-Hellman exchange.

⚠️ WARNING: NOT UNIFORMLY RANDOM! ⚠️

This value is not uniformly random and should not be used directly as a cryptographic key for anything which requires that property (e.g. symmetric ciphers).

Instead, the resulting value should be used as input to a Key Derivation Function (KDF) or cryptographic hash function to produce a symmetric key.

Implementations

impl<C> SharedSecret<C> where
    C: Curve + Arithmetic,
    C::AffinePoint: Zeroize,
    C::ElementSize: Add<U1>,
    <C::ElementSize as Add>::Output: Add<U1>,
    UncompressedPointSize<C>: ArrayLength<u8>, 

pub fn as_bytes(&self) -> &ElementBytes<C>

This is supported on feature="ecdh" only.

Shared secret value, serialized as bytes.

As noted in the comments for this struct, this value is non-uniform and should not be used directly as a symmetric encryption key, but instead as input to a KDF (or failing that, a hash function) used to produce a symmetric key.

Trait Implementations

impl<C> Drop for SharedSecret<C> where
    C: Curve + Arithmetic, 

fn drop(&mut self)

Executes the destructor for this type.

impl<C> Zeroize for SharedSecret<C> where
    C: Curve + Arithmetic, 

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.