1use crate::error::{exact_length, Error};
5use crate::path::ObjectPath;
6use coven_crypto::{
7 seal_handover, CryptoError, MemberKeys, SealingKey, KEY_BOX_HEAD_LEN, KEY_BOX_TAG_LEN,
8};
9use coven_foundation::id_source::MemberId;
10use zeroize::Zeroizing;
11
12const KIND: u8 = crate::kinds::HANDOVER;
13const PREFIX_LEN: usize = 3;
14const PLAINTEXT_LEN: usize = 16 + 4 + MemberKeys::SECRET_LEN;
16pub const LENGTH: usize = PREFIX_LEN + KEY_BOX_HEAD_LEN + PLAINTEXT_LEN + KEY_BOX_TAG_LEN;
18
19#[derive(Clone, Debug, PartialEq, Eq)]
24pub struct Handover {
25 sealed: Vec<u8>,
27}
28
29impl Handover {
30 pub fn seal(
33 member: MemberId,
34 keys: &MemberKeys,
35 recipient: &SealingKey,
36 path: &ObjectPath,
37 ) -> Result<Self, CryptoError> {
38 let blob = keys.to_secret_bytes();
39 let mut plaintext = Zeroizing::new(Vec::with_capacity(PLAINTEXT_LEN));
40 plaintext.extend_from_slice(member.0.as_bytes());
41 plaintext.extend_from_slice(&(blob.as_bytes().len() as u32).to_be_bytes());
42 plaintext.extend_from_slice(blob.as_bytes());
43 let prefix = crate::FormatVersion::CURRENT.prefix(KIND);
44 let sealed = seal_handover(&plaintext, recipient, path.as_str(), &prefix)?;
45 Ok(Self { sealed })
46 }
47
48 pub fn encode(&self) -> Vec<u8> {
50 let mut bytes = Vec::with_capacity(LENGTH);
51 bytes.extend_from_slice(&crate::FormatVersion::CURRENT.prefix(KIND));
52 bytes.extend_from_slice(&self.sealed);
53 bytes
54 }
55
56 pub fn decode(bytes: &[u8]) -> Result<Self, Error> {
60 crate::sealed::prefix(bytes, KIND)?;
61 exact_length(bytes.len(), LENGTH)?;
62 Ok(Self { sealed: bytes[PREFIX_LEN..].to_vec() })
63 }
64
65 #[expect(
69 clippy::map_err_ignore,
70 reason = "a sealed value whose pair does not decode is malformed as a whole"
71 )]
72 pub fn open(
73 &self,
74 path: &ObjectPath,
75 asking: &MemberKeys,
76 ) -> Result<(MemberId, MemberKeys), CryptoError> {
77 let prefix = crate::FormatVersion::CURRENT.prefix(KIND);
78 let plaintext = asking.open_handover(path.as_str(), &prefix, &self.sealed)?;
79 let (member, rest) = plaintext.split_first_chunk::<16>().ok_or(CryptoError::Malformed)?;
80 let (length, rest) = rest.split_first_chunk::<4>().ok_or(CryptoError::Malformed)?;
81 if u32::from_be_bytes(*length) as usize != rest.len() {
82 return Err(CryptoError::Malformed);
83 }
84 let keys = MemberKeys::from_secret_bytes(rest).map_err(|_| CryptoError::Malformed)?;
85 Ok((MemberId(uuid::Uuid::from_bytes(*member)), keys))
86 }
87}
88
89#[cfg(test)]
90#[path = "handover_tests.rs"]
91mod tests;