cryptopay 0.1.0

A comprehensive Rust library for BscScan API integration and payment verification on Binance Smart Chain
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

//! Account-related API endpoints

use crate::client::types::{Balance, InternalTransaction, Transaction};
use crate::client::BscScanClient;
use crate::error::Result;

/// Account endpoints
pub trait AccountEndpoints {
    /// Get BNB balance for an address
    ///
    /// # Example
    /// ```no_run
    /// # use cryptopay::*;
    /// # use cryptopay::client::AccountEndpoints;
    /// # async fn example() -> Result<()> {
    /// let client = BscScanClient::new("api-key")?;
    /// let balance = client.get_balance("0x...").await?;
    /// println!("Balance: {} BNB", balance.bnb());
    /// # Ok(())
    /// # }
    /// ```
    async fn get_balance(&self, address: &str) -> Result<Balance>;

    /// Get list of transactions for an address
    ///
    /// # Parameters
    /// - `address`: The address to get transactions for
    /// - `start_block`: Starting block number (0 for all)
    /// - `end_block`: Ending block number (99999999 for latest)
    /// - `page`: Page number (1-indexed)
    /// - `offset`: Number of transactions per page (max 10000)
    /// - `sort`: "asc" or "desc"
    async fn get_transactions(
        &self,
        address: &str,
        start_block: u64,
        end_block: u64,
        page: u32,
        offset: u32,
        sort: &str,
    ) -> Result<Vec<Transaction>>;

    /// Get list of internal transactions for an address
    async fn get_internal_transactions(
        &self,
        address: &str,
        start_block: u64,
        end_block: u64,
        page: u32,
        offset: u32,
        sort: &str,
    ) -> Result<Vec<InternalTransaction>>;
}

impl AccountEndpoints for BscScanClient {
    async fn get_balance(&self, address: &str) -> Result<Balance> {
        let params = [("address", address), ("tag", "latest")];

        // BscScan returns balance as a simple string, wrap it
        let balance_str: String = self.request_simple("account", "balance", &params).await?;

        Ok(Balance { wei: balance_str })
    }

    async fn get_transactions(
        &self,
        address: &str,
        start_block: u64,
        end_block: u64,
        page: u32,
        offset: u32,
        sort: &str,
    ) -> Result<Vec<Transaction>> {
        let params = [
            ("address", address),
            ("startblock", &start_block.to_string()),
            ("endblock", &end_block.to_string()),
            ("page", &page.to_string()),
            ("offset", &offset.to_string()),
            ("sort", sort),
        ];

        self.request("account", "txlist", &params).await
    }

    async fn get_internal_transactions(
        &self,
        address: &str,
        start_block: u64,
        end_block: u64,
        page: u32,
        offset: u32,
        sort: &str,
    ) -> Result<Vec<InternalTransaction>> {
        let params = [
            ("address", address),
            ("startblock", &start_block.to_string()),
            ("endblock", &end_block.to_string()),
            ("page", &page.to_string()),
            ("offset", &offset.to_string()),
            ("sort", sort),
        ];

        self.request("account", "txlistinternal", &params).await
    }
}