df-hyperliquid-core 0.0.9-beta

Hyperliquid SDK for Rust: markets, account, trading, transfers, earn and deploy, with exact decimals and signing. Native and wasm.
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

//! Each ticket check down to the exact JSON it would sign. The markets: BTC (asset 0, five size
//! decimals, 40x), ETH (1, four), `xyz:TSLA` (110001, three, 10x, isolated only), PURR/USDC (10000,
//! none) and `@107` (10107, two). A market order is bounded from 84000.5, one percent away.

use crate::trade::*;

use crate::utils::sign::L1Action;
use crate::utils::{Address, Asset, Dec};

use crate::account::FrontendOrder;
use crate::trade::builder::BuilderSetting;
use crate::trade::orders::{Side, Tif};

pub fn dec(text: &str) -> Dec {
    Dec::parse(text).unwrap()
}

pub fn btc() -> Market {
    Market::perp(Asset::from_id(0), 5, 40, true).unwrap()
}

pub fn eth() -> Market {
    Market::perp(Asset::from_id(1), 4, 25, true).unwrap()
}

pub fn tsla() -> Market {
    Market::perp(Asset::from_id(110_001), 3, 10, false).unwrap()
}

pub fn hype() -> Market {
    Market::spot(Asset::from_id(10_107), 2).unwrap()
}

pub fn one_percent() -> Dec {
    dec("0.01")
}

pub fn market(side: Side, size: &str) -> OrderIntent {
    OrderIntent::market(side, Amount::Size(dec(size)), dec("84000.5"), one_percent())
}

pub fn limit(side: Side, price: &str, size: &str, tif: Tif) -> OrderIntent {
    OrderIntent::limit(side, Amount::Size(dec(size)), dec(price), tif)
}

pub fn wire(placed: Result<impl L1Action, Refusal>) -> String {
    placed.unwrap().wire()
}

pub fn builder_address() -> Address {
    "0x6967d7AcD1EC5f210E9590666498e0cC5D13a843".parse().unwrap()
}

pub fn at_88_percent() -> BuilderSetting {
    BuilderSetting::share_of_cap(builder_address(), 88).unwrap()
}

/// A resting order as `frontendOpenOrders` writes one, in the venue's own
/// words: `B` a buy, a stop with its `triggerPx`, a position's at `"0.0"`.
pub fn resting(oid: u64, side: &str, price: &str, size: &str, kind: &str, trigger: Option<&str>) -> FrontendOrder {
    let (is_trigger, trigger_px, tif, reduce) = match trigger {
        Some(at) => (true, at, "null", true),
        None => (false, "0.0", r#""Gtc""#, false),
    };
    serde_json::from_str(&format!(
        r#"{{"coin":"BTC","side":"{side}","limitPx":"{price}","sz":"{size}","oid":{oid},"timestamp":1790415847986,"triggerCondition":"N/A","isTrigger":{is_trigger},"triggerPx":"{trigger_px}","children":[],"isPositionTpsl":false,"reduceOnly":{reduce},"orderType":"{kind}","origSz":"{size}","tif":{tif},"cloid":null}}"#
    ))
    .unwrap()
}