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

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

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

/// A mathematical scheme for verifying the authenticity of digital messages or documents.
pub trait Signature {
  /// The structure used to sign messages
  type SignKey: SignKey;
  /// The result of a signing operation
  type SignOutput;

  /// Checks if the `signature` derived from `msg` was signed by `pubkey` .
  fn sign<RNG>(
    rng: &mut RNG,
    sign_key: &mut Self::SignKey,
    msg: &[u8],
  ) -> crate::Result<Self::SignOutput>
  where
    RNG: CryptoRng;

  /// Checks if the `signature` derived from `msg` was signed by `pubkey` .
  fn validate(pk: &[u8], msg: &[u8], signature: &[u8]) -> crate::Result<()>;
}

/// Dummy [`Signature`] implementation used when no backend is enabled.
#[derive(Clone, Copy, Debug, Default, PartialEq)]
pub struct SignatureDummy<SK, SO>(PhantomData<(SK, SO)>);

impl<SK, SO> Signature for SignatureDummy<SK, SO>
where
  SK: SignKey,
  SO: DefaultArray,
{
  type SignKey = SK;
  type SignOutput = SO;

  #[inline]
  fn sign<RNG>(_: &mut RNG, _: &mut Self::SignKey, _: &[u8]) -> crate::Result<Self::SignOutput>
  where
    RNG: CryptoRng,
  {
    dummy_impl_call();
  }

  #[inline]
  fn validate(_: &[u8], _: &[u8], _: &[u8]) -> crate::Result<()> {
    dummy_impl_call();
  }
}