ic-host-tools 0.62.0

Host-side Candid interfaces, ICP responses and certificate decoding
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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

use super::{
    proto::*,
    routing_shards::{canister_range_start_from_key, validate_routing_table_shard_bounds},
};
use ic_platform::Principal;
use prost::Message;

fn canister(value: u64) -> CanisterId {
    let mut raw = value.to_be_bytes().to_vec();
    raw.extend([1, 1]);
    CanisterId {
        principal_id: Some(PrincipalId { raw }),
    }
}

fn shard(start: u64, end: u64) -> RoutingTable {
    RoutingTable {
        entries: vec![RoutingTableEntry {
            range: Some(CanisterIdRange {
                start_canister_id: Some(canister(start)),
                end_canister_id: Some(canister(end)),
            }),
            subnet_id: None,
        }],
    }
}

#[test]
fn wire_tags_preserve_version_wrappers_partial_records_and_unknown_fields() {
    let request = RegistryGetValueRequest {
        version: Some(UInt64Value { value: 7 }),
        key: b"k".to_vec(),
    };
    let bytes = [10, 2, 8, 7, 18, 1, b'k'];
    assert_eq!(request.encode_to_vec(), bytes);
    assert_eq!(
        RegistryGetValueRequest::decode(bytes.as_slice()).unwrap(),
        request
    );
    // Node operator bytes use field 15; unrelated field 1 remains ignored.
    let node = NodeRecord::decode([10, 1, 99, 122, 2, 1, 2].as_slice()).unwrap();
    assert_eq!(node.node_operator_id, [1, 2]);
    assert_eq!(node.encode_to_vec(), [122, 2, 1, 2]);
    assert!(RegistryGetValueRequest::decode([18, 2, 1].as_slice()).is_err());
    assert_eq!(RegistryErrorCode::InternalError as i32, 999);
    assert_eq!(RegistryMutationType::Upsert as i32, 4);
    assert_eq!(SubnetType::CloudEngine as i32, 5);
    assert_eq!(CanisterCyclesCostSchedule::Free as i32, 2);
}

#[test]
fn certified_tree_and_large_value_alternatives_preserve_golden_tags() {
    let response = RegistryCertifiedResponse {
        hash_tree: Some(RegistryMixedHashTree {
            tree: Some(registry_mixed_hash_tree::Tree::LeafData(vec![42])),
        }),
        certificate: vec![7],
    };
    let bytes = [10, 3, 34, 1, 42, 18, 1, 7];
    assert_eq!(response.encode_to_vec(), bytes);
    assert_eq!(
        RegistryCertifiedResponse::decode(bytes.as_slice()).unwrap(),
        response
    );
    let mutation = HighCapacityRegistryMutation {
        mutation_type: RegistryMutationType::Upsert as i32,
        key: b"k".to_vec(),
        content: Some(high_capacity_registry_mutation::Content::Value(vec![8])),
    };
    let bytes = [8, 4, 18, 1, b'k', 26, 1, 8];
    assert_eq!(mutation.encode_to_vec(), bytes);
    assert_eq!(
        HighCapacityRegistryMutation::decode(bytes.as_slice()).unwrap(),
        mutation
    );
}

#[test]
fn keys_require_canonical_routable_ids_and_shards_respect_interval_bounds() {
    let lower: Principal =
        canister_range_start_from_key("ranges_", "ranges_00000000000000000101").unwrap();
    let external = ic_platform::principal::ExternalPrincipal::from(lower);
    assert_eq!(external.as_slice(), &[0, 0, 0, 0, 0, 0, 0, 0, 1, 1]);
    assert_eq!(Principal::from(external), lower);
    let next = Principal::from_slice(&canister(10).principal_id.unwrap().raw);
    // A shard need not start exactly at its key's lower bound.
    validate_routing_table_shard_bounds("key", &lower, &shard(2, 9), Some(&next)).unwrap();
    for table in [
        shard(9, 2),
        shard(2, 10),
        RoutingTable { entries: vec![] },
        RoutingTable {
            entries: vec![RoutingTableEntry {
                range: None,
                subnet_id: None,
            }],
        },
    ] {
        assert!(validate_routing_table_shard_bounds("key", &lower, &table, Some(&next)).is_err());
    }
    for key in [
        "ranges_",
        "ranges_0",
        "ranges_00000000000000000A01",
        "ranges_00000000000000000102",
        "other_00000000000000000101",
    ] {
        assert!(canister_range_start_from_key("ranges_", key).is_err());
    }
    assert!(
        canister_range_start_from_key("ranges_", &format!("ranges_{}", "0".repeat(100_000)))
            .is_err()
    );
}