canic-core 0.97.3

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

//! Module: view::intent
//!
//! Responsibility: define read-only intent-store scan projections.
//! Does not own: stable storage, mutation authority, or workflow decisions.
//! Boundary: storage ops return bounded pages to durable cleanup workflows.

use crate::model::{intent::ReceiptBackedIntent, replay::OperationId};

/// Read-only maintained receipt and resource-total capacity projection.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub struct ReceiptCapacityView {
    pub total_records: u64,
    pub application_records: u64,
    pub canic_owned_records: u64,
    pub pending_records: u64,
    pub terminal_records: u64,
    pub record_limit: u64,
    pub remaining_record_headroom: u64,
    pub resource_total_records: u64,
    pub resource_total_record_limit: u64,
    pub remaining_resource_total_headroom: u64,
    pub reserved_terminal_slots: u64,
    pub reserved_terminal_pages: u64,
    pub next_eligibility_at_ns: Option<u64>,
}

/// Result of one bounded exact application-receipt reclamation batch.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub struct ApplicationReceiptReclamationBatch {
    pub removed_records: u64,
    pub next_eligibility_at_ns: Option<u64>,
}

/// Bounded placement-only acknowledgement page used by its durable cleanup owner.
#[derive(Debug)]
pub struct PlacementAcknowledgementPage {
    pub intents: Vec<ReceiptBackedIntent>,
    pub next_cursor: Option<OperationId>,
}