zera-sdk 0.1.0

Rust SDK for ZERA transactions, validator APIs, and bridge workflows
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

use zera_proto::zera_txn::SmartContractExecuteTxn;

use crate::contract::shared::validate_key_pair;
use crate::error::{Result, ZeraError};
use crate::grpc::{UnaryTransport, ValidatorApiClient};
use crate::sign::sign_with_key;
use crate::smart_contracts::{
    build_smart_contract_execute_txn_with_client, create_smart_contract_execute_txn,
    CreateSmartContractExecuteOptions, ExecuteParameter, ParameterType,
};

use super::types::StakingOptions;

pub const STAKING_CONTRACT_NAME: &str = "staking_proxy";
pub const STAKING_INSTANCE: u32 = 1;
pub const DEFAULT_STAKING_FEE_ID: &str = "$ZRA+0000";

pub async fn create_staking_transaction(
    action_name: &str,
    parameter_value: &str,
    public_key_base58_identifier: &str,
    private_key_base58: &str,
    fee_id: &str,
    options: StakingOptions,
) -> Result<SmartContractExecuteTxn> {
    let parameters = vec![
        ExecuteParameter {
            parameter_type: ParameterType::String.as_str().to_string(),
            value: action_name.as_bytes().to_vec(),
        },
        ExecuteParameter {
            parameter_type: ParameterType::String.as_str().to_string(),
            value: parameter_value.as_bytes().to_vec(),
        },
    ];

    create_smart_contract_execute_txn(
        STAKING_CONTRACT_NAME,
        STAKING_INSTANCE,
        "execute",
        &parameters,
        public_key_base58_identifier,
        private_key_base58,
        CreateSmartContractExecuteOptions {
            memo: options.memo,
            grpc_config: options.grpc_config,
            gas_fee_in_usd: options.gas_fee_in_usd,
            overestimate_percent: options.overestimate_percent,
            nonce: options.nonce,
            fee_id: Some(fee_id.to_string()),
            fee_amount_parts: options.fee_amount_usd,
        },
    )
    .await
}

pub async fn create_staking_transaction_with_client<T>(
    action_name: &str,
    parameter_value: &str,
    public_key_base58_identifier: &str,
    private_key_base58: &str,
    fee_id: &str,
    options: StakingOptions,
    client: &ValidatorApiClient<T>,
) -> Result<SmartContractExecuteTxn>
where
    T: UnaryTransport,
{
    if private_key_base58.is_empty() {
        return Err(ZeraError::Validation(
            "privateKeyBase58 is required".to_string(),
        ));
    }
    validate_key_pair(public_key_base58_identifier, private_key_base58)?;

    let parameters = vec![
        ExecuteParameter {
            parameter_type: ParameterType::String.as_str().to_string(),
            value: action_name.as_bytes().to_vec(),
        },
        ExecuteParameter {
            parameter_type: ParameterType::String.as_str().to_string(),
            value: parameter_value.as_bytes().to_vec(),
        },
    ];

    let mut txn = build_smart_contract_execute_txn_with_client(
        STAKING_CONTRACT_NAME,
        STAKING_INSTANCE,
        "execute",
        &parameters,
        public_key_base58_identifier,
        CreateSmartContractExecuteOptions {
            memo: options.memo,
            grpc_config: options.grpc_config,
            gas_fee_in_usd: options.gas_fee_in_usd,
            overestimate_percent: options.overestimate_percent,
            nonce: options.nonce,
            fee_id: Some(fee_id.to_string()),
            fee_amount_parts: options.fee_amount_usd,
        },
        client,
    )
    .await?;

    sign_with_key(&mut txn, private_key_base58, public_key_base58_identifier)?;
    Ok(txn)
}