Struct EphemeralSecret

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

A short-lived Diffie-Hellman secret key that can only be used to compute a single SharedSecret.

This type is identical to the StaticSecret type, except that the EphemeralSecret::diffie_hellman method consumes and then wipes the secret key, and there are no serialization methods defined. This means that EphemeralSecrets can only be generated from fresh randomness where the compiler statically checks that the resulting secret is used at most once.

Implementations

impl EphemeralSecret

pub fn diffie_hellman(self, their_public: &PublicKey) -> SharedSecret

Perform a Diffie-Hellman key agreement between self and their_public key to produce a SharedSecret.

pub fn new<T: RngCore + CryptoRng>(csprng: T) -> Self

👎Deprecated since 2.0.0: Renamed to random_from_rng. This will be removed in 2.1.0

Generate a new EphemeralSecret with the supplied RNG.

pub fn random_from_rng<T: RngCore + CryptoRng>(csprng: T) -> Self

Generate a new EphemeralSecret with the supplied RNG.

Trait Implementations

impl<'a> From<&'a EphemeralSecret> for PublicKey

fn from(secret: &'a EphemeralSecret) -> PublicKey

Given an x25519 EphemeralSecret key, compute its corresponding PublicKey.

impl Zeroize for EphemeralSecret

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.