aranya-crypto 0.15.0

The Aranya Cryptography Engine
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

#![forbid(unsafe_code)]

use buggy::Bug;
pub use spideroak_crypto::{
    aead::{OpenError, SealError},
    hpke::HpkeError,
    import::{ExportError, ImportError},
    kdf::KdfError,
    kem::{EcdhError, KemError},
    mac::MacError,
    signer::{PkError, SignerError},
};

use crate::{
    engine::{UnwrapError, WrapError},
    id::IdError,
};

/// Encompasses the different errors directly returned by this
/// crate.
#[derive(Debug, Eq, PartialEq, thiserror::Error)]
#[non_exhaustive]
pub enum Error {
    /// An argument was invalid.
    ///
    /// It describes why the argument is invalid.
    #[error("invalid argument: {0}")]
    InvalidArgument(&'static str),
    /// An internal bug was discovered.
    #[error(transparent)]
    Bug(#[from] Bug),

    /// An AEAD seal failure.
    #[error(transparent)]
    Seal(#[from] SealError),
    /// An AEAD open failure.
    #[error(transparent)]
    Open(#[from] OpenError),
    /// An ECDH failure.
    #[error(transparent)]
    Ecdh(#[from] EcdhError),
    /// An HPKE failure.
    #[error(transparent)]
    Hpke(#[from] HpkeError),
    /// A KDF failure.
    #[error(transparent)]
    Kdf(#[from] KdfError),
    /// A KEM failure.
    #[error(transparent)]
    Kem(#[from] KemError),
    /// A MAC failure.
    #[error(transparent)]
    Mac(#[from] MacError),
    /// A digital signature failure.
    #[error(transparent)]
    Signer(#[from] SignerError),
    /// An import failure.
    #[error(transparent)]
    Import(#[from] ImportError),
    /// An export failure.
    #[error(transparent)]
    Export(#[from] ExportError),
    /// A key wrapping failure.
    #[error(transparent)]
    Wrap(#[from] WrapError),
    /// A key unwrapping failure.
    #[error(transparent)]
    Unwrap(#[from] UnwrapError),
    /// An identifier failure.
    #[error(transparent)]
    Id(#[from] IdError),
    /// A public key failure.
    #[error(transparent)]
    Pk(#[from] PkError),
}

#[cfg(feature = "afc")]
impl Error {
    pub(crate) const fn same_device_id() -> Self {
        Self::InvalidArgument("same `DeviceId`")
    }
}