reallyme-crypto-hpke 0.3.16

ReallyMe RFC 9180 HPKE protocol wrapper.
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

// SPDX-FileCopyrightText: 2026 ReallyMe LLC
//
// SPDX-License-Identifier: MIT OR Apache-2.0

#![doc = include_str!("../README.md")]
#![forbid(unsafe_code)]

mod constants;
#[cfg(feature = "backend-native")]
#[macro_use]
mod dispatch;
#[cfg(any(feature = "kem-secp256k1", feature = "kem-x448"))]
mod dhkem;
mod error;
#[cfg(feature = "backend-native")]
mod export;
mod identifiers;
#[cfg(feature = "backend-native")]
mod keypair;
#[cfg(feature = "kem-ml-kem-1024-p384")]
mod mlkem1024p384;
#[cfg(feature = "kem-ml-kem-512")]
mod mlkem512;
#[cfg(feature = "backend-native")]
mod random;
#[cfg(feature = "backend-native")]
mod seal;
#[cfg(feature = "kem-secp256k1")]
mod secp256k1;
#[cfg(feature = "backend-native")]
mod setup_receiver;
#[cfg(feature = "backend-native")]
mod setup_sender;
mod types;
mod validation;
#[cfg(feature = "kem-x448")]
mod x448;

pub use constants::{
    HPKE_AEAD_AES_128_GCM, HPKE_AEAD_AES_256_GCM, HPKE_AEAD_CHACHA20_POLY1305,
    HPKE_AEAD_EXPORT_ONLY, HPKE_AEAD_NONCE_LEN, HPKE_AEAD_TAG_LEN, HPKE_ENCAPSULATED_KEY_MAX_LEN,
    HPKE_KDF_HKDF_SHA256, HPKE_KDF_HKDF_SHA384, HPKE_KDF_HKDF_SHA512, HPKE_KDF_SHAKE128,
    HPKE_KDF_SHAKE256, HPKE_KDF_TURBO_SHAKE128, HPKE_KDF_TURBO_SHAKE256,
    HPKE_KEM_DHKEM_CP256_HKDF_SHA256, HPKE_KEM_DHKEM_CP384_HKDF_SHA384,
    HPKE_KEM_DHKEM_CP521_HKDF_SHA512, HPKE_KEM_DHKEM_P256_HKDF_SHA256,
    HPKE_KEM_DHKEM_P384_HKDF_SHA384, HPKE_KEM_DHKEM_P521_HKDF_SHA512,
    HPKE_KEM_DHKEM_SECP256K1_HKDF_SHA256, HPKE_KEM_DHKEM_X25519_ELLIGATOR_HKDF_SHA256,
    HPKE_KEM_DHKEM_X25519_HKDF_SHA256, HPKE_KEM_DHKEM_X448_HKDF_SHA512, HPKE_KEM_ML_KEM_1024,
    HPKE_KEM_ML_KEM_1024_P384, HPKE_KEM_ML_KEM_512, HPKE_KEM_ML_KEM_768, HPKE_KEM_ML_KEM_768_P256,
    HPKE_KEM_X25519_KYBER768_DRAFT00, HPKE_KEM_X_WING, HPKE_MIN_PSK_LEN, HPKE_P256_PRIVATE_KEY_LEN,
    HPKE_P256_PUBLIC_KEY_LEN, HPKE_P384_PRIVATE_KEY_LEN, HPKE_P384_PUBLIC_KEY_LEN,
    HPKE_P521_PRIVATE_KEY_LEN, HPKE_P521_PUBLIC_KEY_LEN, HPKE_PRIVATE_KEY_MAX_LEN,
    HPKE_PUBLIC_KEY_MAX_LEN, HPKE_SECP256K1_PRIVATE_KEY_LEN, HPKE_SECP256K1_PUBLIC_KEY_LEN,
    HPKE_X25519_PRIVATE_KEY_LEN, HPKE_X25519_PUBLIC_KEY_LEN, HPKE_X448_PRIVATE_KEY_LEN,
    HPKE_X448_PUBLIC_KEY_LEN,
};
pub use error::HpkeError;
#[cfg(all(feature = "backend-native", feature = "test-vectors"))]
pub use export::sender_export_derand;
#[cfg(feature = "backend-native")]
pub use export::{receiver_export, sender_export};
pub use identifiers::{
    HpkeAeadId, HpkeComponentSupport, HpkeKdfId, HpkeKemId, HpkeSuite,
    MLS_128_MLKEM768X25519_AES256GCM_SHA384_Ed25519, HPKE_DHKEM_P256_HKDF_SHA256_AES128GCM,
    HPKE_DHKEM_P256_HKDF_SHA256_AES256GCM, HPKE_DHKEM_P384_HKDF_SHA384_AES256GCM,
    HPKE_DHKEM_P521_HKDF_SHA512_AES256GCM, HPKE_DHKEM_X25519_HKDF_SHA256_AES128GCM,
    HPKE_DHKEM_X25519_HKDF_SHA256_CHACHA20POLY1305, HPKE_MLKEM1024P384_HKDF_SHA384_AES256GCM,
    HPKE_MLKEM1024P384_SHAKE256_AES256GCM, HPKE_MLKEM1024_HKDF_SHA384_AES256GCM,
    HPKE_MLKEM1024_SHAKE256_AES256GCM, HPKE_MLKEM512_HKDF_SHA256_AES128GCM,
    HPKE_MLKEM768P256_SHAKE256_AES256GCM, HPKE_MLKEM768_HKDF_SHA384_AES256GCM,
    HPKE_MLKEM768_SHAKE256_AES256GCM, HPKE_REGISTERED_AEADS, HPKE_REGISTERED_KDFS,
    HPKE_REGISTERED_KEMS, HPKE_XWING_HKDF_SHA256_CHACHA20POLY1305,
    HPKE_XWING_HKDF_SHA384_AES256GCM, MLS_192_MLKEM1024P384_AES256GCM_SHA384_P384,
    MLS_192_MLKEM1024_AES256GCM_SHA384_P384, MLS_192_MLKEM768_AES256GCM_SHA384_MLDSA65,
    MLS_256_MLKEM1024_AES256GCM_SHA384_MLDSA87,
};
#[cfg(feature = "backend-native")]
pub use keypair::{derive_keypair, derive_keypair_from_ikm, keygen};
#[cfg(all(feature = "backend-native", feature = "test-vectors"))]
pub use seal::seal_base_derand;
#[cfg(feature = "backend-native")]
pub use seal::{open_base, open_psk, seal_base, seal_psk};
#[cfg(feature = "backend-native")]
pub use setup_receiver::{setup_receiver_psk, HpkePskReceiverSetupRequest, HpkeReceiverContext};
#[cfg(feature = "backend-native")]
pub use setup_sender::{
    setup_sender_psk, HpkePskSenderContext, HpkePskSenderSetupOutput, HpkePskSenderSetupRequest,
    HpkeSenderContext,
};
#[cfg(all(feature = "backend-native", feature = "test-vectors"))]
pub use setup_sender::{setup_sender_psk_derand, HpkeDerandPskSenderSetupRequest};
#[cfg(feature = "test-vectors")]
pub use types::{HpkeDerandSealRequest, HpkeDerandSenderExportRequest};
pub use types::{
    HpkeExporterSecret, HpkeKeyPair, HpkeOpenOutput, HpkeOpenRequest, HpkePrivateKeyBytes,
    HpkePskIdRef, HpkePskOpenRequest, HpkePskRef, HpkePskSealRequest, HpkeReceiverExportRequest,
    HpkeSealOutput, HpkeSealRequest, HpkeSenderExportOutput, HpkeSenderExportRequest,
};