Module common 

Shared utilities for Hyperliquid execution clients (perps and spot).

Contains parsing helpers and stream wrappers used by both HyperliquidClient (perps) and HyperliquidSpotClient.

Error mapping is in the error module.

Structs

CancelOnDropStream

Stream wrapper that cancels background tasks when dropped.

Functions

cid_to_cloid

Convert a ClientOrderId to SDK cloid format (UUID) if valid.

instrument_to_perp_coin

Extract coin name from perp instrument (e.g., “BTC-USD-PERP” -> “BTC”).

instrument_to_spot_coin

Extract coin pair from spot instrument (e.g., “PURR-USDC-SPOT” -> “PURR/USDC”).

is_spot_coin

Check if a Hyperliquid coin name is a spot pair (contains ‘/’).

map_tif

Map rustrade TimeInForce to Hyperliquid TIF string.

millis_to_datetime

Convert milliseconds timestamp to DateTime<Utc>.

parse_decimal

Parse a decimal string from SDK response, logging warnings on failure.

parse_side

Parse SDK side string to rustrade Side.

perp_coin_to_instrument

Build perp instrument name from Hyperliquid coin name (e.g., “BTC” -> “BTC-USD-PERP”).

round_to_5_sig_figs

Round a price to 5 significant figures (Hyperliquid requirement).

spot_coin_to_instrument

Build spot instrument name from Hyperliquid coin pair (e.g., “PURR/USDC” -> “PURR-USDC-SPOT”).