1.12.0: Lighter on Robinhood Chain, account positions, Lighter liquidations

[0xFantomMenace]

Release 1.12.0 of the Rust SDK: Lighter on Robinhood Chain, account positions and Lighter liquidations. It also releases the order flow cursor and 1-minute interval changes from #13, and fixes freshness().

Lighter on Robinhood Chain

• client.rh_lighter covers /v1/rh-lighter, the second Lighter deployment. It has the same resources as client.lighter except the L3 order book: orderbook, trades, instruments, funding, open_interest, candles, liquidations, positions, freshness(), summary() and price_history().
• Markets are quoted in USDG: uppercase perps (BTC) and dashed spot pairs (AAPL-USDG).
• Coverage: trades and liquidations from 2026-06-26 20:10:26 UTC (venue launch); order book, open interest and funding from 2026-08-22 18:43 UTC; candles from 2026-06-26 once candle history is enabled.
• WebSocket: live and replay on rh_lighter_orderbook, rh_lighter_trades, rh_lighter_open_interest and rh_lighter_funding; rh_lighter_candles is replay-only. subscribe_with_interval() accepts rh_lighter_orderbook (100 to 5000 ms). Live payloads decode with ServerMsg::lighter_live_data().

Lighter liquidations

• liquidations.history() and liquidations.volume() on both Lighter clients, typed as LighterLiquidation and LighterLiquidationVolume. Mainnet history starts on 2026-06-10; Robinhood Chain at the venue launch.
• On Robinhood Chain, rows from before live capture were backfilled from the venue's finalized export and have source "bucket" and an empty raw_json; rows captured live have source "ws" and the venue's raw JSON.

Lighter trades meta

• trades.list_with_meta() and trades.recent_with_meta() return the same rows as list() and recent() with the full meta: finalized_through, requested_end, clamped_to and preliminary_row_count. list() and recent() are unchanged.

Account positions

• positions on client.hyperliquid and client.hyperliquid.hip3 (keyed by 0x address) and on client.lighter and client.rh_lighter (keyed by account index): get, history, changes, market, market_summary and all; Hyperliquid and HIP-3 add account and account_history. client.lighter.accounts.by_l1() finds the account indices of an L1 address (mainnet only).
• Typed models Position, MarketPosition, PositionChange, AccountSummary, MarketPositionsSummary, WalletPositions and LighterL1Accounts, and MetaResponse<T> / ResponseMeta with the full response meta. ResponseMeta::position_totals() decodes the totals of a market listing.
• Lighter market symbols are sent uppercase, since the Lighter positions routes accept uppercase symbols only.

Order flow and intervals (from #13)

• OiFundingInterval::OneMinute ("1m").
• cursor on OrderFlowParams and Hip4OrderFlowParams. The API does not return next_cursor on order flow yet.

Fixed

• freshness() failed on every client with a deserialization error, because the response carries a symbol string next to the per-data-type entries. CoinFreshness has a symbol field now.

Verification

• Every positions and Robinhood Chain method was called against the production API with small limits; every response decoded.
• cargo test --all-features: 89 passed (lib 32, coverage_contract 16, rh_lighter_and_positions 15, websocket_capability 17, doctests 9). cargo test without features passes.
• cargo clippy --all-features --all-targets -- -D warnings and RUSTDOCFLAGS="-D warnings" cargo doc are clean.
• Builds on Rust 1.75 with a lockfile resolved for 1.75.
• The README snippets for the new APIs compile.
• cargo package --list holds only tracked files and cargo metadata.

Version 1.12.0 in Cargo.toml; README and rustdoc install pins read 1.12.