corim 0.1.3

Concise Reference Integrity Manifest (CoRIM) — CBOR-based encoding of Endorsements and Reference Values for Remote Attestation (RATS).
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

// Copyright (c) Microsoft Corporation.
// Licensed under the MIT License.

//! Minimal CBOR backend: [`MinimalCodec`] implementation using
//! the in-house encoder/decoder.
//!
//! This backend avoids the ciborium dependency entirely. It goes through
//! the backend-agnostic [`Value`](super::value::Value) as an intermediate
//! representation:
//!
//! ```text
//! Encode: T →(serde)→ Value →(minimal::encode_value)→ CBOR bytes
//! Decode: CBOR bytes →(minimal::decode_value)→ Value →(serde)→ T
//! ```
//!
//! To enable: set `features = ["cbor-minimal"]` and disable `cbor-ciborium`.

#![allow(dead_code)] // Only used when cbor-ciborium is disabled

#[allow(unused_imports)]
use crate::nostd_prelude::*;

use crate::cbor::CborCodec;
use crate::error::{DecodeError, EncodeError};
use serde::{de::DeserializeOwned, Serialize};

pub(crate) mod value_de;
pub(crate) mod value_ser;

/// CBOR codec using the in-house minimal encoder/decoder.
pub struct MinimalCodec;

impl CborCodec for MinimalCodec {
    fn encode_deterministic<T: Serialize>(value: &T) -> Result<Vec<u8>, EncodeError> {
        // Step 1: Serialize T into a Value tree via serde
        let val = value_ser::to_value(value).map_err(EncodeError::Serialization)?;
        // Step 2: Encode Value to deterministic CBOR bytes
        let mut buf = Vec::new();
        super::minimal::encode_value(&mut buf, &val)
            .map_err(|e| EncodeError::Serialization(e.to_string()))?;
        Ok(buf)
    }

    fn decode<T: DeserializeOwned>(bytes: &[u8]) -> Result<T, DecodeError> {
        // Step 1: Decode CBOR bytes into a Value tree (preserves tags)
        let mut reader = super::minimal::SliceReader::new(bytes);
        let val = super::minimal::decode_value(&mut reader)
            .map_err(|e| DecodeError::Deserialization(e.to_string()))?;

        // Step 2: Deserialize Value into T via serde.
        // Tags are preserved in the Value tree. The value_de module
        // presents Value::Tag as a 2-element seq to the serde visitor.
        // Types that expect tags (Tagged<T>, type-choice enums) handle
        // this correctly because their Deserialize impls go through
        // Value::deserialize which calls deserialize_any, and our
        // ValueDeserializer presents the tag data appropriately.
        let result = value_de::from_value(val).map_err(DecodeError::Deserialization)?;
        Ok(result)
    }
}