[HZ] Fbox - FaucetBox REST API helper

[Hothza]

Cześć,
Fbox to gem, dzięki któremu łatwiej jest zintegrować API FaucetBoksa z aplikacją w RubyOnRails (być może się komuś przyda )

Źródła: https://github.com/Hothza/fbox

Instalacja:
Należy dodać do Gemfile aplikacji:

Kod: Zaznacz cały

gem 'fbox'

a następnie odpalić

Kod: Zaznacz cały

$ bundle

lub zainstalować ręcznie:

Kod: Zaznacz cały

$ gem install fbox

Dostępne metody i przykładowe użycie:

• currencies - zwraca listę obsługiwanych przez FaucetBox monet

  Kod: Zaznacz cały

      require 'pp'
      require 'fbox'
  
      api_key = '4VdBEIAQKPpZ4SWOhQLUMn7mMNVql' # FBox example API key
      fbox = Fbox::Client.new({:api_key => api_key})
      currencies = fbox.currencies()
  
      pp "Supported currencies: #{currencies}\n"
  

• balance(currency) - zwraca aktualną ilość monet dla danej waluty (jeśli nie została ustawiona, to BTC jest brane jako domyślne)

  Kod: Zaznacz cały

      require 'pp'
      require 'fbox'
  
      # Unfortunately at this moment API key used in examples on FaucetBox site
      # gives 403 status, so you have to use your own
  
      api_key = '4VdBEIAQKPpZ4SWOhQLUMn7mMNVql' # Put your API key here
      currency = 'BTC'
  
      fbox = Fbox::Client.new({:api_key => api_key})
      balance = fbox.balance()
      pp "balance: #{balance}\n"
  

• payment(to, amount, referral = false, currency = '') - wysyła żądaną ilość monet (satoshi) w zadanej walucie (jeśli nie ustawiona to BTC jest brane domyślnie) z Twojego fauceta na zadany adres

  Kod: Zaznacz cały

      require 'pp'
      require 'fbox'
  
      api_key = ''      # Put here your API key
      address = ''      # Put here destination address (BTC, LTC, or other supported by FaucetBox)
      amount = 10       # Amount of satoshis to send
      referral = false  # Is this a referral payment?
  
      fbox = Fbox::Client.new({:api_key => api_key})
      payment = fbox.payment(address, amount, referral)
      pp "payment: #{payment}\n"
  

• is_response_ok?(body) - helper, który sprawdza czy odpowiedź z serwera FaucetBox jest prawidłowa (tj. czy ma pole status = 200)
• is_address_valid?(address) - helper, który wykorzystuje CoinsAddressValidatora do sprawdzania poprawności adresów (sprawdzana jest długość, suma kontrolna, etc.)

Hz