kadena 0.1.0

A comprehensive Rust library for interacting with Pact smart contracts and the Kadena blockchain.
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

use serde::{Deserialize, Serialize};

/// Metadata for a Pact command.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Meta {
    #[serde(rename = "chainId")]
    pub chain_id: String,
    pub sender: String,
    #[serde(rename = "gasLimit")]
    pub gas_limit: u64,
    #[serde(rename = "gasPrice")]
    pub gas_price: f64,
    pub ttl: u64,
    #[serde(rename = "creationTime")]
    pub creation_time: u64,
}

impl Meta {
    /// Creates a new Meta instance with common default values
    ///
    /// # Arguments
    ///
    /// * `chain_id` - The chain ID where the command will be executed
    /// * `sender` - The sender's account address
    ///
    /// # Examples
    ///
    /// ```
    /// use kadena::pact::Meta;
    ///
    /// let meta = Meta::new("0", "k:abc123");
    /// assert_eq!(meta.chain_id, "0");
    /// assert_eq!(meta.gas_limit, 1500);
    /// ```
    pub fn new(chain_id: &str, sender: &str) -> Self {
        Self {
            chain_id: chain_id.to_string(),
            sender: sender.to_string(),
            gas_limit: 1500,       // Common default
            gas_price: 0.00000001, // Common default
            ttl: 3600,             // Default 1 hour
            creation_time: std::time::SystemTime::now()
                .duration_since(std::time::UNIX_EPOCH)
                .unwrap()
                .as_secs(),
        }
    }

    /// Creates a new Meta instance with all parameters specified
    ///
    /// # Examples
    ///
    /// ```
    /// use kadena::pact::Meta;
    ///
    /// let meta = Meta::with_params(
    ///     "0",
    ///     "k:abc123",
    ///     2000,
    ///     0.00000001,
    ///     7200,
    ///     1234567890,
    /// );
    /// ```
    pub fn with_params(
        chain_id: &str,
        sender: &str,
        gas_limit: u64,
        gas_price: f64,
        ttl: u64,
        creation_time: u64,
    ) -> Self {
        Self {
            chain_id: chain_id.to_string(),
            sender: sender.to_string(),
            gas_limit,
            gas_price,
            ttl,
            creation_time,
        }
    }

    /// Modifies the gas limit
    pub fn with_gas_limit(mut self, gas_limit: u64) -> Self {
        self.gas_limit = gas_limit;
        self
    }

    /// Modifies the gas price
    pub fn with_gas_price(mut self, gas_price: f64) -> Self {
        self.gas_price = gas_price;
        self
    }

    /// Modifies the TTL
    pub fn with_ttl(mut self, ttl: u64) -> Self {
        self.ttl = ttl;
        self
    }
}