stacks-rs 0.1.4

Rust toolkit to interact with the Stacks 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

use reqwest::Client;

use crate::api::f;
use crate::api::Error;
use crate::Network;

#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, serde::Deserialize)]
pub struct FetchAccountInfoResponse {
    pub balance: String,
    pub locked: String,
    pub unlock_height: u64,
    pub nonce: u64,
    pub balance_proof: String,
    pub nonce_proof: String,
}

#[derive(Debug, Clone)]
pub struct AccountsApi<T: Network> {
    client: Client,
    network: T,
}

impl<T: Network> AccountsApi<T> {
    pub fn new(network: T) -> Self {
        Self {
            client: Client::new(),
            network,
        }
    }

    /// Fetches the account info for a given address.
    pub async fn fetch_account_info(
        &self,
        address: impl Into<String>,
    ) -> Result<FetchAccountInfoResponse, Error> {
        let request_url = f!("{}/v2/accounts/{}", self.network.base_url(), address.into());
        let response = self
            .client
            .get(request_url)
            .send()
            .await?
            .json::<FetchAccountInfoResponse>()
            .await?;

        Ok(response)
    }

    /// Fetches the nonce for a given address.
    pub async fn fetch_account_nonce(&self, address: impl Into<String>) -> Result<u64, Error> {
        let response = self.fetch_account_info(address).await?;
        Ok(response.nonce)
    }
}