df-lighter-core

Rust SDK for Lighter, on Lighter and on Lighter on Robinhood Chain: markets, trading, transfers, pools and binary options in one crate, with exact decimals, the API key signer in Rust and native or wasm transports.

SDK

df-lighter-core
├── client          the Client, the two networks, rate limits
│   ├── http        the REST API, the wire, sendTx, the limit gate
│   ├── evm         the L1: JSON-RPC, EIP-1559 transactions, ABI, the ZkLighter contract
│   ├── native      reqwest and tokio-tungstenite (feature native)
│   └── web         fetch and WebSocket (feature web)
├── markets         what is listed and what it trades at
│   ├── books       perps and spot pairs, their details and grids
│   ├── book        resting orders, depth, a taker's walk
│   ├── trades      the tape and trade history
│   ├── candles     trade and mark price candles
│   ├── funding     hourly settlements, current rates
│   ├── assets      assets, tokens, oracles
│   ├── stats       exchange stats, metrics, fee tiers
│   ├── system      system config, contract, L1, announcements
│   └── binary      binary options events
├── account         what an account holds and who may sign for it
│   ├── holdings    the account, positions, balances, pool shares, an owner's accounts
│   ├── history     orders, fills, transactions, PnL, funding, liquidations
│   ├── keys        API keys, auth tokens, the owner's wallet, registering a key
│   └── settings    sub-accounts, trading mode, integrators, tier, read tokens, referrals
├── trade           orders on every market
│   ├── orders      limit, market, stop, take-profit, TWAP, grouped, client indexes
│   ├── manage      cancel, cancel all, modify
│   └── margin      leverage, isolated margin
├── transfer        transfers, secure and fast withdrawals, deposits through the L1, history
├── earn            public pools and the LLP, LIT staking, fee credits
├── deploy          binary options markets an operator creates, updates and settles
├── live            websocket subscriptions, frames, connection state, the kept book
└── utils           decimals, grids, ids, units, time, nonces, Poseidon2, ECgFp5, Schnorr

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

    subgraph sdk ["df-lighter-core"]
        direction TB
        domains["<b>markets, account, trade</b><br/><b>transfer, earn, deploy</b><br/>reads and transactions"]
        live["<b>live</b><br/>subscriptions, book"]
        client["<b>client</b><br/>sign, send, nonces, rate limits"]
        utils["<b>utils</b><br/>decimals, grids, ids, signer"]
    end

    subgraph venue ["Lighter, Lighter on Robinhood Chain"]
        direction LR
        rest["<b>/api/v1</b>"]
        ws["<b>websocket</b>"]
        l1["<b>Ethereum</b><br/><b>Robinhood Chain</b>"]
    end

    app --> domains
    app --> live
    domains --> client
    live --> client
    domains --> utils
    client --> rest
    client --> ws
    client --> l1

Examples

Tests

packages/core
├── src/**/tests       unit: decimals, grids, encoding, signing, refusals, every read on its recording
├── tests
│   ├── conformance    every transaction, auth token and L1 call matches lighter-go and go-ethereum
│   ├── mocked         whole journeys through Client against a fake venue that checks every signature
│   └── live           both networks, read only: every public read and L1 read
├── fixtures           recorded venue answers, both networks
└── vectors            what lighter-go and go-ethereum produce, and the program that made them