hyperliquid 0.2.0 → 0.4.0

data/test_integration.rb

@@ -0,0 +1,255 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Hyperliquid Ruby SDK - Testnet Integration Test
+#
+# This script tests the Exchange API against the live testnet:
+#   1. Spot market roundtrip (buy PURR, sell PURR)
+#   2. Spot limit order (place and cancel)
+#   3. Perp market roundtrip (long BTC, close position)
+#   4. Perp limit order (place short, cancel)
+#
+# Prerequisites:
+#   - Testnet wallet with USDC balance
+#   - Get testnet funds from: https://app.hyperliquid-testnet.xyz
+#
+# Usage:
+#   HYPERLIQUID_PRIVATE_KEY=0x... ruby test_integration.rb
+#
+# Note: This script executes real trades on testnet. No real funds are at risk.
+
+require_relative 'lib/hyperliquid'
+require 'json'
+
+WAIT_SECONDS = 10
+SPOT_SLIPPAGE = 0.40  # 40% for illiquid testnet spot markets
+PERP_SLIPPAGE = 0.05  # 5% for perp markets
+
+def separator(title)
+  puts
+  puts '=' * 60
+  puts title
+  puts '=' * 60
+  puts
+end
+
+def wait_with_countdown(seconds, message)
+  puts message
+  seconds.downto(1) do |i|
+    print "\r  #{i} seconds remaining...  "
+    sleep 1
+  end
+  puts "\r  Done!                      "
+  puts
+end
+
+def check_result(result, operation)
+  status = result.dig('response', 'data', 'statuses', 0)
+
+  if status.is_a?(Hash) && status['error']
+    puts "FAILED: #{status['error']}"
+    return false
+  end
+
+  if status.is_a?(Hash) && status['resting']
+    puts "Order resting with OID: #{status['resting']['oid']}"
+    return status['resting']['oid']
+  end
+
+  if status == 'success' || (status.is_a?(Hash) && status['filled'])
+    puts "#{operation} successful!"
+    return true
+  end
+
+  puts "Result: #{status.inspect}"
+  true
+end
+
+# --- Main Script ---
+
+private_key = ENV['HYPERLIQUID_PRIVATE_KEY']
+unless private_key
+  puts 'Error: Set HYPERLIQUID_PRIVATE_KEY environment variable'
+  puts 'Usage: HYPERLIQUID_PRIVATE_KEY=0x... ruby test_integration.rb'
+  exit 1
+end
+
+sdk = Hyperliquid.new(
+  testnet: true,
+  private_key: private_key
+)
+
+puts 'Hyperliquid Ruby SDK - Testnet Integration Test'
+puts '=' * 60
+puts "Wallet: #{sdk.exchange.address}"
+puts 'Network: Testnet'
+puts "Testnet UI: https://app.hyperliquid-testnet.xyz"
+
+# ============================================================
+# TEST 1: Spot Market Roundtrip (PURR/USDC)
+# ============================================================
+separator('TEST 1: Spot Market Roundtrip (PURR/USDC)')
+
+spot_coin = 'PURR/USDC'
+spot_size = 5  # PURR has 0 decimals
+
+mids = sdk.info.all_mids
+spot_price = mids[spot_coin]&.to_f
+
+if spot_price&.positive?
+  puts "#{spot_coin} mid: $#{spot_price}"
+  puts "Size: #{spot_size} PURR (~$#{(spot_size * spot_price).round(2)})"
+  puts "Slippage: #{(SPOT_SLIPPAGE * 100).to_i}%"
+  puts
+
+  # Buy
+  puts 'Placing market BUY...'
+  result = sdk.exchange.market_order(
+    coin: spot_coin,
+    is_buy: true,
+    size: spot_size,
+    slippage: SPOT_SLIPPAGE
+  )
+  check_result(result, 'Buy')
+
+  wait_with_countdown(WAIT_SECONDS, 'Waiting before sell...')
+
+  # Sell
+  puts 'Placing market SELL...'
+  result = sdk.exchange.market_order(
+    coin: spot_coin,
+    is_buy: false,
+    size: spot_size,
+    slippage: SPOT_SLIPPAGE
+  )
+  check_result(result, 'Sell')
+else
+  puts "SKIPPED: Could not get #{spot_coin} price"
+end
+
+# ============================================================
+# TEST 2: Spot Limit Order (Place and Cancel)
+# ============================================================
+separator('TEST 2: Spot Limit Order (Place and Cancel)')
+
+if spot_price&.positive?
+  # Place limit buy well below market (won't fill)
+  limit_price = (spot_price * 0.50).round(2)  # 50% below mid
+  puts "#{spot_coin} mid: $#{spot_price}"
+  puts "Limit price: $#{limit_price} (50% below mid - won't fill)"
+  puts "Size: #{spot_size} PURR"
+  puts
+
+  puts 'Placing limit BUY order...'
+  result = sdk.exchange.order(
+    coin: spot_coin,
+    is_buy: true,
+    size: spot_size,
+    limit_px: limit_price,
+    order_type: { limit: { tif: 'Gtc' } },
+    reduce_only: false
+  )
+  oid = check_result(result, 'Limit order')
+
+  if oid.is_a?(Integer)
+    wait_with_countdown(WAIT_SECONDS, 'Order resting. Waiting before cancel...')
+
+    puts "Canceling order #{oid}..."
+    result = sdk.exchange.cancel(coin: spot_coin, oid: oid)
+    check_result(result, 'Cancel')
+  end
+else
+  puts "SKIPPED: Could not get #{spot_coin} price"
+end
+
+# ============================================================
+# TEST 3: Perp Market Roundtrip (BTC Long)
+# ============================================================
+separator('TEST 3: Perp Market Roundtrip (BTC Long)')
+
+perp_coin = 'BTC'
+btc_price = mids[perp_coin]&.to_f
+
+if btc_price&.positive?
+  # Get BTC metadata for size precision
+  meta = sdk.info.meta
+  btc_meta = meta['universe'].find { |a| a['name'] == perp_coin }
+  sz_decimals = btc_meta['szDecimals']
+
+  # Calculate size for ~$20 notional
+  perp_size = (20.0 / btc_price).ceil(sz_decimals)
+
+  puts "#{perp_coin} mid: $#{btc_price.round(2)}"
+  puts "Size: #{perp_size} BTC (~$#{(perp_size * btc_price).round(2)})"
+  puts "Slippage: #{(PERP_SLIPPAGE * 100).to_i}%"
+  puts
+
+  # Open long
+  puts 'Opening LONG position (market buy)...'
+  result = sdk.exchange.market_order(
+    coin: perp_coin,
+    is_buy: true,
+    size: perp_size,
+    slippage: PERP_SLIPPAGE
+  )
+  check_result(result, 'Long open')
+
+  wait_with_countdown(WAIT_SECONDS, 'Position open. Waiting before close...')
+
+  # Close long (sell to close)
+  puts 'Closing LONG position (market sell)...'
+  result = sdk.exchange.market_order(
+    coin: perp_coin,
+    is_buy: false,
+    size: perp_size,
+    slippage: PERP_SLIPPAGE
+  )
+  check_result(result, 'Long close')
+else
+  puts "SKIPPED: Could not get #{perp_coin} price"
+end
+
+# ============================================================
+# TEST 4: Perp Limit Order (Short, then Cancel)
+# ============================================================
+separator('TEST 4: Perp Limit Order (Short, then Cancel)')
+
+if btc_price&.positive?
+  # Place limit sell well above market (won't fill)
+  limit_price = (btc_price * 1.50).round(0).to_i  # 50% above mid, whole number tick
+  perp_size = (20.0 / btc_price).ceil(sz_decimals)
+
+  puts "#{perp_coin} mid: $#{btc_price.round(2)}"
+  puts "Limit price: $#{limit_price} (50% above mid - won't fill)"
+  puts "Size: #{perp_size} BTC"
+  puts
+
+  puts 'Placing limit SELL order (short)...'
+  result = sdk.exchange.order(
+    coin: perp_coin,
+    is_buy: false,
+    size: perp_size,
+    limit_px: limit_price,
+    order_type: { limit: { tif: 'Gtc' } },
+    reduce_only: false
+  )
+  oid = check_result(result, 'Limit short')
+
+  if oid.is_a?(Integer)
+    wait_with_countdown(WAIT_SECONDS, 'Order resting. Waiting before cancel...')
+
+    puts "Canceling order #{oid}..."
+    result = sdk.exchange.cancel(coin: perp_coin, oid: oid)
+    check_result(result, 'Cancel')
+  end
+else
+  puts "SKIPPED: Could not get #{perp_coin} price"
+end
+
+# ============================================================
+# Summary
+# ============================================================
+separator('INTEGRATION TEST COMPLETE')
+puts 'All tests executed. Check your testnet wallet for trade history:'
+puts 'https://app.hyperliquid-testnet.xyz'
+puts

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hyperliquid
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - carter2099
@@ -9,6 +9,20 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: eth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
@@ -37,6 +51,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: msgpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
 description: A Ruby SDK for interacting with Hyperliquid's decentralized exchange
   API
 email:
@@ -49,6 +77,7 @@ files:
 - ".rubocop.yml"
 - ".ruby-version"
 - CHANGELOG.md
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
 - README.md
@@ -56,11 +85,16 @@ files:
 - example.rb
 - lib/hyperliquid.rb
 - lib/hyperliquid/client.rb
+- lib/hyperliquid/cloid.rb
 - lib/hyperliquid/constants.rb
 - lib/hyperliquid/errors.rb
+- lib/hyperliquid/exchange.rb
 - lib/hyperliquid/info.rb
+- lib/hyperliquid/signing/eip712.rb
+- lib/hyperliquid/signing/signer.rb
 - lib/hyperliquid/version.rb
 - sig/hyperliquid.rbs
+- test_integration.rb
 homepage: https://github.com/carter2099/hyperliquid
 licenses:
 - MIT