helius 1.1.0

An asynchronous Helius Rust SDK for building the future of Solana
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

use crate::error::Result;
use crate::types::{EnhancedTransaction, ParseTransactionsRequest, ParsedTransactionHistoryRequest};
use crate::Helius;

use reqwest::{Method, Url};

impl Helius {
    /// Parses transactions given an array of transaction IDs
    ///
    /// # Arguments
    /// * `ParseTransactionsRequest` - A parse transaction request, which includes:
    /// - A vector of transaction IDs to be parsed
    ///
    /// # Returns
    /// A `Result` wrapping a vector of `EnhancedTransaction`s
    pub async fn parse_transactions(&self, request: ParseTransactionsRequest) -> Result<Vec<EnhancedTransaction>> {
        let api_key = self.config.require_api_key("enhanced transaction parsing")?;
        let url: String = format!(
            "{}v0/transactions?api-key={}",
            self.config.endpoints.api,
            api_key.as_str()
        );
        let parsed_url: Url = Url::parse(&url).expect("Failed to parse URL");

        self.rpc_client
            .handler
            .send(Method::POST, parsed_url, Some(&request))
            .await
    }

    /// Retrieves a parsed transaction history for a specific address
    ///
    /// # Arguments
    /// * `ParsedTransactionHistoryRequest` - A parsed transaction history request, which includes:
    /// - An address for which a given parsed transaction history will be retrieved
    /// - An optional `before` parameter that, when provided, fetches the parsed transaction history before the given signature. This is useful for pagination
    ///
    /// # Returns
    /// A `Result` wrapping a vector of `EnhancedTransaction`s
    pub async fn parsed_transaction_history(
        &self,
        request: ParsedTransactionHistoryRequest,
    ) -> Result<Vec<EnhancedTransaction>> {
        let api_key = self.config.require_api_key("enhanced transaction history")?;
        let mut url: String = format!(
            "{}v0/addresses/{}/transactions?api-key={}",
            self.config.endpoints.api,
            request.address,
            api_key.as_str()
        );

        if let Some(before) = request.before {
            url = format!("{}&before={}", url, before);
        }

        if let Some(until) = request.until {
            url = format!("{}&until={}", url, until);
        }

        if let Some(commitment) = request.commitment {
            url = format!("{}&commitment={}", url, commitment);
        }

        if let Some(source) = request.source {
            url = format!("{}&source={}", url, source);
        }

        if let Some(transaction_type) = request.transaction_type {
            url = format!("{}&type={}", url, transaction_type);
        }

        if let Some(limit) = request.limit {
            url = format!("{}&limit={}", url, limit);
        }

        let parsed_url: Url = Url::parse(&url).expect("Failed to parse URL");

        self.rpc_client.handler.send(Method::GET, parsed_url, None::<&()>).await
    }
}