mithril_common/messages/
mithril_stake_distribution.rs

1use chrono::DateTime;
2use chrono::Utc;
3use serde::{Deserialize, Serialize};
4
5use crate::entities::Epoch;
6use crate::entities::ProtocolParameters;
7
8use super::SignerWithStakeMessagePart;
9/// Message structure of a Mithril Stake Distribution
10#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
11pub struct MithrilStakeDistributionMessage {
12    /// Epoch at which the Mithril Stake Distribution is created
13    pub epoch: Epoch,
14
15    /// List of signers with stakes of the Mithril Stake Distribution
16    #[serde(rename = "signers")]
17    pub signers_with_stake: Vec<SignerWithStakeMessagePart>,
18
19    /// Hash of the Mithril Stake Distribution (different from the AVK).
20    pub hash: String,
21
22    /// Hash of the associated certificate
23    pub certificate_hash: String,
24
25    /// DateTime of creation
26    pub created_at: DateTime<Utc>,
27
28    /// Protocol parameters used to compute AVK
29    pub protocol_parameters: ProtocolParameters,
30}
31
32#[cfg(test)]
33mod tests {
34    use crate::test::double::fake_data;
35
36    use super::*;
37
38    fn golden_message_current() -> MithrilStakeDistributionMessage {
39        MithrilStakeDistributionMessage {
40            epoch: Epoch(1),
41            signers_with_stake: vec![
42                SignerWithStakeMessagePart {
43                    party_id: "0".to_string(),
44                    verification_key: "7b22766b223a5b3134332c3136312c3235352c34382c37382c35372c3230342c3232302c32352c3232312c3136342c3235322c3234382c31342c35362c3132362c3138362c3133352c3232382c3138382c3134352c3138312c35322c3230302c39372c39392c3231332c34362c302c3139392c3139332c38392c3138372c38382c32392c3133352c3137332c3234342c38362c33362c38332c35342c36372c3136342c362c3133372c39342c37322c362c3130352c3132382c3132382c39332c34382c3137362c31312c342c3234362c3133382c34382c3138302c3133332c39302c3134322c3139322c32342c3139332c3131312c3134322c33312c37362c3131312c3131302c3233342c3135332c39302c3230382c3139322c33312c3132342c39352c3130322c34392c3135382c39392c35322c3232302c3136352c39342c3235312c36382c36392c3132312c31362c3232342c3139345d2c22706f70223a5b3136382c35302c3233332c3139332c31352c3133362c36352c37322c3132332c3134382c3132392c3137362c33382c3139382c3230392c34372c32382c3230342c3137362c3134342c35372c3235312c34322c32382c36362c37362c38392c39372c3135382c36332c35342c3139382c3139342c3137362c3133352c3232312c31342c3138352c3139372c3232352c3230322c39382c3234332c37342c3233332c3232352c3134332c3135312c3134372c3137372c3137302c3131372c36362c3136352c36362c36322c33332c3231362c3233322c37352c36382c3131342c3139352c32322c3130302c36352c34342c3139382c342c3136362c3130322c3233332c3235332c3234302c35392c3137352c36302c3131372c3134322c3131342c3134302c3132322c31372c38372c3131302c3138372c312c31372c31302c3139352c3135342c31332c3234392c38362c35342c3232365d7d".to_string(),
45                    verification_key_signature: None,
46                    operational_certificate: None,
47                    kes_period: None,
48                    stake: 826
49                },
50            ],
51            hash: "hash-123".to_string(),
52            certificate_hash: "cert-hash-123".to_string(),
53            created_at: DateTime::parse_from_rfc3339("2023-01-19T13:43:05.618857482Z")
54            .unwrap()
55            .with_timezone(&Utc),
56            protocol_parameters: fake_data::protocol_parameters(),
57        }
58    }
59
60    const CURRENT_JSON: &str = r#"{
61            "epoch": 1,
62            "signers": [
63                {
64                    "party_id": "0",
65                    "verification_key": "7b22766b223a5b3134332c3136312c3235352c34382c37382c35372c3230342c3232302c32352c3232312c3136342c3235322c3234382c31342c35362c3132362c3138362c3133352c3232382c3138382c3134352c3138312c35322c3230302c39372c39392c3231332c34362c302c3139392c3139332c38392c3138372c38382c32392c3133352c3137332c3234342c38362c33362c38332c35342c36372c3136342c362c3133372c39342c37322c362c3130352c3132382c3132382c39332c34382c3137362c31312c342c3234362c3133382c34382c3138302c3133332c39302c3134322c3139322c32342c3139332c3131312c3134322c33312c37362c3131312c3131302c3233342c3135332c39302c3230382c3139322c33312c3132342c39352c3130322c34392c3135382c39392c35322c3232302c3136352c39342c3235312c36382c36392c3132312c31362c3232342c3139345d2c22706f70223a5b3136382c35302c3233332c3139332c31352c3133362c36352c37322c3132332c3134382c3132392c3137362c33382c3139382c3230392c34372c32382c3230342c3137362c3134342c35372c3235312c34322c32382c36362c37362c38392c39372c3135382c36332c35342c3139382c3139342c3137362c3133352c3232312c31342c3138352c3139372c3232352c3230322c39382c3234332c37342c3233332c3232352c3134332c3135312c3134372c3137372c3137302c3131372c36362c3136352c36362c36322c33332c3231362c3233322c37352c36382c3131342c3139352c32322c3130302c36352c34342c3139382c342c3136362c3130322c3233332c3235332c3234302c35392c3137352c36302c3131372c3134322c3131342c3134302c3132322c31372c38372c3131302c3138372c312c31372c31302c3139352c3135342c31332c3234392c38362c35342c3232365d7d",
66                    "stake": 826
67                }
68            ],
69            "hash": "hash-123",
70            "certificate_hash": "cert-hash-123",
71            "created_at": "2023-01-19T13:43:05.618857482Z",
72            "protocol_parameters": {"k": 5, "m": 100, "phi_f": 0.65 }
73        }"#;
74
75    #[test]
76    fn test_current_json_deserialized_into_current_message() {
77        let json = CURRENT_JSON;
78        let message: MithrilStakeDistributionMessage = serde_json::from_str(json).expect(
79            "This JSON is expected to be successfully parsed into a MithrilStakeDistributionMessage instance.",
80        );
81
82        assert_eq!(golden_message_current(), message);
83    }
84}
mithril_common/messages/mithril_stake_distribution.rs

mithril_common/messages/
mithril_stake_distribution.rs
