sim-lib-journal 0.2.0

Domain-free atomic content journal contract for SIM.
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

use sha2::{Digest, Sha256};
use sim_kernel::{ContentId, Symbol};

use crate::JournalError;

/// Immutable canonical bytes and their content identity.
#[derive(Clone, Debug, PartialEq, Eq)]
pub struct JournalObject {
    pub id: ContentId,
    pub bytes: Vec<u8>,
}

impl JournalObject {
    /// Constructs an object using the journal's canonical byte identity.
    pub fn from_bytes(bytes: impl Into<Vec<u8>>) -> Self {
        let bytes = bytes.into();
        let digest: [u8; 32] = Sha256::digest(&bytes).into();
        Self {
            id: ContentId::from_bytes(Symbol::qualified("journal", "sha256-bytes-v1"), digest),
            bytes,
        }
    }

    /// Rejects bytes that do not match their claimed identity.
    pub fn verify(&self) -> Result<(), JournalError> {
        if Self::from_bytes(self.bytes.clone()).id == self.id {
            Ok(())
        } else {
            Err(JournalError::CorruptObject(self.id.clone()))
        }
    }
}