erpc-sdk 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f52f98e6f0df7cf416a17a3db62fe29b2182da2f4888eb0fd02293402c1a664
-  data.tar.gz: 9d25c259f339edfd2c4c2e5080a7a6befd00cb587f2281ab9297ea71f83c974c
+  metadata.gz: 4152582a8b2cdb14a5b98a90761f07abf0ab2313540e5f46cef71d0111a6c531
+  data.tar.gz: 6f8d52e59d11fe4aa9d7d81af2941c65e59adfb98b5bade3a478f25c91d2bc52
 SHA512:
-  metadata.gz: 70db8d372a797587c54a69992689c533ae20204a8c215c0637753524c19e47465935deaf1cec231161eb6ed1a50a2f044a084f84b1e281cabff1fe7a14bcb6ba
-  data.tar.gz: f505d87463f95c0ac66c4d9789045dc92cd25765d3ed2d55538f4497d7894f1f599f020afd47f22627085df07f425cfef066911c3879d643ddd0739b39f52027
+  metadata.gz: 8f14e31048992941c30e753cf0ad84e066063ec667b66d5718c4d442acf2e5e1202b9bb7d70c391f720f32554cb518cde25de19c0166da4c2722cbe2ac66b0bf
+  data.tar.gz: '094c74f0c2939dab9312171da51889a121b8a1f6baed947bc11942ebde119211373f785abf5d8d81b8b1f9cf4818e3b2b8d6bedfe9ace572a7ce6beab765b73a'

data/README.md

@@ -1,7 +1,7 @@
 # ERPC SDK for Ruby
 
 Synchronous Ruby client for ERPC. It covers standard Solana, Ethereum, and
-Avalanche C-Chain JSON-RPC, indexed data, analytics, WebSocket subscriptions,
+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
@@ -47,14 +47,28 @@ only when `send` is called. `request` restricts calls to the namespace catalog;
 | `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. The Avalanche namespace uses the Ethereum-compatible typed
-catalog; use `raw` for additional C-Chain methods.
+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
 

data/lib/erpc_sdk/client.rb

@@ -3,7 +3,24 @@
 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)
+  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, :avalanche, :price, :account, :usage
@@ -31,6 +48,15 @@ module ERPC
         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,
@@ -78,6 +104,37 @@ module ERPC
       )
       @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(
@@ -119,6 +176,18 @@ module ERPC
       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/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.5.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.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - ELSOUL LABO B.V.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-04 00:00:00.000000000 Z
+date: 2026-09-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest