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

use helius::client::Helius;
use helius::error::Result;
use helius::types::Cluster;

#[tokio::test]
async fn test_creating_new_client_success() {
    let api_key: &str = "valid-api-key";
    let cluster: Cluster = Cluster::Devnet;

    let result: Result<Helius> = Helius::new(api_key, cluster);
    assert!(result.is_ok());

    let helius: Helius = result.unwrap();
    assert!(helius.config.api_key.is_some());
    assert_eq!(helius.config.api_key.as_ref().unwrap().as_str(), api_key);
}

#[tokio::test]
async fn test_creating_new_async_client_fails_without_real_ws() {
    // new_async() includes WebSocket, which requires a real connection.
    // With a fake API key, the WS connection will fail.
    let api_key: &str = "valid-api-key";
    let cluster: Cluster = Cluster::Devnet;

    let result: Result<Helius> = Helius::new_async(api_key, cluster).await;
    assert!(result.is_err());
}

#[tokio::test]
async fn test_creating_async_client_via_builder() {
    // Use the builder directly without WebSocket for testability
    use helius::HeliusBuilder;

    let api_key: &str = "valid-api-key";
    let cluster: Cluster = Cluster::Devnet;

    let result: Result<Helius> = HeliusBuilder::new()
        .with_api_key(api_key)
        .unwrap()
        .with_cluster(cluster)
        .with_async_solana()
        .build()
        .await;
    assert!(result.is_ok());

    let helius: Helius = result.unwrap();
    assert!(helius.config.api_key.is_some());
    assert_eq!(helius.config.api_key.as_ref().unwrap().as_str(), api_key);
    assert!(helius.async_rpc_client.is_some());
}

#[tokio::test]
async fn test_creating_new_client_with_custom_url_success() {
    let result: Result<Helius> = Helius::new_with_url("http://localhost:8899");
    assert!(result.is_ok());

    let helius: Helius = result.unwrap();
    assert!(helius.config.api_key.is_none());
    assert!(helius.config.custom_url.is_some());
}