cosmrs 0.22.0

Transaction builder and signer for Cosmos-based blockchains
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 crate::crypto::PublicKey;
use crate::staking::{Commission, Description};
use crate::{proto, AccountId, ErrorReport, Result};
use cosmos_sdk_proto::Timestamp;
use tendermint::Time;

/// Validator defines a validator, together with the total amount of the
/// Validator's bond shares and their exchange rate to coins. Slashing results in
/// a decrease in the exchange rate, allowing correct calculation of future
/// undelegations without iterating over delegators. When coins are delegated to
/// this validator, the validator is credited with a delegation whose number of
/// bond shares is based on the amount of coins delegated divided by the current
/// exchange rate. Voting power can be calculated as total bonded shares
/// multiplied by exchange rate.
#[derive(Clone, Debug, PartialEq)]
pub struct Validator {
    /// operator_address defines the address of the validator's operator;
    pub operator_address: AccountId,

    /// consensus_pubkey is the consensus public key of the validator.
    pub consensus_pubkey: Option<PublicKey>,

    /// jailed defined whether the validator has been jailed from bonded status or not.
    pub jailed: bool,

    /// status is the validator status (bonded/unbonding/unbonded).
    pub status: i32,

    /// tokens define the delegated tokens (incl. self-delegation).
    pub tokens: String,

    /// delegator_shares defines total shares issued to a validator's delegators.
    pub delegator_shares: String,

    /// description defines the description terms for the validator.
    pub description: Option<Description>,

    /// unbonding_height defines, if unbonding, the height at which this validator has begun unbonding.
    pub unbonding_height: i64,

    /// list of unbonding ids, each uniquely identifing an unbonding of this validator
    pub unbonding_ids: Vec<u64>,

    /// strictly positive if this validator's unbonding has been stopped by external modules
    pub unbonding_on_hold_ref_count: i64,

    /// unbonding_time defines, if unbonding, the min time for the validator to complete unbonding.
    pub unbonding_time: Option<Time>,

    /// commission defines the commission parameters.
    pub commission: Option<Commission>,

    /// min_self_delegation is the validator's self declared minimum self delegation.
    ///
    /// Since: cosmos-sdk 0.46
    pub min_self_delegation: String,
}

impl TryFrom<proto::cosmos::staking::v1beta1::Validator> for Validator {
    type Error = ErrorReport;

    fn try_from(proto: cosmos_sdk_proto::cosmos::staking::v1beta1::Validator) -> Result<Self> {
        Ok(Validator {
            operator_address: proto.operator_address.parse()?,
            consensus_pubkey: proto.consensus_pubkey.map(TryInto::try_into).transpose()?,
            jailed: proto.jailed,
            status: proto.status,
            tokens: proto.tokens,
            delegator_shares: proto.delegator_shares,
            description: proto.description.map(Into::into),
            unbonding_height: proto.unbonding_height,
            unbonding_ids: proto.unbonding_ids,
            unbonding_on_hold_ref_count: proto.unbonding_on_hold_ref_count,
            unbonding_time: proto
                .unbonding_time
                .map(|jailed_until| {
                    cosmos_sdk_proto::tendermint::google::protobuf::Timestamp {
                        seconds: jailed_until.seconds,
                        nanos: jailed_until.nanos,
                    }
                    .try_into()
                })
                .transpose()?,
            commission: proto.commission.map(TryInto::try_into).transpose()?,
            min_self_delegation: proto.min_self_delegation,
        })
    }
}

impl From<Validator> for proto::cosmos::staking::v1beta1::Validator {
    fn from(validator: Validator) -> Self {
        proto::cosmos::staking::v1beta1::Validator {
            operator_address: validator.operator_address.to_string(),
            consensus_pubkey: validator.consensus_pubkey.map(Into::into),
            jailed: validator.jailed,
            status: validator.status,
            tokens: validator.tokens,
            delegator_shares: validator.delegator_shares,
            description: validator.description.map(Into::into),
            unbonding_height: validator.unbonding_height,
            unbonding_ids: validator.unbonding_ids,
            unbonding_on_hold_ref_count: validator.unbonding_on_hold_ref_count,
            unbonding_time: validator
                .unbonding_time
                .map(cosmos_sdk_proto::tendermint::google::protobuf::Timestamp::from)
                .map(|t| Timestamp {
                    seconds: t.seconds,
                    nanos: t.nanos,
                }),
            commission: validator.commission.map(Into::into),
            min_self_delegation: validator.min_self_delegation,
        }
    }
}