canic-core 0.111.0

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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

//! Module: memory::registry
//!
//! Responsibility: define memory registry bootstrap and validation errors.
//! Does not own: allocation policy, stable schemas, or memory-manager storage.
//! Boundary: memory bootstrap maps `ic-memory` validation failures into this type.

use thiserror::Error as ThisError;

///
/// MemoryRegistryError
///
/// Canic-facing errors returned while bootstrapping or reading the
/// `ic-memory` allocation ledger.
/// Owned by memory registry and returned to lifecycle/bootstrap callers.
///

#[derive(Debug, ThisError)]
pub enum MemoryRegistryError {
    /// A composed consumer rejected the sealed snapshot before commitment.
    #[error("composed memory admission rejected: {source}")]
    Admission {
        #[source]
        source: Box<dyn std::error::Error + Send + Sync>,
    },

    /// Exactly one artifact owner may compose consumer admission.
    #[error("memory admission is already registered")]
    AdmissionAlreadyRegistered,

    /// Admission cannot change after Canic has selected its bootstrap policy.
    #[error("memory admission registration is sealed")]
    AdmissionRegistrationSealed,

    /// A poisoned registry cannot supply trustworthy admission authority.
    #[error("memory admission registry is poisoned")]
    AdmissionRegistryPoisoned,

    /// A declaration was rejected before or during `ic-memory` validation.
    #[error("memory declaration rejected for stable key '{stable_key}': {reason}")]
    InvalidDeclaration {
        stable_key: String,
        reason: &'static str,
    },

    /// Host pool registration failed before bootstrap.
    #[error("memory host pool registration rejected: {reason}")]
    PoolRegistration { reason: &'static str },
    /// The host supplied invalid namespace grants or physical exclusions.
    #[error(transparent)]
    Pool(#[from] ic_memory::MemoryAllocationPoolError),
}