use super::CertificateDecodeLimits;
#[derive(Debug, thiserror::Error)]
pub enum CanisterSignatureDecodeError {
#[error("canister signature has {actual} bytes, exceeding {maximum}")]
InputLimit {
actual: usize,
maximum: usize,
},
#[error("canister signature requires CBOR tag 55799")]
MissingTag,
#[error("invalid canister signature encoding: {0}")]
InvalidEncoding(#[source] serde_cbor::Error),
}
#[derive(Debug)]
pub struct DecodedCanisterSignature<'a> {
original: &'a [u8],
certificate: Vec<u8>,
witness: ic_certification::HashTree,
}
impl<'a> DecodedCanisterSignature<'a> {
#[must_use]
pub const fn original_bytes(&self) -> &'a [u8] {
self.original
}
#[must_use]
pub fn certificate_bytes(&self) -> &[u8] {
&self.certificate
}
#[must_use]
pub const fn unverified_witness(&self) -> &ic_certification::HashTree {
&self.witness
}
}
pub fn decode_canister_signature(
bytes: &[u8],
limits: CertificateDecodeLimits,
) -> Result<DecodedCanisterSignature<'_>, CanisterSignatureDecodeError> {
if bytes.len() > limits.bytes {
return Err(CanisterSignatureDecodeError::InputLimit {
actual: bytes.len(),
maximum: limits.bytes,
});
}
if !bytes.starts_with(&[0xd9, 0xd9, 0xf7]) {
return Err(CanisterSignatureDecodeError::MissingTag);
}
let (certificate, witness) = super::wire::decode_canister_signature(bytes)
.map_err(CanisterSignatureDecodeError::InvalidEncoding)?;
Ok(DecodedCanisterSignature {
original: bytes,
certificate,
witness,
})
}
#[cfg(test)]
mod tests;