pub struct IcMutationRequest<'a> { /* private fields */ }Expand description
Structural request for one already reserved original host-ingress mutation.
Retained identity does not prove fresh permissions, prerequisites, application safety or exclusive custody. A pending reservation does not prove it was never dispatched. This request is not a dispatch permit or an interruption retry.
Implementations§
Source§impl<'a> IcMutationRequest<'a>
impl<'a> IcMutationRequest<'a>
Sourcepub fn new(
plan: &'a OperationPlanRecord,
operation_sequence: u64,
journal: &AttemptJournalRecord,
payload: &'a IcManagementRequestRecord,
) -> Result<Self, IcMutationRequestError>
pub fn new( plan: &'a OperationPlanRecord, operation_sequence: u64, journal: &AttemptJournalRecord, payload: &'a IcManagementRequestRecord, ) -> Result<Self, IcMutationRequestError>
Bind exact original plan, allowances and IC bytes after mutation reservation.
Accepts only capture, load, start and stop; observations have separate reservations. Derivation never creates a journal, spends or resets allowance.
§Errors
Rejects unknown operations, changed authority/bytes, absent pending mutation or an observation already reserved for recovery.
Sourcepub const fn plan(&self) -> &OperationPlanRecord
pub const fn plan(&self) -> &OperationPlanRecord
Read original full context, inventory, selection and dependency declarations.
Sourcepub const fn payload(&self) -> &'a IcManagementRequestRecord
pub const fn payload(&self) -> &'a IcManagementRequestRecord
Read exact management receiver, routing target, method and Candid argument bytes.
Read canonical original identity and immutable mutation/observation limits.
Sourcepub const fn mutation_attempt(&self) -> u32
pub const fn mutation_attempt(&self) -> u32
Read the original already consumed mutation attempt number.
Sourcepub fn validate_journal(
&self,
journal: &AttemptJournalRecord,
) -> Result<(), IcMutationRequestError>
pub fn validate_journal( &self, journal: &AttemptJournalRecord, ) -> Result<(), IcMutationRequestError>
Recheck the exact current pending reservation without IO or effect admission.
§Errors
Rejects different authority, replaced/settled mutation or observation recovery.