sibit 0.25.0 → 0.26.0

data/features/cli.feature

@@ -1,3 +1,5 @@
+# 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
 

data/features/gem_package.feature

@@ -1,3 +1,5 @@
+# SPDX-FileCopyrightText: Copyright (c) 2019-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 Feature: Gem Package
   As a source code writer I want to be able to
   package the Gem into .gem file
@@ -17,7 +19,8 @@ Feature: Gem Package
     """
     cd sibit
     gem build sibit.gemspec
-    gem specification --ruby sibit-*.gem > ../spec.rb
+    gemfile=$(ls -t sibit-*.gem | head -1)
+    gem specification --ruby "$gemfile" > ../spec.rb
     cd ..
     ruby execs.rb
     """

data/features/step_definitions/steps.rb

@@ -1,24 +1,7 @@
 # frozen_string_literal: true
 
-# Copyright (c) 2019-2023 Yegor Bugayenko
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the 'Software'), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
+# SPDX-FileCopyrightText: Copyright (c) 2019-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 require 'nokogiri'
 require 'tmpdir'

data/features/support/env.rb

@@ -1,24 +1,7 @@
 # frozen_string_literal: true
 
-# Copyright (c) 2019-2023 Yegor Bugayenko
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the 'Software'), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
+# SPDX-FileCopyrightText: Copyright (c) 2019-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 require 'simplecov'
 require 'aruba/cucumber'

data/lib/sibit/bestof.rb

@@ -1,39 +1,22 @@
 # frozen_string_literal: true
 
-# Copyright (c) 2019-2023 Yegor Bugayenko
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the 'Software'), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
+# SPDX-FileCopyrightText: Copyright (c) 2019-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 require 'backtrace'
+require 'loog'
 require_relative 'error'
-require_relative 'log'
 
 # API best of.
 #
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2019-2023 Yegor Bugayenko
+# Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
 # License:: MIT
 class Sibit
   # Best of API.
   class BestOf
     # Constructor.
-    def initialize(list, log: Sibit::Log.new, verbose: false)
+    def initialize(list, log: Loog::NULL, verbose: false)
       @list = list
       @log = log
       @verbose = verbose

data/lib/sibit/bitcoin/base58.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2019-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require 'digest'
+
+class Sibit
+  # 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 Bitcoin
+    MIN_TX_FEE = 10_000
+
+    # Base58 encoding for Bitcoin addresses.
+    #
+    # Author:: Yegor Bugayenko (yegor256@gmail.com)
+    # Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
+    # License:: MIT
+    module Base58
+      ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz'
+
+      def self.encode(hex)
+        bytes = [hex].pack('H*')
+        leading = bytes.match(/^\x00*/)[0].length
+        num = hex.to_i(16)
+        result = ''
+        while num.positive?
+          num, remainder = num.divmod(58)
+          result = ALPHABET[remainder] + result
+        end
+        ('1' * leading) + result
+      end
+
+      def self.decode(str)
+        leading = str.match(/^1*/)[0].length
+        num = 0
+        str.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]
+      end
+    end
+  end
+end

data/lib/sibit/bitcoin/key.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2019-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require 'openssl'
+require 'digest'
+require_relative 'base58'
+
+class Sibit
+  module Bitcoin
+    # Bitcoin ECDSA key using secp256k1 curve.
+    #
+    # Supports OpenSSL 3.0+ by constructing keys via DER encoding instead
+    # of using deprecated mutable key APIs.
+    #
+    # Author:: Yegor Bugayenko (yegor256@gmail.com)
+    # Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
+    # License:: MIT
+    class Key
+      MIN_PRIV = 0x01
+      MAX_PRIV = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364140
+
+      def self.generate
+        key = OpenSSL::PKey::EC.generate('secp256k1')
+        pvt = key.private_key.to_s(16).rjust(64, '0').downcase
+        new(pvt)
+      end
+
+      def initialize(privkey)
+        @privkey = privkey
+        @compressed = true
+        @key = build(privkey)
+      end
+
+      def priv
+        @privkey
+      end
+
+      def pub
+        point = @key.public_key
+        point.to_octet_string(@compressed ? :compressed : :uncompressed).unpack1('H*')
+      end
+
+      def addr
+        hash = hash160(pub)
+        versioned = "00#{hash}"
+        checksum = Base58.check(versioned)
+        Base58.encode(versioned + checksum)
+      end
+
+      def sign(data)
+        @key.sign('SHA256', data)
+      end
+
+      def verify(data, sig)
+        @key.verify('SHA256', sig, data)
+      rescue OpenSSL::PKey::PKeyError
+        false
+      end
+
+      private
+
+      def build(privkey)
+        value = privkey.to_i(16)
+        raise 'private key is not on curve' unless value.between?(MIN_PRIV, MAX_PRIV)
+        group = OpenSSL::PKey::EC::Group.new('secp256k1')
+        bn = OpenSSL::BN.new(privkey, 16)
+        pubkey = group.generator.mul(bn)
+        asn1 = OpenSSL::ASN1::Sequence(
+          [
+            OpenSSL::ASN1::Integer.new(1),
+            OpenSSL::ASN1::OctetString(bn.to_s(2)),
+            OpenSSL::ASN1::ObjectId('secp256k1', 0, :EXPLICIT),
+            OpenSSL::ASN1::BitString(pubkey.to_octet_string(:uncompressed), 1, :EXPLICIT)
+          ]
+        )
+        OpenSSL::PKey::EC.new(asn1.to_der)
+      end
+
+      def hash160(hex)
+        bytes = [hex].pack('H*')
+        Digest::RMD160.hexdigest(Digest::SHA256.digest(bytes))
+      end
+    end
+  end
+end

data/lib/sibit/bitcoin/script.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2019-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require 'digest'
+require_relative 'base58'
+
+class Sibit
+  module Bitcoin
+    # Bitcoin Script parser.
+    #
+    # Parses standard P2PKH scripts to extract addresses.
+    #
+    # Author:: Yegor Bugayenko (yegor256@gmail.com)
+    # Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
+    # License:: MIT
+    class Script
+      OP_DUP = 0x76
+      OP_HASH160 = 0xa9
+      OP_EQUALVERIFY = 0x88
+      OP_CHECKSIG = 0xac
+
+      def initialize(hex)
+        @bytes = [hex].pack('H*').bytes
+      end
+
+      def address
+        return p2pkh_address if p2pkh?
+        nil
+      end
+
+      def p2pkh?
+        @bytes.length == 25 &&
+          @bytes[0] == OP_DUP &&
+          @bytes[1] == OP_HASH160 &&
+          @bytes[2] == 20 &&
+          @bytes[23] == OP_EQUALVERIFY &&
+          @bytes[24] == OP_CHECKSIG
+      end
+
+      def hash160
+        return nil unless p2pkh?
+        @bytes[3, 20].pack('C*').unpack1('H*')
+      end
+
+      private
+
+      def p2pkh_address
+        h = hash160
+        return nil unless h
+        versioned = "00#{h}"
+        checksum = Base58.check(versioned)
+        Base58.encode(versioned + checksum)
+      end
+    end
+  end
+end

data/lib/sibit/bitcoin/tx.rb

@@ -0,0 +1,212 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2019-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require 'digest'
+require_relative 'base58'
+require_relative 'key'
+require_relative 'script'
+
+class Sibit
+  module Bitcoin
+    # Bitcoin Transaction structure.
+    #
+    # Author:: Yegor Bugayenko (yegor256@gmail.com)
+    # Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
+    # License:: MIT
+    class Tx
+      SIGHASH_ALL = 0x01
+      VERSION = 1
+      SEQUENCE = 0xffffffff
+
+      attr_reader :inputs, :outputs
+
+      def initialize
+        @inputs = []
+        @outputs = []
+      end
+
+      def add_input(hash:, index:, script:, key:)
+        @inputs << Input.new(hash, index, script, key)
+      end
+
+      def add_output(value, address)
+        @outputs << Output.new(value, address)
+      end
+
+      def hash
+        Digest::SHA256.hexdigest(Digest::SHA256.digest(payload)).reverse.scan(/../).join
+      end
+
+      def payload
+        sign_inputs
+        serialize
+      end
+
+      def hex
+        payload.unpack1('H*')
+      end
+
+      def in
+        @inputs
+      end
+
+      def out
+        @outputs
+      end
+
+      private
+
+      def sign_inputs
+        @inputs.each_with_index do |input, idx|
+          sighash = signature_hash(idx)
+          sig = sign(input.key, sighash)
+          pubkey = [input.key.pub].pack('H*')
+          input.script_sig = der_sig(sig) + pubkey_script(pubkey)
+        end
+      end
+
+      def signature_hash(idx)
+        tx_copy = serialize_for_signing(idx)
+        hash_type = [SIGHASH_ALL].pack('V')
+        Digest::SHA256.digest(Digest::SHA256.digest(tx_copy + hash_type))
+      end
+
+      def sign(key, hash)
+        der = key.sign(hash)
+        repack(der)
+      end
+
+      def repack(der)
+        return der if low_s?(der)
+        seq = OpenSSL::ASN1.decode(der)
+        r = seq.value[0].value.to_i
+        s = seq.value[1].value.to_i
+        order = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141
+        s = order - s if s > order / 2
+        OpenSSL::ASN1::Sequence.new(
+          [OpenSSL::ASN1::Integer.new(r), OpenSSL::ASN1::Integer.new(s)]
+        ).to_der
+      end
+
+      def low_s?(der)
+        seq = OpenSSL::ASN1.decode(der)
+        s = seq.value[1].value.to_i
+        order = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141
+        s <= order / 2
+      end
+
+      def der_sig(sig)
+        data = sig + [SIGHASH_ALL].pack('C')
+        [data.length].pack('C') + data
+      end
+
+      def pubkey_script(pubkey)
+        [pubkey.length].pack('C') + pubkey
+      end
+
+      def serialize
+        result = [VERSION].pack('V')
+        result += varint(@inputs.length)
+        @inputs.each do |input|
+          result += [input.hash].pack('H*').reverse
+          result += [input.index].pack('V')
+          result += varint(input.script_sig.length)
+          result += input.script_sig
+          result += [SEQUENCE].pack('V')
+        end
+        result += varint(@outputs.length)
+        @outputs.each do |output|
+          result += [output.value].pack('Q<')
+          script = output.script
+          result += varint(script.length)
+          result += script
+        end
+        result += [0].pack('V')
+        result
+      end
+
+      def serialize_for_signing(idx)
+        result = [VERSION].pack('V')
+        result += varint(@inputs.length)
+        @inputs.each_with_index do |input, i|
+          result += [input.hash].pack('H*').reverse
+          result += [input.index].pack('V')
+          if i == idx
+            script = [input.prev_script].pack('H*')
+            result += varint(script.length)
+            result += script
+          else
+            result += varint(0)
+          end
+          result += [SEQUENCE].pack('V')
+        end
+        result += varint(@outputs.length)
+        @outputs.each do |output|
+          result += [output.value].pack('Q<')
+          script = output.script
+          result += varint(script.length)
+          result += script
+        end
+        result += [0].pack('V')
+        result
+      end
+
+      def varint(num)
+        return [num].pack('C') if num < 0xfd
+        return [0xfd, num].pack('Cv') if num <= 0xffff
+        return [0xfe, num].pack('CV') if num <= 0xffffffff
+        [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
+end

data/lib/sibit/bitcoin/txbuilder.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2019-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+require_relative 'tx'
+require_relative 'key'
+
+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
+
+      def input
+        inp = InputBuilder.new
+        yield inp
+        @inputs << inp
+      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
+    end
+
+    # Input builder for collecting input parameters.
+    class InputBuilder
+      attr_reader :prev_out_hash, :prev_out_idx, :script, :key
+
+      def prev_out(hash)
+        @prev_out_hash = hash
+      end
+
+      def prev_out_index(idx)
+        @prev_out_idx = idx
+      end
+
+      def prev_out_script=(scr)
+        @script = scr
+      end
+
+      def signature_key(key)
+        @key = key
+      end
+    end
+
+    # Wrapper for built transaction with convenience methods.
+    class BuiltTx
+      def initialize(txn, inputs, outputs)
+        @tx = txn
+        @inputs_data = inputs
+        @outputs_data = outputs
+      end
+
+      def hash
+        @tx.hash
+      end
+
+      def in
+        @tx.in
+      end
+
+      def out
+        @tx.out
+      end
+
+      def inputs
+        @tx.inputs
+      end
+
+      def outputs
+        @tx.outputs
+      end
+
+      def to_payload
+        PayloadWrapper.new(@tx.payload)
+      end
+    end
+
+    # Wrapper for payload with hex conversion.
+    class PayloadWrapper
+      def initialize(bytes)
+        @bytes = bytes
+      end
+
+      def bth
+        @bytes.unpack1('H*')
+      end
+    end
+  end
+end

data/lib/sibit/bitcoinchain.rb

@@ -1,44 +1,27 @@
 # frozen_string_literal: true
 
-# Copyright (c) 2019-2023 Yegor Bugayenko
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the 'Software'), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
+# SPDX-FileCopyrightText: Copyright (c) 2019-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 require 'iri'
 require 'json'
 require 'uri'
 require_relative 'error'
 require_relative 'http'
+require 'loog'
 require_relative 'json'
-require_relative 'log'
 require_relative 'version'
 
 # Bitcoinchain.com API.
 #
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2019-2023 Yegor Bugayenko
+# Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
 # License:: MIT
 class Sibit
   # Btc.com API.
   class Bitcoinchain
     # Constructor.
-    def initialize(log: Sibit::Log.new, http: Sibit::Http.new, dry: false)
+    def initialize(log: Loog::NULL, http: Sibit::Http.new, dry: false)
       @http = http
       @log = log
       @dry = dry