vitaminc-aead 0.7.0

Authenticated Encryption with Associated Data (AEAD) primitives. Part of the Vitamin-C cryptographic suite.
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

/// The opaque error of a cipher: it reveals nothing about what failed.
///
/// It is crucial when returning an error from a cipher operation that it
/// does not reveal any details about the failure, as those can lead to side
/// channel attacks: a wrong key, a wrong AAD and a tampered leaf are
/// indistinguishable.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct Unspecified;

impl std::fmt::Display for Unspecified {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "Unspecified error")
    }
}

impl std::error::Error for Unspecified {}

#[cfg(test)]
mod tests {
    use super::Unspecified;

    #[test]
    fn the_message_says_only_that_something_failed() {
        assert_eq!(Unspecified.to_string(), "Unspecified error");
    }
}