sibit 0.29.0 → 0.29.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ddde20b613a744a0618b9b91d4adfea42d945a13d778ecad2492b1a15afe3c0e
-  data.tar.gz: 7d83be599123ff738035fbf610d1ae6f763c5c36cec2a83a626658707cf37cda
+  metadata.gz: 16d749128c92e0a715c1545d8cb6aa6a41a4afcbd7fc39db0e708fa87ea7383d
+  data.tar.gz: c522bc105501aedd9f3ef6140ac99bb1b18cec23fc060ff8dd6ceed4d4e69dff
 SHA512:
-  metadata.gz: 9811599df9ebb242927bcf50a8ed2b1e24adad74832b72748b1f1c113c9f30e89c0b9079f3a0898308963c55c59d0f899534d529d673f0120a718176402a4e10
-  data.tar.gz: 2f3821bb817a4fadbe8137ccce649d66ba388ae17f0a3b99f6293947e0d3ef084d2d0f1501fabcbec8d933b7127d655a1fae74bdb907019ae39e088d4bd6bf52
+  metadata.gz: 854ede7b60a6cd9e1334341b14f1b712e002b23499a5a192d61b53380b68d3203f4d7c3d0aaa87499d59a885190345e776410e1eb133f26f85b8aaac260772ed
+  data.tar.gz: f99cee0f4d8615d0a39ee7609c697b4238e0e867193934564d5f2d29cfffe454b630b8da0f4e7f1bda9620d57d395bdf4b365614cf318c6079b808dab330cc2f

data/Gemfile

@@ -14,6 +14,8 @@ gem 'logger', '~>1.7', require: false
 gem 'minitest', '~>6.0', require: false
 gem 'minitest-reporters', '~>1.7', require: false
 gem 'nokogiri', '~>1.18', require: false
+gem 'os', '~>1.1', require: false
+gem 'qbash', '~>0.0', require: false
 gem 'rake', '~>13.2', require: false
 gem 'rdoc', '~>7.0', require: false
 gem 'rubocop', '~>1.62', require: false

data/Gemfile.lock

@@ -59,6 +59,9 @@ GEM
     date (3.5.1)
     diff-lcs (1.6.2)
     docile (1.4.1)
+    elapsed (0.2.1)
+      loog (~> 0.6)
+      tago (~> 0.1)
     erb (6.0.1)
     ffi (1.17.2-arm64-darwin)
     ffi (1.17.2-x86_64-linux-gnu)
@@ -85,6 +88,7 @@ GEM
       mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
     openssl (4.0.0)
+    os (1.1.4)
     parallel (1.27.0)
     parser (3.3.10.0)
       ast (~> 2.4.1)
@@ -94,6 +98,11 @@ GEM
       date
       stringio
     public_suffix (7.0.0)
+    qbash (0.4.8)
+      backtrace (> 0)
+      elapsed (> 0)
+      loog (> 0)
+      tago (> 0)
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.3.1)
@@ -150,6 +159,7 @@ GEM
     sys-uname (1.4.1)
       ffi (~> 1.1)
       memoist3 (~> 1.0.0)
+    tago (0.6.0)
     thor (1.4.0)
     tsort (0.2.0)
     unicode-display_width (3.2.0)
@@ -173,6 +183,8 @@ DEPENDENCIES
   minitest (~> 6.0)
   minitest-reporters (~> 1.7)
   nokogiri (~> 1.18)
+  os (~> 1.1)
+  qbash (~> 0.0)
   rake (~> 13.2)
   rdoc (~> 7.0)
   rubocop (~> 1.62)

data/Rakefile

@@ -3,10 +3,13 @@
 # SPDX-FileCopyrightText: Copyright (c) 2019-2025 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 
-require 'rubygems'
+require 'os'
+require 'qbash'
 require 'rake'
-require 'rdoc'
 require 'rake/clean'
+require 'rdoc'
+require 'rubygems'
+require 'shellwords'
 
 def name
   @name ||= File.basename(Dir['*.gemspec'].first, '.*')
@@ -16,7 +19,7 @@ def version
   Gem::Specification.load(Dir['*.gemspec'].first).version
 end
 
-task default: %i[clean test features rubocop]
+task default: %i[clean test picks features rubocop]
 
 require 'rake/testtask'
 Rake::TestTask.new(:test) do |test|
@@ -27,6 +30,16 @@ Rake::TestTask.new(:test) do |test|
   test.verbose = false
 end
 
+desc 'Run them via Ruby, one by one'
+task :picks do
+  next if OS.windows?
+  %w[test lib].each do |d|
+    Dir["#{d}/**/*.rb"].each do |f|
+      qbash("bundle exec ruby #{Shellwords.escape(f)}", log: $stdout, env: { 'PICKS' => 'yes' })
+    end
+  end
+end
+
 require 'rdoc/task'
 Rake::RDocTask.new do |rdoc|
   rdoc.rdoc_dir = 'rdoc'

data/bin/sibit

@@ -11,6 +11,7 @@ require 'loog'
 require 'retriable_proxy'
 require 'slop'
 require_relative '../lib/sibit'
+require_relative '../lib/sibit/http'
 require_relative '../lib/sibit/bitcoinchain'
 require_relative '../lib/sibit/blockchain'
 require_relative '../lib/sibit/blockchair'

data/features/cli.feature

@@ -1,7 +1,7 @@
 # SPDX-FileCopyrightText: Copyright (c) 2019-2025 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 Feature: Command Line Processing
-  As a newsletter author I want to be able to send a newsletter
+  As a holder of BTC I want to be able to use sibit
 
   Scenario: Help can be printed
     When I run bin/sibit with "--help"

data/features/dry.feature

@@ -0,0 +1,25 @@
+# SPDX-FileCopyrightText: Copyright (c) 2019-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+Feature: Command Line Processing
+  As a holder of BTC I want to use sibit in dry mode
+
+  Scenario: Bitcoin price can be retrieved
+    When I run bin/sibit with "price --dry --attempts=4"
+    Then Exit code is zero
+
+  Scenario: Bitcoin latest block hash can be retrieved
+    When I run bin/sibit with "latest --dry --api=blockchain"
+    Then Exit code is zero
+
+  Scenario: Bitcoin balance can be checked
+    When I run bin/sibit with "balance --dry 1MZT1fa6y8H9UmbZV6HqKF4UY41o9MGT5f --verbose --api=blockchain,btc"
+    Then Exit code is zero
+
+  Scenario: Bitcoin fees can be printed
+    When I run bin/sibit with "fees --dry --verbose --api=fake"
+    Then Exit code is zero
+
+  Scenario: Bitcoin payment can be sent
+    When I run bin/sibit with "pay --dry --verbose --api=fake --proxy=localhost:3128 999999 XL- 46feba063e9b59a8ae0dba68abd39a3cb8f52089e776576d6eb1bb5bfec123d1 1MZT1fa6y8H9UmbZV6HqKF4UY41o9MGT5f 1Fsyq5YGe8zbSjLS8YsDnZWM8U6AYMR6ZD"
+    Then Exit code is not zero
+    Then Stdout contains "UTXO arrived to 1JvCsJtLmCxEk7ddZFnVkGXpr9uhxZPmJi is incorrect"

data/lib/sibit/bitcoin/base58.rb

@@ -5,25 +5,26 @@
 
 require 'digest'
 
-# Bitcoin primitives module.
-#
-# Pure Ruby implementation of Bitcoin functionality using OpenSSL 3.0+.
-# Replaces the bitcoin-ruby dependency which is incompatible with OpenSSL 3.0.
-module Sibit::Bitcoin
-  MIN_TX_FEE = 10_000
-
+# Sibit main class.
+class Sibit
   # Base58 encoding for Bitcoin addresses.
   #
+  # Encapsulates hex data and provides encoding/decoding functionality.
+  #
   # Author:: Yegor Bugayenko (yegor256@gmail.com)
   # Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
   # License:: MIT
-  module Base58
+  class Base58
     ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz'
 
-    def self.encode(hex)
-      bytes = [hex].pack('H*')
+    def initialize(data)
+      @data = data
+    end
+
+    def encode
+      bytes = [@data].pack('H*')
       leading = bytes.match(/^\x00*/)[0].length
-      num = hex.to_i(16)
+      num = @data.to_i(16)
       result = ''
       while num.positive?
         num, remainder = num.divmod(58)
@@ -32,17 +33,17 @@ module Sibit::Bitcoin
       ('1' * leading) + result
     end
 
-    def self.decode(str)
-      leading = str.match(/^1*/)[0].length
+    def decode
+      leading = @data.match(/^1*/)[0].length
       num = 0
-      str.each_char { |c| num = (num * 58) + ALPHABET.index(c) }
+      @data.each_char { |c| num = (num * 58) + ALPHABET.index(c) }
       hex = num.zero? ? '' : num.to_s(16)
       hex = "0#{hex}" if hex.length.odd?
       ('00' * leading) + hex
     end
 
-    def self.check(hex)
-      Digest::SHA256.hexdigest(Digest::SHA256.digest([hex].pack('H*')))[0...8]
+    def check
+      Digest::SHA256.hexdigest(Digest::SHA256.digest([@data].pack('H*')))[0...8]
     end
   end
 end

data/lib/sibit/bitcoin/key.rb

@@ -7,7 +7,8 @@ require 'digest'
 require 'openssl'
 require_relative 'base58'
 
-module Sibit::Bitcoin
+# Sibit main class.
+class Sibit
   # Bitcoin ECDSA key using secp256k1 curve.
   #
   # Supports OpenSSL 3.0+ by constructing keys via DER encoding instead
@@ -44,8 +45,8 @@ module Sibit::Bitcoin
     def addr
       hash = hash160(pub)
       versioned = "00#{hash}"
-      checksum = Base58.check(versioned)
-      Base58.encode(versioned + checksum)
+      checksum = Base58.new(versioned).check
+      Base58.new(versioned + checksum).encode
     end
 
     def sign(data)

data/lib/sibit/bitcoin/script.rb

@@ -6,7 +6,8 @@
 require 'digest'
 require_relative 'base58'
 
-module Sibit::Bitcoin
+# Sibit main class.
+class Sibit
   # Bitcoin Script parser.
   #
   # Parses standard P2PKH scripts to extract addresses.
@@ -49,8 +50,8 @@ module Sibit::Bitcoin
       h = hash160
       return nil unless h
       versioned = "00#{h}"
-      checksum = Base58.check(versioned)
-      Base58.encode(versioned + checksum)
+      checksum = Base58.new(versioned).check
+      Base58.new(versioned + checksum).encode
     end
   end
 end

data/lib/sibit/bitcoin/tx.rb

@@ -8,7 +8,10 @@ require_relative 'base58'
 require_relative 'key'
 require_relative 'script'
 
-module Sibit::Bitcoin
+# Sibit main class.
+class Sibit
+  MIN_TX_FEE = 10_000
+
   # Bitcoin Transaction structure.
   #
   # Author:: Yegor Bugayenko (yegor256@gmail.com)
@@ -55,6 +58,62 @@ module Sibit::Bitcoin
       @outputs
     end
 
+    # Transaction input.
+    #
+    # Author:: Yegor Bugayenko (yegor256@gmail.com)
+    # Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
+    # License:: MIT
+    class Input
+      attr_reader :hash, :index, :prev_script, :key
+      attr_accessor :script_sig
+
+      def initialize(hash, index, script, key)
+        @hash = hash
+        @index = index
+        @prev_script = script
+        @key = key
+        @script_sig = ''
+      end
+
+      def prev_out
+        [@hash].pack('H*')
+      end
+
+      def prev_out_index
+        @index
+      end
+    end
+
+    # Transaction output.
+    #
+    # Author:: Yegor Bugayenko (yegor256@gmail.com)
+    # Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
+    # License:: MIT
+    class Output
+      attr_reader :value
+
+      def initialize(value, address)
+        @value = value
+        @address = address
+      end
+
+      def script
+        hash160 = address_to_hash160(@address)
+        [0x76, 0xa9, 0x14].pack('C*') + [hash160].pack('H*') + [0x88, 0xac].pack('C*')
+      end
+
+      def script_hex
+        script.unpack1('H*')
+      end
+
+      private
+
+      def address_to_hash160(addr)
+        decoded = Base58.new(addr).decode
+        decoded[2..41]
+      end
+    end
+
     private
 
     def sign_inputs
@@ -159,52 +218,4 @@ module Sibit::Bitcoin
       [0xff, num].pack('CQ<')
     end
   end
-
-  # Transaction input.
-  class Input
-    attr_reader :hash, :index, :prev_script, :key
-    attr_accessor :script_sig
-
-    def initialize(hash, index, script, key)
-      @hash = hash
-      @index = index
-      @prev_script = script
-      @key = key
-      @script_sig = ''
-    end
-
-    def prev_out
-      [@hash].pack('H*')
-    end
-
-    def prev_out_index
-      @index
-    end
-  end
-
-  # Transaction output.
-  class Output
-    attr_reader :value
-
-    def initialize(value, address)
-      @value = value
-      @address = address
-    end
-
-    def script
-      hash160 = address_to_hash160(@address)
-      [0x76, 0xa9, 0x14].pack('C*') + [hash160].pack('H*') + [0x88, 0xac].pack('C*')
-    end
-
-    def script_hex
-      script.unpack1('H*')
-    end
-
-    private
-
-    def address_to_hash160(addr)
-      decoded = Base58.decode(addr)
-      decoded[2..41]
-    end
-  end
 end

data/lib/sibit/bitcoin/txbuilder.rb

@@ -6,54 +6,57 @@
 require_relative 'key'
 require_relative 'tx'
 
+# Sibit main class.
 class Sibit
-  module Bitcoin
-    # Bitcoin Transaction Builder.
-    #
-    # Provides a similar interface to Bitcoin::Builder::TxBuilder for
-    # building and signing Bitcoin transactions.
-    #
-    # Author:: Yegor Bugayenko (yegor256@gmail.com)
-    # Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
-    # License:: MIT
-    class TxBuilder
-      def initialize
-        @inputs = []
-        @outputs = []
-      end
+  # Bitcoin Transaction Builder.
+  #
+  # Provides a similar interface to Bitcoin::Builder::TxBuilder for
+  # building and signing Bitcoin transactions.
+  #
+  # Author:: Yegor Bugayenko (yegor256@gmail.com)
+  # Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
+  # License:: MIT
+  class TxBuilder
+    def initialize
+      @inputs = []
+      @outputs = []
+    end
 
-      def input
-        inp = InputBuilder.new
-        yield inp
-        @inputs << inp
-      end
+    def input
+      inp = Input.new
+      yield inp
+      @inputs << inp
+    end
 
-      def output(value, address)
-        @outputs << { value: value, address: address }
-      end
+    def output(value, address)
+      @outputs << { value: value, address: address }
+    end
 
-      def tx(input_value:, leave_fee:, extra_fee:, change_address:)
-        txn = Tx.new
-        @inputs.each do |inp|
-          txn.add_input(
-            hash: inp.prev_out_hash,
-            index: inp.prev_out_idx,
-            script: inp.script,
-            key: inp.key
-          )
-        end
-        total_out = @outputs.sum { |o| o[:value] }
-        @outputs.each { |o| txn.add_output(o[:value], o[:address]) }
-        if leave_fee
-          change = input_value - total_out - extra_fee
-          txn.add_output(change, change_address) if change.positive?
-        end
-        BuiltTx.new(txn, @inputs, @outputs)
-      end
+    def tx(input_value:, leave_fee:, extra_fee:, change_address:)
+      txn = Tx.new
+      @inputs.each do |inp|
+        txn.add_input(
+          hash: inp.prev_out_hash,
+          index: inp.prev_out_idx,
+          script: inp.script,
+          key: inp.key
+        )
+      end
+      total_out = @outputs.sum { |o| o[:value] }
+      @outputs.each { |o| txn.add_output(o[:value], o[:address]) }
+      if leave_fee
+        change = input_value - total_out - extra_fee
+        txn.add_output(change, change_address) if change.positive?
+      end
+      Built.new(txn, @inputs, @outputs)
     end
 
     # Input builder for collecting input parameters.
-    class InputBuilder
+    #
+    # Author:: Yegor Bugayenko (yegor256@gmail.com)
+    # Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
+    # License:: MIT
+    class Input
       attr_reader :prev_out_hash, :prev_out_idx, :script, :key
 
       def prev_out(hash)
@@ -74,11 +77,15 @@ class Sibit
     end
 
     # Wrapper for built transaction with convenience methods.
-    class BuiltTx
+    #
+    # Author:: Yegor Bugayenko (yegor256@gmail.com)
+    # Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
+    # License:: MIT
+    class Built
       def initialize(txn, inputs, outputs)
         @tx = txn
-        @inputs_data = inputs
-        @outputs_data = outputs
+        @inputs = inputs
+        @outputs = outputs
       end
 
       def hash
@@ -102,18 +109,22 @@ class Sibit
       end
 
       def to_payload
-        PayloadWrapper.new(@tx.payload)
+        Payload.new(@tx.payload)
       end
-    end
 
-    # Wrapper for payload with hex conversion.
-    class PayloadWrapper
-      def initialize(bytes)
-        @bytes = bytes
-      end
+      # Wrapper for payload with hex conversion.
+      #
+      # Author:: Yegor Bugayenko (yegor256@gmail.com)
+      # Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
+      # License:: MIT
+      class Payload
+        def initialize(bytes)
+          @bytes = bytes
+        end
 
-      def bth
-        @bytes.unpack1('H*')
+        def bth
+          @bytes.unpack1('H*')
+        end
       end
     end
   end

data/lib/sibit/fake.rb

@@ -32,7 +32,15 @@ class Sibit::Fake
   end
 
   def utxos(_sources)
-    []
+    [
+      {
+        hash: '5de641d3867eb8fec3eb1a5ef2b44df39b54e0b3bb664ab520f2ae26a5b18ffc',
+        index: 0,
+        value: 100_000_000,
+        confirmations: 6,
+        script: '76a914c48a1737b35a9f9d9e3b624a910f1e22f7e80bbc88ac'
+      }
+    ]
   end
 
   def push(_hex); end

data/lib/sibit/http.rb

@@ -5,30 +5,37 @@
 
 require 'net/http'
 
-# HTTP interface.
-#
-# Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
-# License:: MIT
-class Sibit::Http
-  def client(uri)
-    http = Net::HTTP.new(uri.host, uri.port)
-    http.use_ssl = true
-    http.read_timeout = 240
-    http
+# Sibit main class.
+class Sibit
+  # HTTP interface.
+  #
+  # Author:: Yegor Bugayenko (yegor256@gmail.com)
+  # Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
+  # License:: MIT
+  class Http
+    def client(uri)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+      http.read_timeout = 240
+      http
+    end
   end
-end
 
-# This HTTP client with proxy.
-class HttpProxy
-  def initialize(addr)
-    @host, @port = addr.split(':')
-  end
+  # This HTTP client with proxy.
+  #
+  # Author:: Yegor Bugayenko (yegor256@gmail.com)
+  # Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
+  # License:: MIT
+  class HttpProxy
+    def initialize(addr)
+      @host, @port = addr.split(':')
+    end
 
-  def client(uri)
-    http = Net::HTTP.new(uri.host, uri.port, @host, @port.to_i)
-    http.use_ssl = true
-    http.read_timeout = 240
-    http
+    def client(uri)
+      http = Net::HTTP.new(uri.host, uri.port, @host, @port.to_i)
+      http.use_ssl = true
+      http.read_timeout = 240
+      http
+    end
   end
 end

data/lib/sibit/version.rb

@@ -9,5 +9,5 @@
 # License:: MIT
 class Sibit
   # Current version of the library.
-  VERSION = '0.29.0'
+  VERSION = '0.29.1'
 end

data/lib/sibit.rb

@@ -48,14 +48,14 @@ class Sibit
 
   # Generates new Bitcoin private key and returns in Hash160 format.
   def generate
-    key = Bitcoin::Key.generate.priv
+    key = Key.generate.priv
     @log.info("Bitcoin private key generated: #{key[0..8]}...")
     key
   end
 
   # Creates Bitcoin address using the private key in Hash160 format.
   def create(pvt)
-    Bitcoin::Key.new(pvt).addr
+    Key.new(pvt).addr
   end
 
   # Gets the balance of the address, in satoshi.
@@ -100,9 +100,9 @@ class Sibit
   # +change+: the address where the change has to be sent to
   def pay(amount, fee, sources, target, change, skip_utxo: [])
     p = price('USD')
-    sources = sources.map { |k| [Bitcoin::Key.new(k).addr, k] }.to_h
+    sources = sources.map { |k| [Key.new(k).addr, k] }.to_h
     satoshi = satoshi(amount)
-    builder = Bitcoin::TxBuilder.new
+    builder = TxBuilder.new
     unspent = 0
     size = 100
     utxos = @api.utxos(sources.keys)
@@ -118,8 +118,10 @@ class Sibit
         i.prev_out(utxo[:hash])
         i.prev_out_index(utxo[:index])
         i.prev_out_script = script_hex(utxo[:script])
-        address = Bitcoin::Script.new(script_hex(utxo[:script])).address
-        i.signature_key(key(sources[address]))
+        address = Script.new(script_hex(utxo[:script])).address
+        k = sources[address]
+        raise Error, "UTXO arrived to #{address} is incorrect" unless k
+        i.signature_key(key(k))
       end
       size += 180
       @log.info(
@@ -138,7 +140,7 @@ class Sibit
     tx = builder.tx(
       input_value: unspent,
       leave_fee: true,
-      extra_fee: [f, Bitcoin::MIN_TX_FEE].max,
+      extra_fee: [f, MIN_TX_FEE].max,
       change_address: change
     )
     left = unspent - tx.outputs.sum(&:value)
@@ -147,7 +149,7 @@ class Sibit
     #{tx.inputs.map { |i| " in: #{i.prev_out.unpack1('H*')}:#{i.prev_out_index}" }.join("\n    ")}
   #{tx.out.count} output#{'s' if tx.out.count > 1}:
     #{tx.outputs.map { |o| "out: #{o.script_hex} / #{num(o.value, p)}" }.join("\n    ")}
-  Min tx fee: #{num(Bitcoin::MIN_TX_FEE, p)}
+  Min tx fee: #{num(MIN_TX_FEE, p)}
   Fee requested: #{num(f, p)} as \"#{fee}\"
   Fee actually paid: #{num(left, p)}
   Tx size: #{size} bytes
@@ -272,7 +274,7 @@ in block #{block} (by #{json[:provider]})")
 
   # Make key from private key string in Hash160.
   def key(hash160)
-    Bitcoin::Key.new(hash160)
+    Key.new(hash160)
   end
 
   # Convert script to hex string if needed.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sibit
 version: !ruby/object:Gem::Version
-  version: 0.29.0
+  version: 0.29.1
 platform: ruby
 authors:
 - Yegor Bugayenko
@@ -128,6 +128,7 @@ files:
 - bin/sibit
 - cucumber.yml
 - features/cli.feature
+- features/dry.feature
 - features/gem_package.feature
 - features/step_definitions/steps.rb
 - features/support/env.rb