erpc-sdk 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0b83f0a7e0881001a42033b8c7116ea6407f1e024cd258e9cf7df546eb0d875
-  data.tar.gz: 48a8098b1739371b431ba2e534644002647ffff6fa4c57889cf0723ffeecfdc1
+  metadata.gz: 4f52f98e6f0df7cf416a17a3db62fe29b2182da2f4888eb0fd02293402c1a664
+  data.tar.gz: 9d25c259f339edfd2c4c2e5080a7a6befd00cb587f2281ab9297ea71f83c974c
 SHA512:
-  metadata.gz: 6badad47dbad416e9cea863d849de82beefd7fbf9448acce21b9a146ebf4f13e1260aad6591b94bd33a71f21cb832640a66bb3767c8a40f3785ab2629d9f1a1c
-  data.tar.gz: d9c6f52fbfc4ca654e8540640a50dc6fdda24773d6bb3ed54752cd8d6ba99fdf33db19a92522acdef95c5761aa9d4e702ff024f773fd2fff06196c523504eab3
+  metadata.gz: 70db8d372a797587c54a69992689c533ae20204a8c215c0637753524c19e47465935deaf1cec231161eb6ed1a50a2f044a084f84b1e281cabff1fe7a14bcb6ba
+  data.tar.gz: f505d87463f95c0ac66c4d9789045dc92cd25765d3ed2d55538f4497d7894f1f599f020afd47f22627085df07f425cfef066911c3879d643ddd0739b39f52027

data/README.md

@@ -1,8 +1,8 @@
 # ERPC SDK for Ruby
 
-Synchronous Ruby client for ERPC. It covers standard Solana and Ethereum
-JSON-RPC, indexed data, analytics, WebSocket subscriptions, price REST and
-server-sent events, account usage, and scoped Cloud reads.
+Synchronous Ruby client for ERPC. It covers standard Solana, Ethereum, and
+Avalanche C-Chain JSON-RPC, indexed data, analytics, WebSocket subscriptions,
+price REST and server-sent events, account usage, and scoped Cloud reads.
 
 ```bash
 gem install erpc-sdk
@@ -21,7 +21,8 @@ begin
 
   slot = erpc.solana.rpc.get_slot.send
   chain_id = erpc.ethereum.rpc.eth_chain_id.send
-  puts({ slot: slot, chain_id: chain_id })
+  avalanche_chain_id = erpc.avalanche.rpc.eth_chain_id.send
+  puts({ slot: slot, chain_id: chain_id, avalanche_chain_id: avalanche_chain_id })
 ensure
   erpc&.close
 end
@@ -44,10 +45,17 @@ only when `send` is called. `request` restricts calls to the namespace catalog;
 | `erpc.solana.subscriptions` | Enhanced WebSocket subscriptions |
 | `erpc.ethereum.rpc` | Standard Ethereum JSON-RPC |
 | `erpc.ethereum.subscriptions` | Ethereum WebSocket subscriptions |
+| `erpc.avalanche.rpc` | Avalanche C-Chain EVM-compatible JSON-RPC |
+| `erpc.avalanche.subscriptions` | Avalanche C-Chain WebSocket subscriptions |
 | `erpc.price` | Price metadata, updates, and SSE streams |
 | `erpc.account` | Token balance |
 | `erpc.usage` | Masked monthly API-key usage |
 
+`avalanche_endpoint` defaults to `https://ava-rpc.erpc.global` and can be
+overridden independently. The SDK uses its `/ava` HTTP route and `/ava-ws`
+WebSocket route. The Avalanche namespace uses the Ethereum-compatible typed
+catalog; use `raw` for additional C-Chain methods.
+
 ## Intact batches
 
 ```ruby
@@ -74,7 +82,7 @@ end
 ```
 
 Subscriptions use a lazy persistent WebSocket connection. `unsubscribe` is
-idempotent, and `close` closes both network subscription transports.
+idempotent, and `close` closes all network subscription transports.
 
 ## Cloud reads
 

data/lib/erpc_sdk/client.rb

@@ -3,9 +3,10 @@
 module ERPC
   SolanaClient = Struct.new(:rpc, :das, :history, :leaders, :analytics, :subscriptions, keyword_init: true)
   EthereumClient = Struct.new(:rpc, :subscriptions, keyword_init: true)
+  AvalancheClient = Struct.new(:rpc, :subscriptions, keyword_init: true)
 
   class Client
-    attr_reader :solana, :ethereum, :price, :account, :usage
+    attr_reader :solana, :ethereum, :avalanche, :price, :account, :usage
 
     def initialize(config, http_adapter: nil, websocket_factory: nil)
       adapter = http_adapter || NetHttpAdapter.new
@@ -23,6 +24,13 @@ module ERPC
         timeout: config.timeout,
         adapter: adapter
       )
+      avalanche_transport = HttpJsonRpcTransport.new(
+        api_key: config.api_key,
+        endpoint: URLs.with_path(config.avalanche_endpoint, "/ava"),
+        headers: config.headers,
+        timeout: config.timeout,
+        adapter: adapter
+      )
       solana_ws = WebSocketJsonRpcTransport.new(
         URLs.websocket(config.endpoint, config.api_key),
         config.api_key,
@@ -35,6 +43,12 @@ module ERPC
         config.timeout,
         connection_factory: websocket_factory
       )
+      avalanche_ws = WebSocketJsonRpcTransport.new(
+        URLs.websocket(config.avalanche_endpoint, config.api_key, "/ava-ws"),
+        config.api_key,
+        config.timeout,
+        connection_factory: websocket_factory
+      )
 
       @solana = SolanaClient.new(
         rpc: RpcNamespace.new(
@@ -62,6 +76,10 @@ module ERPC
         rpc: RpcNamespace.new(ethereum_transport, ETHEREUM_RPC_METHODS, parameter_mode: :positional),
         subscriptions: EthereumSubscriptions.new(ethereum_ws)
       )
+      @avalanche = AvalancheClient.new(
+        rpc: RpcNamespace.new(avalanche_transport, ETHEREUM_RPC_METHODS, parameter_mode: :positional),
+        subscriptions: EthereumSubscriptions.new(avalanche_ws)
+      )
       @price = PriceClient.new(
         RestTransport.new(
           credential: config.api_key,
@@ -98,6 +116,7 @@ module ERPC
       @closed = true
       solana.subscriptions.close
       ethereum.subscriptions.close
+      avalanche.subscriptions.close
       nil
     end
   end

data/lib/erpc_sdk/config.rb

@@ -4,6 +4,7 @@ require "uri"
 
 module ERPC
   DEFAULT_ENDPOINT = "https://edge.erpc.global"
+  DEFAULT_AVALANCHE_ENDPOINT = "https://ava-rpc.erpc.global"
   DEFAULT_ACCOUNT_ENDPOINT = "https://solana-rpc.erpc.global"
   DEFAULT_USER_ENDPOINT = "https://user-api.erpc.global"
   DEFAULT_TIMEOUT = 30.0
@@ -56,15 +57,17 @@ module ERPC
   end
 
   class ClientConfig
-    attr_reader :api_key, :endpoint, :account_endpoint, :user_endpoint, :headers, :timeout
+    attr_reader :api_key, :endpoint, :account_endpoint, :user_endpoint, :headers, :timeout, :avalanche_endpoint
 
     def initialize(api_key:, endpoint: DEFAULT_ENDPOINT, account_endpoint: DEFAULT_ACCOUNT_ENDPOINT,
-                   user_endpoint: DEFAULT_USER_ENDPOINT, headers: {}, timeout: DEFAULT_TIMEOUT)
+                   user_endpoint: DEFAULT_USER_ENDPOINT, headers: {}, timeout: DEFAULT_TIMEOUT,
+                   avalanche_endpoint: DEFAULT_AVALANCHE_ENDPOINT)
       @api_key = api_key.to_s.strip
       raise ConfigError, "api_key must not be empty" if @api_key.empty?
       raise ConfigError, "timeout must be positive" unless timeout.is_a?(Numeric) && timeout.finite? && timeout.positive?
 
       @endpoint = URLs.normalize_endpoint(endpoint)
+      @avalanche_endpoint = URLs.normalize_endpoint(avalanche_endpoint)
       @account_endpoint = URLs.normalize_endpoint(account_endpoint)
       @user_endpoint = URLs.normalize_endpoint(user_endpoint)
       @headers = headers.to_h.transform_keys(&:to_s).transform_values(&:to_s).freeze
@@ -73,6 +76,7 @@ module ERPC
 
     def inspect
       "#<#{self.class} api_key=[REDACTED] endpoint=#{endpoint.inspect} " \
+        "avalanche_endpoint=#{avalanche_endpoint.inspect} " \
         "account_endpoint=#{account_endpoint.inspect} user_endpoint=#{user_endpoint.inspect} " \
         "header_names=#{headers.keys.inspect} timeout=#{timeout.inspect}>"
     end

data/lib/erpc_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ERPC
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: erpc-sdk
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - ELSOUL LABO B.V.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-29 00:00:00.000000000 Z
+date: 2026-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -50,8 +50,8 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '14'
-description: Ruby client for ERPC JSON-RPC, REST, streams, subscriptions, and Cloud
-  reads.
+description: Ruby client for ERPC Solana, Ethereum, and Avalanche RPC, REST, streams,
+  subscriptions, and Cloud reads.
 email:
 executables: []
 extensions: []
@@ -96,5 +96,5 @@ requirements: []
 rubygems_version: 3.3.27
 signing_key:
 specification_version: 4
-summary: Ruby SDK for ERPC
+summary: Multi-network Ruby SDK for ERPC
 test_files: []