tightbeam-rs 0.8.0

A secure, high-performance messaging protocol library
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

//! Builder-specific errors for CMS handshake construction.

#[cfg(not(feature = "std"))]
extern crate alloc;
#[cfg(not(feature = "std"))]
use alloc::string::ToString;

/// Errors that can occur during KARI builder construction.
#[cfg_attr(feature = "derive", derive(crate::Errorizable))]
#[derive(Debug)]
pub enum KariBuilderError {
	/// Sender private key not set
	#[cfg_attr(feature = "derive", error("Sender private key not set"))]
	MissingSenderPrivateKey,

	/// Sender public key SPKI not set
	#[cfg_attr(feature = "derive", error("Sender public key SPKI not set"))]
	MissingSenderPublicKeySpki,

	/// Recipient public key not set
	#[cfg_attr(feature = "derive", error("Recipient public key not set"))]
	MissingRecipientPublicKey,

	/// Recipient identifier not set
	#[cfg_attr(feature = "derive", error("Recipient identifier not set"))]
	MissingRecipientIdentifier,

	/// User Keying Material (UKM) not set
	#[cfg_attr(feature = "derive", error("User Keying Material (UKM) not set"))]
	MissingUkm,

	/// Key encryption algorithm not set
	#[cfg_attr(feature = "derive", error("Key encryption algorithm not set"))]
	MissingKeyEncryptionAlgorithm,

	/// DER encoding/decoding error
	#[cfg_attr(feature = "derive", error("DER error: {0}"))]
	#[cfg_attr(feature = "derive", from)]
	DerError(crate::der::Error),

	/// CMS builder error
	#[cfg_attr(feature = "derive", error("CMS builder error: {0}"))]
	#[cfg_attr(feature = "derive", from)]
	CmsBuilderError(crate::cms::builder::Error),
}

crate::impl_error_display!(KariBuilderError {
	MissingSenderPrivateKey => "Sender private key not set",
	MissingSenderPublicKeySpki => "Sender public key SPKI not set",
	MissingRecipientPublicKey => "Recipient public key not set",
	MissingRecipientIdentifier => "Recipient identifier not set",
	MissingUkm => "User Keying Material (UKM) not set",
	MissingKeyEncryptionAlgorithm => "Key encryption algorithm not set",
	DerError(e) => "DER error: {e}",
	CmsBuilderError(e) => "CMS builder error: {e}",
});

#[cfg(not(feature = "derive"))]
crate::impl_from!(der::Error => KariBuilderError::DerError);
#[cfg(not(feature = "derive"))]
crate::impl_from!(crate::cms::builder::Error => KariBuilderError::CmsBuilderError);

/// Narrows [`KariBuilderError`] into the foreign [`crate::cms::builder::Error`].
/// `Missing*` config variants lack a structured `cms` counterpart, so collapse
/// into [`Builder`](crate::cms::builder::Error::Builder) via their `Display`.
impl From<KariBuilderError> for crate::cms::builder::Error {
	fn from(err: KariBuilderError) -> Self {
		match err {
			KariBuilderError::DerError(e) => crate::cms::builder::Error::Asn1(e),
			KariBuilderError::CmsBuilderError(e) => e,
			other => crate::cms::builder::Error::Builder(other.to_string()),
		}
	}
}