hyperliquid 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 749f15d29e4a3e03829a031352be5c151c83d178ef5b7ac4a03e4e6741d2c097
-  data.tar.gz: 558db42547ec4f1a615b31e45730e868b84ee4a0641d56c3103257c8ff546707
+  metadata.gz: a9976736621e86406eb3de9e8e4827b59d1c96c86aac1efcff2ee700afa78429
+  data.tar.gz: 79c0a9f8587b1af017f02539e2c35b27e7311ba7e00328c0147db636483aed28
 SHA512:
-  metadata.gz: 78163c112fb337a68f453fdca4d9ead9cd219e5919dd5d4c39697dde9d104d28ca32e37a3075e34eced886cc685845fb128b3b7196e418ab80db806ce28cb388
-  data.tar.gz: cb5a6f2bd65e4b31235a200c970355dc20eb5050c74c334d03ee6bee694c0550680c02a86001ed2003cbd53eb1edac30d0c9747af3af6628ffcc37a5a893938f
+  metadata.gz: 89e3b1c854bdb152494abc51ed5f7a3dcfe3c354226d7d92ed994ef8f99d9d5fabcf91d81ddedb18bf083bcc9f3cc4952578b2bfe1d95cc2d8c35b359eb392b1
+  data.tar.gz: c8fd08574cfa29c927bd5c848ca5bd578914bc82150af2ab0305c38ea84785b22f4f92bed0ca07e49f86f31c8dde089fd83c47e73c58678c807a0dacf5dc9b75

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 ## [Ruby Hyperliquid SDK Changelog]
 
+## [1.1.0] - 2026-04-24
+
+### New Info endpoints
+
+- `Info#validator_summaries` — validator status/stake summaries
+- `Info#exchange_status` — exchange-wide status
+- `Info#max_market_order_ntls` — per-coin max market order notionals
+- `Info#pre_transfer_check` — pre-flight checks for transfers
+- `Info#vip?` — VIP status lookup
+- `Info#liquidatable` — open positions flagged liquidatable
+- `Info#recent_trades(coin)` — recent trades feed
+- `Info#block_details(height)` — block detail lookup by height
+- `Info#user_abstraction` — account abstraction state (unifiedAccount, portfolioMargin, dexAbstraction, etc.)
+- `Info#vault_summaries` — vaults less than 2 hours old
+- `Info#user_fills_by_time` now accepts `aggregate_by_time` and `reversed` kwargs (matches upstream Python/TS SDKs)
+
+### Fixes
+
+- Fix `TypeError` in `dump_status`/`check_result` when `response.data` is a String (e.g. `usdClassTransfer`, `approveBuilderFee` style actions)
+
 ## [1.0.2] - 2026-02-05
 
 - Lower minimum Ruby requirement to 3.3 and align RuboCop target

data/lib/hyperliquid/info.rb

@@ -52,10 +52,15 @@ module Hyperliquid
     # @param user [String] Wallet address
     # @param start_time [Integer] Start timestamp in milliseconds
     # @param end_time [Integer, nil] Optional end timestamp in milliseconds
+    # @param aggregate_by_time [Boolean, nil] If true, partial fills are aggregated when a
+    #   crossing order fills multiple resting orders
+    # @param reversed [Boolean, nil] If true, fills are returned in reverse chronological order (newest first)
     # @return [Array]
-    def user_fills_by_time(user, start_time, end_time = nil)
+    def user_fills_by_time(user, start_time, end_time = nil, aggregate_by_time: nil, reversed: nil)
       body = { type: 'userFillsByTime', user: user, startTime: start_time }
       body[:endTime] = end_time if end_time
+      body[:aggregateByTime] = aggregate_by_time unless aggregate_by_time.nil?
+      body[:reversed] = reversed unless reversed.nil?
       @client.post(Constants::INFO_ENDPOINT, body)
     end
 
@@ -89,6 +94,20 @@ module Hyperliquid
       @client.post(Constants::INFO_ENDPOINT, { type: 'l2Book', coin: coin })
     end
 
+    # Get recent trades for a coin
+    # @param coin [String] Asset symbol (e.g., "BTC")
+    # @return [Array] Recent trades with coin, side, px, sz, time, hash, tid, users (maker, taker)
+    def recent_trades(coin)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'recentTrades', coin: coin })
+    end
+
+    # Get block details by block height
+    # @param height [Integer] Block height
+    # @return [Hash] Block details including blockTime, hash, height, numTxs, proposer, txs
+    def block_details(height)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'blockDetails', height: height })
+    end
+
     # Get candlestick data
     # @param coin [String] Coin symbol
     # @param interval [String] Time interval (e.g., "1m", "1h", "1d")
@@ -163,6 +182,13 @@ module Hyperliquid
       @client.post(Constants::INFO_ENDPOINT, { type: 'userVaultEquities', user: user })
     end
 
+    # Retrieve a list of vaults less than 2 hours old
+    # @return [Array] Recently created vaults with name, address, leader, tvl, isClosed,
+    #   relationship, createTimeMillis
+    def vault_summaries
+      @client.post(Constants::INFO_ENDPOINT, { type: 'vaultSummaries' })
+    end
+
     # Query a user's role
     # @param user [String]
     # @return [Hash]
@@ -240,6 +266,56 @@ module Hyperliquid
       @client.post(Constants::INFO_ENDPOINT, { type: 'userDexAbstraction', user: user })
     end
 
+    # Query a user's abstraction state
+    # @param user [String] Wallet address
+    # @return [String] Abstraction state (e.g., "unifiedAccount", "portfolioMargin", "disabled",
+    #   "default", "dexAbstraction")
+    def user_abstraction(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'userAbstraction', user: user })
+    end
+
+    # Check user existence, activation fee, and sanctions status before a transfer
+    # @param user [String] Destination user address
+    # @param source [String] Source (funding) address
+    # @return [Hash] Keys: fee (String), isSanctioned (Boolean), userExists (Boolean),
+    #   userHasSentTx (Boolean)
+    def pre_transfer_check(user, source)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'preTransferCheck', user: user, source: source })
+    end
+
+    # Check whether a user is a VIP
+    # @param user [String] Wallet address
+    # @return [Boolean, nil] True/false VIP status, or nil if the user is unknown
+    def vip?(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'isVip', user: user })
+    end
+
+    # Retrieve addresses of currently liquidatable users
+    # @return [Array] Array of liquidatable user entries
+    def liquidatable
+      @client.post(Constants::INFO_ENDPOINT, { type: 'liquidatable' })
+    end
+
+    # Retrieve validator performance summaries
+    # @return [Array] Array of validator entries with validator, signer, name, description,
+    #   nRecentBlocks, stake, isJailed, unjailableAfter, isActive, commission, and stats
+    #   (day/week/month uptime fraction, predicted APR, and sample count)
+    def validator_summaries
+      @client.post(Constants::INFO_ENDPOINT, { type: 'validatorSummaries' })
+    end
+
+    # Retrieve exchange system status information
+    # @return [Hash] Keys: time (Integer, ms since epoch), specialStatuses (Object or nil)
+    def exchange_status
+      @client.post(Constants::INFO_ENDPOINT, { type: 'exchangeStatus' })
+    end
+
+    # Retrieve maximum market order notionals per asset
+    # @return [Array<Array>] Array of [notional (Numeric), symbol (String)] tuples
+    def max_market_order_ntls
+      @client.post(Constants::INFO_ENDPOINT, { type: 'maxMarketOrderNtls' })
+    end
+
     # ============================
     # Info: Perpetuals
     # ============================

data/lib/hyperliquid/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Hyperliquid
-  VERSION = '1.0.2'
+  VERSION = '1.1.0'
 end

data/scripts/test_automated.rb

@@ -0,0 +1,80 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Hyperliquid Ruby SDK - Automated Integration Test Runner
+#
+# Same as test_all.rb but excludes tests unsuitable for unattended runs:
+#   - test_09_sub_account_lifecycle.rb: requires $100k traded volume on testnet to create sub-accounts
+#   - test_12_staking.rb: requires HYPE token balance (locking issues)
+#
+# Usage:
+#   HYPERLIQUID_PRIVATE_KEY=0x... ruby scripts/test_automated.rb
+
+SCRIPTS = [
+  'test_01_spot_market_roundtrip.rb',
+  'test_02_spot_limit_order.rb',
+  'test_03_perp_market_roundtrip.rb',
+  'test_04_perp_limit_order.rb',
+  'test_05_update_leverage.rb',
+  'test_06_modify_order.rb',
+  'test_07_market_close.rb',
+  'test_08_usd_class_transfer.rb',
+  'test_10_vault.rb',
+  'test_11_builder_fee.rb',
+  'test_13_ws_l2_book.rb',
+  'test_14_ws_candle.rb'
+].freeze
+
+def green(text)
+  "\e[32m#{text}\e[0m"
+end
+
+def red(text)
+  "\e[31m#{text}\e[0m"
+end
+
+unless ENV['HYPERLIQUID_PRIVATE_KEY']
+  puts red('Error: Set HYPERLIQUID_PRIVATE_KEY environment variable')
+  puts 'Usage: HYPERLIQUID_PRIVATE_KEY=0x... ruby scripts/test_automated.rb'
+  exit 1
+end
+
+scripts_dir = __dir__
+passed = []
+failed = []
+
+SCRIPTS.each do |script|
+  path = File.join(scripts_dir, script)
+  puts
+  puts '#' * 60
+  puts "# Running: #{script}"
+  puts '#' * 60
+
+  success = system(RbConfig.ruby, path)
+
+  if success
+    passed << script
+  else
+    failed << script
+    puts red("!!! #{script} exited with error !!!")
+  end
+end
+
+puts
+puts '=' * 60
+puts 'INTEGRATION TEST SUMMARY'
+puts '=' * 60
+puts
+puts "Passed: #{passed.length}/#{SCRIPTS.length}"
+passed.each { |s| puts green("  [PASS] #{s}") }
+if failed.any?
+  puts
+  puts "Failed: #{failed.length}/#{SCRIPTS.length}"
+  failed.each { |s| puts red("  [FAIL] #{s}") }
+end
+puts
+puts 'Check your testnet wallet for trade history:'
+puts 'https://app.hyperliquid-testnet.xyz'
+puts
+
+exit(failed.empty? ? 0 : 1)

data/scripts/test_helpers.rb

@@ -49,7 +49,13 @@ end
 def dump_status(result)
   return unless result.is_a?(Hash)
 
-  status = result.dig('response', 'data', 'statuses', 0)
+  response = result['response']
+  return unless response.is_a?(Hash)
+
+  data = response['data']
+  return unless data.is_a?(Hash)
+
+  status = data.dig('statuses', 0)
   return unless status
 
   puts "  API status: #{status.inspect}"
@@ -60,7 +66,9 @@ def check_result(result, operation)
 
   return false if api_error?(result)
 
-  status = result.dig('response', 'data', 'statuses', 0)
+  response = result['response']
+  data = response.is_a?(Hash) ? response['data'] : nil
+  status = data.is_a?(Hash) ? data.dig('statuses', 0) : nil
 
   if status.is_a?(Hash) && status['error']
     $test_failed = true

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hyperliquid
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - carter2099
@@ -131,6 +131,7 @@ files:
 - scripts/test_13_ws_l2_book.rb
 - scripts/test_14_ws_candle.rb
 - scripts/test_all.rb
+- scripts/test_automated.rb
 - scripts/test_helpers.rb
 - sig/hyperliquid.rbs
 - test_integration.rb