nexus-sdk 2.0.0

Rust SDK for Nexus protocol types, RPC access, and transaction construction.
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 {
    crate::sui,
    anyhow::bail,
    reqwest::{header, Client},
    serde::Deserialize,
    std::time::Duration,
    tokio_retry::{strategy::ExponentialBackoff, Retry},
};

/// Request tokens from the Sui faucet for the given address.
pub async fn request_tokens(url: &str, addr: sui::types::Address) -> anyhow::Result<()> {
    #[derive(Debug, Deserialize)]
    struct FaucetResponse {
        error: Option<String>,
    }

    let json_body = serde_json::json!({
        "FixedAmountRequest": {
            "recipient": &addr.to_string()
        }
    });

    let retry_strategy = ExponentialBackoff::from_millis(100)
        .max_delay(Duration::from_secs(5))
        .take(5);

    // Retry a couple times in case the faucet is slow to load.
    let response = Retry::start(retry_strategy, || async {
        let resp = Client::new()
            .post(url)
            .header(header::USER_AGENT, "nexus-leader")
            .json(&json_body)
            .send()
            .await?;

        if !resp.status().is_success() {
            let status = resp.status();
            let detail = resp.text().await.unwrap_or_default();
            anyhow::bail!("Faucet returned {status}: {detail}")
        }

        Ok(resp)
    })
    .await?;

    let faucet_resp: FaucetResponse = response.json().await?;

    if let Some(err) = faucet_resp.error {
        bail!("Faucet request was unsuccessful: {err}");
    }

    Ok(())
}