hyperliquid 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 324ff762cbf5edcea7fc532f853b7295ffcd34476f6273fdef4e03bcc0f9eaee
-  data.tar.gz: 98b1b88b378bb8ae010301c656c833282cd406822fa0c8a7d6c134911b0f2cce
+  metadata.gz: 67b19ec4599a62be35288947fdc8ce2a98c6a0f012f4bdb055a58bd9e4a37849
+  data.tar.gz: 58470f99ebf59a1ba95936816c887210d5937240c55ea1b6e85f7d68b0d82a37
 SHA512:
-  metadata.gz: fe9e447e5500312f98e8f8e602071372847963daacfd51475e92d4db5a7bc988546e4cf106479a9c899bcecf113612c2aa9ebe0dd50a5384bd438bb0d6429865
-  data.tar.gz: 7cd7d2e048c4bf25e128dd7fd41814621bd95305d613199cb4c41abdf1901fdc4c665635000112aafeb7c395dbf01dae81cba74042557d86643c6ac169e3d201
+  metadata.gz: fe341138c6085166b2ddd6e87fd7458554e178c4361e9ad16ed7ab1d239333c821dc0556d7f86d9080ec2002c3c36f26b3f32282acc2b6ccc010b85f83c83abe
+  data.tar.gz: caaefe028d2a4727c01daeea7241290af00c8676d73c2371ce360279f4dc0c18337c1daa398ab968416ee2516f02d08882b0556d91b5e5e78d318bfbd2d7531f

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 ## [Ruby Hyperliquid SDK Changelog]
 
+## [0.7.0] - 2026-01-30
+
+- Add agent, builder & delegation actions to Exchange API
+  - `approve_agent` — authorize an agent wallet to trade on behalf of the account
+  - `approve_builder_fee` — approve a builder fee rate for a builder address
+  - `token_delegate` — delegate or undelegate HYPE tokens to a validator
+- Add builder fee support on order placement
+  - Optional `builder:` parameter on `order`, `bulk_orders`, `market_order`, `market_close`
+- Add EIP-712 type definitions for `ApproveAgent`, `ApproveBuilderFee`, and `TokenDelegate`
+
 ## [0.6.0] - 2026-01-28
 
 - Add transfers and account management to Exchange API

data/docs/API.md

@@ -97,12 +97,20 @@ Read-only methods for querying market data and user information.
 - `vault_transfer(vault_address:, is_deposit:, usd:)` - Deposit or withdraw USDC to/from a vault
 - `set_referrer(code:)` - Set referral code
 
+### Agent & Builder
+
+- `approve_agent(agent_address:, agent_name:)` - Authorize an agent wallet to trade on behalf of this account
+- `approve_builder_fee(builder:, max_fee_rate:)` - Approve a builder fee rate for a builder address
+- `token_delegate(validator:, wei:, is_undelegate:)` - Delegate or undelegate HYPE tokens to a validator
+
 ### Other
 
 - `address` - Get the wallet address associated with the private key
 
 Order placement and management methods support an optional `vault_address:` parameter for vault trading.
 
+Order placement methods (`order`, `bulk_orders`, `market_order`, `market_close`) support an optional `builder:` parameter for builder fee integration. The builder is a Hash with `:b` (builder address) and `:f` (fee in tenths of a basis point).
+
 ### Order Types
 
 - `{ limit: { tif: 'Gtc' } }` - Good-til-canceled (default)

data/docs/EXAMPLES.md

@@ -479,6 +479,62 @@ sdk.exchange.vault_transfer(
 sdk.exchange.set_referrer(code: 'MY_REFERRAL_CODE')
 ```
 
+### Agent, Builder & Delegation
+
+```ruby
+# Authorize an agent wallet to trade on your behalf
+agent_key = Eth::Key.new
+result = sdk.exchange.approve_agent(
+  agent_address: agent_key.address.to_s,
+  agent_name: 'my-trading-bot'       # optional
+)
+
+# Approve a builder fee (required before placing orders with that builder)
+sdk.exchange.approve_builder_fee(
+  builder: '0x250F311Ae04D3CEA03443C76340069eD26C47D7D',
+  max_fee_rate: '0.01%'   # 1 basis point
+)
+
+# Place an order with a builder fee
+sdk.exchange.order(
+  coin: 'BTC',
+  is_buy: true,
+  size: '0.01',
+  limit_px: '95000',
+  builder: { b: '0x250F311Ae04D3CEA03443C76340069eD26C47D7D', f: 10 }  # f=10 means 1bp
+)
+
+# Builder works with all order methods
+sdk.exchange.bulk_orders(
+  orders: [
+    { coin: 'BTC', is_buy: true, size: '0.01', limit_px: '94000' },
+    { coin: 'BTC', is_buy: false, size: '0.01', limit_px: '96000' }
+  ],
+  builder: { b: '0x250F311Ae04D3CEA03443C76340069eD26C47D7D', f: 10 }
+)
+
+sdk.exchange.market_order(
+  coin: 'BTC',
+  is_buy: true,
+  size: '0.01',
+  builder: { b: '0x250F311Ae04D3CEA03443C76340069eD26C47D7D', f: 10 }
+)
+
+# Delegate HYPE tokens to a validator (wei = float * 1e8)
+sdk.exchange.token_delegate(
+  validator: '0x...',
+  wei: 100_000_000,  # 1 HYPE
+  is_undelegate: false
+)
+
+# Undelegate HYPE tokens
+sdk.exchange.token_delegate(
+  validator: '0x...',
+  wei: 10_000_000,   # 0.1 HYPE
+  is_undelegate: true
+)
+```
+
 ### Client Order IDs (Cloid)
 
 ```ruby

data/lib/hyperliquid/exchange.rb

@@ -16,11 +16,13 @@ module Hyperliquid
     # @param client [Hyperliquid::Client] HTTP client
     # @param signer [Hyperliquid::Signing::Signer] EIP-712 signer
     # @param info [Hyperliquid::Info] Info API client for metadata
+    # @param testnet [Boolean] Whether targeting testnet (default: false)
     # @param expires_after [Integer, nil] Optional global expiration timestamp
-    def initialize(client:, signer:, info:, expires_after: nil)
+    def initialize(client:, signer:, info:, testnet: false, expires_after: nil)
       @client = client
       @signer = signer
       @info = info
+      @testnet = testnet
       @expires_after = expires_after
       @asset_cache = nil
     end
@@ -40,9 +42,10 @@ module Hyperliquid
     # @param reduce_only [Boolean] Reduce-only flag (default: false)
     # @param cloid [Cloid, String, nil] Client order ID (optional)
     # @param vault_address [String, nil] Vault address for vault trading (optional)
+    # @param builder [Hash, nil] Builder fee config { b: "0xaddress", f: fee_in_tenths_of_bp } (optional)
     # @return [Hash] Order response
     def order(coin:, is_buy:, size:, limit_px:, order_type: { limit: { tif: 'Gtc' } },
-              reduce_only: false, cloid: nil, vault_address: nil)
+              reduce_only: false, cloid: nil, vault_address: nil, builder: nil)
       nonce = timestamp_ms
 
       order_wire = build_order_wire(
@@ -60,6 +63,7 @@ module Hyperliquid
         orders: [order_wire],
         grouping: 'na'
       }
+      action[:builder] = normalize_builder(builder) if builder
 
       signature = @signer.sign_l1_action(
         action, nonce,
@@ -74,8 +78,9 @@ module Hyperliquid
     #   :coin, :is_buy, :size, :limit_px, :order_type, :reduce_only, :cloid
     # @param grouping [String] Order grouping ("na", "normalTpsl", "positionTpsl")
     # @param vault_address [String, nil] Vault address for vault trading (optional)
+    # @param builder [Hash, nil] Builder fee config { b: "0xaddress", f: fee_in_tenths_of_bp } (optional)
     # @return [Hash] Bulk order response
-    def bulk_orders(orders:, grouping: 'na', vault_address: nil)
+    def bulk_orders(orders:, grouping: 'na', vault_address: nil, builder: nil)
       nonce = timestamp_ms
 
       order_wires = orders.map do |o|
@@ -95,6 +100,7 @@ module Hyperliquid
         orders: order_wires,
         grouping: grouping
       }
+      action[:builder] = normalize_builder(builder) if builder
 
       signature = @signer.sign_l1_action(
         action, nonce,
@@ -110,8 +116,9 @@ module Hyperliquid
     # @param size [String, Numeric] Order size
     # @param slippage [Float] Slippage tolerance (default: 0.05 = 5%)
     # @param vault_address [String, nil] Vault address for vault trading (optional)
+    # @param builder [Hash, nil] Builder fee config { b: "0xaddress", f: fee_in_tenths_of_bp } (optional)
     # @return [Hash] Order response
-    def market_order(coin:, is_buy:, size:, slippage: DEFAULT_SLIPPAGE, vault_address: nil)
+    def market_order(coin:, is_buy:, size:, slippage: DEFAULT_SLIPPAGE, vault_address: nil, builder: nil)
       # Get current mid price
       mids = @info.all_mids
       mid = mids[coin]&.to_f
@@ -126,7 +133,8 @@ module Hyperliquid
         size: size,
         limit_px: slippage_price,
         order_type: { limit: { tif: 'Ioc' } },
-        vault_address: vault_address
+        vault_address: vault_address,
+        builder: builder
       )
     end
 
@@ -342,8 +350,9 @@ module Hyperliquid
     # @param slippage [Float] Slippage tolerance (default: 5%)
     # @param cloid [Cloid, String, nil] Client order ID (optional)
     # @param vault_address [String, nil] Vault address for vault trading (optional)
+    # @param builder [Hash, nil] Builder fee config { b: "0xaddress", f: fee_in_tenths_of_bp } (optional)
     # @return [Hash] Order response
-    def market_close(coin:, size: nil, slippage: DEFAULT_SLIPPAGE, cloid: nil, vault_address: nil)
+    def market_close(coin:, size: nil, slippage: DEFAULT_SLIPPAGE, cloid: nil, vault_address: nil, builder: nil)
       address = vault_address || @signer.address
       state = @info.user_state(address)
 
@@ -370,7 +379,8 @@ module Hyperliquid
         order_type: { limit: { tif: 'Ioc' } },
         reduce_only: true,
         cloid: cloid,
-        vault_address: vault_address
+        vault_address: vault_address,
+        builder: builder
       )
     end
 
@@ -383,7 +393,7 @@ module Hyperliquid
       action = {
         type: 'usdSend',
         signatureChainId: '0x66eee',
-        hyperliquidChain: Signing::EIP712.hyperliquid_chain(testnet: @signer.instance_variable_get(:@testnet)),
+        hyperliquidChain: Signing::EIP712.hyperliquid_chain(testnet: @testnet),
         destination: destination,
         amount: amount.to_s,
         time: nonce
@@ -406,7 +416,7 @@ module Hyperliquid
       action = {
         type: 'spotSend',
         signatureChainId: '0x66eee',
-        hyperliquidChain: Signing::EIP712.hyperliquid_chain(testnet: @signer.instance_variable_get(:@testnet)),
+        hyperliquidChain: Signing::EIP712.hyperliquid_chain(testnet: @testnet),
         destination: destination,
         token: token,
         amount: amount.to_s,
@@ -429,7 +439,7 @@ module Hyperliquid
       action = {
         type: 'usdClassTransfer',
         signatureChainId: '0x66eee',
-        hyperliquidChain: Signing::EIP712.hyperliquid_chain(testnet: @signer.instance_variable_get(:@testnet)),
+        hyperliquidChain: Signing::EIP712.hyperliquid_chain(testnet: @testnet),
         amount: amount.to_s,
         toPerp: to_perp,
         nonce: nonce
@@ -451,7 +461,7 @@ module Hyperliquid
       action = {
         type: 'withdraw3',
         signatureChainId: '0x66eee',
-        hyperliquidChain: Signing::EIP712.hyperliquid_chain(testnet: @signer.instance_variable_get(:@testnet)),
+        hyperliquidChain: Signing::EIP712.hyperliquid_chain(testnet: @testnet),
         destination: destination,
         amount: amount.to_s,
         time: nonce
@@ -476,7 +486,7 @@ module Hyperliquid
       action = {
         type: 'sendAsset',
         signatureChainId: '0x66eee',
-        hyperliquidChain: Signing::EIP712.hyperliquid_chain(testnet: @signer.instance_variable_get(:@testnet)),
+        hyperliquidChain: Signing::EIP712.hyperliquid_chain(testnet: @testnet),
         destination: destination,
         sourceDex: source_dex,
         destinationDex: destination_dex,
@@ -569,6 +579,77 @@ module Hyperliquid
       post_action(action, signature, nonce, nil)
     end
 
+    # Authorize an agent wallet to trade on behalf of this account
+    # @param agent_address [String] Agent's Ethereum address
+    # @param agent_name [String, nil] Optional agent name (omitted from action if nil)
+    # @return [Hash] Approve agent response
+    def approve_agent(agent_address:, agent_name: nil)
+      nonce = timestamp_ms
+      action = {
+        type: 'approveAgent',
+        signatureChainId: '0x66eee',
+        hyperliquidChain: Signing::EIP712.hyperliquid_chain(testnet: @testnet),
+        agentAddress: agent_address,
+        nonce: nonce
+      }
+      # agentName is always included in the signed message (empty string if nil),
+      # but only included in the posted action if a name was provided (matches Python SDK)
+      action[:agentName] = agent_name if agent_name
+      signature = @signer.sign_user_signed_action(
+        { agentAddress: agent_address, agentName: agent_name || '', nonce: nonce },
+        'HyperliquidTransaction:ApproveAgent',
+        Signing::EIP712::APPROVE_AGENT_TYPES
+      )
+      post_action(action, signature, nonce, nil)
+    end
+
+    # Approve a builder fee rate for a builder address
+    # Users must approve a builder before orders with that builder can be placed.
+    # @param builder [String] Builder's Ethereum address
+    # @param max_fee_rate [String] Maximum fee rate (e.g., "0.01%" for 1 basis point)
+    # @return [Hash] Approve builder fee response
+    def approve_builder_fee(builder:, max_fee_rate:)
+      nonce = timestamp_ms
+      action = {
+        type: 'approveBuilderFee',
+        signatureChainId: '0x66eee',
+        hyperliquidChain: Signing::EIP712.hyperliquid_chain(testnet: @testnet),
+        maxFeeRate: max_fee_rate,
+        builder: builder,
+        nonce: nonce
+      }
+      signature = @signer.sign_user_signed_action(
+        { maxFeeRate: max_fee_rate, builder: builder, nonce: nonce },
+        'HyperliquidTransaction:ApproveBuilderFee',
+        Signing::EIP712::APPROVE_BUILDER_FEE_TYPES
+      )
+      post_action(action, signature, nonce, nil)
+    end
+
+    # Delegate or undelegate HYPE tokens to a validator
+    # @param validator [String] Validator's Ethereum address
+    # @param wei [Integer] Amount as float * 1e8 (e.g., 1 HYPE = 100_000_000)
+    # @param is_undelegate [Boolean] True to undelegate, false to delegate
+    # @return [Hash] Token delegate response
+    def token_delegate(validator:, wei:, is_undelegate:)
+      nonce = timestamp_ms
+      action = {
+        type: 'tokenDelegate',
+        signatureChainId: '0x66eee',
+        hyperliquidChain: Signing::EIP712.hyperliquid_chain(testnet: @testnet),
+        validator: validator,
+        wei: wei,
+        isUndelegate: is_undelegate,
+        nonce: nonce
+      }
+      signature = @signer.sign_user_signed_action(
+        { validator: validator, wei: wei, isUndelegate: is_undelegate, nonce: nonce },
+        'HyperliquidTransaction:TokenDelegate',
+        Signing::EIP712::TOKEN_DELEGATE_TYPES
+      )
+      post_action(action, signature, nonce, nil)
+    end
+
     # Clear the asset metadata cache
     # Call this if metadata has been updated
     def reload_metadata!
@@ -745,6 +826,13 @@ module Hyperliquid
       end
     end
 
+    # Normalize builder fee config for inclusion in action payload
+    # @param builder [Hash] Builder config with :b (address) and :f (fee)
+    # @return [Hash] Normalized builder config with lowercased address
+    def normalize_builder(builder)
+      { b: builder[:b].downcase, f: builder[:f] }
+    end
+
     # Convert order type to wire format
     # @param order_type [Hash] Order type configuration
     # @return [Hash] Wire format order type

data/lib/hyperliquid/signing/eip712.rb

@@ -67,6 +67,34 @@ module Hyperliquid
         ]
       }.freeze
 
+      APPROVE_AGENT_TYPES = {
+        'HyperliquidTransaction:ApproveAgent': [
+          { name: :hyperliquidChain, type: 'string' },
+          { name: :agentAddress, type: 'address' },
+          { name: :agentName, type: 'string' },
+          { name: :nonce, type: 'uint64' }
+        ]
+      }.freeze
+
+      APPROVE_BUILDER_FEE_TYPES = {
+        'HyperliquidTransaction:ApproveBuilderFee': [
+          { name: :hyperliquidChain, type: 'string' },
+          { name: :maxFeeRate, type: 'string' },
+          { name: :builder, type: 'address' },
+          { name: :nonce, type: 'uint64' }
+        ]
+      }.freeze
+
+      TOKEN_DELEGATE_TYPES = {
+        'HyperliquidTransaction:TokenDelegate': [
+          { name: :hyperliquidChain, type: 'string' },
+          { name: :validator, type: 'address' },
+          { name: :wei, type: 'uint64' },
+          { name: :isUndelegate, type: 'bool' },
+          { name: :nonce, type: 'uint64' }
+        ]
+      }.freeze
+
       class << self
         # Domain for L1 actions (orders, cancels, leverage, etc.)
         # @return [Hash] EIP-712 domain configuration

data/lib/hyperliquid/signing/signer.rb

@@ -22,6 +22,12 @@ module Hyperliquid
         @key.address.to_s
       end
 
+      # Whether the signer targets testnet
+      # @return [Boolean]
+      def testnet?
+        @testnet
+      end
+
       # Sign an L1 action (orders, cancels, leverage updates, etc.)
       # @param action [Hash] The action payload to sign
       # @param nonce [Integer] Timestamp in milliseconds

data/lib/hyperliquid/version.rb

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

data/lib/hyperliquid.rb

@@ -58,6 +58,7 @@ module Hyperliquid
         client: client,
         signer: signer,
         info: @info,
+        testnet: testnet,
         expires_after: expires_after
       )
     end

data/scripts/test_10_vault.rb

@@ -0,0 +1,66 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Test 10: Vault Status / Deposit / Withdraw
+#
+# Default:  Show vault status (equity, entry date, unlock date)
+# Options:  ruby test_10_vault_transfer.rb deposit
+#           ruby test_10_vault_transfer.rb withdraw
+
+require_relative 'test_helpers'
+
+sdk = build_sdk
+separator('TEST 10: Vault Status / Deposit / Withdraw')
+
+vault_addr = '0xa15099a30bbf2e68942d6f4c43d70d04faeab0a0'
+action = ARGV[0] # nil, "deposit", or "withdraw"
+
+puts "Vault: #{vault_addr}"
+puts
+
+vault = sdk.info.vault_details(vault_addr, sdk.exchange.address)
+follower = vault['followerState']
+
+if follower
+  equity = follower['vaultEquity']
+  entry_time = follower['vaultEntryTime']
+  lockup_until = follower['lockupUntil']
+
+  puts "Vault equity:  $#{equity}"
+  puts "Entry date:    #{Time.at(entry_time / 1000.0).utc}" if entry_time
+  puts "Unlock date:   #{Time.at(lockup_until / 1000.0).utc}" if lockup_until
+else
+  puts 'No position in this vault.'
+end
+puts
+
+case action
+when 'deposit'
+  puts 'Depositing $10 to vault...'
+  result = sdk.exchange.vault_transfer(
+    vault_address: vault_addr,
+    is_deposit: true,
+    usd: 10
+  )
+  api_error?(result) || puts(green('Vault deposit successful!'))
+when 'withdraw'
+  equity_f = follower&.dig('vaultEquity')&.to_f || 0
+  if equity_f > 1
+    withdraw_amount = equity_f.floor
+    puts "Withdrawing $#{withdraw_amount} from vault..."
+    result = sdk.exchange.vault_transfer(
+      vault_address: vault_addr,
+      is_deposit: false,
+      usd: withdraw_amount
+    )
+    api_error?(result) || puts(green('Vault withdrawal successful!'))
+  else
+    puts red("Insufficient vault equity to withdraw ($#{equity_f})")
+  end
+else
+  puts 'Pass "deposit" or "withdraw" as an argument to perform a transfer.'
+  puts '  ruby scripts/test_10_vault_transfer.rb deposit'
+  puts '  ruby scripts/test_10_vault_transfer.rb withdraw'
+end
+
+test_passed('Test 10 Vault Status')

data/scripts/test_11_builder_fee.rb

@@ -0,0 +1,70 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Test 11: Builder Fee (Approve + Order with Builder)
+# Approve a builder fee, then place an order with builder param, then cancel.
+
+require_relative 'test_helpers'
+
+sdk = build_sdk
+separator('TEST 11: Builder Fee (Approve + Order with Builder)')
+
+builder_address = '0x250F311Ae04D3CEA03443C76340069eD26C47D7D'
+max_fee_rate = '0.01%'
+perp_coin = 'BTC'
+
+# Step 1: Approve builder fee
+puts "Approving builder fee for #{builder_address} (max #{max_fee_rate})..."
+result = sdk.exchange.approve_builder_fee(builder: builder_address, max_fee_rate: max_fee_rate)
+api_error?(result) || puts(green('Builder fee approved'))
+puts
+
+wait_with_countdown(WAIT_SECONDS, 'Waiting before placing order with builder...')
+
+# Step 2: Verify approval via Info API
+puts 'Checking builder fee approval...'
+approval = sdk.info.max_builder_fee(sdk.exchange.address, builder_address)
+puts "Max builder fee: #{approval.inspect}"
+puts
+
+# Step 3: Place order with builder param
+mids = sdk.info.all_mids
+btc_price = mids[perp_coin]&.to_f
+
+if btc_price&.positive?
+  meta = sdk.info.meta
+  btc_meta = meta['universe'].find { |a| a['name'] == perp_coin }
+  sz_decimals = btc_meta['szDecimals']
+
+  limit_price = (btc_price * 1.50).round(0).to_i
+  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 "Builder: #{builder_address} (fee: 10 = 1bp)"
+  puts
+
+  puts 'Placing limit SELL order with builder fee...'
+  result = sdk.exchange.order(
+    coin: perp_coin,
+    is_buy: false,
+    size: perp_size,
+    limit_px: limit_price,
+    order_type: { limit: { tif: 'Gtc' } },
+    builder: { b: builder_address, f: 10 }
+  )
+  oid = check_result(result, 'Limit short with builder')
+
+  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 red("SKIPPED: Could not get #{perp_coin} price")
+end
+
+test_passed('Test 11 Builder Fee')

data/scripts/test_12_staking.rb

@@ -0,0 +1,68 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Test 12: Staking Status / Delegate / Undelegate
+#
+# Default:  Show staking summary and delegations
+# Options:  ruby test_12_staking.rb delegate
+#           ruby test_12_staking.rb undelegate
+
+require_relative 'test_helpers'
+
+sdk = build_sdk
+separator('TEST 12: Staking Status / Delegate / Undelegate')
+
+validator = '0x946bf3135c7d15e4462b510f74b6e304aabb5b21'
+action = ARGV[0] # nil, "delegate", or "undelegate"
+delegate_amount = 10_000_000 # 0.1 HYPE (wei = float * 1e8)
+
+puts "Validator: #{validator}"
+puts
+
+# Show staking summary
+summary = sdk.info.delegator_summary(sdk.exchange.address)
+puts "Staking summary:"
+puts "  Delegated:      #{summary['delegated']}" if summary['delegated']
+puts "  Undelegatable:  #{summary['undelegatable']}" if summary['undelegatable']
+puts "  Total pending:  #{summary['totalPending']}" if summary['totalPending']
+puts "  N delegations:  #{summary['nDelegations']}" if summary['nDelegations']
+puts
+
+# Show delegations for this validator
+delegations = sdk.info.delegations(sdk.exchange.address)
+validator_delegation = delegations&.find { |d| d['validator']&.downcase == validator.downcase }
+
+if validator_delegation
+  puts "Delegation to #{validator}:"
+  puts "  Amount:    #{validator_delegation['amount']}"
+  lockup = validator_delegation['lockedUntilTimestamp']
+  puts "  Locked until: #{Time.at(lockup / 1000.0).utc}" if lockup
+else
+  puts "No active delegation to #{validator}."
+end
+puts
+
+case action
+when 'delegate'
+  puts "Delegating 0.1 HYPE to #{validator}..."
+  result = sdk.exchange.token_delegate(
+    validator: validator,
+    wei: delegate_amount,
+    is_undelegate: false
+  )
+  api_error?(result) || puts(green('Delegation successful!'))
+when 'undelegate'
+  puts "Undelegating 0.1 HYPE from #{validator}..."
+  result = sdk.exchange.token_delegate(
+    validator: validator,
+    wei: delegate_amount,
+    is_undelegate: true
+  )
+  api_error?(result) || puts(green('Undelegation successful!'))
+else
+  puts 'Pass "delegate" or "undelegate" as an argument to perform an action.'
+  puts '  ruby scripts/test_12_staking.rb delegate'
+  puts '  ruby scripts/test_12_staking.rb undelegate'
+end
+
+test_passed('Test 12 Staking')

data/scripts/test_all.rb

@@ -28,7 +28,9 @@ SCRIPTS = [
   'test_07_market_close.rb',
   'test_08_usd_class_transfer.rb',
   'test_09_sub_account_lifecycle.rb',
-  'test_10_vault_transfer.rb'
+  'test_10_vault.rb',
+  'test_11_builder_fee.rb',
+  'test_12_staking.rb'
 ].freeze
 
 def green(text)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hyperliquid
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - carter2099
@@ -108,7 +108,9 @@ files:
 - scripts/test_07_market_close.rb
 - scripts/test_08_usd_class_transfer.rb
 - scripts/test_09_sub_account_lifecycle.rb
-- scripts/test_10_vault_transfer.rb
+- scripts/test_10_vault.rb
+- scripts/test_11_builder_fee.rb
+- scripts/test_12_staking.rb
 - scripts/test_all.rb
 - scripts/test_helpers.rb
 - sig/hyperliquid.rbs

data/scripts/test_10_vault_transfer.rb

@@ -1,41 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-# Test 10: Vault Deposit/Withdraw
-# Check vault equity and either deposit or withdraw.
-
-require_relative 'test_helpers'
-
-sdk = build_sdk
-separator('TEST 10: Vault Deposit/Withdraw')
-
-vault_addr = '0xa15099a30bbf2e68942d6f4c43d70d04faeab0a0'
-puts "Vault: #{vault_addr}"
-puts
-
-vault = sdk.info.vault_details(vault_addr, sdk.exchange.address)
-user_vault_equity = vault.dig('portfolio', 0, 1, 'accountValue')&.to_f || 0
-puts "User equity in vault: $#{user_vault_equity}"
-puts
-
-if user_vault_equity > 1
-  withdraw_amount = user_vault_equity.floor
-  puts "Withdrawing $#{withdraw_amount} from vault..."
-  result = sdk.exchange.vault_transfer(
-    vault_address: vault_addr,
-    is_deposit: false,
-    usd: withdraw_amount
-  )
-  api_error?(result) || puts(green('Vault withdrawal successful!'))
-else
-  puts "User has $#{user_vault_equity} in vault (insufficient to withdraw)"
-  puts 'Depositing $10 to vault...'
-  result = sdk.exchange.vault_transfer(
-    vault_address: vault_addr,
-    is_deposit: true,
-    usd: 10
-  )
-  api_error?(result) || puts(green('Vault deposit successful!'))
-end
-
-test_passed('Test 10 Vault Deposit/Withdraw')