Added - Phase 16: Vault Operations #

• InfoClient - 4 new vault query methods:
  • vaultDetails(vaultAddress, user?) - Get detailed vault information including performance, followers, and portfolio history
  • vaultSummaries() - Get summaries for all vaults on Hyperliquid
  • leadingVaults(user) - Get all vaults managed by a specific vault leader
  • userVaultEquities(user) - Get user's vault deposits and equity across all vaults
• ExchangeClient - 1 new vault transfer method:
  • vaultTransfer(vaultAddress, isDeposit, usd) - Deposit/withdraw USDC to/from vaults
• New Models:
  • VaultDetails - Complete vault information with portfolio metrics
  • VaultPortfolio - Historical TVL and PnL across time periods (day/week/month/allTime)
  • PortfolioPeriod - Account value history, PnL history, and trading volume
  • VaultFollower - Follower information with equity, PnL, and lockup details
  • VaultSummary - Lightweight vault listing
  • LeadingVault - Vault performance metrics by leader
  • UserVaultEquity - User's vault position
  • VaultRelationship - Parent/child vault hierarchy
• Helper Scripts (6 total):
  • explore_vault.dart - Generalized vault explorer using env vars
  • test_vault_deposit.dart - Test vault deposits with confirmation
  • check_vault_balance.dart - Check user's vault positions
  • check_vault_holdings.dart - View vault's current trading positions
  • test_spot_perp_transfer.dart - Transfer USDC between spot and perp accounts
  • test_hlp_vault.dart - HLP vault specific explorer
• Documentation:
  • VAULT_REFERENCES.md - Complete vault operations guide with known vault addresses

Changed #

• InfoClient coverage: 27 → 31 methods (+15% increase)
• ExchangeClient coverage: 20 → 21 methods (+5% increase)
• Test coverage: 19 → 21 passing tests (95% pass rate)
• Overall SDK coverage: 52% → 56% of TypeScript SDK

Fixed #

• Documented $5 minimum deposit requirement for vaults (protocol-enforced)
• Clarified vault deposits use PERP account balance (not spot)
• Fixed VaultPortfolio parsing to handle array-of-tuples format from API
• Simplified LeadingVault model to match actual API response

Notes #

• Vault deposits subject to 24-hour lockup period
• Vault leaders must maintain at least 5% of total vault equity
• vaultSummaries() may return empty (known API issue - use leadingVaults() instead)
• Successfully tested on mainnet with real deposits

Added #

• Initial release of Hyperliquid Dart SDK
• InfoClient with 15+ read-only endpoints
  • allMids() - Current prices for all assets
  • candleSnapshot() - OHLCV candlestick data
  • l2Book() - Orderbook snapshots
  • metaAndAssetCtxs() - Asset metadata and contexts
  • clearinghouseState() - Account state (balance, positions)
  • openOrders() - Open orders for an account
  • userFills() - Trade fills for an account
  • userFunding() - Funding payments for an account
  • And more...
• ExchangeClient with 8 trading endpoints
  • placeOrder() - Place limit/market/trigger orders
  • cancelOrders() - Cancel orders by order ID
  • cancelOrdersByCloid() - Cancel by client order ID
  • updateLeverage() - Set leverage for an asset
  • updateIsolatedMargin() - Add/remove isolated margin
  • withdraw() - Withdraw USDC
  • approveBuilderFee() - Approve builder fee
• WebSocketClient with 8 real-time subscriptions
  • subscribeAllMids() - Live prices for all assets
  • subscribeL2Book() - Live orderbook updates
  • subscribeCandle() - Live candle updates
  • subscribeTrades() - Recent trades stream
  • subscribeUserFills() - Live trade fills
  • subscribeOrderUpdates() - Order status updates
  • Auto-reconnection with exponential backoff
• Full EIP-712 signing support
  • WalletAdapter interface for wallet-agnostic integration
  • PrivateKeyWalletAdapter for raw private key signing
  • Keccak-256 hashing (fixed from SHA-3)
  • secp256k1 ECDSA signatures with recovery ID
• Comprehensive type-safe models
  • Candle, L2Book, AssetMetadata, AssetContext
  • ClearinghouseState, OpenOrder, UserFill, UserFunding
  • OrderWire (limit/market/trigger factories)
  • SignatureComponents, BuilderFee, and more
• 37 passing tests
  • 32 unit tests (keccak256, action hashing, signing, adapter)
  • 5 live integration tests (verified against mainnet)
• Minimal dependencies (only 4 runtime deps)
  • http for REST transport
  • web_socket_channel for WebSocket transport
  • pointycastle for keccak256 + secp256k1
  • msgpack_dart for action serialization

Fixed #

• Critical Keccak-256 bug (was using SHA-3 instead of Keccak)
• Signature recovery ID computation for Ethereum compatibility

Documentation #

• Comprehensive README with installation and usage examples
• MIT License
• Example application demonstrating all features