use crate::{
Principal,
agent::{Agent, AgentError, EffectiveId},
certification::{
Certificate, HashTree, LookupResult,
cbor::strict::{DecodeError, DecodeLimits, decode_certificate, decode_hash_tree},
},
};
#[derive(Debug, thiserror::Error)]
pub enum EvidenceError {
#[error("certificate evidence exceeds byte allowance")]
Budget,
#[error("invalid certificate evidence: {0}")]
Decode(#[source] DecodeError),
#[error("certificate authentication failed: {0}")]
Authentication(#[source] Box<AgentError>),
#[error("witness is not committed by the certificate")]
WitnessMismatch,
}
pub fn authenticate_hash_tree(
agent: &Agent,
canister: Principal,
certificate: &[u8],
witness: &[u8],
maximum_bytes: usize,
) -> Result<HashTree, EvidenceError> {
if certificate
.len()
.checked_add(witness.len())
.is_none_or(|size| size > maximum_bytes)
{
return Err(EvidenceError::Budget);
}
let certificate = authenticate_certificate(agent, canister, certificate, maximum_bytes)?;
let witness = decode_hash_tree(
witness,
DecodeLimits {
bytes: maximum_bytes,
},
)
.map_err(EvidenceError::Decode)?;
verify_witness(&certificate, canister, &witness)?;
Ok(witness)
}
pub fn verify_witness(
certificate: &Certificate,
canister: Principal,
witness: &HashTree,
) -> Result<(), EvidenceError> {
match certificate.tree.lookup_path([
b"canister".as_slice(),
canister.as_slice(),
b"certified_data".as_slice(),
]) {
LookupResult::Found(value) if value == witness.digest() => Ok(()),
_ => Err(EvidenceError::WitnessMismatch),
}
}
#[expect(
clippy::missing_panics_doc,
reason = "Canonical Principal length is already within Agent's admitted bound"
)]
pub fn authenticate_certificate(
agent: &Agent,
canister: Principal,
bytes: &[u8],
maximum_bytes: usize,
) -> Result<Certificate, EvidenceError> {
let certificate = decode_certificate(
bytes,
DecodeLimits {
bytes: maximum_bytes,
},
)
.map_err(EvidenceError::Decode)?;
let effective = EffectiveId::Canister(
canister
.as_slice()
.try_into()
.expect("canonical principal fits Agent"),
);
agent
.verify(&certificate, effective)
.map_err(|source| EvidenceError::Authentication(Box::new(source)))?;
Ok(certificate)
}
#[cfg(test)]
mod tests;