ic-backup 0.5.1

Host-side snapshot backup and same-release recovery for Internet Computer canisters
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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

//! Passive exact pending journal and application evidence fixtures; no backend.

use crate::{
    model::{
        attempt_journal::AttemptJournalRecord, consistency::*, fence_obligation::*,
        fence_reconciliation::*, operation_plan::OperationPlanRecord,
        restore_safety::RestoreSafetyLaneRecord,
    },
    test_support::{
        consistency,
        membership::{hash, plan},
        restore_safety,
    },
};
pub struct Original {
    pub plan: OperationPlanRecord,
    pub obligation: FenceObligationRecord,
    pub journal: AttemptJournalRecord,
}
pub fn original(restore: bool) -> Original {
    let plan = plan();
    let obligation = if restore {
        let source = restore_safety::source();
        let requirement =
            restore_safety::requirement(&plan, &source, RestoreSafetyLaneRecord::ApplicationFenced);
        FenceObligationRecord::for_restore(&plan, &source, &requirement, 0).unwrap()
    } else {
        FenceObligationRecord::for_capture(
            &plan,
            &ConsistencyRequirementRecord::new(
                &plan,
                ConsistencyGuaranteeRecord::ApplicationCoordinated,
            ),
            0,
            &ApplicationFenceBinding {
                identity: hash("56"),
                membership_revision: hash("78"),
            },
        )
        .unwrap()
    };
    let mut journal = AttemptJournalRecord::new(plan.attempt_authority(0).unwrap());
    journal.reserve_mutation().unwrap();
    Original {
        plan,
        obligation,
        journal,
    }
}
pub fn reserve(original: &mut Original, challenge: &str) {
    let intent = FenceReconciliationIntent::new(
        &original.plan,
        &original.obligation,
        &original.journal,
        hash(challenge),
    )
    .unwrap();
    original
        .journal
        .reserve_observation(intent.mutation_attempt(), intent.digest().hash())
        .unwrap();
}
pub fn input(request: &FenceReconciliationRequest<'_, '_>) -> FenceReconciliationObservationInput {
    FenceReconciliationObservationInput {
        request: request.digest(),
        mutation_attempt: request.intent().mutation_attempt(),
        observation_attempt: request.observation_attempt(),
        context: request.intent().plan().context().clone(),
        inventory: request.intent().plan().inventory().clone(),
        selected_targets: request.intent().plan().selected_targets().into(),
        settlement: match request.intent().obligation().scope() {
            FenceObligationScopeRecord::Capture { .. } => {
                FenceReconciliationEvidence::AcquiredCapture {
                    fence: Box::new(consistency::fence()),
                    attribution: hash("34"),
                }
            }
            FenceObligationScopeRecord::Restore { .. } => {
                FenceReconciliationEvidence::AcquiredRestore {
                    fence: Box::new(restore_safety::fence()),
                    attribution: hash("34"),
                }
            }
        },
        evidence: hash("ab"),
        remote_observations: 1,
    }
}