stellar-base 0.7.0

Low level Stellar types
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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153

use crate::claim::ClaimableBalanceId;
use crate::crypto::MuxedAccount;
use crate::error::{Error, Result};
use crate::operations::Operation;
use crate::xdr;

#[derive(Debug, Clone, PartialEq, Eq)]
pub struct ClaimClaimableBalanceOperation {
    source_account: Option<MuxedAccount>,
    balance_id: ClaimableBalanceId,
}

#[derive(Debug, Default)]
pub struct ClaimClaimableBalanceOperationBuilder {
    source_account: Option<MuxedAccount>,
    balance_id: Option<ClaimableBalanceId>,
}

impl ClaimClaimableBalanceOperation {
    /// Retrieves the operation source account.
    pub fn source_account(&self) -> &Option<MuxedAccount> {
        &self.source_account
    }

    /// Retrieves a reference to the operation source account.
    pub fn source_account_mut(&mut self) -> &mut Option<MuxedAccount> {
        &mut self.source_account
    }

    /// Retrieves a reference to the claimable balance id.
    pub fn balance_id(&self) -> &ClaimableBalanceId {
        &self.balance_id
    }

    /// Retrieves a mutable reference to the claimable balance id.
    pub fn balance_id_mut(&mut self) -> &mut ClaimableBalanceId {
        &mut self.balance_id
    }

    /// Returns tho xdr operation body.
    pub fn to_xdr_operation_body(&self) -> Result<xdr::OperationBody> {
        let balance_id = self.balance_id.to_xdr();
        let inner = xdr::ClaimClaimableBalanceOp { balance_id };
        Ok(xdr::OperationBody::ClaimClaimableBalance(inner))
    }

    /// Creates from the xdr operation body.
    pub fn from_xdr_operation_body(
        source_account: Option<MuxedAccount>,
        x: &xdr::ClaimClaimableBalanceOp,
    ) -> Result<ClaimClaimableBalanceOperation> {
        let balance_id = ClaimableBalanceId::from_xdr(&x.balance_id)?;
        Ok(ClaimClaimableBalanceOperation {
            source_account,
            balance_id,
        })
    }
}

impl ClaimClaimableBalanceOperationBuilder {
    pub fn new() -> ClaimClaimableBalanceOperationBuilder {
        Default::default()
    }

    pub fn with_source_account<S>(mut self, source: S) -> ClaimClaimableBalanceOperationBuilder
    where
        S: Into<MuxedAccount>,
    {
        self.source_account = Some(source.into());
        self
    }

    pub fn with_claimable_balance_id(
        mut self,
        balance_id: ClaimableBalanceId,
    ) -> ClaimClaimableBalanceOperationBuilder {
        self.balance_id = Some(balance_id);
        self
    }

    pub fn build(self) -> Result<Operation> {
        let balance_id = self.balance_id.ok_or_else(|| {
            Error::InvalidOperation("missing claim claimable balance id".to_string())
        })?;

        Ok(Operation::ClaimClaimableBalance(
            ClaimClaimableBalanceOperation {
                source_account: self.source_account,
                balance_id,
            },
        ))
    }
}

#[cfg(test)]
mod tests {
    use crate::claim::ClaimableBalanceId;

    use crate::network::Network;
    use crate::operations::tests::*;
    use crate::operations::Operation;
    use crate::transaction::{Transaction, TransactionEnvelope, MIN_BASE_FEE};
    use crate::xdr::{XDRDeserialize, XDRSerialize};

    #[test]
    fn test_claim_claimable_balance() {
        let kp = keypair0();

        let balance_id = ClaimableBalanceId::new(vec![7; 32]).unwrap();

        let op = Operation::new_claim_claimable_balance()
            .with_claimable_balance_id(balance_id)
            .build()
            .unwrap();

        let mut tx = Transaction::builder(kp.public_key(), 3556091187167235, MIN_BASE_FEE)
            .add_operation(op)
            .into_transaction()
            .unwrap();
        tx.sign(kp.as_ref(), &Network::new_test()).unwrap();
        let envelope = tx.to_envelope();
        let xdr = envelope.xdr_base64().unwrap();
        let expected = "AAAAAgAAAADg3G3hclysZlFitS+s5zWyiiJD5B0STWy5LXCj6i5yxQAAAGQADKI/AAAAAwAAAAAAAAAAAAAAAQAAAAAAAAAPAAAAAAcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHAAAAAAAAAAHqLnLFAAAAQH9SMMxYh28+t9WP0xrJWUZH/i7mk9jG1Qzjvnh2I2Hx/M8OTOqr0511hvBuHI+ETJiAEMUoFw8zb16fXHjQoQQ=";
        assert_eq!(expected, xdr);
        let back = TransactionEnvelope::from_xdr_base64(&xdr).unwrap();
        assert_eq!(envelope, back);
    }

    #[test]
    fn test_claim_claimable_balance_with_source_account() {
        let kp = keypair0();

        let balance_id = ClaimableBalanceId::new(vec![7; 32]).unwrap();

        let op = Operation::new_claim_claimable_balance()
            .with_source_account(kp.public_key())
            .with_claimable_balance_id(balance_id)
            .build()
            .unwrap();

        let mut tx = Transaction::builder(kp.public_key(), 3556091187167235, MIN_BASE_FEE)
            .add_operation(op)
            .into_transaction()
            .unwrap();
        tx.sign(kp.as_ref(), &Network::new_test()).unwrap();
        let envelope = tx.to_envelope();
        let xdr = envelope.xdr_base64().unwrap();
        let expected = "AAAAAgAAAADg3G3hclysZlFitS+s5zWyiiJD5B0STWy5LXCj6i5yxQAAAGQADKI/AAAAAwAAAAAAAAAAAAAAAQAAAAEAAAAA4Nxt4XJcrGZRYrUvrOc1sooiQ+QdEk1suS1wo+oucsUAAAAPAAAAAAcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHAAAAAAAAAAHqLnLFAAAAQD80Q+16BK4ZzJzNGaesezr0cPxsyOvgVVlANU1g91tfM6/NkzLXkB1QI2F4xkXIbp5qbSJ/OfrGRxmsdwWo2g0=";
        assert_eq!(expected, xdr);
        let back = TransactionEnvelope::from_xdr_base64(&xdr).unwrap();
        assert_eq!(envelope, back);
    }
}