hyperliquid-rb 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7592a75a389665ac7ccb861b5cf9f4f500d16b712343f41b0acf5411c8408dc
-  data.tar.gz: 5c7d881e948ae92752a8b0fa58b6738cec1318ff3ebd5e27764cac4919475460
+  metadata.gz: c0cb88c29e0a7a10e761bd52c99e62a07a8c878bda0871b4b8812d53b50093cc
+  data.tar.gz: b2cf212fcb066dd751dc261c1cdfe7d539d23bc04144cdedef7838dc56bc86aa
 SHA512:
-  metadata.gz: dea8bc10e5b32c4e9695a11004f6c85d7bd8ef84c0afa01d3996c11d0813dbf5700a71a2203b9dc3d4bb0c2bebf262ab537b119ea122385a9ffb35f643db402e
-  data.tar.gz: 90965b87faee7ee1e1d0ffdaca66c1e34bdd11a957aeefee5c10ab0176a10f16759055b5141307aad8a02cf7de09703464309edda514a87d2dcebc722e50642e
+  metadata.gz: 50666c8b56ac24dfcd33b336966dc9fa89e271ab92241cd1dbf785634475b3239669597867229029d82153bf4bcd2126f81265f754399466bde9a3d7005c4b26
+  data.tar.gz: 5a2d38dec0920f433565509ef01c76178b4ae990920bef46d1d86637272b4ce1eb9396705971a4f8be5527e26ab457a9f3b94f67114918ad9020cff100f39637

data/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.1] - 2026-06-17
+
+### Fixed
+
+- **Spot coin → asset mapping now uses the universe entry's permanent `index`
+  field instead of its array position.** The live spot universe is sparse
+  (delisted pairs leave permanent index gaps), so for every entry after the
+  first gap, position no longer equals index. The old code addressed orders to
+  the wrong spot asset — e.g. `name_to_asset("@107")` (HYPE/USDC) returned
+  `10105` (HPYH/USDC) — which could be rejected or, for a similarly priced
+  neighbor, silently fill the wrong coin. This matches the official Python SDK
+  (`asset = spot_info["index"] + 10000`). Affects `Info#name_to_asset`,
+  `Info#spot_coin_to_asset`, and every `Exchange` trading op that resolves a
+  spot coin (orders, modify, cancel, TWAP, leverage/margin, slippage pricing).
+
+### Added
+
+- `Info#name_to_asset` now resolves the friendly `BASE/QUOTE` spot name (e.g.
+  `"HYPE/USDC"`) in addition to the universe name (e.g. `"@107"`), mirroring the
+  Python SDK's `name_to_coin` mapping.
+
+### Changed (breaking)
+
+- **`Info#asset_to_sz_decimals` spot keys moved from token index to asset id.**
+  Spot `szDecimals` are now keyed by the order asset id (`10_000 + index`) and
+  hold the base token's `szDecimals`, matching the Python SDK. Previously they
+  were keyed by the raw token index, which returned `nil` for real asset ids and
+  collided with perpetual asset ids. This also fixes spot `slippage_price`
+  rounding (was falling back to `0` decimals) — the likely cause of latent
+  "Order has invalid size" errors. Any caller that looked up spot `szDecimals`
+  by a small token index must switch to the asset id.
+
+[0.1.1]: https://github.com/deltabadger/hyperliquid-rb/releases/tag/v0.1.1

data/README.md

@@ -1,5 +1,9 @@
 # Hyperliquid Ruby SDK
 
+[![Gem Version](https://img.shields.io/gem/v/hyperliquid-rb)](https://rubygems.org/gems/hyperliquid-rb)
+[![CI](https://github.com/deltabadger/hyperliquid-rb/actions/workflows/ci.yml/badge.svg)](https://github.com/deltabadger/hyperliquid-rb/actions)
+[![License](https://img.shields.io/github/license/deltabadger/hyperliquid-rb)](LICENSE.txt)
+
 Complete Ruby SDK for the [Hyperliquid](https://hyperliquid.xyz) DEX. Covers 100% of the official Python SDK — trading, market data, EIP-712 signing, WebSocket subscriptions, and account management.
 
 Verified with 314 tests including 141 cross-library test vectors generated from the official Python SDK to ensure byte-identical signing output.

data/lib/hyperliquid/info.rb

@@ -422,9 +422,8 @@ module Hyperliquid
     def load_spot_coin_mapping!
       m = spot_meta
       @spot_coin_to_asset = {}
-      m["universe"].each_with_index do |token_info, index|
-        name = token_info["name"]
-        @spot_coin_to_asset[name] = 10_000 + index
+      m["universe"].each do |token_info|
+        @spot_coin_to_asset[token_info["name"]] = 10_000 + token_info["index"]
       end
     end
 
@@ -439,16 +438,7 @@ module Hyperliquid
 
       # Load spot metadata
       begin
-        sm = spot_meta
-        sm["universe"].each_with_index do |token_info, index|
-          name = token_info["name"]
-          asset = 10_000 + index
-          @coin_to_asset[name] = asset
-          @name_to_coin[name] = name
-        end
-        sm["tokens"]&.each do |token|
-          @asset_to_sz_decimals[token["index"]] = token["szDecimals"] if token["index"]
-        end
+        set_spot_meta(spot_meta)
       rescue Error
         # spot_meta may not be available
       end
@@ -472,6 +462,26 @@ module Hyperliquid
       @spot_coin_to_asset = @coin_to_asset.select { |_k, v| v >= 10_000 && v < 110_000 }
     end
 
+    # Load the spot section of the mappings (mirrors the official Python SDK).
+    # Asset ids use the universe entry's permanent `index` field (10_000 + index),
+    # never its array position; the spot universe is sparse so the two diverge.
+    def set_spot_meta(m)
+      tokens = m["tokens"] || []
+      m["universe"].each do |spot_info|
+        asset = 10_000 + spot_info["index"]
+        name  = spot_info["name"]
+        @coin_to_asset[name] = asset
+        @name_to_coin[name]  = name
+        base, quote = spot_info["tokens"] # nil tokens => base=quote=nil (safe)
+        base_info  = tokens[base]  if base
+        quote_info = tokens[quote] if quote
+        @asset_to_sz_decimals[asset] = base_info["szDecimals"] if base_info
+        next unless base_info && quote_info
+
+        @name_to_coin["#{base_info["name"]}/#{quote_info["name"]}"] ||= name
+      end
+    end
+
     def set_perp_meta(m, offset, dex: nil)
       m["universe"].each_with_index do |asset_info, index|
         name = asset_info["name"]

data/lib/hyperliquid/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Hyperliquid
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hyperliquid-rb
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Deltabadger
@@ -73,6 +73,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE.txt
 - README.md
 - lib/hyperliquid.rb
@@ -92,7 +93,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/deltabadger/hyperliquid-rb
   source_code_uri: https://github.com/deltabadger/hyperliquid-rb
-  changelog_uri: https://github.com/deltabadger/hyperliquid-rb/commits/main
+  changelog_uri: https://github.com/deltabadger/hyperliquid-rb/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
@@ -101,7 +102,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="