runx-receipts 0.6.19

Pure Rust receipt model, canonicalization, and verification parity for runx.
Documentation
use thiserror::Error;

#[derive(Clone, Debug, Error, PartialEq, Eq)]
pub enum ReceiptError {
    #[error("receipt serialization failed: {message}")]
    Serialization { message: String },
}

#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum ReceiptFindingCode {
    EmptyEnvelopeField,
    ActFormDetailsInvalid,
    DecisionSelectedActMissing,
    SealCriterionActMissing,
    SealCriterionUnbound,
    ChildReceiptRefInvalid,
    ChildReceiptRefMalformed,
    ChildReceiptMissing,
    ChildReceiptAmbiguous,
    ChildReceiptResolverError,
    ChildReceiptCycle,
    OrphanChildReceipt,
    ChildReceiptParentMismatch,
    ChildReceiptDigestMismatch,
    ChildReceiptDepthLimit,
    ChildReceiptBreadthLimit,
    DuplicateChildReceipt,
    HashCommitmentInvalid,
    AuthorityAttenuationInvalid,
    EffectGrantEvidenceMissing,
    SealDigestMismatch,
    SignatureVerifierMissing,
    SignatureInvalid,
    SignatureKeyMissing,
    SignatureKeyMalformed,
    SignatureKeyHashMismatch,
    SignatureUnsupportedIssuer,
    SignatureUnsupportedAlgorithm,
    SignatureMalformed,
    VerificationSummaryInvalid,
    AuthorityProofMissing,
    RedactionProofMissing,
    HashCommitmentProofMissing,
    ExternalAttestationMissing,
}

#[derive(Clone, Debug, PartialEq, Eq)]
pub struct ReceiptFinding {
    pub code: ReceiptFindingCode,
    pub path: String,
    pub message: String,
}

#[derive(Clone, Debug, PartialEq, Eq)]
pub struct ReceiptVerification {
    pub valid: bool,
    pub findings: Vec<ReceiptFinding>,
}

impl ReceiptVerification {
    #[must_use]
    pub fn valid() -> Self {
        Self {
            valid: true,
            findings: Vec::new(),
        }
    }

    #[must_use]
    pub fn from_findings(findings: Vec<ReceiptFinding>) -> Self {
        Self {
            valid: findings.is_empty(),
            findings,
        }
    }
}