df-hyperliquid-core 0.0.8-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
70
71
72
73
74
75
76
77
78
79
80

<p align="center">
  <a href="https://dfurrer.com">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="assets/dfu-dark.svg">
      <img src="assets/dfu-light.svg" alt="DFU" width="64">
    </picture>
  </a>
</p>

# df-hyperliquid-core

Rust SDK for [Hyperliquid](https://hyperliquid.xyz): markets, trading, transfers, earn and deploy in one crate, with exact decimals, signing and native or wasm transports.

## SDK

```text
df-hyperliquid-core
├── client        /info, /exchange, websocket, HyperEVM RPC, rate limits, Client
│   ├── evm       JSON-RPC, transactions, ABI, precompiles, CoreWriter
│   ├── native    reqwest and tokio transport (feature native)
│   └── web       fetch and WebSocket transport (feature web)
├── markets       perps, spot, HIP-3 dexes, outcomes, books, candles, trades, funding
├── account       balances, positions, orders, fills, fees, modes, subaccounts, API wallets
├── trade         orders, cancel, modify, TWAP, TP/SL, leverage, margin, builder fees
├── transfer      sends, withdrawals, Arbitrum deposits, perps and spot, HyperCore to HyperEVM
├── earn          staking, vaults, lending
├── deploy        spot tokens, HIP-3 dexes, HIP-4 outcome markets
├── live          websocket subscriptions, frames, connection state, store
└── utils         decimals, rounding, asset ids, units, time, hex, nonces, signing
```

```mermaid
flowchart TB
    app["<b>your app</b>"]

    subgraph sdk ["df-hyperliquid-core"]
        direction TB
        domains["<b>markets, account, trade</b><br/><b>transfer, earn, deploy</b><br/>reads and actions"]
        live["<b>live</b><br/>subscriptions, store"]
        client["<b>client</b><br/>sign, send, rate limits"]
        utils["<b>utils</b><br/>decimals, rounding, ids"]
    end

    subgraph hl ["Hyperliquid"]
        direction LR
        rest["<b>/info</b><br/><b>/exchange</b>"]
        ws["<b>websocket</b>"]
        evm["<b>HyperEVM</b>"]
    end

    app --> domains
    app --> live
    domains --> client
    live --> client
    domains --> utils
    client --> rest
    client --> ws
    client --> evm
```

## Examples

| Example | What it does |
|---|---|
| `cargo run -p df-hyperliquid-core --example perps_page` | Reads BTC's meta, book and context from mainnet, prints the unsigned market order for a $20 long |

## Reference implementations

- [metalliq.xyz](https://metalliq.xyz)
- [tui.hip4.dev](https://tui.hip4.dev)

<br>

<p align="center">
  <sub><sub><a href="https://dfurrer.com">DFU</a></sub></sub>
  &emsp;&emsp;&emsp;
  <sub><a href="https://dfurrer.com">dfurrer.com</a></sub>
  &emsp;&emsp;&emsp;
  <sub><sub><a href="https://dfurrer.com">df.hl</a></sub></sub>
</p>