hyperliquid 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e1cb7c8ae1c1b83ab34eaba6f6bf9ce34b620ca1af4500912d62e54d75a95ab
-  data.tar.gz: 9d026ad803f2fe0d2983c3dd242ee5d901cf56677e7c32cf756b5da38eb39c68
+  metadata.gz: a9976736621e86406eb3de9e8e4827b59d1c96c86aac1efcff2ee700afa78429
+  data.tar.gz: 79c0a9f8587b1af017f02539e2c35b27e7311ba7e00328c0147db636483aed28
 SHA512:
-  metadata.gz: 99a8f5cf7847c9236f3b4b48cfb83734ecb6ae8b7679d8d5cc1aef003b1a510df3edefdf9f6481d7bdb4ff7d22546549247b9aa17771e95d58307eb93bdd0448
-  data.tar.gz: d649b243e0aab4ae25ffcd3c452878cce1be94dd86dde1aeb151b9478bba1c42fe534ec485f4ddd896e0f358b705d4b063180b26e23fcf7d09d42a9f71ffbc64
+  metadata.gz: 89e3b1c854bdb152494abc51ed5f7a3dcfe3c354226d7d92ed994ef8f99d9d5fabcf91d81ddedb18bf083bcc9f3cc4952578b2bfe1d95cc2d8c35b359eb392b1
+  data.tar.gz: c8fd08574cfa29c927bd5c848ca5bd578914bc82150af2ab0305c38ea84785b22f4f92bed0ca07e49f86f31c8dde089fd83c47e73c58678c807a0dacf5dc9b75

data/.rubocop.yml

@@ -1,6 +1,6 @@
 AllCops:
   NewCops: enable
-  TargetRubyVersion: 3.4.3
+  TargetRubyVersion: 3.3
   SuggestExtensions: false
   Exclude:
     - 'test_*.rb'  # Exclude ad-hoc integration test scripts

data/.ruby-version

@@ -1 +1 @@
-3.4.3
+3.4.8

data/AGENTS.md

@@ -0,0 +1,83 @@
+# AGENTS.md
+
+This file provides guidance to AI coding agents working with this repository.
+
+## Overview
+
+Ruby SDK (v1.0.1) for the Hyperliquid decentralized exchange API. Three API surfaces: **Info** (read-only market data), **Exchange** (authenticated trading), and **WebSocket** (real-time streaming). Built on Faraday for HTTP, the `eth` gem for EIP-712 signing, `msgpack` for action serialization, and `ws_lite` for WebSocket connections.
+
+**Ruby**: >= 3.3.0 (CI tests 3.3, 3.4)
+
+## Commands
+
+```bash
+bin/setup                  # install dependencies
+rake                       # run tests + linting (CI default)
+rake spec                  # tests only
+rake rubocop               # linting only
+bundle exec rspec spec/hyperliquid/cloid_spec.rb       # single file
+bundle exec rspec spec/hyperliquid/cloid_spec.rb:62    # single test by line
+bin/console                # IRB with SDK loaded
+ruby example.rb            # example usage script
+```
+
+### Integration Tests (Testnet)
+```bash
+HYPERLIQUID_PRIVATE_KEY=0x... ruby scripts/test_all.rb              # all
+HYPERLIQUID_PRIVATE_KEY=0x... ruby scripts/test_08_usd_class_transfer.rb  # single
+```
+Integration tests live in `scripts/` as standalone files. `test_integration.rb` at project root is a convenience wrapper.
+
+## Architecture
+
+### Request Flow
+
+The SDK has three parallel API surfaces, all routed through `Hyperliquid::SDK` (`lib/hyperliquid.rb`):
+
+```
+Hyperliquid.new(...)
+  ├── sdk.info     → Info       → Client → POST /info     (always available)
+  ├── sdk.exchange → Exchange   → Client → POST /exchange  (requires private_key)
+  └── sdk.ws       → WS::Client → WSS /ws                 (real-time streaming)
+```
+
+**Info path**: Method builds `{ type: 'someType' }` body → `Client` POSTs to `/info` → parsed JSON returned.
+
+**Exchange path**: Method builds action payload → `Signer` generates EIP-712 signature over msgpack-encoded action → `Client` POSTs signed payload to `/exchange` → parsed JSON returned.
+
+**WebSocket path**: `WS::Client` manages a persistent WSS connection with subscription tracking, automatic reconnection, ping keepalive (50s), and a bounded message queue (1024 max, drops oldest on overflow). Subscriptions are identified by a canonical key and dispatched via callbacks on a dedicated thread.
+
+### Signing (Python SDK Parity)
+
+The signing chain in `lib/hyperliquid/signing/` must exactly match the official Python SDK:
+
+1. **Action hash**: `keccak256(msgpack(action) + nonce(8B big-endian) + vault_flag + [vault_addr] + [expires_flag + expires_after])`
+2. **Phantom agent**: `{ source: 'a'|'b', connectionId: action_hash }` (a=mainnet, b=testnet)
+3. **EIP-712 signature** over phantom agent with Exchange domain (chain ID 1337)
+
+Any change to signing must maintain parity with the Python SDK or transactions will be rejected.
+
+### Numeric Conversion
+
+**float_to_wire** (in Exchange): Converts to string with 8 decimal precision, validates rounding tolerance (1e-12), normalizes trailing zeros. No scientific notation.
+
+**Market order pricing** (_slippage_price): Apply slippage (default 5%) to mid price → round to 5 significant figures → round to `(6 for perp, 8 for spot) - szDecimals` decimal places.
+
+**Spot vs Perp**: Assets with index >= 10,000 are spot (`SPOT_ASSET_THRESHOLD` in Exchange). This affects decimal place calculations.
+
+### Testing
+
+- **Unit tests** (`spec/`): RSpec + WebMock. WebMock resets between tests. Monkey-patching disabled. Test files mirror `lib/` structure.
+- **Integration tests** (`scripts/`): Run against testnet with a real private key. Each script is self-contained.
+
+### Code Style
+
+RuboCop targets Ruby 3.3. Key relaxations: methods up to 50 lines, no class length limit (Info/Exchange are large by design), no block length limit in specs, no parameter list limit in Exchange. `scripts/`, `test_*.rb`, `local/`, and `vendor/` are excluded from linting.
+
+### CI
+
+GitHub Actions (`.github/workflows/main.yml`): runs `bundle exec rake` (tests + lint) on Ruby 3.3 and 3.4 for pushes to main and all PRs. Release workflow creates GitHub releases from CHANGELOG.md on version tags.
+
+## Additional Docs
+
+Detailed API reference, examples, WebSocket guide, configuration, and error handling in `docs/`.

data/CHANGELOG.md

@@ -1,5 +1,31 @@
 ## [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
+- Expand CI matrix to Ruby 3.3, 3.4, and 4.0
+- Bump `ws_lite` dependency to `~> 1.0.1`
+
 ## [1.0.1] - 2026-02-03
 
 - Minor refactors to reduce method complexity

data/CLAUDE.md

@@ -2,200 +2,5 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
-## Overview
-
-This is a Ruby SDK for the Hyperliquid decentralized exchange API. The current version (0.4.0) supports both **read operations** (Info API) and **authenticated write operations** (Exchange API) for trading.
-
-**Target Ruby Version**: 3.4.0+
-
-## Development Commands
-
-### Running Tests
-```bash
-# Run all tests
-rake spec
-
-# Run tests and linting together (default rake task)
-rake
-
-# Run a single test file
-bundle exec rspec spec/hyperliquid/cloid_spec.rb
-
-# Run a specific test by line number
-bundle exec rspec spec/hyperliquid/cloid_spec.rb:62
-```
-
-### Linting
-```bash
-# Run RuboCop linter
-rake rubocop
-```
-
-### Interactive Console
-```bash
-# Open an interactive console with the SDK loaded
-bin/console
-```
-
-### Example Script
-```bash
-# Run the example usage script
-ruby example.rb
-```
-
-### Integration Testing (Testnet)
-```bash
-# Run all integration tests (requires private key)
-# Get testnet funds from: https://app.hyperliquid-testnet.xyz
-HYPERLIQUID_PRIVATE_KEY=0x... ruby scripts/test_all.rb
-
-# Run a single integration test
-HYPERLIQUID_PRIVATE_KEY=0x... ruby scripts/test_08_usd_class_transfer.rb
-```
-
-Integration tests live in `scripts/` as individual files. Each can be run standalone for debugging. `test_integration.rb` at the project root is a convenience wrapper that runs them all.
-
-### Setup
-```bash
-# Install dependencies
-bin/setup
-```
-
-## Architecture
-
-### Core Components
-
-**Hyperliquid::SDK** (`lib/hyperliquid.rb`)
-- Main entry point created via `Hyperliquid.new(testnet:, timeout:, retry_enabled:, private_key:, expires_after:)`
-- Manages environment selection (mainnet vs testnet)
-- Exposes the `info` API client (always available)
-- Exposes the `exchange` API client (when `private_key` provided)
-
-**Hyperliquid::Client** (`lib/hyperliquid/client.rb`)
-- Low-level HTTP client built on Faraday
-- Handles all POST requests to the Hyperliquid API
-- Manages retry logic (disabled by default, opt-in via `retry_enabled: true`)
-- Converts HTTP errors into typed exceptions
-
-**Hyperliquid::Info** (`lib/hyperliquid/info.rb`)
-- High-level API client for all Info endpoints (read-only)
-- Organized into three sections:
-  1. **General Info**: Market data, user orders, fills, rate limits, portfolios, referrals, fees, staking
-  2. **Perpetuals**: Perp DEXs, metadata, user state, funding rates, open interest
-  3. **Spot**: Spot tokens, balances, deploy auctions, token details
-- All methods accept user wallet addresses and return parsed JSON responses
-
-**Hyperliquid::Exchange** (`lib/hyperliquid/exchange.rb`)
-- High-level API client for Exchange endpoints (authenticated write operations)
-- Order placement: `order`, `bulk_orders`, `market_order`
-- Order cancellation: `cancel`, `cancel_by_cloid`, `bulk_cancel`, `bulk_cancel_by_cloid`
-- Supports trigger orders (stop loss / take profit)
-- Supports vault trading via `vault_address` parameter
-- Caches asset metadata for efficient lookups
-
-**Hyperliquid::Signing::Signer** (`lib/hyperliquid/signing/signer.rb`)
-- EIP-712 signature generation using phantom agent scheme
-- Matches official Python SDK signing algorithm exactly
-- Supports vault address and expiration in signature
-
-**Hyperliquid::Signing::EIP712** (`lib/hyperliquid/signing/eip712.rb`)
-- EIP-712 domain and type definitions
-- L1 chain ID (1337) and source identifiers ('a' mainnet, 'b' testnet)
-
-**Hyperliquid::Cloid** (`lib/hyperliquid/cloid.rb`)
-- Type-safe client order ID class
-- Validates 16-byte hex format (0x + 32 hex characters)
-- Factory methods: `from_int`, `from_str`, `from_uuid`, `random`
-
-**Hyperliquid::Constants** (`lib/hyperliquid/constants.rb`)
-- API URLs for mainnet and testnet
-- Endpoint paths (`/info`, `/exchange`)
-- Default timeout values
-
-**Hyperliquid::Errors** (`lib/hyperliquid/errors.rb`)
-- Typed exception hierarchy for API errors
-- Base class: `Hyperliquid::Error`
-- Specific errors: `ClientError`, `ServerError`, `AuthenticationError`, `RateLimitError`, `BadRequestError`, `NotFoundError`, `TimeoutError`, `NetworkError`
-
-### API Request Pattern
-
-**Info API (read-only):**
-1. SDK method called (e.g., `sdk.info.all_mids`)
-2. Info class builds request body with `type` field (e.g., `{ type: 'allMids' }`)
-3. Client POSTs JSON body to `/info` endpoint
-4. Client parses response and handles errors
-5. Parsed JSON returned to caller
-
-**Exchange API (authenticated):**
-1. SDK method called (e.g., `sdk.exchange.order(...)`)
-2. Exchange class builds action payload with order/cancel details
-3. Signer generates EIP-712 signature over msgpack-encoded action
-4. Exchange POSTs signed payload to `/exchange` endpoint
-5. Client parses response and handles errors
-6. Parsed JSON returned to caller
-
-### Testing
-
-- Uses RSpec for testing
-- WebMock for HTTP mocking
-- Spec helper configures WebMock to reset between tests
-- Test files mirror source structure in `spec/`
-
-### Code Style
-
-RuboCop configuration (`.rubocop.yml`):
-- Targets Ruby 3.4.0+
-- Allows longer methods (max 50 lines) for complex logic
-- Disables class length checks (Info/Exchange classes implement many endpoints)
-- Excludes block length checks for specs
-- Enables NewCops by default
-
-## Key Implementation Details
-
-### Retry Logic
-- **Disabled by default** for predictable behavior in time-sensitive trading
-- When enabled: max 2 retries, 0.5s base interval, exponential backoff (2x), ±50% randomness
-- Retries on: connection failures, timeouts, 429 (rate limit), 5xx errors
-
-### API Endpoints
-- Info requests POST to `/info` endpoint
-- Exchange requests POST to `/exchange` endpoint
-- Request body includes `type` field indicating the operation
-
-### Time Parameters
-- All timestamps are in **milliseconds** (not seconds)
-- Methods with time ranges support optional `end_time` parameter
-- `expires_after` is an absolute timestamp in milliseconds
-
-### Signature Generation (Python SDK Parity)
-The signing implementation matches the official Python SDK exactly:
-- **Action hash**: `keccak256(msgpack(action) + nonce(8B BE) + vault_flag + [vault_addr] + [expires_flag + expires_after])`
-- **Phantom agent**: `{ source: 'a'|'b', connectionId: action_hash }`
-- **EIP-712 signature** over phantom agent with Exchange domain
-
-### Float to Wire Format
-Numeric values are converted to strings matching Python SDK `float_to_wire`:
-- 8 decimal precision
-- Rounding tolerance validation (1e-12)
-- Trailing zero normalization (no scientific notation)
-
-### Market Order Price Calculation
-Market orders use Python SDK `_slippage_price` algorithm:
-- Apply slippage to mid price
-- Round to 5 significant figures
-- Round to asset-specific decimal places: `(6 for perp, 8 for spot) - szDecimals`
-
-### Client Order IDs (Cloid)
-- Must be 16 bytes in hex format: `0x` + 32 hex characters
-- Use `Hyperliquid::Cloid` class for type safety and validation
-- Factory methods: `from_int(n)`, `from_str(s)`, `from_uuid(uuid)`, `random`
-
-## Development Workflow
-
-1. Make changes to library code in `lib/hyperliquid/`
-2. Add/update tests in `spec/`
-3. Run tests: `rake spec`
-4. Run linter: `rake rubocop`
-5. Test in console: `bin/console`
-6. Run example script: `ruby example.rb`
-
+AGENTS.md is the canonical source of truth; this file exists only as a Claude Code convenience entrypoint.
+For comprehensive architecture documentation and implementation details, see **[AGENTS.md](./AGENTS.md)**.

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.1'
+  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.1
+  version: 1.1.0
 platform: ruby
 authors:
 - carter2099
@@ -71,14 +71,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: 1.0.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: 1.0.1
 description: A Ruby SDK for interacting with Hyperliquid's decentralized exchange
   API
 email:
@@ -90,6 +90,7 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - ".ruby-version"
+- AGENTS.md
 - CHANGELOG.md
 - CLAUDE.md
 - CODE_OF_CONDUCT.md
@@ -130,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
@@ -148,14 +150,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.4.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Ruby SDK for Hyperliquid API
 test_files: []