bsv-sdk 0.16.0 → 0.18.0

data/lib/bsv/wire_format.rb

@@ -18,6 +18,10 @@ module BSV
   #   BSV::WireFormat.to_wire({ outputs: [{ locking_script: 'abc' }] })
   #   # => { 'outputs' => [{ 'lockingScript' => 'abc' }] }
   module WireFormat
+    # Maximum nesting depth for deep conversions. Prevents stack overflow on
+    # pathologically deep hashes or arrays.
+    MAX_DEPTH = 20
+
     # Well-known snake_case -> camelCase pairs for BRC-100/BRC-103 protocol keys.
     #
     # Acronyms like protocolID, keyID are canonical per the TS SDK (Wallet.interfaces.ts).
@@ -90,10 +94,7 @@ module BSV
     def to_wire(hash)
       raise ArgumentError, 'argument must not be nil' if hash.nil?
 
-      hash.each_with_object({}) do |(k, v), out|
-        camel_key = snake_to_camel(k.to_s)
-        out[camel_key] = deep_convert_value_to_wire(v)
-      end
+      to_wire_at_depth(hash, 0)
     end
 
     # Deeply converts all Hash keys from camelCase strings to snake_case symbols.
@@ -107,10 +108,7 @@ module BSV
     def from_wire(hash)
       raise ArgumentError, 'argument must not be nil' if hash.nil?
 
-      hash.each_with_object({}) do |(k, v), out|
-        snake_key = camel_to_snake(k.to_s).to_sym
-        out[snake_key] = deep_convert_value_from_wire(v)
-      end
+      from_wire_at_depth(hash, 0)
     end
 
     # Converts top-level Hash keys only from snake_case to camelCase strings.
@@ -182,12 +180,35 @@ module BSV
     end
     private_class_method :generic_camel_to_snake
 
+    # Depth-aware inner implementation of to_wire.
+    def to_wire_at_depth(hash, depth)
+      hash.each_with_object({}) do |(k, v), out|
+        camel_key = snake_to_camel(k.to_s)
+        out[camel_key] = deep_convert_value_to_wire(v, depth + 1)
+      end
+    end
+    private_class_method :to_wire_at_depth
+
+    # Depth-aware inner implementation of from_wire.
+    def from_wire_at_depth(hash, depth)
+      hash.each_with_object({}) do |(k, v), out|
+        snake_key = camel_to_snake(k.to_s).to_sym
+        out[snake_key] = deep_convert_value_from_wire(v, depth + 1)
+      end
+    end
+    private_class_method :from_wire_at_depth
+
     # Recursively converts a value destined for the wire (to_wire direction).
-    def deep_convert_value_to_wire(value)
+    # depth is the nesting level of this value (1 = directly inside the root hash).
+    def deep_convert_value_to_wire(value, depth = 0)
       if value.is_a?(Hash)
-        to_wire(value)
+        raise ArgumentError, "WireFormat nesting exceeds maximum depth (#{MAX_DEPTH})" if depth >= MAX_DEPTH
+
+        to_wire_at_depth(value, depth)
       elsif value.is_a?(Array)
-        value.map { |elem| deep_convert_value_to_wire(elem) }
+        raise ArgumentError, "WireFormat nesting exceeds maximum depth (#{MAX_DEPTH})" if depth >= MAX_DEPTH
+
+        value.map { |elem| deep_convert_value_to_wire(elem, depth + 1) }
       else
         value
       end
@@ -195,11 +216,16 @@ module BSV
     private_class_method :deep_convert_value_to_wire
 
     # Recursively converts a value coming from the wire (from_wire direction).
-    def deep_convert_value_from_wire(value)
+    # depth is the nesting level of this value (1 = directly inside the root hash).
+    def deep_convert_value_from_wire(value, depth = 0)
       if value.is_a?(Hash)
-        from_wire(value)
+        raise ArgumentError, "WireFormat nesting exceeds maximum depth (#{MAX_DEPTH})" if depth >= MAX_DEPTH
+
+        from_wire_at_depth(value, depth)
       elsif value.is_a?(Array)
-        value.map { |elem| deep_convert_value_from_wire(elem) }
+        raise ArgumentError, "WireFormat nesting exceeds maximum depth (#{MAX_DEPTH})" if depth >= MAX_DEPTH
+
+        value.map { |elem| deep_convert_value_from_wire(elem, depth + 1) }
       else
         value
       end

data/lib/bsv-sdk.rb

@@ -3,6 +3,20 @@
 require_relative 'bsv/version'
 
 module BSV
+  class << self
+    # Optional logger for debug-level instrumentation of txid conversions,
+    # BEEF wiring, and merkle path operations.
+    #
+    # No logger is configured by default — zero overhead when unused.
+    # Consumers opt in via:
+    #
+    #   require 'logger'
+    #   BSV.logger = Logger.new($stdout).tap { |l| l.level = Logger::DEBUG }
+    #
+    # @return [Logger, nil]
+    attr_accessor :logger
+  end
+
   autoload :Primitives,  'bsv/primitives'
   autoload :Script,      'bsv/script'
   autoload :Transaction, 'bsv/transaction'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bsv-sdk
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.18.0
 platform: ruby
 authors:
 - Simon Bettison
@@ -29,14 +29,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.12'
+        version: '0.15'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.12'
+        version: '0.15'
 - !ruby/object:Gem::Dependency
   name: secp256k1-native
   requirement: !ruby/object:Gem::Requirement
@@ -104,6 +104,7 @@ files:
 - lib/bsv/network/protocols.rb
 - lib/bsv/network/protocols/arc.rb
 - lib/bsv/network/protocols/chaintracks.rb
+- lib/bsv/network/protocols/jungle_bus.rb
 - lib/bsv/network/protocols/ordinals.rb
 - lib/bsv/network/protocols/taal_binary.rb
 - lib/bsv/network/protocols/woc_rest.rb