1mod keystore;
2mod leaf;
3mod mls;
4mod proteus;
5mod recursive;
6mod wrapper;
7
8pub use keystore::KeystoreError;
9pub use leaf::LeafError;
10pub use mls::{MlsError, MlsErrorKind};
11pub use proteus::{ProteusError, ProteusErrorKind};
12pub use recursive::{RecursiveError, ToRecursiveError};
13
14pub type Result<T, E = Error> = core::result::Result<T, E>;
16
17#[derive(Debug, thiserror::Error)]
19pub enum Error {
20 #[error("This transaction context has already been finished and can no longer be used.")]
22 InvalidTransactionContext,
23 #[error("Proteus client hasn't been initialized")]
25 ProteusNotInitialized,
26 #[error("The mls transport callbacks needed for CoreCrypto to operate were not set")]
28 MlsTransportNotProvided,
29 #[error("Error during mls transport: {0}")]
31 ErrorDuringMlsTransport(String),
32 #[error("This item requires a feature that the core-crypto library was built without: {0}")]
34 FeatureDisabled(&'static str),
35 #[error(transparent)]
37 Keystore(#[from] KeystoreError),
38 #[error("Invalid history secret: {0}")]
40 InvalidHistorySecret(&'static str),
41 #[error(transparent)]
43 Mls(#[from] MlsError),
44 #[error(transparent)]
46 Proteus(#[from] ProteusError),
47 #[error(transparent)]
49 Recursive(#[from] RecursiveError),
50}
51
52pub trait InnermostErrorMessage {
61 fn innermost_error_message(&self) -> String;
63}
64
65impl<E: std::error::Error> InnermostErrorMessage for E {
66 fn innermost_error_message(&self) -> String {
67 let mut err: &dyn std::error::Error = self;
68 while let Some(source) = err.source() {
69 err = source;
70 }
71 err.to_string()
72 }
73}
74
75#[cfg(test)]
76mod tests {
77 use super::*;
78
79 #[test]
80 fn can_unpack_wrapped_error() {
81 let inner = Error::InvalidTransactionContext;
82 let outer = RecursiveError::root("wrapping the inner for test purposes")(inner);
83 let message = outer.innermost_error_message();
84 assert_eq!(message, Error::InvalidTransactionContext.to_string());
85 }
86}