Skip to main content

EphemeralSecret

Struct EphemeralSecret 

Source
pub struct EphemeralSecret(pub(crate) [u8; 32]);
Expand description

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.

Tuple Fields§

§0: [u8; 32]

Implementations§

Source§

impl EphemeralSecret

Source

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.

Source

pub fn random_from_rng<R: CryptoRng + ?Sized>(csprng: &mut R) -> Self

Generate a new EphemeralSecret with the supplied RNG.

Source

pub fn random() -> Self

Generate a new EphemeralSecret.

Trait Implementations§

Source§

impl Drop for EphemeralSecret

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

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

Source§

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

Given an x25519 EphemeralSecret key, compute its corresponding PublicKey.

Source§

impl ZeroizeOnDrop for EphemeralSecret

Available on crate feature zeroize only.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.