erpc-sdk 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0b83f0a7e0881001a42033b8c7116ea6407f1e024cd258e9cf7df546eb0d875
-  data.tar.gz: 48a8098b1739371b431ba2e534644002647ffff6fa4c57889cf0723ffeecfdc1
+  metadata.gz: 4152582a8b2cdb14a5b98a90761f07abf0ab2313540e5f46cef71d0111a6c531
+  data.tar.gz: 6f8d52e59d11fe4aa9d7d81af2941c65e59adfb98b5bade3a478f25c91d2bc52
 SHA512:
-  metadata.gz: 6badad47dbad416e9cea863d849de82beefd7fbf9448acce21b9a146ebf4f13e1260aad6591b94bd33a71f21cb832640a66bb3767c8a40f3785ab2629d9f1a1c
-  data.tar.gz: d9c6f52fbfc4ca654e8540640a50dc6fdda24773d6bb3ed54752cd8d6ba99fdf33db19a92522acdef95c5761aa9d4e702ff024f773fd2fff06196c523504eab3
+  metadata.gz: 8f14e31048992941c30e753cf0ad84e066063ec667b66d5718c4d442acf2e5e1202b9bb7d70c391f720f32554cb518cde25de19c0166da4c2722cbe2ac66b0bf
+  data.tar.gz: '094c74f0c2939dab9312171da51889a121b8a1f6baed947bc11942ebde119211373f785abf5d8d81b8b1f9cf4818e3b2b8d6bedfe9ace572a7ce6beab765b73a'

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/P/X-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,31 @@ 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.avalanche.avax` | C-Chain AVAX atomic transaction API |
+| `erpc.avalanche.x_chain` | X-Chain API |
+| `erpc.avalanche.p_chain` | P-Chain API |
+| `erpc.avalanche.proposer_vm` | P-Chain proposer VM API |
+| `erpc.avalanche.info` | Network upgrade information |
+| `erpc.avalanche.index` | C/P/X block and X transaction indexes |
 | `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. Native methods use named Hash parameters and Index calls use
+explicit chain/container paths. Native and Index batches are rejected locally;
+use `raw` with an exact wire method name for forward compatibility.
+
+```ruby
+p_height = erpc.avalanche.p_chain.get_height.send
+indexed_tx = erpc.avalanche.index.x_chain_transactions
+  .get_container_by_id(id: transaction_id)
+  .send
+```
+
 ## Intact batches
 
 ```ruby
@@ -74,7 +96,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,27 @@
 module ERPC
   SolanaClient = Struct.new(:rpc, :das, :history, :leaders, :analytics, :subscriptions, keyword_init: true)
   EthereumClient = Struct.new(:rpc, :subscriptions, keyword_init: true)
+  AvalancheIndexClient = Struct.new(
+    :c_chain_blocks,
+    :p_chain_blocks,
+    :x_chain_blocks,
+    :x_chain_transactions,
+    keyword_init: true
+  )
+  AvalancheClient = Struct.new(
+    :rpc,
+    :avax,
+    :x_chain,
+    :p_chain,
+    :proposer_vm,
+    :info,
+    :index,
+    :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 +41,22 @@ 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
+      )
+      avalanche_index_transport = lambda do |path|
+        HttpJsonRpcTransport.new(
+          api_key: config.api_key,
+          endpoint: URLs.with_path(config.avalanche_endpoint, path),
+          headers: config.headers,
+          timeout: config.timeout,
+          adapter: adapter
+        )
+      end
       solana_ws = WebSocketJsonRpcTransport.new(
         URLs.websocket(config.endpoint, config.api_key),
         config.api_key,
@@ -35,6 +69,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 +102,41 @@ 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),
+        avax: avalanche_namespace(avalanche_transport, AVALANCHE_AVAX_METHODS, "avax"),
+        x_chain: avalanche_namespace(avalanche_transport, AVALANCHE_X_CHAIN_METHODS, "avm"),
+        p_chain: avalanche_namespace(avalanche_transport, AVALANCHE_P_CHAIN_METHODS, "platform"),
+        proposer_vm: avalanche_namespace(
+          avalanche_transport,
+          AVALANCHE_PROPOSER_VM_METHODS,
+          "proposervm"
+        ),
+        info: avalanche_namespace(avalanche_transport, AVALANCHE_INFO_METHODS, "info"),
+        index: AvalancheIndexClient.new(
+          c_chain_blocks: avalanche_namespace(
+            avalanche_index_transport.call("/ava/ext/index/C/block"),
+            AVALANCHE_INDEX_METHODS,
+            "index"
+          ),
+          p_chain_blocks: avalanche_namespace(
+            avalanche_index_transport.call("/ava/ext/index/P/block"),
+            AVALANCHE_INDEX_METHODS,
+            "index"
+          ),
+          x_chain_blocks: avalanche_namespace(
+            avalanche_index_transport.call("/ava/ext/index/X/block"),
+            AVALANCHE_INDEX_METHODS,
+            "index"
+          ),
+          x_chain_transactions: avalanche_namespace(
+            avalanche_index_transport.call("/ava/ext/index/X/tx"),
+            AVALANCHE_INDEX_METHODS,
+            "index"
+          )
+        ),
+        subscriptions: EthereumSubscriptions.new(avalanche_ws)
+      )
       @price = PriceClient.new(
         RestTransport.new(
           credential: config.api_key,
@@ -98,8 +173,21 @@ module ERPC
       @closed = true
       solana.subscriptions.close
       ethereum.subscriptions.close
+      avalanche.subscriptions.close
       nil
     end
+
+    private
+
+    def avalanche_namespace(transport, methods, prefix)
+      RpcNamespace.new(
+        transport,
+        methods,
+        parameter_mode: :named,
+        batch_policy: :unsupported,
+        method_prefix: prefix
+      )
+    end
   end
 
   class CloudClient

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/rpc.rb

@@ -162,6 +162,72 @@ module ERPC
     "eth_unsubscribe"
   ].freeze
 
+  AVALANCHE_AVAX_METHODS = [
+    "avax.getAtomicTx",
+    "avax.getAtomicTxStatus",
+    "avax.getUTXOs",
+    "avax.issueTx"
+  ].freeze
+
+  AVALANCHE_X_CHAIN_METHODS = [
+    "avm.buildGenesis",
+    "avm.getAllBalances",
+    "avm.getAssetDescription",
+    "avm.getBalance",
+    "avm.getBlockByHeight",
+    "avm.getHeight",
+    "avm.getTx",
+    "avm.getTxFee",
+    "avm.getTxStatus",
+    "avm.getUTXOs",
+    "avm.issueTx"
+  ].freeze
+
+  AVALANCHE_P_CHAIN_METHODS = [
+    "platform.getAllValidatorsAt",
+    "platform.getBalance",
+    "platform.getBlockchainStatus",
+    "platform.getBlockchains",
+    "platform.getCurrentSupply",
+    "platform.getCurrentValidators",
+    "platform.getFeeConfig",
+    "platform.getFeeState",
+    "platform.getHeight",
+    "platform.getMinStake",
+    "platform.getRewardUTXOs",
+    "platform.getStake",
+    "platform.getStakingAssetID",
+    "platform.getSubnets",
+    "platform.getTimestamp",
+    "platform.getTotalStake",
+    "platform.getTx",
+    "platform.getTxStatus",
+    "platform.getUTXOs",
+    "platform.getValidatorFeeConfig",
+    "platform.getValidatorFeeState",
+    "platform.getValidatorsAt",
+    "platform.issueTx",
+    "platform.sampleValidators",
+    "platform.validatedBy",
+    "platform.validates"
+  ].freeze
+
+  AVALANCHE_PROPOSER_VM_METHODS = [
+    "proposervm.getCurrentEpoch",
+    "proposervm.getProposedHeight"
+  ].freeze
+
+  AVALANCHE_INFO_METHODS = ["info.upgrades"].freeze
+
+  AVALANCHE_INDEX_METHODS = [
+    "index.getContainerByID",
+    "index.getContainerByIndex",
+    "index.getContainerRange",
+    "index.getIndex",
+    "index.getLastAccepted",
+    "index.isAccepted"
+  ].freeze
+
   HEAVY_SOLANA_METHODS = %w[
     getPriorityFeeEstimate
     getProgramAccounts
@@ -197,11 +263,16 @@ module ERPC
   class RpcNamespace
     attr_reader :endpoint
 
-    def initialize(transport, methods, parameter_mode:, batch_policy: :any)
+    def initialize(transport, methods, parameter_mode:, batch_policy: :any, method_prefix: nil)
       @transport = transport
       @endpoint = transport.endpoint
-      @methods = methods.to_h { |method| [method, true] }.freeze
-      @aliases = methods.to_h { |method| [snake_case(method), method] }.freeze
+      prefix = method_prefix.nil? ? "" : "#{method_prefix}."
+      @wire_methods = methods.to_h do |method|
+        public_method = method.start_with?(prefix) ? method.delete_prefix(prefix) : method
+        [public_method, method]
+      end.freeze
+      @methods = @wire_methods.transform_values { true }.freeze
+      @aliases = @methods.to_h { |method, _| [snake_case(method), method] }.freeze
       @parameter_mode = parameter_mode
       @batch_policy = batch_policy
     end
@@ -211,7 +282,7 @@ module ERPC
         raise ConfigError, "#{method.inspect} is not in this namespace; use raw for forward-compatible methods"
       end
 
-      PendingRpcRequest.new(@transport, method, params, decoder || ->(value) { value })
+      PendingRpcRequest.new(@transport, @wire_methods.fetch(method), params, decoder || ->(value) { value })
     end
 
     def raw(method, params = nil, decoder: nil)
@@ -222,7 +293,7 @@ module ERPC
 
     def batch(calls)
       if @batch_policy == :unsupported && !calls.empty?
-        raise BatchPolicyError, "Leader RPC methods do not support batching"
+        raise BatchPolicyError, "This RPC namespace does not support batching"
       end
       if @batch_policy == :solana_standard
         methods = calls.map { |call| call[:method] || call["method"] }
@@ -233,7 +304,12 @@ module ERPC
         end
       end
 
-      PendingRpcBatchRequest.new(@transport, calls)
+      wire_calls = if @wire_methods.any? { |method, wire| method != wire }
+                     calls.map { |call| wire_call(call) }
+                   else
+                     calls
+                   end
+      PendingRpcBatchRequest.new(@transport, wire_calls)
     end
 
     def method_missing(name, *arguments, &block)
@@ -262,6 +338,18 @@ module ERPC
 
     private
 
+    def wire_call(call)
+      method = call[:method] || call["method"]
+      unless @wire_methods.key?(method)
+        raise ConfigError, "#{method.inspect} is not in this namespace; use raw for forward-compatible methods"
+      end
+
+      mapped = { method: @wire_methods.fetch(method) }
+      mapped[:params] = call[:params] if call.key?(:params)
+      mapped[:params] = call["params"] if call.key?("params")
+      mapped
+    end
+
     def snake_case(value)
       value.gsub(/(?<=[a-z0-9])(?=[A-Z])/, "_").downcase
     end

data/lib/erpc_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ERPC
-  VERSION = "0.4.0"
+  VERSION = "0.6.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.6.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-07 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: []