Struct xxxdh::protocol::Protocol

source · [−]

pub struct Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
    SK: SecretKey,
    ESK: SecretKey,
    SIG: Signature,
    S: ProtocolStorage<SK, SK::PK, SIG>,
    KDF: Kdf,
    CIPHER: Aead,  {
    pub storage: S,
    /* private fields */
}

Expand description

X3DH Protocol.

Fields

storage: S

Protocol key storage.

Implementations

source

impl<SK, ESK, SIG, S, KDF, CIPHER> Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
 SK: SecretKey + DiffieHellman<PK = <SK as SecretKey>::PK> + From<ESK>,
 <SK as SecretKey>::PK: ToVec + Verify<SIG = SIG>,
 ESK: SecretKey + Generate,
 SIG: Signature,
 S: ProtocolStorage<SK, <SK as SecretKey>::PK, SIG>,
 KDF: Kdf,
 <SK as DiffieHellman>::SSK: ToVec,
 CIPHER: Aead,
 XxxDhError: From<<<SK as SecretKey>::PK as Verify>::E> + From<<CIPHER as Aead>::E> + From<<KDF as Kdf>::E>,

source

pub fn new(
 identity_keypair: KeyPair<SK>,
 prekey_keypair: KeyPair<SK>,
 prekey_signature: SIG,
 onetime_keypairs: Option<Vec<KeyPair<SK>>>
) -> Self

source

pub fn prepare_init_msg(
 &mut self,
 receiver_identity: &<SK as SecretKey>::PK,
 receiver_prekey: &<SK as SecretKey>::PK,
 receiver_prekey_signature: &SIG,
 receiver_onetime_key: &<SK as SecretKey>::PK
) -> Result<(<SK as SecretKey>::PK, <SK as SecretKey>::PK, <SK as SecretKey>::PK, Vec<u8>, Vec<u8>, Vec<u8>), XxxDhError>

Derive secret key and create initial message using receiver’s keys.

source

pub fn derive_shared_secret(
 &mut self,
 sender_identity: &<SK as SecretKey>::PK,
 sender_ephemeral_key: &<SK as SecretKey>::PK,
 receiver_onetime_key: &<SK as SecretKey>::PK,
 nonce: &[u8 ],
 ciphertext: &[u8 ]
) -> Result<Vec<u8>, XxxDhError>

Derive secret key from sender’s message.

Auto Trait Implementations

impl<SK, ESK, SIG, S, KDF, CIPHER> RefUnwindSafe for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
 CIPHER: RefUnwindSafe,
 ESK: RefUnwindSafe,
 KDF: RefUnwindSafe,
 S: RefUnwindSafe,
 SIG: RefUnwindSafe,
 SK: RefUnwindSafe,

impl<SK, ESK, SIG, S, KDF, CIPHER> Send for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
 CIPHER: Send,
 ESK: Send,
 KDF: Send,
 S: Send,
 SIG: Send,
 SK: Send,

impl<SK, ESK, SIG, S, KDF, CIPHER> Sync for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
 CIPHER: Sync,
 ESK: Sync,
 KDF: Sync,
 S: Sync,
 SIG: Sync,
 SK: Sync,

impl<SK, ESK, SIG, S, KDF, CIPHER> Unpin for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
 CIPHER: Unpin,
 ESK: Unpin,
 KDF: Unpin,
 S: Unpin,
 SIG: Unpin,
 SK: Unpin,

impl<SK, ESK, SIG, S, KDF, CIPHER> UnwindSafe for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
 CIPHER: UnwindSafe,
 ESK: UnwindSafe,
 KDF: UnwindSafe,
 S: UnwindSafe,
 SIG: UnwindSafe,
 SK: 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, 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 xxxdh::protocol::Protocol

Fields

Implementations

pub fn new(
    identity_keypair: KeyPair<SK>,
    prekey_keypair: KeyPair<SK>,
    prekey_signature: SIG,
    onetime_keypairs: Option<Vec<KeyPair<SK>>>
) -> Self

pub fn derive_shared_secret(
    &mut self,
    sender_identity: &<SK as SecretKey>::PK,
    sender_ephemeral_key: &<SK as SecretKey>::PK,
    receiver_onetime_key: &<SK as SecretKey>::PK,
    nonce: &[u8 ],
    ciphertext: &[u8 ]
) -> Result<Vec<u8>, XxxDhError>

Auto Trait Implementations

impl<SK, ESK, SIG, S, KDF, CIPHER> RefUnwindSafe for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
    CIPHER: RefUnwindSafe,
    ESK: RefUnwindSafe,
    KDF: RefUnwindSafe,
    S: RefUnwindSafe,
    SIG: RefUnwindSafe,
    SK: RefUnwindSafe,

impl<SK, ESK, SIG, S, KDF, CIPHER> Send for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
    CIPHER: Send,
    ESK: Send,
    KDF: Send,
    S: Send,
    SIG: Send,
    SK: Send,

impl<SK, ESK, SIG, S, KDF, CIPHER> Sync for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
    CIPHER: Sync,
    ESK: Sync,
    KDF: Sync,
    S: Sync,
    SIG: Sync,
    SK: Sync,

impl<SK, ESK, SIG, S, KDF, CIPHER> Unpin for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
    CIPHER: Unpin,
    ESK: Unpin,
    KDF: Unpin,
    S: Unpin,
    SIG: Unpin,
    SK: Unpin,

impl<SK, ESK, SIG, S, KDF, CIPHER> UnwindSafe for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
    CIPHER: UnwindSafe,
    ESK: UnwindSafe,
    KDF: UnwindSafe,
    S: UnwindSafe,
    SIG: UnwindSafe,
    SK: 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, 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

Struct xxxdh::protocol::Protocol

Fields

Implementations

pub fn new( identity_keypair: KeyPair<SK>, prekey_keypair: KeyPair<SK>, prekey_signature: SIG, onetime_keypairs: Option<Vec<KeyPair<SK>>>) -> Self

pub fn derive_shared_secret( &mut self, sender_identity: &<SK as SecretKey>::PK, sender_ephemeral_key: &<SK as SecretKey>::PK, receiver_onetime_key: &<SK as SecretKey>::PK, nonce: &[u8], ciphertext: &[u8]) -> Result<Vec<u8>, XxxDhError>

Auto Trait Implementations

impl<SK, ESK, SIG, S, KDF, CIPHER> RefUnwindSafe for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where CIPHER: RefUnwindSafe, ESK: RefUnwindSafe, KDF: RefUnwindSafe, S: RefUnwindSafe, SIG: RefUnwindSafe, SK: RefUnwindSafe,

impl<SK, ESK, SIG, S, KDF, CIPHER> Send for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where CIPHER: Send, ESK: Send, KDF: Send, S: Send, SIG: Send, SK: Send,

impl<SK, ESK, SIG, S, KDF, CIPHER> Sync for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where CIPHER: Sync, ESK: Sync, KDF: Sync, S: Sync, SIG: Sync, SK: Sync,

impl<SK, ESK, SIG, S, KDF, CIPHER> Unpin for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where CIPHER: Unpin, ESK: Unpin, KDF: Unpin, S: Unpin, SIG: Unpin, SK: Unpin,

impl<SK, ESK, SIG, S, KDF, CIPHER> UnwindSafe for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where CIPHER: UnwindSafe, ESK: UnwindSafe, KDF: UnwindSafe, S: UnwindSafe, SIG: UnwindSafe, SK: 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, 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 new(
identity_keypair: KeyPair<SK>,
prekey_keypair: KeyPair<SK>,
prekey_signature: SIG,
onetime_keypairs: Option<Vec<KeyPair<SK>>>
) -> Self

pub fn derive_shared_secret(
&mut self,
sender_identity: &<SK as SecretKey>::PK,
sender_ephemeral_key: &<SK as SecretKey>::PK,
receiver_onetime_key: &<SK as SecretKey>::PK,
nonce: &[u8 ],
ciphertext: &[u8 ]
) -> Result<Vec<u8>, XxxDhError>

impl<SK, ESK, SIG, S, KDF, CIPHER> RefUnwindSafe for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
CIPHER: RefUnwindSafe,
ESK: RefUnwindSafe,
KDF: RefUnwindSafe,
S: RefUnwindSafe,
SIG: RefUnwindSafe,
SK: RefUnwindSafe,

impl<SK, ESK, SIG, S, KDF, CIPHER> Send for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
CIPHER: Send,
ESK: Send,
KDF: Send,
S: Send,
SIG: Send,
SK: Send,

impl<SK, ESK, SIG, S, KDF, CIPHER> Sync for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
CIPHER: Sync,
ESK: Sync,
KDF: Sync,
S: Sync,
SIG: Sync,
SK: Sync,

impl<SK, ESK, SIG, S, KDF, CIPHER> Unpin for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
CIPHER: Unpin,
ESK: Unpin,
KDF: Unpin,
S: Unpin,
SIG: Unpin,
SK: Unpin,

impl<SK, ESK, SIG, S, KDF, CIPHER> UnwindSafe for Protocol<SK, ESK, SIG, S, KDF, CIPHER> where
CIPHER: UnwindSafe,
ESK: UnwindSafe,
KDF: UnwindSafe,
S: UnwindSafe,
SIG: UnwindSafe,
SK: 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, 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>,