rhyperliquid 0.2.0

Rust SDK and client for the Hyperliquid exchange API
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

use crate::{
    api::{exchange::ExchangeApi, info::InfoApi, SubscriptionClient},
    client::HyperliquidClientBuilder,
    error::Result,
    types::chain::NetworkType,
};
use alloy::signers::local::PrivateKeySigner;
use reqwest::{Client, ClientBuilder};
use std::sync::Arc;

#[derive(Clone)]
pub struct HyperliquidClient {
    inner: Arc<Inner>,
}

pub struct Inner {
    http_client: Client,
    base_url: String,
    wallet: Option<PrivateKeySigner>,
    network: NetworkType,
    ws_endpoint: Option<String>,
}

impl Inner {
    pub fn new(
        network: NetworkType,
        base_url: String,
        ws_endpoint: Option<String>,
        wallet: Option<PrivateKeySigner>,
    ) -> Result<Self> {
        let http_client = ClientBuilder::new().build()?;

        Ok(Self {
            http_client,
            base_url,
            ws_endpoint,
            wallet,
            network,
        })
    }
}

impl HyperliquidClient {
    pub fn new(
        network: NetworkType,
        base_url: String,
        ws_endpoint: Option<String>,
        wallet: Option<PrivateKeySigner>,
    ) -> Result<Self> {
        let inner = Arc::new(Inner::new(network, base_url, ws_endpoint, wallet)?);

        Ok(Self { inner })
    }

    pub fn builder() -> HyperliquidClientBuilder {
        HyperliquidClientBuilder::new()
    }

    pub fn http_client(&self) -> &Client {
        &self.inner.http_client
    }

    pub fn base_url(&self) -> &str {
        &self.inner.base_url
    }

    pub fn ws_endpoint(&self) -> Option<&String> {
        self.inner.ws_endpoint.as_ref()
    }

    pub fn signer(&self) -> Option<&PrivateKeySigner> {
        self.inner.wallet.as_ref()
    }

    pub fn network_type(&self) -> &NetworkType {
        &self.inner.network
    }

    pub fn info(&self) -> InfoApi<'_> {
        InfoApi::new(self)
    }

    pub fn exchange(&self) -> ExchangeApi<'_> {
        ExchangeApi::new(self)
    }

    pub async fn subscriptions(&self) -> Result<SubscriptionClient> {
        SubscriptionClient::new(self, None).await
    }

    pub fn is_mainnet(&self) -> bool {
        match self.inner.network {
            NetworkType::Mainnet => true,
            NetworkType::Testnet => false,
        }
    }
}