df-papertrade-core

Rust SDK for Papertrade, gasless 1000x perps on HyperEVM: intents, relayer, live account and exact venue math, on df-hyperliquid-core.

SDK

df-papertrade-core
├── client          Client, config and reads, HyperEVM reads, deployment
│   └── relayer     requests as values, answers, the sender
├── markets
│   ├── trading     trading state, instruments, leverage bounds, the relayer's intake
│   └── stats       protocol summary, volumes, payout queue, recent trades, queue rank
├── account         key and nonce storage, wallet
│   ├── state       live account from the stream
│   ├── session     stored session key, whether it signs, enable and register
│   └── session_key the key that signs opens, closes and cancels
├── trade
│   ├── intent      intents, EIP-712, signatures, intent ids
│   ├── math        bust prices, PnL after impact and fees, open limits, PAPER mint
│   └── writes      open, close, cancel, withdraw, stake, unstake, claim
├── transfer        deposits from Hyperliquid
├── live            account stream parser
└── utils           units, intent nonces, JSON readers

flowchart TB
    app["<b>your app</b><br/>Http, Store, Wallet"]

    subgraph sdk ["df-papertrade-core"]
        direction TB
        domains["<b>markets, account</b><br/><b>trade, transfer</b><br/>reads and intents"]
        client["<b>client</b><br/>relayer, HyperEVM reads"]
    end

    subgraph hl ["df-hyperliquid-core"]
        direction LR
        http["<b>client::http</b>"]
        evm["<b>client::evm</b>"]
        send["<b>transfer::send</b>"]
        keys["<b>account::keys</b>"]
        sign["<b>utils::sign</b>"]
    end

    app --> domains
    domains --> client
    client --> http
    client --> evm
    domains --> send
    domains --> keys
    domains --> sign

Examples

Tests

packages/core
├── src/**/tests       unit: venue math, intents and EIP-712, the stream parser, account state, units
├── tests
│   ├── mocked         whole journeys through Client against a fake relayer, node and /exchange
│   └── live           mainnet, read only: every relayer read, the account stream, the HyperEVM views
└── fixtures           recorded relayer, stream and node answers

Reference implementations

• metalliq.xyz
• tui.hip4.dev