penumbra_governance/
params.rs

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
use anyhow::Context;
use penumbra_num::Amount;
use penumbra_proto::core::component::governance::v1 as pb;
use penumbra_proto::DomainType;
use serde::{Deserialize, Serialize};

use crate::tally::Ratio;

#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
#[serde(
    try_from = "pb::GovernanceParameters",
    into = "pb::GovernanceParameters"
)]
pub struct GovernanceParameters {
    /// The number of blocks during which a proposal is voted on.
    pub proposal_voting_blocks: u64,
    /// The deposit required to create a proposal.
    pub proposal_deposit_amount: Amount,
    /// The quorum required for a proposal to be considered valid, as a fraction of the total stake
    /// weight of the network.
    pub proposal_valid_quorum: Ratio,
    /// The threshold for a proposal to pass voting, as a ratio of "yes" votes over "no" votes.
    pub proposal_pass_threshold: Ratio,
    /// The threshold for a proposal to be slashed, as a ratio of "no" votes over all total votes.
    pub proposal_slash_threshold: Ratio,
}

impl DomainType for GovernanceParameters {
    type Proto = pb::GovernanceParameters;
}

impl TryFrom<pb::GovernanceParameters> for GovernanceParameters {
    type Error = anyhow::Error;

    fn try_from(msg: pb::GovernanceParameters) -> anyhow::Result<Self> {
        Ok(GovernanceParameters {
            proposal_voting_blocks: msg.proposal_voting_blocks,
            proposal_deposit_amount: msg
                .proposal_deposit_amount
                .ok_or_else(|| anyhow::anyhow!("missing proposal_deposit_amount"))?
                .try_into()?,
            proposal_valid_quorum: msg
                .proposal_valid_quorum
                .parse()
                .context("couldn't parse proposal_valid_quorum")?,
            proposal_pass_threshold: msg
                .proposal_pass_threshold
                .parse()
                .context("couldn't parse proposal_pass_threshold")?,
            proposal_slash_threshold: msg
                .proposal_slash_threshold
                .parse()
                .context("couldn't parse proposal_slash_threshold")?,
        })
    }
}

impl From<GovernanceParameters> for pb::GovernanceParameters {
    fn from(params: GovernanceParameters) -> Self {
        pb::GovernanceParameters {
            proposal_voting_blocks: params.proposal_voting_blocks,
            proposal_deposit_amount: Some(params.proposal_deposit_amount.into()),
            proposal_valid_quorum: params.proposal_valid_quorum.to_string(),
            proposal_pass_threshold: params.proposal_pass_threshold.to_string(),
            proposal_slash_threshold: params.proposal_slash_threshold.to_string(),
        }
    }
}

impl Default for GovernanceParameters {
    fn default() -> Self {
        Self {
            // governance
            proposal_voting_blocks: 17_280, // 24 hours, at a 5 second block time
            proposal_deposit_amount: 10_000_000u64.into(), // 10,000,000 upenumbra = 10 penumbra
            // governance parameters copied from cosmos hub
            proposal_valid_quorum: Ratio::new(40, 100),
            proposal_pass_threshold: Ratio::new(50, 100),
            // slash threshold means if (no / no + yes + abstain) > slash_threshold, then proposal is slashed
            proposal_slash_threshold: Ratio::new(80, 100),
        }
    }
}