hpke-dispatch 0.9.0

Runtime algorithm selection for hybrid public key encryption
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

use std::str::FromStr;

use num_enum::TryFromPrimitive;

use crate::IdLookupError;

/// A key derivation function used in HPKE.
///
/// Codepoints are defined in [RFC9180ยง7.2][1] and [draft-ietf-hpke-pq][2].
///
/// [1]: https://www.rfc-editor.org/rfc/rfc9180.html#section-7.2
/// [2]: https://www.ietf.org/archive/id/draft-ietf-hpke-pq-05.html#table-1
#[non_exhaustive]
#[repr(u16)]
#[derive(Copy, Clone, Debug, PartialEq, Eq, TryFromPrimitive)]
#[cfg_attr(
    feature = "serde",
    derive(serde_crate::Serialize, serde_crate::Deserialize)
)]
#[cfg_attr(feature = "serde", serde(crate = "serde_crate"))]
pub enum Kdf {
    /// Sha256 [RFC5869](https://www.rfc-editor.org/info/rfc5869)
    #[cfg(feature = "hkdfsha2")]
    Sha256 = 0x0001,
    /// Sha384 [RFC5869](https://www.rfc-editor.org/info/rfc5869)
    #[cfg(feature = "hkdfsha2")]
    Sha384 = 0x0002,
    /// Sha512 [RFC5869](https://www.rfc-editor.org/info/rfc5869)
    #[cfg(feature = "hkdfsha2")]
    Sha512 = 0x0003,
    /// SHAKE128 [FIPS 202](https://csrc.nist.gov/pubs/fips/202/final)
    #[cfg(feature = "shake")]
    Shake128 = 0x0010,
    /// SHAKE256 [FIPS 202](https://csrc.nist.gov/pubs/fips/202/final)
    #[cfg(feature = "shake")]
    Shake256 = 0x0011,
    /// TurboSHAKE128 [RFC 9861](https://www.rfc-editor.org/info/rfc9861/)
    #[cfg(feature = "shake")]
    TurboShake128 = 0x0012,
    /// TurboSHAKE256 [RFC 9861](https://www.rfc-editor.org/info/rfc9861/)
    #[cfg(feature = "shake")]
    TurboShake256 = 0x0013,
}

impl FromStr for Kdf {
    type Err = IdLookupError;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        match &*s.to_lowercase().replace('-', "") {
            #[cfg(feature = "hkdfsha2")]
            "hkdfsha256" | "sha256" => Ok(Self::Sha256),
            #[cfg(feature = "hkdfsha2")]
            "hkdfsha384" | "sha384" => Ok(Self::Sha384),
            #[cfg(feature = "hkdfsha2")]
            "hkdfsha512" | "sha512" => Ok(Self::Sha512),
            #[cfg(feature = "shake")]
            "shake128" => Ok(Self::Shake128),
            #[cfg(feature = "shake")]
            "shake256" => Ok(Self::Shake256),
            #[cfg(feature = "shake")]
            "turboshake128" => Ok(Self::TurboShake128),
            #[cfg(feature = "shake")]
            "turboshake256" => Ok(Self::TurboShake256),
            _ => Err(IdLookupError("kdf not recognized")),
        }
    }
}

/// An iterable slice of [`Kdf`] variants
pub const KDF_ALL: &[Kdf] = &[
    #[cfg(feature = "hkdfsha2")]
    Kdf::Sha256,
    #[cfg(feature = "hkdfsha2")]
    Kdf::Sha384,
    #[cfg(feature = "hkdfsha2")]
    Kdf::Sha512,
    #[cfg(feature = "shake")]
    Kdf::Shake128,
    #[cfg(feature = "shake")]
    Kdf::Shake256,
    #[cfg(feature = "shake")]
    Kdf::TurboShake128,
    #[cfg(feature = "shake")]
    Kdf::TurboShake256,
];