chain-spec-generator 13.0.1-beta.196

Generates a chainspec artifact for use in genesis block creation of a Xand network.
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
115
116
117
118
119
120
121
122
123

use crate::{
    cli::commands::GenerateError,
    public_models::domain::{
        encryption_pub_key::EncryptionPubKey, validator_auth_address::ValidatorAuthAddress,
    },
};

use serde_derive::Deserialize;

use super::parse_cidr_block_list;

#[derive(Debug, Deserialize, Clone)]
#[serde(deny_unknown_fields)]
pub struct ValidatorIdentityConfiguration {
    pub address: ValidatorAuthAddress,
    pub aura_session_key: String,
    pub grandpa_session_key: String,
    pub encryption_pub_key: EncryptionPubKey,

    pub ip_address_ranges: Vec<String>,
}

impl ValidatorIdentityConfiguration {
    pub fn build_validator_identity(&self) -> Result<crate::ValidatorIdentity, GenerateError> {
        Ok(crate::ValidatorIdentity {
            cidr_blocks: parse_cidr_block_list(&self.ip_address_ranges)?,
            key_gen_summary: crate::ValidatorKeys {
                val_kp_pub: self.address.clone(),
                produce_blocks_kp_pub: self.aura_session_key.clone().into(),
                finalize_blocks_kp_pub: self.grandpa_session_key.clone().into(),
                pub_key: self.encryption_pub_key.clone(),
            },
        })
    }
}

#[cfg(test)]
mod tests {
    use crate::cli::commands::GenerateError;

    use super::ValidatorIdentityConfiguration;

    use crate::public_models::domain::encryption_pub_key::EncryptionPubKey;
    use assert_matches::assert_matches;

    #[test]
    fn build_validator_identity__can_parse_valid_ip() {
        // Given
        let config = ValidatorIdentityConfiguration {
            address: "someaddr".into(),
            ip_address_ranges: vec!["127.0.0.1".into()],
            aura_session_key: "aura_key".into(),
            grandpa_session_key: "grandpa_key".into(),
            encryption_pub_key: EncryptionPubKey([5; 32]),
        };

        // When
        let ident = config.build_validator_identity().unwrap();

        // Then
        assert_eq!(ident.key_gen_summary.val_kp_pub, "someaddr".into());
        assert_eq!(ident.cidr_blocks, vec!["127.0.0.1".parse().unwrap()]);
        assert_eq!(
            ident.key_gen_summary.produce_blocks_kp_pub,
            "aura_key".into()
        );
        assert_eq!(
            ident.key_gen_summary.finalize_blocks_kp_pub,
            "grandpa_key".into()
        );
    }

    #[test]
    fn build_validator_identity__errors_on_invalid_ip() {
        // Given
        let config = ValidatorIdentityConfiguration {
            address: "someaddr".into(),
            aura_session_key: "aura_key".into(),
            grandpa_session_key: "grandpa_key".into(),
            ip_address_ranges: vec!["notARealIpAddress".into()],
            encryption_pub_key: EncryptionPubKey([5; 32]),
        };

        // When
        let ident = config.build_validator_identity();

        // Then
        assert_matches!(ident.err().unwrap(), GenerateError::AddressParse(..))
    }

    #[test]
    fn from_str__can_parse_yaml_str() {
        let source_str = r#"
        address: 5Dd9WpDQcuHbzHeV4STUbNZKGiaEWRs58KtWjTWUcdDaq2LJ
        aura_session_key: 5Dd9WpDQcuHbzHeV4STUbNZKGiaEWRs58KtWjTWUcdDaq2LJ
        grandpa_session_key: 5F7Qp9rgETxE2ZLaJqNPT2b55kDUSMkQSAzd25Mr6PL5yVfV
        encryption_pub_key: Nc3hoeZaZmiSJcXmmYN1i5p65LBXscpHLFFRJJKhZfE
        ip_address_ranges: [ "127.0.0.1" ]
        "#;

        let config: ValidatorIdentityConfiguration = serde_yaml::from_str(source_str).unwrap();

        assert_eq!(
            config.address.to_string(),
            "5Dd9WpDQcuHbzHeV4STUbNZKGiaEWRs58KtWjTWUcdDaq2LJ"
        );
        assert_eq!(
            config.aura_session_key,
            "5Dd9WpDQcuHbzHeV4STUbNZKGiaEWRs58KtWjTWUcdDaq2LJ"
        );
        assert_eq!(
            config.grandpa_session_key,
            "5F7Qp9rgETxE2ZLaJqNPT2b55kDUSMkQSAzd25Mr6PL5yVfV"
        );
        assert_eq!(
            config.encryption_pub_key.0,
            bs58::decode("Nc3hoeZaZmiSJcXmmYN1i5p65LBXscpHLFFRJJKhZfE")
                .into_vec()
                .unwrap()[..]
        );
        assert_eq!(config.ip_address_ranges[..], ["127.0.0.1"]);
    }
}