sibit 0.18.4 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9190dd104e8af92e3a5d8f1f6a967ef5d001fcf47e51adbaf260a281ecf043a5
-  data.tar.gz: f6b2280a10d118ad474b02022ad428de4c5775632c8f98a7f552c100ddb25460
+  metadata.gz: c16c2d9c8fd8acd2635dc38d1b97599dc2138851ffc162db62aa3dc35feec993
+  data.tar.gz: b17f0c383453182402041ac8793eb2e308480b660e4bd79577a846a6517cf66e
 SHA512:
-  metadata.gz: 863c1ce07d8c74d1029d29a27711244e12350d23f2cdcdc0da21a41793fdd98ce5685a8a725814c691d633e65e6d6858aa1cc716382a4465f93973df773a802c
-  data.tar.gz: 4b7556e9a790db63e63c2cdb0b836b8e3a7f1a9153cb1eba18f722c701b460c379ccda784feb40773f627e78f8129ef78ca7d2e9648431ecaa3608ef6409c89f
+  metadata.gz: 3a7234573110a1fd17ed0e67257474f5c07801e0fd74a0212ca1e08453e9088aeae00b803382814119b9e16fe1b22a9f2fab1974724fdc5c1f5f0d11649e5e29
+  data.tar.gz: '089e4b96cf9c5fb0b3e17bd1692e9ee66f553c2752fd8669a520008a533dacc60063c473264f0469d394a5c272209419026f4920dfa3f3f97bbfc422fe359751'

data/.rubocop.yml

@@ -4,6 +4,8 @@ AllCops:
   DisplayCopNames: true
   TargetRubyVersion: 2.3
 
+Style/ClassAndModuleChildren:
+  Enabled: false
 Metrics/LineLength:
   Max: 100
 Layout/EndOfLine:

data/.rultor.yml

@@ -1,15 +1,11 @@
 assets:
   rubygems.yml: yegor256/home#assets/rubygems.yml
 install: |
-  export GEM_HOME=~/.ruby
-  export GEM_PATH=$GEM_HOME:$GEM_PATH
-  sudo apt-get -y update
-  sudo gem install pdd -v 0.20.5
-  bundle install
+  pdd -f /dev/null
+  sudo bundle install --no-color "--gemfile=$(pwd)/Gemfile"
 release:
   script: |-
     bundle exec rake
-    rm -rf *.gem
     sed -i "s/1\.0\.snapshot/${tag}/g" lib/sibit/version.rb
     git add lib/sibit/version.rb
     git commit -m "version set to ${tag}"
@@ -19,7 +15,6 @@ release:
 merge:
   script: |-
     bundle exec rake
-    pdd -f /dev/null
 deploy:
   script: |-
     echo "There is nothing to deploy"

data/README.md

@@ -107,7 +107,7 @@ pkey = sibit.generate
 address = sibit.create(pkey)
 balance = sibit.balance(address)
 target = sibit.create(pkey) # where to send coins to
-change = sibit.create(pkey) # where the change will sent to
+change = sibit.create(pkey) # where the change will be sent to
 tx = sibit.pay(10_000_000, 'XL', { address => pkey }, target, change)
 ```
 
@@ -145,7 +145,14 @@ will be used one by one, until a successful response is obtained:
 require 'sibit'
 require 'sibit/btc'
 require 'sibit/cryptoapis'
-sibit = Sibit.new(api: [Sibit::Btc.new, Sibit::Cryptoapis.new('key')])
+sibit = Sibit.new(
+  api: Sibit::FirstOf.new(
+    [
+      Sibit::Btc.new,
+      Sibit::Cryptoapis.new('key')
+    ]
+  )
+)
 ```
 
 If you think we may need to use some other API, you can submit a ticket,

data/bin/sibit

@@ -32,6 +32,7 @@ require_relative '../lib/sibit/blockchain'
 require_relative '../lib/sibit/btc'
 require_relative '../lib/sibit/bitcoinchain'
 require_relative '../lib/sibit/earn'
+require_relative '../lib/sibit/firstof'
 
 begin
   begin
@@ -86,7 +87,7 @@ Options are:"
     api = RetriableProxy.for_object(api, on: Sibit::Error) if opts[:attempts] > 1
     api
   end
-  sibit = Sibit.new(log: log, api: apis)
+  sibit = Sibit.new(log: log, api: Sibit::FirstOf.new(apis, log: log))
   case opts.arguments[0]
   when 'price'
     puts sibit.price

data/lib/sibit.rb

@@ -55,9 +55,7 @@ class Sibit
 
   # Current price of 1 BTC in USD (or another currency), float returned.
   def price(currency = 'USD')
-    first_one do |api|
-      api.price(currency)
-    end
+    @api.price(currency)
   end
 
   # Generates new Bitcon private key and returns in Hash160 format.
@@ -76,29 +74,23 @@ class Sibit
 
   # Gets the balance of the address, in satoshi.
   def balance(address)
-    first_one do |api|
-      api.balance(address)
-    end
+    @api.balance(address)
   end
 
   # Get the height of the block.
   def height(hash)
-    first_one do |api|
-      api.height(hash)
-    end
+    @api.height(hash)
   end
 
   # Get the hash of the next block.
   def next_of(hash)
-    first_one do |api|
-      api.next_of(hash)
-    end
+    @api.next_of(hash)
   end
 
   # Get recommended fees, in satoshi per byte. The method returns
   # a hash: { S: 12, M: 45, L: 100, XL: 200 }
   def fees
-    first_one(&:fees)
+    @api.fees
   end
 
   # Sends a payment and returns the transaction hash.
@@ -124,7 +116,7 @@ class Sibit
     builder = Bitcoin::Builder::TxBuilder.new
     unspent = 0
     size = 100
-    utxos = first_one { |api| api.utxos(sources.keys) }
+    utxos = @api.utxos(sources.keys)
     @log.info("#{utxos.count} UTXOs found, these will be used \
 (value/confirmations at tx_hash):")
     utxos.each do |utxo|
@@ -170,15 +162,13 @@ class Sibit
   Amount: #{num(satoshi, p)}
   Target address: #{target}
   Change address is #{change}")
-    first_one do |api|
-      api.push(tx.to_payload.bth)
-    end
+    @api.push(tx.to_payload.bth)
     tx.hash
   end
 
   # Gets the hash of the latest block.
   def latest
-    first_one(&:latest)
+    @api.latest
   end
 
   # You call this method and provide a callback. You provide the hash
@@ -197,7 +187,7 @@ class Sibit
     wrong = []
     json = {}
     loop do
-      json = first_one { |api| api.block(block) }
+      json = @api.block(block)
       if json[:orphan]
         steps = 4
         @log.info("Orphan block found at #{block}, moving #{steps} steps back...")
@@ -206,7 +196,7 @@ class Sibit
           block = json[:previous]
           wrong << block
           @log.info("Moved back to #{block}")
-          json = first_one { |api| api.block(block) }
+          json = @api.block(block)
         end
         next
       end
@@ -236,31 +226,12 @@ class Sibit
         break
       end
     end
+    @log.info("Scanned from #{start} to #{json[:hash]} (#{count} blocks)")
     json[:hash]
   end
 
   private
 
-  def first_one
-    return yield @api unless @api.is_a?(Array)
-    done = false
-    result = nil
-    @api.each do |api|
-      begin
-        result = yield api
-        done = true
-        break
-      rescue Sibit::Error => e
-        @log.info("The API #{api.class.name} failed: #{e.message}")
-      end
-    end
-    unless done
-      raise Sibit::Error, "No APIs out of #{@api.length} managed to succeed: \
-#{@api.map { |a| a.class.name }.join(', ')}"
-    end
-    result
-  end
-
   def num(satoshi, usd)
     format(
       '%<satoshi>ss/$%<dollars>0.2f',

data/lib/sibit/bestof.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2019-2020 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.
+
+require_relative 'error'
+require_relative 'log'
+
+# API best of.
+#
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2019-2020 Yegor Bugayenko
+# License:: MIT
+class Sibit
+  # Best of API.
+  class BestOf
+    # Constructor.
+    def initialize(list, log: Sibit::Log.new)
+      @list = list
+      @log = log
+    end
+
+    # Current price of BTC in USD (float returned).
+    def price(currency = 'USD')
+      best_of('price') do |api|
+        api.price(currency)
+      end
+    end
+
+    # Gets the balance of the address, in satoshi.
+    def balance(address)
+      best_of('balance') do |api|
+        api.balance(address)
+      end
+    end
+
+    # Get the height of the block.
+    def height(hash)
+      best_of('height') do |api|
+        api.height(hash)
+      end
+    end
+
+    # Get the hash of the next block.
+    def next_of(hash)
+      best_of('next_of') do |api|
+        api.next_of(hash)
+      end
+    end
+
+    # Get recommended fees, in satoshi per byte. The method returns
+    # a hash: { S: 12, M: 45, L: 100, XL: 200 }
+    def fees
+      best_of('fees', &:fees)
+    end
+
+    # Fetch all unspent outputs per address.
+    def utxos(keys)
+      best_of('utxos') do |api|
+        api.utxos(keys)
+      end
+    end
+
+    # Latest block hash.
+    def latest
+      best_of('latest', &:latest)
+    end
+
+    # Push this transaction (in hex format) to the network.
+    def push(hex)
+      best_of('push') do |api|
+        api.push(hex)
+      end
+    end
+
+    # This method should fetch a block and return as a hash.
+    def block(hash)
+      best_of('block') do |api|
+        api.block(hash)
+      end
+    end
+
+    private
+
+    def best_of(method)
+      return yield @list unless @list.is_a?(Array)
+      results = []
+      @list.each do |api|
+        begin
+          results << yield(api)
+        rescue Sibit::Error => e
+          @log.info("The API #{api.class.name} failed at #{method}(): #{e.message}")
+        end
+      end
+      if results.empty?
+        raise Sibit::Error, "No APIs out of #{@api.length} managed to succeed at #{method}(): \
+#{@api.map { |a| a.class.name }.join(', ')}"
+      end
+      results.group_by(&:to_s).values.max_by(&:size)[0]
+    end
+  end
+end

data/lib/sibit/bitcoinchain.rb

@@ -45,21 +45,24 @@ class Sibit
 
     # Current price of BTC in USD (float returned).
     def price(_currency = 'USD')
-      raise Sibit::Error, 'Bitcoinchain API doesn\'t provide BTC price'
+      raise Sibit::NotSupportedError, 'Bitcoinchain API doesn\'t provide BTC price'
     end
 
     # The height of the block.
     def height(_hash)
-      raise Sibit::Error, 'Bitcoinchain API doesn\'t provide height()'
+      raise Sibit::NotSupportedError, 'Bitcoinchain API doesn\'t provide height()'
     end
 
     # Get hash of the block after this one.
     def next_of(hash)
-      nxt = Sibit::Json.new(http: @http, log: @log).get(
+      block = Sibit::Json.new(http: @http, log: @log).get(
         URI("https://api-r.bitcoinchain.com/v1/block/#{hash}")
-      )[0]['next_block']
+      )[0]
+      raise Sibit::Error, "Block #{hash} not found" if block.nil?
+      nxt = block['next_block']
       nxt = nil if nxt == '0000000000000000000000000000000000000000000000000000000000000000'
-      @log.info("The next block of #{hash} is #{nxt}")
+      @log.info("The block #{hash} is the latest, there is no next block") if nxt.nil?
+      @log.info("The next block of #{hash} is #{nxt}") unless nxt.nil?
       nxt
     end
 
@@ -76,13 +79,13 @@ class Sibit
       end
       b *= 100_000_000
       b = b.to_i
-      @log.info("The balance of #{address} is #{b} satoshi")
+      @log.info("The balance of #{address} is #{b} satoshi (#{json['transactions']} txns)")
       b
     end
 
     # Get recommended fees, in satoshi per byte.
     def fees
-      raise Sibit::Error, 'Not implemented yet'
+      raise Sibit::NotSupportedError, 'Not implemented yet'
     end
 
     # Gets the hash of the latest block.
@@ -96,12 +99,12 @@ class Sibit
 
     # Fetch all unspent outputs per address.
     def utxos(_sources)
-      raise Sibit::Error, 'Not implemented yet'
+      raise Sibit::NotSupportedError, 'Not implemented yet'
     end
 
     # Push this transaction (in hex format) to the network.
     def push(_hex)
-      raise Sibit::Error, 'Not implemented yet'
+      raise Sibit::NotSupportedError, 'Not implemented yet'
     end
 
     # This method should fetch a Blockchain block and return as a hash. Raises

data/lib/sibit/blockchain.rb

@@ -59,7 +59,7 @@ class Sibit
 
     # Get hash of the block after this one.
     def next_of(_hash)
-      raise Sibit::Error, 'Blockchain API doesn\'t provide next_of()'
+      raise Sibit::NotSupportedError, 'Blockchain API doesn\'t provide next_of()'
     end
 
     # The height of the block.
@@ -78,13 +78,14 @@ class Sibit
         URI("https://blockchain.info/rawaddr/#{address}?limit=0"),
         accept: [200, 500]
       )
-      @log.info("Received/sent: #{json['total_received']}/#{json['total_sent']}")
-      json['final_balance']
+      b = json['final_balance']
+      @log.info("The balance of #{address} is #{b} satoshi (#{json['n_tx']} txns)")
+      b
     end
 
     # Get recommended fees.
     def fees
-      raise Sibit::Error, 'fees() is not provided by Blockchain API'
+      raise Sibit::NotSupportedError, 'fees() is not provided by Blockchain API'
     end
 
     # Fetch all unspent outputs per address. The argument is an array

data/lib/sibit/blockchair.rb

@@ -47,18 +47,18 @@ class Sibit
 
     # Current price of BTC in USD (float returned).
     def price(_currency = 'USD')
-      raise Sibit::Error, 'Blockchair doesn\'t provide BTC price'
+      raise Sibit::NotSupportedError, 'Blockchair doesn\'t provide BTC price'
     end
 
     # The height of the block.
     def height(_hash)
-      raise Sibit::Error, 'Blockchair API doesn\'t provide height()'
+      raise Sibit::NotSupportedError, 'Blockchair API doesn\'t provide height()'
     end
 
     # Get hash of the block after this one.
     def next_of(_hash)
       # They don't provide next block hash
-      raise Sibit::Error, 'Blockchair API doesn\'t provide next_of()'
+      raise Sibit::NotSupportedError, 'Blockchair API doesn\'t provide next_of()'
     end
 
     # Gets the balance of the address, in satoshi.
@@ -70,24 +70,25 @@ class Sibit
         @log.info("Address #{address} not found")
         return 0
       end
-      b = json['address']['balance']
+      a = json['address']
+      b = a['balance']
       @log.info("The balance of #{address} is #{b} satoshi")
       b
     end
 
     # Get recommended fees, in satoshi per byte.
     def fees
-      raise Sibit::Error, 'Blockchair doesn\'t implement fees()'
+      raise Sibit::NotSupportedError, 'Blockchair doesn\'t implement fees()'
     end
 
     # Gets the hash of the latest block.
     def latest
-      raise Sibit::Error, 'Blockchair doesn\'t implement latest()'
+      raise Sibit::NotSupportedError, 'Blockchair doesn\'t implement latest()'
     end
 
     # Fetch all unspent outputs per address.
     def utxos(_sources)
-      raise Sibit::Error, 'Blockchair doesn\'t implement utxos()'
+      raise Sibit::NotSupportedError, 'Blockchair doesn\'t implement utxos()'
     end
 
     # Push this transaction (in hex format) to the network.
@@ -101,7 +102,7 @@ class Sibit
 
     # This method should fetch a Blockchain block and return as a hash.
     def block(_hash)
-      raise Sibit::Error, 'Blockchair doesn\'t implement block()'
+      raise Sibit::NotSupportedError, 'Blockchair doesn\'t implement block()'
     end
 
     private

data/lib/sibit/btc.rb

@@ -47,7 +47,7 @@ class Sibit
 
     # Current price of BTC in USD (float returned).
     def price(_currency = 'USD')
-      raise Sibit::Error, 'Btc.com API doesn\'t provide prices'
+      raise Sibit::NotSupportedError, 'Btc.com API doesn\'t provide prices'
     end
 
     # Gets the balance of the address, in satoshi.
@@ -69,9 +69,12 @@ class Sibit
       head = Sibit::Json.new(http: @http, log: @log).get(
         URI("https://chain.api.btc.com/v3/block/#{hash}")
       )
-      nxt = head['data']['next_block_hash']
+      data = head['data']
+      raise Sibit::Error, "The block #{hash} not found" if data.nil?
+      nxt = data['next_block_hash']
       nxt = nil if nxt == '0000000000000000000000000000000000000000000000000000000000000000'
-      @log.info("The next block of #{hash} is #{nxt}")
+      @log.info("The block #{hash} is the latest, there is no next block") if nxt.nil?
+      @log.info("The next block of #{hash} is #{nxt}") unless nxt.nil?
       nxt
     end
 
@@ -80,21 +83,25 @@ class Sibit
       json = Sibit::Json.new(http: @http, log: @log).get(
         URI("https://chain.api.btc.com/v3/block/#{hash}")
       )
-      h = json['data']['height']
+      data = json['data']
+      raise Sibit::Error, "The block #{hash} not found" if data.nil?
+      h = data['height']
       @log.info("The height of #{hash} is #{h}")
       h
     end
 
     # Get recommended fees, in satoshi per byte.
     def fees
-      raise Sibit::Error, 'Btc.com doesn\'t provide recommended fees'
+      raise Sibit::NotSupportedError, 'Btc.com doesn\'t provide recommended fees'
     end
 
     # Gets the hash of the latest block.
     def latest
       uri = URI('https://chain.api.btc.com/v3/block/latest')
       json = Sibit::Json.new(http: @http, log: @log).get(uri)
-      hash = json['data']['hash']
+      data = json['data']
+      raise Sibit::Error, 'The latest block not found' if data.nil?
+      hash = data['hash']
       @log.info("The hash of the latest block is #{hash}")
       hash
     end
@@ -106,7 +113,9 @@ class Sibit
         json = Sibit::Json.new(http: @http, log: @log).get(
           URI("https://chain.api.btc.com/v3/address/#{hash}/unspent")
         )
-        json['data']['list'].each do |u|
+        data = json['data']
+        raise Sibit::Error, "The address #{hash} not found" if data.nil?
+        data['list'].each do |u|
           outs = Sibit::Json.new(http: @http, log: @log).get(
             URI("https://chain.api.btc.com/v3/tx/#{u['tx_hash']}?verbose=3")
           )['data']['outputs']
@@ -127,7 +136,7 @@ class Sibit
 
     # Push this transaction (in hex format) to the network.
     def push(_hex)
-      raise Sibit::Error, 'Btc.com doesn\'t provide payment gateway'
+      raise Sibit::NotSupportedError, 'Btc.com doesn\'t provide payment gateway'
     end
 
     # This method should fetch a Blockchain block and return as a hash.
@@ -135,13 +144,15 @@ class Sibit
       head = Sibit::Json.new(http: @http, log: @log).get(
         URI("https://chain.api.btc.com/v3/block/#{hash}")
       )
-      nxt = head['data']['next_block_hash']
+      data = head['data']
+      raise Sibit::Error, "The block #{hash} not found" if data.nil?
+      nxt = data['next_block_hash']
       nxt = nil if nxt == '0000000000000000000000000000000000000000000000000000000000000000'
       {
-        hash: head['data']['hash'],
-        orphan: head['data']['is_orphan'],
+        hash: data['hash'],
+        orphan: data['is_orphan'],
         next: nxt,
-        previous: head['data']['prev_block_hash'],
+        previous: data['prev_block_hash'],
         txns: txns(hash)
       }
     end

data/lib/sibit/cex.rb

@@ -54,41 +54,41 @@ class Sibit
 
     # Get hash of the block after this one.
     def next_of(_hash)
-      raise Sibit::Error, 'Cex.io API doesn\'t provide next_of()'
+      raise Sibit::NotSupportedError, 'Cex.io API doesn\'t provide next_of()'
     end
 
     # Gets the balance of the address, in satoshi.
     def balance(_address)
-      raise Sibit::Error, 'Cex.io doesn\'t implement balance()'
+      raise Sibit::NotSupportedError, 'Cex.io doesn\'t implement balance()'
     end
 
     # The height of the block.
     def height(_hash)
-      raise Sibit::Error, 'Cex.io doesn\'t implement height()'
+      raise Sibit::NotSupportedError, 'Cex.io doesn\'t implement height()'
     end
 
     # Get recommended fees, in satoshi per byte.
     def fees
-      raise Sibit::Error, 'Cex.io doesn\'t implement fees()'
+      raise Sibit::NotSupportedError, 'Cex.io doesn\'t implement fees()'
     end
 
     # Gets the hash of the latest block.
     def latest
-      raise Sibit::Error, 'Cex.io doesn\'t implement latest()'
+      raise Sibit::NotSupportedError, 'Cex.io doesn\'t implement latest()'
     end
 
     # Fetch all unspent outputs per address.
     def utxos(_sources)
-      raise Sibit::Error, 'Cex.io doesn\'t implement utxos()'
+      raise Sibit::NotSupportedError, 'Cex.io doesn\'t implement utxos()'
     end
 
     # Push this transaction (in hex format) to the network.
     def push(_hex)
-      raise Sibit::Error, 'Cex.io doesn\'t implement push()'
+      raise Sibit::NotSupportedError, 'Cex.io doesn\'t implement push()'
     end
 
     def block(_hash)
-      raise Sibit::Error, 'Cex.io doesn\'t implement block()'
+      raise Sibit::NotSupportedError, 'Cex.io doesn\'t implement block()'
     end
   end
 end

data/lib/sibit/cryptoapis.rb

@@ -46,15 +46,18 @@ class Sibit
 
     # Current price of BTC in USD (float returned).
     def price(_currency = 'USD')
-      raise Sibit::Error, 'Cryptoapis doesn\'t provide BTC price'
+      raise Sibit::NotSupportedError, 'Cryptoapis doesn\'t provide BTC price'
     end
 
     # Get hash of the block after this one.
     def next_of(hash)
-      Sibit::Json.new(http: @http, log: @log).get(
+      nxt = Sibit::Json.new(http: @http, log: @log).get(
         URI("https://api.cryptoapis.io/v1/bc/btc/mainnet/blocks/#{hash}"),
         headers: headers
       )['payload']['hash']
+      @log.info("The block #{hash} is the latest, there is no next block") if nxt.nil?
+      @log.info("The next block of #{hash} is #{nxt}") unless nxt.nil?
+      nxt
     end
 
     # The height of the block.
@@ -81,7 +84,7 @@ class Sibit
 
     # Get recommended fees, in satoshi per byte.
     def fees
-      raise Sibit::Error, 'Cryptoapis doesn\'t provide recommended fees'
+      raise Sibit::NotSupportedError, 'Cryptoapis doesn\'t provide recommended fees'
     end
 
     # Gets the hash of the latest block.
@@ -96,7 +99,7 @@ class Sibit
 
     # Fetch all unspent outputs per address.
     def utxos(_sources)
-      raise Sibit::Error, 'Not implemented yet'
+      raise Sibit::NotSupportedError, 'Not implemented yet'
     end
 
     # Push this transaction (in hex format) to the network.

data/lib/sibit/earn.rb

@@ -44,22 +44,22 @@ class Sibit
 
     # Current price of BTC in USD (float returned).
     def price(_currency)
-      raise Sibit::Error, 'price() doesn\'t work here'
+      raise Sibit::NotSupportedError, 'price() doesn\'t work here'
     end
 
     # Gets the balance of the address, in satoshi.
     def balance(_address)
-      raise Sibit::Error, 'balance() doesn\'t work here'
+      raise Sibit::NotSupportedError, 'balance() doesn\'t work here'
     end
 
     # Get hash of the block after this one.
     def next_of(_hash)
-      raise Sibit::Error, 'Earn.com API doesn\'t provide next_of()'
+      raise Sibit::NotSupportedError, 'Earn.com API doesn\'t provide next_of()'
     end
 
     # The height of the block.
     def height(_hash)
-      raise Sibit::Error, 'Earn API doesn\'t provide height()'
+      raise Sibit::NotSupportedError, 'Earn API doesn\'t provide height()'
     end
 
     # Get recommended fees, in satoshi per byte. The method returns
@@ -80,22 +80,22 @@ class Sibit
 
     # Fetch all unspent outputs per address.
     def utxos(_sources)
-      raise Sibit::Error, 'Not implemented yet'
+      raise Sibit::NotSupportedError, 'Not implemented yet'
     end
 
     # Push this transaction (in hex format) to the network.
     def push(_hex)
-      raise Sibit::Error, 'Not implemented yet'
+      raise Sibit::NotSupportedError, 'Not implemented yet'
     end
 
     # Gets the hash of the latest block.
     def latest
-      raise Sibit::Error, 'latest() doesn\'t work here'
+      raise Sibit::NotSupportedError, 'latest() doesn\'t work here'
     end
 
     # This method should fetch a Blockchain block and return as a hash.
     def block(_hash)
-      raise Sibit::Error, 'block() doesn\'t work here'
+      raise Sibit::NotSupportedError, 'block() doesn\'t work here'
     end
   end
 end

data/lib/sibit/error.rb

@@ -28,4 +28,7 @@
 class Sibit
   # The error.
   class Error < StandardError; end
+
+  # The operation is not supported.
+  class NotSupportedError < Error; end
 end

data/lib/sibit/firstof.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2019-2020 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.
+
+require_relative 'error'
+require_relative 'log'
+
+# API first of.
+#
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2019-2020 Yegor Bugayenko
+# License:: MIT
+class Sibit
+  # First of API.
+  class FirstOf
+    # Constructor.
+    def initialize(list, log: Sibit::Log.new)
+      @list = list
+      @log = log
+    end
+
+    # Current price of BTC in USD (float returned).
+    def price(currency = 'USD')
+      first_of('price') do |api|
+        api.price(currency)
+      end
+    end
+
+    # Gets the balance of the address, in satoshi.
+    def balance(address)
+      first_of('balance') do |api|
+        api.balance(address)
+      end
+    end
+
+    # Get the height of the block.
+    def height(hash)
+      first_of('height') do |api|
+        api.height(hash)
+      end
+    end
+
+    # Get the hash of the next block.
+    def next_of(hash)
+      first_of('next_of') do |api|
+        api.next_of(hash)
+      end
+    end
+
+    # Get recommended fees, in satoshi per byte. The method returns
+    # a hash: { S: 12, M: 45, L: 100, XL: 200 }
+    def fees
+      first_of('fees', &:fees)
+    end
+
+    # Fetch all unspent outputs per address.
+    def utxos(keys)
+      first_of('utxos') do |api|
+        api.utxos(keys)
+      end
+    end
+
+    # Latest block hash.
+    def latest
+      first_of('latest', &:latest)
+    end
+
+    # Push this transaction (in hex format) to the network.
+    def push(hex)
+      first_of('push') do |api|
+        api.push(hex)
+      end
+    end
+
+    # This method should fetch a block and return as a hash.
+    def block(hash)
+      first_of('block') do |api|
+        api.block(hash)
+      end
+    end
+
+    private
+
+    def first_of(method)
+      return yield @list unless @list.is_a?(Array)
+      done = false
+      result = nil
+      @list.each do |api|
+        begin
+          result = yield api
+          done = true
+          break
+        rescue Sibit::Error => e
+          @log.info("The API #{api.class.name} failed at #{method}(): #{e.message}")
+        end
+      end
+      unless done
+        raise Sibit::Error, "No APIs out of #{@api.length} managed to succeed at #{method}(): \
+#{@api.map { |a| a.class.name }.join(', ')}"
+      end
+      result
+    end
+  end
+end

data/lib/sibit/version.rb

@@ -26,5 +26,5 @@
 # License:: MIT
 class Sibit
   # Current version of the library.
-  VERSION = '0.18.4'
+  VERSION = '0.19.0'
 end

data/sibit.gemspec

@@ -36,9 +36,9 @@ Gem::Specification.new do |s|
   s.version = Sibit::VERSION
   s.license = 'MIT'
   s.summary = 'Simple Bitcoin Client'
-  s.description = 'This is a simple Bitcoin client, to use from command line \
-or from your Ruby app. You don\'t need to run any Bitcoin software, \
-no need to install anything, etc. All you need is just a command line \
+  s.description = 'This is a simple Bitcoin client, to use from command line
+or from your Ruby app. You don\'t need to run any Bitcoin software,
+no need to install anything, etc. All you need is just a command line
 and Ruby 2.3+.'
   s.authors = ['Yegor Bugayenko']
   s.email = 'yegor256@gmail.com'

data/test/test_bestof.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2019-2020 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.
+
+require 'minitest/autorun'
+require_relative '../lib/sibit'
+require_relative '../lib/sibit/fake'
+require_relative '../lib/sibit/bestof'
+
+# Sibit::BestOf test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2019-2020 Yegor Bugayenko
+# License:: MIT
+class TestBestOf < Minitest::Test
+  def test_not_array
+    sibit = Sibit::BestOf.new(Sibit::Fake.new)
+    assert_equal(64, sibit.latest.length)
+    assert_equal(12, sibit.fees[:S])
+  end
+
+  def test_one_apis
+    sibit = Sibit::BestOf.new([Sibit::Fake.new])
+    assert_equal(64, sibit.latest.length)
+    assert_equal(12, sibit.fees[:S])
+  end
+
+  def test_two_apis
+    sibit = Sibit::BestOf.new([Sibit::Fake.new, Sibit::Fake.new])
+    assert_equal(64, sibit.latest.length)
+    assert_equal(12, sibit.fees[:S])
+  end
+end

data/test/test_blockchair.rb

@@ -34,7 +34,8 @@ class TestBlockchair < Minitest::Test
   def test_fetch_balance
     hash = '1GkQmKAmHtNfnD3LHhTkewJxKHVSta4m2a'
     stub_request(:get, "https://api.blockchair.com/bitcoin/dashboards/address/#{hash}")
-      .to_return(body: "{\"data\": {\"#{hash}\": {\"address\": {\"balance\": 1}}}}")
+      .to_return(body: "{\"data\": {\"#{hash}\": {\"address\":
+        {\"balance\": 1, \"transactions\": []}}}}")
     sibit = Sibit::Blockchair.new
     satoshi = sibit.balance(hash)
     assert_equal(1, satoshi)

data/test/test_firstof.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2019-2020 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.
+
+require 'minitest/autorun'
+require_relative '../lib/sibit'
+require_relative '../lib/sibit/fake'
+require_relative '../lib/sibit/firstof'
+
+# Sibit::FirstOf test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2019-2020 Yegor Bugayenko
+# License:: MIT
+class TestFirstOf < Minitest::Test
+  def test_not_array
+    sibit = Sibit::FirstOf.new(Sibit::Fake.new)
+    assert_equal(64, sibit.latest.length)
+    assert_equal(12, sibit.fees[:S])
+  end
+
+  def test_one_apis
+    sibit = Sibit::FirstOf.new([Sibit::Fake.new])
+    assert_equal(64, sibit.latest.length)
+    assert_equal(12, sibit.fees[:S])
+  end
+
+  def test_two_apis
+    sibit = Sibit::FirstOf.new([Sibit::Fake.new, Sibit::Fake.new])
+    assert_equal(64, sibit.latest.length)
+    assert_equal(12, sibit.fees[:S])
+  end
+end

data/test/test_sibit.rb

@@ -27,6 +27,8 @@ require_relative '../lib/sibit'
 require_relative '../lib/sibit/earn'
 require_relative '../lib/sibit/fake'
 require_relative '../lib/sibit/blockchain'
+require_relative '../lib/sibit/firstof'
+require_relative '../lib/sibit/bestof'
 
 # Sibit.
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
@@ -127,7 +129,7 @@ class TestSibit < Minitest::Test
       'https://blockchain.info/unspent?active=1JvCsJtLmCxEk7ddZFnVkGXpr9uhxZPmJi&limit=1000'
     ).to_return(body: JSON.pretty_generate(json))
     stub_request(:post, 'https://blockchain.info/pushtx').to_return(status: 200)
-    sibit = Sibit.new(api: [Sibit::Earn.new, Sibit::Blockchain.new])
+    sibit = Sibit.new(api: Sibit::FirstOf.new([Sibit::Earn.new, Sibit::Blockchain.new]))
     target = sibit.create(sibit.generate)
     change = sibit.create(sibit.generate)
     tx = sibit.pay(
@@ -156,7 +158,7 @@ class TestSibit < Minitest::Test
       :get,
       'https://blockchain.info/unspent?active=1JvCsJtLmCxEk7ddZFnVkGXpr9uhxZPmJi&limit=1000'
     ).to_return(body: JSON.pretty_generate(json))
-    sibit = Sibit.new
+    sibit = Sibit.new(api: Sibit::BestOf.new([Sibit::Fake.new, Sibit::Fake.new]))
     target = sibit.create(sibit.generate)
     change = sibit.create(sibit.generate)
     assert_raises Sibit::Error do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sibit
 version: !ruby/object:Gem::Version
-  version: 0.18.4
+  version: 0.19.0
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-27 00:00:00.000000000 Z
+date: 2020-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: backtrace
@@ -249,9 +249,9 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 3.7.6
 description: |-
-  This is a simple Bitcoin client, to use from command line \
-  or from your Ruby app. You don't need to run any Bitcoin software, \
-  no need to install anything, etc. All you need is just a command line \
+  This is a simple Bitcoin client, to use from command line
+  or from your Ruby app. You don't need to run any Bitcoin software,
+  no need to install anything, etc. All you need is just a command line
   and Ruby 2.3+.
 email: yegor256@gmail.com
 executables:
@@ -281,6 +281,7 @@ files:
 - features/step_definitions/steps.rb
 - features/support/env.rb
 - lib/sibit.rb
+- lib/sibit/bestof.rb
 - lib/sibit/bitcoinchain.rb
 - lib/sibit/blockchain.rb
 - lib/sibit/blockchair.rb
@@ -290,6 +291,7 @@ files:
 - lib/sibit/earn.rb
 - lib/sibit/error.rb
 - lib/sibit/fake.rb
+- lib/sibit/firstof.rb
 - lib/sibit/http.rb
 - lib/sibit/json.rb
 - lib/sibit/log.rb
@@ -297,6 +299,7 @@ files:
 - logo.svg
 - sibit.gemspec
 - test/test__helper.rb
+- test/test_bestof.rb
 - test/test_bitcoinchain.rb
 - test/test_blockchain.rb
 - test/test_blockchair.rb
@@ -304,6 +307,7 @@ files:
 - test/test_cex.rb
 - test/test_cryptoapis.rb
 - test/test_fake.rb
+- test/test_firstof.rb
 - test/test_json.rb
 - test/test_live.rb
 - test/test_sibit.rb
@@ -337,6 +341,7 @@ test_files:
 - features/step_definitions/steps.rb
 - features/support/env.rb
 - test/test__helper.rb
+- test/test_bestof.rb
 - test/test_bitcoinchain.rb
 - test/test_blockchain.rb
 - test/test_blockchair.rb
@@ -344,6 +349,7 @@ test_files:
 - test/test_cex.rb
 - test/test_cryptoapis.rb
 - test/test_fake.rb
+- test/test_firstof.rb
 - test/test_json.rb
 - test/test_live.rb
 - test/test_sibit.rb