sframe 1.2.0

pure rust implementation of SFrame (RFC 9605)
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

//! Buffer types for AEAD encryption and decryption operations
//! as defined in [RFC 9605 Section 4.4](https://www.rfc-editor.org/rfc/rfc9605.html#section-4.4).

pub(crate) mod decryption;
pub(crate) mod encryption;

use crate::error::Result;

/// A view into a buffer for AEAD decryption operations.
pub struct DecryptionBufferView<'a> {
    /// The Additional Authenticated Data (AAD).
    pub aad: &'a mut [u8],
    /// The data buffer, transformed in place: on input the ciphertext (including the
    /// authentication tag), on success the decrypted plaintext.
    pub data: &'a mut [u8],
}

/// A view into a buffer for AEAD encryption operations.
pub struct EncryptionBufferView<'a> {
    /// The Additional Authenticated Data (AAD).
    pub aad: &'a mut [u8],
    /// The data buffer, transformed in place: on input the plaintext, on success the ciphertext.
    pub data: &'a mut [u8],
    /// The buffer for the authentication tag.
    pub tag: &'a mut [u8],
}

/// Trait for types that can provide Additional Authenticated Data (AAD)
/// as specified in [RFC 9605 Section 4.4.3](https://www.rfc-editor.org/rfc/rfc9605.html#section-4.4.3).
pub trait AadData {
    /// Returns the length in bytes of the serialized AAD.
    fn len(&self) -> usize;
    /// Returns true if the AAD data is empty.
    fn is_empty(&self) -> bool {
        self.len() == 0
    }
    /// Serializes the AAD into the provided buffer.
    fn serialize(&self, buffer: &mut [u8]) -> Result<()>;
}

impl AadData for Vec<u8> {
    fn len(&self) -> usize {
        self.len()
    }

    fn serialize(&self, buffer: &mut [u8]) -> Result<()> {
        buffer.copy_from_slice(self);
        Ok(())
    }
}

#[cfg(test)]
mod test {
    use super::AadData;
    use crate::error::Result;

    pub(super) struct TestAadData {
        pub data: [u8; 4],
    }

    impl AadData for TestAadData {
        fn len(&self) -> usize {
            self.data.len()
        }

        fn serialize(&self, buffer: &mut [u8]) -> Result<()> {
            buffer.copy_from_slice(&self.data);
            Ok(())
        }
    }
}