Struct tor_llcrypto::pk::curve25519::EphemeralSecret

pub struct EphemeralSecret(_);

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 by EphemeralSecret::new and 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>(csprng: T) -> EphemeralSecret where
    T: RngCore + CryptoRng, 

Generate an x25519 EphemeralSecret key.

Trait Implementations

impl Drop for EphemeralSecret

fn drop(&mut self)

Executes the destructor for this type.

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.