Release v0.1.2

Changes

Added

• Exchange: API-wallet account selection support — added a constructor overload with optional account_address so authenticated flows can query the effective trading account separately from the signing key.
• Info: canonical asset lookup helpers — added name_to_coin, name_to_asset, asset_to_sz_decimals, and canonical_coin() to resolve human-readable market names to Hyperliquid wire identifiers and asset ids.
• WebsocketManager::message_to_identifier() — explicit inbound message routing helper for channel-to-handler lookup.
• Offline exchange parity tests — added tests/test_exchange.cpp covering spot/perp mapping, payload shapes, price rounding, and effective-account selection.

Fixed

• WebsocketManager: use-after-free / same-dispatch unsubscribe race — callbacks now dispatch from a lock-free snapshot of shared handler state instead of copying std::functions under a mutex. Each callback entry carries an active flag and in_flight counter: unsubscribe() removes the callback from future snapshots, marks that specific callback inactive, and waits on its per-callback in-flight count with C++20 atomic wait/notify. This prevents a later callback from firing after being removed earlier in the same snapshot while still allowing self-unsubscribe without deadlocking.
• updateIsolatedMargin payload shape — exchange requests now send the documented ntli field with isBuy: true instead of the previous mismatched parameters.
• usdClassTransfer formatting — the signed action now uses the SDK-compatible "amount" string and appends " subaccount:<address>" when trading through a vault.
• Effective account selection for market_close() — account state is now queried against vault_address, then account_address, then the signer wallet, matching Hyperliquid API-wallet semantics.
• Vault handling for user-signed transfers — user-signed exchange payloads now include or omit vaultAddress consistently with the current Python SDK behavior.
• basic_order.cpp default credentials — the example now uses the Hardhat private key instead of the Hardhat address.

Changed

• WebsocketManager: removed pending_subs_ pre-connection queue — the underlying slick::net::Websocket already buffers outbound frames until the connection is established, making the manual pending-subscription queue redundant. subscribe() and unsubscribe() now call ws_->send() unconditionally; flush_pending(), writer_mutex_, and the pending_subs_ vector are all removed.
• Metadata loading now matches the Hyperliquid SDK/docs — perp assets use meta indices, spot assets use 10000 + spotMeta.index, and spot aliases such as PURR/USDC and @<index> resolve to canonical wire coins.
• REST and WebSocket market-data requests now canonicalize coin names before sending requests, so spot and perp subscriptions/queries use documented wire names instead of assuming perpetual-only symbols.
• Exchange precision handling was tightened to SDK behavior — float_to_wire() and float_to_usd_int() now reject silent rounding, and market-order slippage pricing now applies 5 significant figures with max decimals derived from szDecimals.
• WebSocket routing was rebuilt around explicit message identifiers — trades, candle, activeAssetCtx, activeSpotAssetCtx, userEvents, and orderUpdates now route using the actual inbound payload shape, with a 50-second heartbeat under the documented idle timeout.
• Internal identifier normalization is narrower — coin-bearing websocket identifiers now preserve canonical coin casing, while address-bearing identifiers still lowercase the user/address portion for stable routing.
• Docs and examples were refreshed — README.md now documents the expanded asset lookup maps, account_address, and the updated update_isolated_margin(coin, amount) signature.

Tests

• UnsubscribeBlocksUntilCallbackCompletes (integration) — regression test for the above fix; subscribes with a callback that blocks until explicitly released, calls unsubscribe() concurrently from a second thread, and asserts that unsubscribe() does not return before the in-flight callback has finished.
• CallbackCanRemoveLaterCallbackFromSameDispatch (integration) — regression test for the snapshot hazard where callback A unsubscribes callback B on the same channel before the dispatcher reaches B in the already-loaded snapshot.
• Signing regressions — added tests asserting that float_to_wire() and float_to_usd_int() throw when serialization would require rounding.
• WebSocket routing regressions — extended channel-identifier tests to cover inbound routing, snapshot-safe channel naming, spot/perp active-asset messages, address normalization, and preserved coin casing.

Release v0.1.1

Changes

Added

• install() rules and generated CMake package-config files (hyperliquid-config.cmake, hyperliquid-config-version.cmake, hyperliquid-targets.cmake) so the library can be consumed via find_package(hyperliquid CONFIG REQUIRED) after cmake --install / vcpkg install
• HYPERLIQUID_BUILD_TESTS and HYPERLIQUID_BUILD_EXAMPLES CMake options — default ON for top-level builds, automatically OFF when the project is consumed via add_subdirectory/FetchContent

Changed

• target_compile_features(hyperliquid PUBLIC cxx_std_20) — the C++20 requirement now propagates to consumers through the exported target
• Raised minimum CMake version from 3.20 to 3.21 (required for PROJECT_IS_TOP_LEVEL)

Release v0.1.0

Added

Core library (hyperliquid)

Info — read-only REST + WebSocket client

• meta() — perpetuals universe (names, szDecimals, …)
• spot_meta() — spot token list and spot universe
• all_mids() — all mid prices as {coin: priceString}
• l2_snapshot(coin) — full L2 order-book snapshot
• bbo(coin) — best bid/offer (WebSocket-only; REST returns 422 on testnet)
• candle_snapshot(coin, interval, start_ms[, end_ms]) — OHLCV candles; intervals: 1m 5m 15m 30m 1h 4h 8h 12h 1d 3d 1w
• perp_asset_ctxs() — funding rate, open interest, and mark price for all perps
• spot_asset_ctxs() — spot market context
• funding_history(coin, start_ms[, end_ms]) — historical funding rates
• user_state(address) — margin summary and open positions
• open_orders(address) — open orders
• user_fills(address) — complete fill history
• user_fills_by_time(address, start_ms[, end_ms]) — fills within a time window
• query_order_by_oid(address, oid) — single order lookup by order ID
• query_order_by_cloid(address, cloid) — single order lookup by client order ID
• sub_accounts(address) — sub-account list
• load_meta() — populates coin_to_asset map (called automatically by Exchange)
• subscribe(subscription, callback) — WebSocket subscription; returns integer ID; multiple callbacks per channel supported
• unsubscribe(subscription, id) — remove a subscription; double-unsubscribe is harmless
• skip_ws constructor flag (Info(url, true)) — disables WebSocket for REST-only use

Exchange — authenticated trading client

• Order management
  • order(coin, is_buy, sz, limit_px, order_type[, reduce_only, cloid, builder, grouping]) — single limit or trigger order
  • bulk_orders(orders[, builder, grouping]) — multiple orders in one round trip
  • market_open(coin, is_buy, sz[, slippage, cloid]) — IoC limit at mid ± slippage (default 5 %)
  • market_close(coin[, sz, slippage, cloid]) — close position at mid ± slippage; queries user_state for size
• Cancel
  • cancel(coin, oid) / cancel_by_cloid(coin, cloid)
  • bulk_cancel(cancels) / bulk_cancel_by_cloid(cancels)
  • schedule_cancel([time_ms]) — dead-man's switch
• Modify
  • modify_order(oid, new_order) / bulk_modify_orders(mods)
• Leverage and margin
  • update_leverage(coin, is_cross, leverage)
  • update_isolated_margin(coin, is_buy, ntl)
• Transfers (user-signed EIP-712)
  • usd_class_transfer(amount, to_perp) — spot ↔ perp vault
  • usd_transfer(amount, destination) — send USDC to an address
  • spot_transfer(amount, destination, token) — send spot tokens
  • withdraw_from_bridge(amount, destination) — L1 withdrawal
• Agent and builder
  • approve_agent(agent_address[, agent_name])
  • approve_builder_fee(builder, max_fee_rate)
• Sub-accounts
  • create_sub_account(name)
  • sub_account_transfer(usd, to_sub, sub_account_user)
• wallet_address() — returns the Ethereum address derived from the private key
• vault_address constructor parameter — sign on behalf of a sub-account / vault

Cryptographic internals

• Embedded Keccak-256 implementation (Ethereum's pre-FIPS variant — distinct from OpenSSL's SHA3-256)
• EIP-712 signing for L1 actions (Exchange domain, chainId 1337)
• EIP-712 signing for user-signed actions (HyperliquidSignTransaction domain, chainId 0x66eee)
• msgpack-based action hashing using nlohmann::ordered_json for byte-compatible key ordering with the Python SDK
• Private key accepted with or without "0x" prefix

Types (hyperliquid::utils::types)

• Tif enum — Gtc, Ioc, Alo
• LimitOrderType{tif} — standard limit order
• TriggerOrderType{trigger_px, is_market, tpsl} — stop / TP-SL; tpsl is "tp" or "sl"
• Cloid — 16-byte client order ID; construct via Cloid::from_int(uint64_t) or Cloid::from_str("0x...")
• BuilderInfo{builder_address, fee_tbps} — fee_tbps is in tenths of basis points (e.g. 10 = 1 bps)
• OrderRequest, CancelRequest, CancelByCloidRequest, ModifyRequest — bulk operation helpers

Constants

• MAINNET_API_URL — https://api.hyperliquid.xyz
• TESTNET_API_URL — https://api.hyperliquid-testnet.xyz

Build system

• CMake ≥ 3.20 build with C++20
• vcpkg integration (nlohmann-json, openssl, gtest, slick-net)
• Targets: hyperliquid (static library), basic_order (example), hyperliquid_tests (unit tests), hyperliquid_integration_tests (integration tests)

Examples

• examples/basic_order.cpp — places a resting GTC limit buy on testnet then cancels it; accepts private key as an optional CLI argument, falls back to the hardhat test key

Tests

• Unit tests (hyperliquid_tests, ~40 tests, no network):
  • Keccak-256 hash vectors
  • EIP-712 signing correctness
  • Type serialisation (Tif, Cloid, BuilderInfo, order/cancel request encoding)
  • WebSocket URL construction and channel-identifier utilities
• Integration tests (hyperliquid_integration_tests, ~54 tests, require testnet access):
  • REST: all Info endpoints against api.hyperliquid-testnet.xyz
  • WebSocket: live subscription tests for allMids, l2Book, trades, candle; multi-callback fan-out; partial unsubscribe; unsubscribe-stops-delivery