hyperliquid 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a800dda349fdca23a3e13c4b49020a3c17d506934f7f80b9859d760a95fb1a23
+  data.tar.gz: 518ae3c035ba3018ccb27d80552dd2f08b7b64d126b58f9828ce2db7d84052f6
+SHA512:
+  metadata.gz: 64ecd6d0060040e6f98143535c05ed0d4a3035e72fa9e0eba0faf4865b14496172463eecd1d57f664c9e5c9df35f0517cfd53b40d3bd34d1325625e1526c64e4
+  data.tar.gz: 1700985bc702806ea068c180327ae6ee5fc2ac0d8d5c801e85a61dc044a30c298a3130c840d44b9a132dddbc55c00262ff2137635a03b2139279b0ed0522890a

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,16 @@
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 3.4.3
+
+# Allow longer methods for complex logic
+Metrics/MethodLength:
+  Max: 50
+
+# Allow higher complexity for response handling
+Metrics/AbcSize:
+  Max: 25
+
+# Allow longer blocks in specs - this is normal for tests
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'

data/.ruby-version

@@ -0,0 +1 @@
+3.4.3

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-08-21
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 carter2099
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,200 @@
+# Hyperliquid Ruby SDK
+
+A Ruby SDK for interacting with the Hyperliquid decentralized exchange API.
+
+This is v0.1.0 - a read-only implementation focusing on the Info API endpoints for market data, user information, and order book data.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'hyperliquid'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install hyperliquid
+
+## Usage
+
+### Basic Setup
+
+```ruby
+require 'hyperliquid'
+
+# Create SDK instance (mainnet by default)
+sdk = Hyperliquid.new
+
+# Or use testnet
+testnet_sdk = Hyperliquid.new(testnet: true)
+
+# Access the Info API
+info = sdk.info
+```
+
+### Info API Methods
+
+The SDK provides access to all Hyperliquid Info API endpoints:
+
+#### Market Data
+
+```ruby
+# Get all market mid prices
+mids = sdk.info.all_mids
+# => { "BTC" => "50000", "ETH" => "3000", ... }
+
+# Get asset metadata
+meta = sdk.info.meta
+# => { "universe" => [...] }
+
+# Get extended asset metadata with contexts
+meta_ctxs = sdk.info.meta_and_asset_ctxs  
+# => { "universe" => [...], "assetCtxs" => [...] }
+
+# Get L2 order book for a coin
+book = sdk.info.l2_book("BTC")
+# => { "coin" => "BTC", "levels" => [[asks], [bids]], "time" => ... }
+
+# Get candlestick data
+candles = sdk.info.candles_snapshot("BTC", "1h", start_time, end_time)
+# => [{ "t" => ..., "o" => "50000", "h" => "51000", "l" => "49000", "c" => "50500", "v" => "100" }]
+```
+
+#### User Data
+
+```ruby
+user_address = "0x..." # Wallet address
+
+# Get user's open orders
+orders = sdk.info.open_orders(user_address)
+# => [{ "coin" => "BTC", "sz" => "0.1", "px" => "50000", "side" => "A" }]
+
+# Get user's fill history
+fills = sdk.info.user_fills(user_address)
+# => [{ "coin" => "BTC", "sz" => "0.1", "px" => "50000", "side" => "A", "time" => 1234567890 }]
+
+# Get user's trading state (positions, balances)
+state = sdk.info.user_state(user_address)
+# => { "assetPositions" => [...], "marginSummary" => {...} }
+
+# Get order status  
+status = sdk.info.order_status(user_address, order_id)
+# => { "status" => "filled", "sz" => "0.1", "px" => "50000" }
+```
+
+### Configuration
+
+```ruby
+# Custom timeout (default: 30 seconds)
+sdk = Hyperliquid.new(timeout: 60)
+
+# Check which environment you're using
+sdk.testnet?  # => false
+sdk.base_url  # => "https://api.hyperliquid.xyz"
+```
+
+### Error Handling
+
+The SDK provides comprehensive error handling:
+
+```ruby
+begin
+  orders = sdk.info.open_orders(user_address)
+rescue Hyperliquid::AuthenticationError
+  # Handle authentication issues
+rescue Hyperliquid::RateLimitError  
+  # Handle rate limiting
+rescue Hyperliquid::ServerError
+  # Handle server errors
+rescue Hyperliquid::NetworkError
+  # Handle network connectivity issues
+rescue Hyperliquid::Error => e
+  # Handle any other Hyperliquid API errors
+  puts "Error: #{e.message}"
+  puts "Status: #{e.status_code}" if e.status_code
+  puts "Response: #{e.response_body}" if e.response_body
+end
+```
+
+Available error classes:
+- `Hyperliquid::Error` - Base error class
+- `Hyperliquid::ClientError` - 4xx errors
+- `Hyperliquid::ServerError` - 5xx errors
+- `Hyperliquid::AuthenticationError` - 401 errors
+- `Hyperliquid::BadRequestError` - 400 errors
+- `Hyperliquid::NotFoundError` - 404 errors
+- `Hyperliquid::RateLimitError` - 429 errors
+- `Hyperliquid::NetworkError` - Connection issues
+- `Hyperliquid::TimeoutError` - Request timeouts
+
+## API Reference
+
+### Hyperliquid.new(options = {})
+
+Creates a new SDK instance.
+
+**Parameters:**
+- `testnet` (Boolean) - Use testnet instead of mainnet (default: false)  
+- `timeout` (Integer) - Request timeout in seconds (default: 30)
+
+### Info API Methods
+
+All Info methods return parsed JSON responses from the Hyperliquid API.
+
+#### Market Data Methods
+- `all_mids()` - Get all market mid prices
+- `meta()` - Get asset metadata
+- `meta_and_asset_ctxs()` - Get extended asset metadata
+- `l2_book(coin)` - Get L2 order book for a coin
+- `candles_snapshot(coin, interval, start_time, end_time)` - Get candlestick data
+
+#### User Data Methods  
+- `open_orders(user)` - Get user's open orders
+- `user_fills(user)` - Get user's fill history
+- `user_state(user)` - Get user's trading state
+- `order_status(user, oid)` - Get order status
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+Run the example:
+```bash
+ruby example.rb
+```
+
+Run tests:
+```bash  
+rake spec
+```
+
+Run tests and linting together:
+```bash
+rake
+```
+
+Run linting:
+```bash
+rake rubocop
+```
+
+## Roadmap
+
+This is v0.1.0 with read-only Info API support. Future versions will include:
+
+- v0.2.0: Trading API (place orders, cancel orders, etc.)
+- v0.3.0: WebSocket support for real-time data
+- v0.4.0: Advanced trading features
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/carter2099/hyperliquid.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/example.rb

@@ -0,0 +1,58 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative 'lib/hyperliquid'
+
+# Example usage of the Hyperliquid Ruby SDK
+
+# Create a new SDK instance (defaults to mainnet)
+sdk = Hyperliquid.new
+
+puts 'Hyperliquid Ruby SDK v0.1 - Info API Examples'
+puts '=' * 50
+
+# Example 1: Get all market mid prices
+begin
+  puts "\n1. Getting all market mid prices..."
+  mids = sdk.info.all_mids
+  puts "Found #{mids.length} markets" if mids.is_a?(Hash)
+rescue Hyperliquid::Error => e
+  puts "Error getting market mids: #{e.message}"
+end
+
+# Example 2: Get metadata for all assets
+begin
+  puts "\n2. Getting asset metadata..."
+  meta = sdk.info.meta
+  puts 'Got metadata for universe' if meta.is_a?(Hash)
+rescue Hyperliquid::Error => e
+  puts "Error getting metadata: #{e.message}"
+end
+
+# Example 3: Use testnet
+puts "\n3. Using testnet..."
+testnet_sdk = Hyperliquid.new(testnet: true)
+puts "Testnet SDK created, base URL: #{testnet_sdk.base_url}"
+
+# Example 4: User-specific endpoints (requires valid wallet address)
+wallet_address = "0x#{'0' * 40}" # Example placeholder address
+
+begin
+  puts "\n4. Getting open orders for wallet #{wallet_address[0..10]}..."
+  orders = sdk.info.open_orders(wallet_address)
+  puts "Open orders: #{orders}"
+rescue Hyperliquid::Error => e
+  puts "Error getting open orders: #{e.message}"
+end
+
+puts "\nSDK examples completed!"
+puts "\nAvailable Info methods:"
+puts '- all_mids() - Get all market mid prices'
+puts "- open_orders(user) - Get user's open orders"
+puts "- user_fills(user) - Get user's fill history"
+puts '- order_status(user, oid) - Get order status'
+puts "- user_state(user) - Get user's trading state"
+puts '- meta() - Get asset metadata'
+puts '- meta_and_asset_ctxs() - Get extended asset metadata'
+puts '- l2_book(coin) - Get L2 order book'
+puts '- candles_snapshot(coin, interval, start_time, end_time) - Get candlestick data'

data/lib/hyperliquid/client.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'faraday/retry'
+require 'json'
+
+module Hyperliquid
+  # HTTP client for making requests to Hyperliquid API
+  class Client
+    # TODO:
+    # Unused for now. To be added to build_connection
+    DEFAULT_RETRY_OPTIONS = {
+      max: 2,
+      interval: 0.5,
+      interval_randomness: 0.5,
+      backoff_factor: 2,
+      retry_statuses: [502, 503, 504],
+      exceptions: [
+        Faraday::ConnectionFailed,
+        Faraday::TimeoutError
+      ]
+    }.freeze
+
+    # Initialize a new HTTP client
+    # @param base_url [String] The base URL for the API
+    # @param timeout [Integer] Request timeout in seconds (default: Constants::DEFAULT_TIMEOUT)
+    def initialize(base_url:, timeout: Constants::DEFAULT_TIMEOUT)
+      @connection = build_connection(base_url, timeout)
+    end
+
+    # Make a POST request to the API
+    # @param endpoint [String] The API endpoint to make the request to
+    # @param body [Hash] The request body as a hash (default: {})
+    # @return [Hash, String] The parsed JSON response or raw response body
+    # @raise [NetworkError] When connection fails
+    # @raise [TimeoutError] When request times out
+    # @raise [BadRequestError] When API returns 400 status
+    # @raise [AuthenticationError] When API returns 401 status
+    # @raise [NotFoundError] When API returns 404 status
+    # @raise [RateLimitError] When API returns 429 status
+    # @raise [ServerError] When API returns 5xx status
+    # @raise [ClientError] When API returns unexpected status
+    def post(endpoint, body = {})
+      response = @connection.post(endpoint) do |req|
+        req.headers['Content-Type'] = 'application/json'
+        req.body = body.to_json unless body.empty?
+      end
+
+      handle_response(response)
+    rescue Faraday::ConnectionFailed => e
+      raise NetworkError, "Connection failed: #{e.message}"
+    rescue Faraday::TimeoutError => e
+      raise TimeoutError, "Request timed out: #{e.message}"
+    end
+
+    private
+
+    def build_connection(base_url, timeout)
+      Faraday.new(url: base_url) do |conn|
+        conn.options.timeout = timeout
+        conn.options.read_timeout = Constants::DEFAULT_READ_TIMEOUT
+
+        # TODO:
+        # conn.request :retry, DEFAULT_RETRY_OPTIONS
+      end
+    end
+
+    def handle_response(response)
+      parsed_body = parse_json(response.body)
+
+      case response.status
+      when 200..299
+        parsed_body
+      when 400
+        raise BadRequestError.new(
+          'Bad request',
+          status_code: response.status,
+          response_body: parsed_body
+        )
+      when 401
+        raise AuthenticationError.new(
+          'Authentication failed',
+          status_code: response.status,
+          response_body: parsed_body
+        )
+      when 404
+        raise NotFoundError.new(
+          'Resource not found',
+          status_code: response.status,
+          response_body: parsed_body
+        )
+      when 429
+        raise RateLimitError.new(
+          'Rate limit exceeded',
+          status_code: response.status,
+          response_body: parsed_body
+        )
+      when 500..599
+        raise ServerError.new(
+          'Server error',
+          status_code: response.status,
+          response_body: parsed_body
+        )
+      else
+        raise ClientError.new(
+          "Unexpected response status: #{response.status}",
+          status_code: response.status,
+          response_body: parsed_body
+        )
+      end
+    end
+
+    def parse_json(body)
+      return {} if body.nil? || body.empty?
+
+      JSON.parse(body)
+    rescue JSON::ParserError
+      body
+    end
+  end
+end

data/lib/hyperliquid/constants.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Hyperliquid
+  # Constants for Hyperliquid API
+  module Constants
+    # API URLs
+    MAINNET_API_URL = 'https://api.hyperliquid.xyz'
+    TESTNET_API_URL = 'https://api.hyperliquid-testnet.xyz'
+
+    # API endpoints
+    INFO_ENDPOINT = '/info'
+
+    # Request timeouts (seconds)
+    DEFAULT_TIMEOUT = 30
+    DEFAULT_READ_TIMEOUT = 30
+  end
+end

data/lib/hyperliquid/errors.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Hyperliquid
+  # Base error class for all Hyperliquid SDK errors
+  class Error < StandardError
+    attr_reader :status_code, :response_body
+
+    def initialize(message, status_code: nil, response_body: nil)
+      super(message)
+      @status_code = status_code
+      @response_body = response_body
+    end
+  end
+
+  # Error for HTTP client issues
+  class ClientError < Error; end
+
+  # Error for server-side issues
+  class ServerError < Error; end
+
+  # Error for authentication issues
+  class AuthenticationError < ClientError; end
+
+  # Error for rate limiting
+  class RateLimitError < ClientError; end
+
+  # Error for bad requests
+  class BadRequestError < ClientError; end
+
+  # Error for not found resources
+  class NotFoundError < ClientError; end
+
+  # Error for connection timeouts
+  class TimeoutError < Error; end
+
+  # Error for network connectivity issues
+  class NetworkError < Error; end
+end

data/lib/hyperliquid/info.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Hyperliquid
+  # Client for read-only Info API endpoints
+  class Info
+    def initialize(client)
+      @client = client
+    end
+
+    # Get all market mid prices
+    # @return [Hash] Hash containing mid prices for all markets
+    def all_mids
+      @client.post(Constants::INFO_ENDPOINT, { type: 'allMids' })
+    end
+
+    # Get a user's open orders
+    # @param user [String] Wallet address
+    # @return [Array] Array of open orders for the user
+    def open_orders(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'openOrders', user: user })
+    end
+
+    # Get a user's fill history
+    # @param user [String] Wallet address
+    # @return [Array] Array of fill history for the user
+    def user_fills(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'userFills', user: user })
+    end
+
+    # Get order status by order ID
+    # @param user [String] Wallet address
+    # @param oid [Integer] Order ID
+    # @return [Hash] Order status information
+    def order_status(user, oid)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'orderStatus', user: user, oid: oid })
+    end
+
+    # Get user's trading state
+    # @param user [String] Wallet address
+    # @return [Hash] User's trading state including positions and balances
+    def user_state(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'clearinghouseState', user: user })
+    end
+
+    # Get metadata for all assets
+    # @return [Hash] Metadata for all tradable assets
+    def meta
+      @client.post(Constants::INFO_ENDPOINT, { type: 'meta' })
+    end
+
+    # Get metadata for all assets including universe info
+    # @return [Hash] Extended metadata for all assets with universe information
+    def meta_and_asset_ctxs
+      @client.post(Constants::INFO_ENDPOINT, { type: 'metaAndAssetCtxs' })
+    end
+
+    # Get L2 order book for a coin
+    # @param coin [String] Coin symbol (e.g., "BTC", "ETH")
+    # @return [Hash] L2 order book data with bids and asks
+    def l2_book(coin)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'l2Book', coin: coin })
+    end
+
+    # Get candlestick data
+    # @param coin [String] Coin symbol
+    # @param interval [String] Time interval (e.g., "1m", "1h", "1d")
+    # @param start_time [Integer] Start timestamp in milliseconds
+    # @param end_time [Integer] End timestamp in milliseconds
+    # @return [Array] Array of candlestick data
+    def candles_snapshot(coin, interval, start_time, end_time)
+      @client.post(Constants::INFO_ENDPOINT, {
+                     type: 'candleSnapshot',
+                     req: {
+                       coin: coin,
+                       interval: interval,
+                       startTime: start_time,
+                       endTime: end_time
+                     }
+                   })
+    end
+  end
+end

data/lib/hyperliquid/version.rb

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

data/lib/hyperliquid.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require_relative 'hyperliquid/version'
+require_relative 'hyperliquid/constants'
+require_relative 'hyperliquid/errors'
+require_relative 'hyperliquid/client'
+require_relative 'hyperliquid/info'
+
+# Ruby SDK for Hyperliquid API
+# Provides read-only access to Hyperliquid's decentralized exchange API
+module Hyperliquid
+  # Create a new SDK instance
+  # @param testnet [Boolean] Whether to use testnet (default: false for mainnet)
+  # @param timeout [Integer] Request timeout in seconds (default: 30)
+  # @return [Hyperliquid::SDK] A new SDK instance
+  def self.new(testnet: false, timeout: Constants::DEFAULT_TIMEOUT)
+    SDK.new(testnet: testnet, timeout: timeout)
+  end
+
+  # Main SDK class
+  class SDK
+    attr_reader :info
+
+    # Initialize the SDK
+    # @param testnet [Boolean] Whether to use testnet (default: false for mainnet)
+    # @param timeout [Integer] Request timeout in seconds
+    def initialize(testnet: false, timeout: Constants::DEFAULT_TIMEOUT)
+      base_url = testnet ? Constants::TESTNET_API_URL : Constants::MAINNET_API_URL
+      client = Client.new(base_url: base_url, timeout: timeout)
+
+      @info = Info.new(client)
+      @testnet = testnet
+    end
+
+    # Check if using testnet
+    # @return [Boolean] True if using testnet, false if mainnet
+    def testnet?
+      @testnet
+    end
+
+    # Get the base API URL being used
+    # @return [String] The base API URL
+    def base_url
+      @testnet ? Constants::TESTNET_API_URL : Constants::MAINNET_API_URL
+    end
+  end
+end

data/sig/hyperliquid.rbs

@@ -0,0 +1,4 @@
+module Hyperliquid
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification
+name: hyperliquid
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- carter2099
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: A Ruby SDK for interacting with Hyperliquid's decentralized exchange
+  API
+email:
+- carter2077@pm.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- example.rb
+- lib/hyperliquid.rb
+- lib/hyperliquid/client.rb
+- lib/hyperliquid/constants.rb
+- lib/hyperliquid/errors.rb
+- lib/hyperliquid/info.rb
+- lib/hyperliquid/version.rb
+- sig/hyperliquid.rbs
+homepage: https://github.com/carter2099/hyperliquid
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/carter2099/hyperliquid
+  source_code_uri: https://github.com/carter2099/hyperliquid
+  changelog_uri: https://github.com/carter2099/hyperliquid/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: Ruby SDK for Hyperliquid API
+test_files: []