bsv-wallet 0.3.4 → 0.5.0

data/lib/bsv/wallet_interface/whats_on_chain_provider.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module BSV
+  module Wallet
+    # ChainProvider implementation backed by the WhatsOnChain public API.
+    #
+    # Delegates to {BSV::Network::WhatsOnChain} for all HTTP communication,
+    # adapting its responses to the {ChainProvider} contract.
+    #
+    # @example Use with WalletClient
+    #   provider = BSV::Wallet::WhatsOnChainProvider.new(network: :main)
+    #   wallet = BSV::Wallet::WalletClient.new(key, chain_provider: provider)
+    #   wallet.sync_utxos
+    class WhatsOnChainProvider
+      include ChainProvider
+
+      # @param network [Symbol] :main (default) or :test
+      # @param http_client [#request, nil] injectable HTTP client for testing
+      def initialize(network: :main, http_client: nil)
+        woc_network = network == :main ? :mainnet : :testnet
+        @woc = BSV::Network::WhatsOnChain.new(network: woc_network, http_client: http_client)
+      end
+
+      # Returns the current blockchain height.
+      # @return [Integer]
+      def get_height
+        raise NotImplementedError, 'WhatsOnChainProvider#get_height not yet implemented'
+      end
+
+      # Returns the block header at the given height.
+      # @param _height [Integer] block height
+      # @return [String] 80-byte hex-encoded block header
+      def get_header(_height)
+        raise NotImplementedError, 'WhatsOnChainProvider#get_header not yet implemented'
+      end
+
+      # Returns unspent transaction outputs for the given address.
+      #
+      # Delegates to {BSV::Network::WhatsOnChain#fetch_utxos} and normalises
+      # the result to plain hashes matching the ChainProvider contract.
+      #
+      # @param address [String] BSV address
+      # @return [Array<Hash>] array of hashes with :tx_hash, :tx_pos, :value keys
+      def get_utxos(address)
+        @woc.fetch_utxos(address).map do |utxo|
+          { tx_hash: utxo.tx_hash, tx_pos: utxo.tx_pos, value: utxo.satoshis }
+        end
+      end
+
+      # Returns the raw transaction hex for the given txid.
+      #
+      # Delegates to {BSV::Network::WhatsOnChain#fetch_transaction} and
+      # serialises the result back to hex.
+      #
+      # @param txid [String] transaction ID (hex)
+      # @return [String] raw transaction hex string
+      def get_transaction(txid)
+        @woc.fetch_transaction(txid).to_hex
+      end
+    end
+  end
+end

data/lib/bsv/wallet_interface.rb

@@ -16,13 +16,19 @@ module BSV
     autoload :FileStore,         'bsv/wallet_interface/file_store'
     autoload :ProofStore,        'bsv/wallet_interface/proof_store'
     autoload :LocalProofStore,   'bsv/wallet_interface/local_proof_store'
-    autoload :ChainProvider,     'bsv/wallet_interface/chain_provider'
-    autoload :NullChainProvider, 'bsv/wallet_interface/null_chain_provider'
+    autoload :ChainProvider,          'bsv/wallet_interface/chain_provider'
+    autoload :NullChainProvider,      'bsv/wallet_interface/null_chain_provider'
+    autoload :WhatsOnChainProvider,   'bsv/wallet_interface/whats_on_chain_provider'
     autoload :WalletClient,      'bsv/wallet_interface/wallet_client'
     autoload :Wire,              'bsv/wallet_interface/wire'
     autoload :CertificateSignature, 'bsv/wallet_interface/certificate_signature'
+    autoload :FeeModel,             'bsv/wallet_interface/fee_model'
+    autoload :FeeEstimator,         'bsv/wallet_interface/fee_estimator'
+    autoload :CoinSelector,         'bsv/wallet_interface/coin_selector'
+    autoload :ChangeGenerator,      'bsv/wallet_interface/change_generator'
 
     # Error classes
+    autoload :InsufficientFundsError, 'bsv/wallet/insufficient_funds_error'
     autoload :WalletError,            'bsv/wallet_interface/errors/wallet_error'
     autoload :InvalidParameterError,  'bsv/wallet_interface/errors/invalid_parameter_error'
     autoload :InvalidHmacError,       'bsv/wallet_interface/errors/invalid_hmac_error'

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: bsv-wallet
 version: !ruby/object:Gem::Version
-  version: 0.3.4
+  version: 0.5.0
 platform: ruby
 authors:
 - Simon Bettison
 bindir: bin
 cert_chain: []
-date: 2026-04-08 00:00:00.000000000 Z
+date: 2026-04-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -29,7 +29,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.2
+        version: 0.9.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '1.0'
@@ -39,7 +39,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.2
+        version: 0.9.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '1.0'
@@ -49,16 +49,21 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG-wallet.md
 - LICENSE
 - lib/bsv-wallet.rb
 - lib/bsv/wallet_interface.rb
 - lib/bsv/wallet_interface/certificate_signature.rb
 - lib/bsv/wallet_interface/chain_provider.rb
+- lib/bsv/wallet_interface/change_generator.rb
+- lib/bsv/wallet_interface/coin_selector.rb
 - lib/bsv/wallet_interface/errors/invalid_hmac_error.rb
 - lib/bsv/wallet_interface/errors/invalid_parameter_error.rb
 - lib/bsv/wallet_interface/errors/invalid_signature_error.rb
 - lib/bsv/wallet_interface/errors/unsupported_action_error.rb
 - lib/bsv/wallet_interface/errors/wallet_error.rb
+- lib/bsv/wallet_interface/fee_estimator.rb
+- lib/bsv/wallet_interface/fee_model.rb
 - lib/bsv/wallet_interface/file_store.rb
 - lib/bsv/wallet_interface/interface.rb
 - lib/bsv/wallet_interface/key_deriver.rb
@@ -71,6 +76,7 @@ files:
 - lib/bsv/wallet_interface/validators.rb
 - lib/bsv/wallet_interface/version.rb
 - lib/bsv/wallet_interface/wallet_client.rb
+- lib/bsv/wallet_interface/whats_on_chain_provider.rb
 - lib/bsv/wallet_interface/wire.rb
 - lib/bsv/wallet_interface/wire/reader.rb
 - lib/bsv/wallet_interface/wire/serializer.rb
@@ -81,7 +87,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/sgbett/bsv-ruby-sdk
   source_code_uri: https://github.com/sgbett/bsv-ruby-sdk
-  changelog_uri: https://github.com/sgbett/bsv-ruby-sdk/blob/master/CHANGELOG.md
+  changelog_uri: https://github.com/sgbett/bsv-ruby-sdk/blob/master/CHANGELOG-wallet.md
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: