Struct magic_wormhole::Key

source · [−]

pub struct Key<P: KeyPurpose>(pub Box<Key>, _);

Expand description

The symmetric encryption key used to communicate with the other side.

You don’t need to do any crypto, but you might need it to derive subkeys for sub-protocols.

Tuple Fields

0: Box<Key>

Implementations

source

impl Key<WormholeKey>

source

pub fn derive_transit_key(&self, appid: &AppID) -> Key<TransitKey>

Derive the sub-key used for transit

This one’s a bit special, since the Wormhole’s AppID is included in the purpose. Different kinds of applications can’t talk to each other, not even accidentally, by design.

The new key is derived with the "{appid}/transit-key" purpose.

source

pub fn derive_subkey_from_purpose<NewP: KeyPurpose>(
&self,
purpose: &str
) -> Key<NewP>

Derive a new sub-key from this one

Trait Implementations

source

impl<P: Clone + KeyPurpose> Clone for Key

source

fn clone(&self) -> Key

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

source

impl<P: Debug + KeyPurpose> Debug for Key

source

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

Formats the value using the given formatter. Read more

source

impl<P: KeyPurpose> Deref for Key where
Box<Key>: Deref,

type Target = <Box<GenericArray<u8, <Salsa<R20> as NewCipher>::KeySize>, Global> as Deref>::Target

The resulting type after dereferencing.

source

fn deref(&self) -> &Self::Target

Dereferences the value.

source

impl<P: KeyPurpose> Display for Key

source

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

Formats the value using the given formatter. Read more

Auto Trait Implementations

impl RefUnwindSafe for Key where
P: RefUnwindSafe,

impl Send for Key where
P: Send,

impl Sync for Key where
P: Sync,

impl Unpin for Key where
P: Unpin,

impl UnwindSafe for Key where
P: UnwindSafe,

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,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

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

const: unstable · source

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

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

source

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

const: unstable · 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<T> for T

type Output = T

Should always be Self

source

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

source

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

source

fn clone_into(&self, target: &mut T)

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

source

impl<T> ToString for T where
T: Display + ?Sized,

source

default fn to_string(&self) -> String

Converts the given value to a String. Read more

source

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

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

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

Performs the conversion.

source

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

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

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

Performs the conversion.

Struct magic_wormhole::Key

Tuple Fields

Implementations

impl Key<WormholeKey>

pub fn derive_transit_key(&self, appid: &AppID) -> Key<TransitKey>

impl<P: KeyPurpose> Key<P>

pub fn new(key: Box<Key>) -> Self

pub fn to_hex(&self) -> String

pub fn derive_subkey_from_purpose<NewP: KeyPurpose>( &self, purpose: &str) -> Key<NewP>

Trait Implementations

impl<P: Clone + KeyPurpose> Clone for Key<P>

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

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

impl<P: Debug + KeyPurpose> Debug for Key<P>

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

impl<P: KeyPurpose> Deref for Key<P> where Box<Key>: Deref,

type Target = <Box<GenericArray<u8, <Salsa<R20> as NewCipher>::KeySize>, Global> as Deref>::Target

fn deref(&self) -> &Self::Target

impl<P: KeyPurpose> Display for Key<P>

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

Auto Trait Implementations

impl<P> RefUnwindSafe for Key<P> where P: RefUnwindSafe,

impl<P> Send for Key<P> where P: Send,

impl<P> Sync for Key<P> where P: Sync,

impl<P> Unpin for Key<P> where P: Unpin,

impl<P> UnwindSafe for Key<P> where P: UnwindSafe,

Blanket Implementations

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

fn type_id(&self) -> TypeId

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

fn borrow(&self) -> &T

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

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

impl<T> From<T> for T

fn from(t: T) -> T

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

fn into(self) -> U

impl<T> Same<T> for T

type Output = T

impl<T> ToOwned for T where T: Clone,

type Owned = T

fn to_owned(&self) -> T

fn clone_into(&self, target: &mut T)

impl<T> ToString for T where T: Display + ?Sized,

default fn to_string(&self) -> String

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

type Error = Infallible

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

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

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

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

impl<V, T> VZip<V> for T where V: MultiLane<T>,

fn vzip(self) -> V

pub fn derive_subkey_from_purpose<NewP: KeyPurpose>(
&self,
purpose: &str
) -> Key<NewP>

impl<P: KeyPurpose> Deref for Key<P> where
Box<Key>: Deref,

impl<P> RefUnwindSafe for Key<P> where
P: RefUnwindSafe,

impl<P> Send for Key<P> where
P: Send,

impl<P> Sync for Key<P> where
P: Sync,

impl<P> Unpin for Key<P> where
P: Unpin,

impl<P> UnwindSafe for Key<P> where
P: UnwindSafe,

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

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

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

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

impl<T> ToOwned for T where
T: Clone,

impl<T> ToString for T where
T: Display + ?Sized,

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

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

impl<V, T> VZip<V> for T where
V: MultiLane<T>,