wtx 0.45.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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

use crate::{
  crypto::{Agreement, CryptoError, P256Ring, P384Ring, X25519Ring},
  rng::CryptoRng,
};
use ring::{
  agreement::{
    ECDH_P256, ECDH_P384, EphemeralPrivateKey, PublicKey, UnparsedPublicKey, X25519,
    agree_ephemeral,
  },
  rand::SystemRandom,
};

impl Agreement for P256Ring {
  type EphemeralSecretKey = EphemeralPrivateKey;
  type PublicKey = PublicKey;
  type SharedSecret = [u8; 32];

  #[inline]
  fn diffie_hellman(
    esk: Self::EphemeralSecretKey,
    other_participant_pk: &[u8],
  ) -> crate::Result<Self::SharedSecret> {
    let mut secret = [0u8; _];
    agree_ephemeral(esk, &UnparsedPublicKey::new(&ECDH_P256, other_participant_pk), |value| {
      secret.copy_from_slice(value);
    })
    .map_err(|_err| CryptoError::DiffieHellmanError)?;
    Ok(secret)
  }

  #[inline]
  fn ephemeral_secret_key<RNG>(_: &mut RNG) -> crate::Result<Self::EphemeralSecretKey>
  where
    RNG: CryptoRng,
  {
    Ok(
      EphemeralPrivateKey::generate(&ECDH_P256, &SystemRandom::new())
        .map_err(|_err| CryptoError::EphemeralSecretKeyError)?,
    )
  }

  #[inline]
  fn public_key(esk: &Self::EphemeralSecretKey) -> crate::Result<Self::PublicKey> {
    Ok(esk.compute_public_key().map_err(|_err| CryptoError::PublicKeyAgreementError)?)
  }
}

impl Agreement for P384Ring {
  type EphemeralSecretKey = EphemeralPrivateKey;
  type PublicKey = PublicKey;
  type SharedSecret = [u8; 48];

  #[inline]
  fn diffie_hellman(
    esk: Self::EphemeralSecretKey,
    other_participant_pk: &[u8],
  ) -> crate::Result<Self::SharedSecret> {
    let mut secret = [0u8; _];
    agree_ephemeral(esk, &UnparsedPublicKey::new(&ECDH_P384, other_participant_pk), |value| {
      secret.copy_from_slice(value);
    })
    .map_err(|_err| CryptoError::DiffieHellmanError)?;
    Ok(secret)
  }

  #[inline]
  fn ephemeral_secret_key<RNG>(_: &mut RNG) -> crate::Result<Self::EphemeralSecretKey>
  where
    RNG: CryptoRng,
  {
    Ok(
      EphemeralPrivateKey::generate(&ECDH_P384, &SystemRandom::new())
        .map_err(|_err| CryptoError::EphemeralSecretKeyError)?,
    )
  }

  #[inline]
  fn public_key(esk: &Self::EphemeralSecretKey) -> crate::Result<Self::PublicKey> {
    Ok(esk.compute_public_key().map_err(|_err| CryptoError::PublicKeyAgreementError)?)
  }
}

impl Agreement for X25519Ring {
  type EphemeralSecretKey = EphemeralPrivateKey;
  type PublicKey = PublicKey;
  type SharedSecret = [u8; 32];

  #[inline]
  fn diffie_hellman(
    esk: Self::EphemeralSecretKey,
    other_participant_pk: &[u8],
  ) -> crate::Result<Self::SharedSecret> {
    let mut secret = [0u8; _];
    agree_ephemeral(esk, &UnparsedPublicKey::new(&X25519, other_participant_pk), |value| {
      secret.copy_from_slice(value);
    })
    .map_err(|_err| CryptoError::DiffieHellmanError)?;
    Ok(secret)
  }

  #[inline]
  fn ephemeral_secret_key<RNG>(_: &mut RNG) -> crate::Result<Self::EphemeralSecretKey>
  where
    RNG: CryptoRng,
  {
    Ok(
      EphemeralPrivateKey::generate(&X25519, &SystemRandom::new())
        .map_err(|_err| CryptoError::EphemeralSecretKeyError)?,
    )
  }

  #[inline]
  fn public_key(esk: &Self::EphemeralSecretKey) -> crate::Result<Self::PublicKey> {
    Ok(esk.compute_public_key().map_err(|_err| CryptoError::PublicKeyAgreementError)?)
  }
}