df-hyperliquid-core 0.0.8-beta.1

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

//! A recorded `l2Book` answer (BTC) and recorded `l2Book` frames (ETH at five figures, and an
//! empty outcome book), all mainnet on 2026-10-08, one level a side kept.

use super::*;

const READ: &str = r#"{"coin":"BTC","time":1791480825902,"levels":[[{"px":"80858.0","sz":"23.7926","n":61}],[{"px":"80859.0","sz":"0.94647","n":5}]]}"#;
const BUCKETED: &str = r#"{"coin":"ETH","time":1791480444439,"levels":[[{"px":"2410.2","sz":"655.1567","n":58}],[{"px":"2410.4","sz":"3.544","n":2}]],"spread":"0.1"}"#;
const EMPTY: &str = r##"{"coin":"#14720","time":1791480447083,"levels":[[],[]]}"##;

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

#[test]
fn a_book_reads_bids_then_asks_best_first() {
    let book: Book = serde_json::from_str(READ).unwrap();
    assert_eq!((book.coin.as_str(), book.time, book.spread), ("BTC", 1_791_480_825_902, None));
    assert_eq!(book.bids, [Level { px: dec("80858"), sz: dec("23.7926"), n: 61 }]);
    assert_eq!(book.asks(), &book.asks[..]);
    assert_eq!(book.touch(), (Some(dec("80858")), Some(dec("80859"))));
    assert_eq!(book.mid(), Some(dec("80858.5")), "the midpoint, exactly");
    let bucketed: Book = serde_json::from_str(BUCKETED).unwrap();
    assert_eq!((bucketed.spread, bucketed.mid()), (Some(dec("0.1")), Some(dec("2410.3"))));
}

#[test]
fn an_empty_side_has_no_touch_and_no_mid() {
    let book: Book = serde_json::from_str(EMPTY).unwrap();
    assert_eq!(book.touch(), (None, None));
    assert_eq!(book.mid(), None);
}

#[test]
fn a_book_without_its_time_is_refused() {
    assert!(serde_json::from_str::<Book>(r#"{"coin":"BTC","levels":[[],[]]}"#).is_err());
}

#[test]
fn halfway_is_a_place_finer_than_either_price() {
    assert_eq!(halfway(dec("0.58495"), dec("0.58498")), Some(dec("0.584965")));
    assert_eq!(halfway(dec("100"), dec("101")), Some(dec("100.5")));
}