wtx 0.50.0

A collection of different transport implementations and related tools focused primarily on web technologies.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

#[cfg(feature = "crypto-aws-lc-rs")]
mod aws_lc_rs;
pub(crate) mod global;
#[cfg(feature = "crypto-graviola")]
mod graviola;
#[cfg(feature = "crypto-ring")]
mod ring;
#[cfg(feature = "crypto-ruco")]
mod ruco;

use crate::{crypto::dummy_crypto_call, misc::DefaultArray, rng::CryptoRng};
use core::marker::PhantomData;

/// Temporary single-use secret key.
pub trait Agreement: Sized {
  /// Public key
  type PublicKey: AsRef<[u8]>;
  /// Shared secret
  type SharedSecret: AsRef<[u8]>;

  /// Generates a symmetric cryptographic key.
  fn diffie_hellman(self, other_participant_pk: &[u8]) -> crate::Result<Self::SharedSecret>;

  /// New random ephemeral secret key
  fn generate<RNG>(rng: &mut RNG) -> crate::Result<Self>
  where
    RNG: CryptoRng;

  /// Associated public key of an ephemeral secret
  fn public_key(&self) -> crate::Result<Self::PublicKey>;
}

/// Dummy [`Agreement`] implementation used when no backend is enabled.
#[derive(Clone, Copy, Debug, Default, PartialEq)]
pub struct AgreementDummy<PK, SS>(PhantomData<(PK, SS)>);

impl<PK, SS> Agreement for AgreementDummy<PK, SS>
where
  PK: AsRef<[u8]> + DefaultArray,
  SS: AsRef<[u8]> + DefaultArray,
{
  type PublicKey = PK;
  type SharedSecret = SS;

  #[inline]
  fn generate<RNG>(_: &mut RNG) -> crate::Result<Self>
  where
    RNG: CryptoRng,
  {
    Ok(Self(PhantomData))
  }

  #[inline]
  fn diffie_hellman(self, _: &[u8]) -> crate::Result<Self::SharedSecret> {
    dummy_crypto_call();
  }

  #[inline]
  fn public_key(&self) -> crate::Result<Self::PublicKey> {
    dummy_crypto_call();
  }
}