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
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

//! `spot_tokens.json` is live `spotMeta`, mainnet and testnet, 2026-10-08,
//! cut to the tokens below, each as the venue wrote it.

use std::collections::BTreeMap;

use crate::client::Network;
use crate::utils::Address;

use super::*;
use crate::transfer::check::{HYPE_SYSTEM, system_address};

const TOKENS: &str = include_str!(concat!(env!("CARGO_MANIFEST_DIR"), "/fixtures/transfer/spot_tokens.json"));

fn tokens() -> BTreeMap<String, Vec<SpotToken>> {
    serde_json::from_str(TOKENS).unwrap()
}

fn token(network: Network, name: &str) -> SpotToken {
    tokens()[network.name()].iter().find(|token| token.name == name).cloned().unwrap()
}

/// HYPE's index and id differ between the networks: 150 on mainnet, 1105 on
/// testnet, where 150 is another token altogether.
#[test]
fn hype_is_the_network_s_own_token() {
    for network in Network::ALL {
        let listed = token(network, "HYPE");
        let ours = hype(network);
        assert_eq!(
            (listed.index, listed.token_id.as_str(), listed.wire(), listed.wei_decimals),
            (ours.index, ours.token_id, ours.wire.to_owned(), ours.wei_decimals),
            "{network}"
        );
        assert!(listed.is_hype(network), "{network}");
        let usdc = token(network, "USDC");
        assert_eq!(usdc.wire(), network.usdc().wire, "{network}");
        assert_eq!(SpotToken::from(network.usdc()).wire(), usdc.wire(), "{network}");
    }
    assert_eq!((hype(Network::Mainnet).index, hype(Network::Testnet).index), (150, 1105));
    let testnet_150 = token(Network::Testnet, "ALERTT");
    assert_eq!(testnet_150.index, 150);
    assert!(!testnet_150.is_hype(Network::Testnet));
    assert!(!token(Network::Mainnet, "HYPE").is_hype(Network::Testnet));
}

/// HYPE is HyperEVM's own coin, eighteen decimals: on mainnet `spotMeta`
/// links it to nothing, on testnet to the zero address with ten more decimals.
/// Every other token is its ERC-20's `weiDecimals` plus the extra, or none.
#[test]
fn a_token_s_decimals_on_hyperevm_and_what_a_crossing_keeps() {
    let mainnet = |name: &str| token(Network::Mainnet, name);
    let testnet = |name: &str| token(Network::Testnet, name);
    assert_eq!(mainnet("HYPE").evm_contract, None);
    assert_eq!(
        testnet("HYPE").evm_contract.map(|link| (link.address, link.extra_wei_decimals)),
        Some((Address::ZERO, 10))
    );
    for (network, token, evm, crossing) in [
        (Network::Mainnet, mainnet("HYPE"), Some(18), Some(8)),
        (Network::Testnet, testnet("HYPE"), Some(18), Some(8)),
        (Network::Mainnet, mainnet("UBTC"), Some(8), Some(8)),
        (Network::Mainnet, mainnet("KNTQ"), Some(18), Some(8)),
        (Network::Mainnet, mainnet("USDC"), Some(6), Some(6)),
        (Network::Testnet, testnet("USDC"), Some(6), Some(6)),
        (Network::Testnet, testnet("ALERTT"), None, None),
    ] {
        assert_eq!(token.evm_decimals(network), evm, "{network} {}", token.name);
        assert_eq!(token.crossing_places(network), crossing, "{network} {}", token.name);
    }
}

/// KNTQ's address matches the destination of a live `spotTransfer` of KNTQ to
/// HyperEVM in `ledger.json`.
#[test]
fn each_token_crosses_through_its_own_address() {
    for network in Network::ALL {
        assert_eq!(token(network, "HYPE").system_address(network), HYPE_SYSTEM, "{network}");
    }
    let kntq = token(Network::Mainnet, "KNTQ");
    assert_eq!(kntq.system_address(Network::Mainnet).to_hex(), "0x200000000000000000000000000000000000007c");
    assert_eq!(token(Network::Mainnet, "UBTC").system_address(Network::Mainnet), system_address(197));
}