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

[0xFantomMenace]

Summary

CLI 1.10.0. Three additions through @0xarchive/sdk 1.12.0, plus the order-flow paging and 1-minute interval work already on master:

• Lighter on Robinhood Chain as --exchange rh-lighter, presented as the second Lighter deployment (Lighter mainnet stays --exchange lighter). It works on every shared command Lighter mainnet supports: instruments, order book and history, trades (canonical range and preliminary recent tier), candles, funding, open interest, liquidations, prices, summary, freshness, and auth test. USDG-quoted, 84 markets (57 perp, 27 spot); spot symbols are dashed (AAPL-USDG). No L3.
• Live Robinhood Chain streams: oxa stream orderbook|trades <symbol> --exchange rh-lighter, and oxa stream subscribe accepts rh_lighter_orderbook, rh_lighter_trades, rh_lighter_open_interest, rh_lighter_funding. Same message shapes as the lighter_* live channels; --interval-ms (100 to 5000) works on rh_lighter_orderbook; drop notices are warnings, as on mainnet. rh_lighter_candles is replay-only and refused before a socket opens.
• Account positions: oxa positions get|history|changes|market|summary|all on hyperliquid, hip3, lighter, rh-lighter, plus oxa positions account|account-history on Hyperliquid and HIP-3, and oxa accounts by-l1 for Lighter mainnet. Hyperliquid and HIP-3 take --address 0x...; Lighter takes --account <index>. Times accept ISO 8601 or Unix ms and are sent as Unix ms. JSON output is { data, nextCursor, meta }, so the as-of time, source, quality, staleness, clamp, and finalization fields are always visible.
• Lighter liquidations: oxa liquidations history|volume accept lighter and rh-lighter, with Lighter-specific pretty tables. liquidations user stays Hyperliquid only. Robinhood Chain liquidations are served from 2026-06-26 20:10:26 UTC, the same floor as trades; order book, OI, and funding start at 2026-08-22 18:43 UTC. Rows from before live capture carry source bucket with an empty rawJson; live rows carry source ws and the venue's raw JSON.

Also:

• Brought up to date with master: --cursor on oxa orders flow and oxa hip4 orders flow, and --interval 1m on the aggregated history commands. Their changelog entries moved from Unreleased into 1.10.0.
• oxa positions summary --cursor without --start and --end is now a validation error (exit 2) before any request, since a summary cursor pages an hourly series bound to its window.
• oxa orders, oxa l4, and oxa l2 refuse lighter / rh-lighter with a clear message before any request.
• On Lighter ranges (both deployments), oxa trades fetch passes the response meta through, including finalizedThrough, requestedEnd, and clampedTo. Hyperliquid and HIP-3 trades output is unchanged.
• README: venue scopes, positions (which reads carry the account summary, clamp fields, empty pages before coverage, and how quality reads per venue), liquidations, and stream sections; CHANGELOG entry.
• New npm run check:pack: fails unless the tarball is exactly LICENSE, README.md, dist/cli.js, dist/cli.js.map, package.json, and the bundle reports the package version.
• New CI workflow: typecheck, tests, build, and the package-contents check on Node 20 and 22.

SDK dependency

@0xarchive/sdk 1.12.0 is released alongside this version. The commands read the new SDK resources through small local interfaces, so the CLI type-checks against both the published SDK and 1.12.0, and an install older than the floor exits with "Support for ... requires @0xarchive/sdk 1.12.0 or newer" instead of a TypeError. Until 1.12.0 is on npm, CI installs the newest published SDK for that run only and says so in a warning. Publish this package after the SDK.

Testing

• npm run typecheck: clean against the published SDK and against a build of SDK 1.12.0.
• npm test: 144 tests pass (7 files).
• npm run build and npm run check:pack: pass.
• Every positions and rh-lighter command was run against the live API through SDK 1.12.0: wallet and account reads (latest, exact hour, reconstructed, before coverage), history, changes with a clamped end, market listings with every filter, summary now and as a paged series, bulk by hour, account summaries, the L1 lookup, and the shared market-data commands on rh-lighter, plus live rh_lighter_* streams. Output shapes and meta fields match the README.

[0xFantomMenace]

master now includes #5 (1-minute intervals and the order-flow cursor). This branch conflicts with it in CHANGELOG.md only; the code merges cleanly. When updating this branch, merge master in and move the Unreleased entries from #5 into this release's section. A local merge with that resolution passes typecheck, the test suite (143 passed) and the build.