Module: BSV::Network::Util

Defined in:
lib/bsv/network/util.rb

Overview

Shared utility methods for protocol implementations.

Class Method Summary collapse

Class Method Details

.resolve_tx_hex(tx) ⇒ String

Coerce a transaction input to hex.

Accepts (in order of preference):

  1. Hex string — pass-through, zero conversion

  2. Binary string — convert to hex

  3. Transaction object — prefer EF hex (BRC-30), fall back to raw hex

Detection uses content, not encoding: a string is hex if it has even length and contains only hex characters. This handles hex strings tagged as ASCII-8BIT (e.g. read from IO in binary mode).

Parameters:

  • tx (String, #to_ef_hex, #to_hex) —

    transaction in any supported form

Returns:

  • (String) —

    hex-encoded transaction



30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/bsv/network/util.rb', line 30

def self.resolve_tx_hex(tx)
  if tx.is_a?(String)
    return tx if tx.match?(/\A[0-9a-fA-F]*\z/) && tx.length.even?

    return tx.unpack1('H*')
  end

  tx.to_ef_hex
rescue ArgumentError => e
  BSV.logger&.debug { "[Network::Util] EF serialisation failed: #{e.message} — falling back to raw hex" }
  tx.to_hex
end

.safe_parse_json(raw) ⇒ Object

Parse JSON, returning a hash with a ‘detail’ key on parse failure. When the raw input is nil or empty the detail is nil (not an empty string).



11
12
13
14
15
 
# File 'lib/bsv/network/util.rb', line 11

def self.safe_parse_json(raw)
  JSON.parse(raw.to_s)
rescue JSON::ParserError
  { 'detail' => (raw.to_s.empty? ? nil : raw.to_s) }
end