ic-backup 0.28.0

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

//! Pure bounded principal text admission shared by owning record boundaries.

pub(super) fn canonical_parts(value: &str) -> Option<(String, ic_principal::Principal)> {
    if value.len() > 63 {
        return None;
    }
    ic_principal::Principal::from_text(value)
        .ok()
        .map(|principal| (principal.to_text(), principal))
}

pub(super) fn canonical_text(value: &str) -> Option<String> {
    canonical_parts(value).map(|(text, _)| text)
}

pub(super) fn canonical_set<E>(
    mut principals: Vec<String>,
    limit: usize,
    too_many: fn() -> E,
    invalid: fn() -> E,
    duplicate: fn() -> E,
) -> Result<Vec<String>, E> {
    if principals.len() > limit {
        return Err(too_many());
    }
    for principal in &mut principals {
        *principal = canonical_text(principal).ok_or_else(invalid)?;
    }
    principals.sort();
    if principals.windows(2).any(|pair| pair[0] == pair[1]) {
        return Err(duplicate());
    }
    Ok(principals)
}