canic-core 0.110.10

Canic — a canister orchestration and management toolkit for the Internet Computer
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

//! Module: ops::root_draining_reservation
//!
//! Responsibility: hash exact Coordinator-owned root-draining reservations.
//! Does not own: reservation persistence, transport, or root lifecycle mutation.
//! Boundary: Coordinator production and root consumption share this canonical authority.

use crate::{InternalError, dto::fleet_registry::FleetSubnetRootDrainingReservationResponse};
use sha2::{Digest, Sha256};

const ROOT_DRAINING_RESERVATION_HASH_DOMAIN: &[u8] =
    b"canic/fleet-subnet-root/draining-reservation/v1";

/// Canonical hashing boundary shared by Coordinator production and root verification.
pub struct FleetSubnetRootDrainingReservationOps;

impl FleetSubnetRootDrainingReservationOps {
    /// Hash one exact reservation after excluding its self-referential hash field.
    pub fn content_hash(
        response: &FleetSubnetRootDrainingReservationResponse,
    ) -> Result<[u8; 32], InternalError> {
        let mut authority = response.clone();
        authority.reservation_hash = [0; 32];
        let payload = candid::encode_one(authority).map_err(|_error| InternalError::invariant())?;
        let mut hasher = Sha256::new();
        hasher.update(ROOT_DRAINING_RESERVATION_HASH_DOMAIN);
        hasher.update(payload);
        Ok(hasher.finalize().into())
    }
}

#[cfg(test)]
mod tests;