ic-query 0.96.0

Internet Computer query library for CloudEngine, NNS, SNS, ICRC, system canisters, and public network metadata
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

//! Module: principal_text
//!
//! Responsibility: check strict canonical principal text in untrusted evidence.
//! Does not own: permissive request normalization or report-specific diagnostics.
//! Boundary: callers retain distinct parse and noncanonical error projections.

use ic_platform::candid::contract::Principal;

/// Check principal spelling without normalizing the supplied evidence.
pub fn validate_canonical<E>(
    value: &str,
    invalid: impl FnOnce(String) -> E,
    noncanonical: impl FnOnce(String) -> E,
) -> Result<(), E> {
    parse_canonical(value, invalid, noncanonical).map(|_| ())
}

/// Admit strict principal evidence and retain the parsed identity.
pub fn parse_canonical<E>(
    value: &str,
    invalid: impl FnOnce(String) -> E,
    noncanonical: impl FnOnce(String) -> E,
) -> Result<Principal, E> {
    let principal = Principal::from_text(value).map_err(|error| invalid(error.to_string()))?;
    let canonical = principal.to_text();
    if canonical == value {
        Ok(principal)
    } else {
        Err(noncanonical(canonical))
    }
}

#[cfg(test)]
mod tests;