zold-ruby-sdk 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d5f77cfaa341fc53d966cdc048bfbb2f4a9ec4ca7c3bd5cc407413bd5460ffe2
+  data.tar.gz: 6fe60f88eae2fb341d128771a20721d63667b9e8907b0cd5acfd4444953f0f35
+SHA512:
+  metadata.gz: e706d2c9dc7c180ca92ccbaa60405055338075bc296acbd35ee706418d8c8b594ea6f262e0895c5a3e91a9b5ff9fd2ed9d88d900be7a40fb8430a1cf981990cf
+  data.tar.gz: 15f24cde6757b62815507deda97af55f12818f2cb66c8353c34c5ae72f81bbf5ad5a221d943d2d54fae243226fbb2af76f7ed8dfea9af59560177319ea308f57

data/.0pdd.yml

@@ -0,0 +1,9 @@
+errors:
+  - yegor256@gmail.com
+# alerts:
+#   github:
+#     - yegor256
+
+tags:
+  - pdd
+  - bug

data/.gitattributes

@@ -0,0 +1,9 @@
+# Check out all text files in UNIX format, with LF as end of line
+# Don't change this file. If you have any ideas about it, please
+# submit a separate issue about it and we'll discuss.
+
+* text=auto eol=lf
+*.rb ident
+*.xml ident
+*.png binary
+*.pdf binary

data/.gitignore

@@ -0,0 +1,9 @@
+coverage/
+.idea/
+*.gem
+.bundle/
+.DS_Store
+rdoc/
+Gemfile.lock
+tmp/
+lib/score_suffix

data/.pdd

@@ -0,0 +1,7 @@
+--source=.
+--verbose
+--exclude target/**/*
+--exclude coverage/**/*
+--rule min-words:20
+--rule min-estimate:15
+--rule max-estimate:90

data/.rubocop.yml

@@ -0,0 +1,24 @@
+AllCops:
+  DisplayCopNames: true
+  TargetRubyVersion: 2.5
+
+Layout/EmptyLineAfterGuardClause:
+  Enabled: false
+Layout/EndOfLine:
+  EnforcedStyle: lf
+Metrics/AbcSize:
+  Max: 45
+Metrics/BlockLength:
+  Max: 30
+Metrics/MethodLength:
+  Max: 40
+Metrics/ClassLength:
+  Max: 180
+Metrics/ParameterLists:
+  Max: 7
+Layout/AlignParameters:
+  Enabled: false
+Metrics/CyclomaticComplexity:
+  Max: 20
+Metrics/PerceivedComplexity:
+  Max: 20

data/.rultor.yml

@@ -0,0 +1,26 @@
+assets:
+  rubygems.yml: zerocracy/home#assets/rubygems.yml
+install: |-
+  export GEM_HOME=~/.ruby
+  export GEM_PATH=$GEM_HOME:$GEM_PATH
+release:
+  script: |-
+    bundle install
+    rake
+    rm -rf *.gem
+    sed -i "s/0\.0\.0/${tag}/g" zold-ruby-sdk.gemspec
+    git add zold-ruby-sdk.gemspec
+    git commit -m "Version set to ${tag}"
+    gem build zold-ruby-sdk.gemspec
+    chmod 0600 ../rubygems.yml
+    gem push *.gem --config-file ../rubygems.yml
+  commanders:
+  - yegor256
+architect:
+- yegor256
+merge:
+  commanders: []
+  script: |-
+    bundle install
+    rake
+deploy: {}

data/.simplecov

@@ -0,0 +1,40 @@
+# encoding: utf-8
+#
+# Copyright (c) 2018-2019 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.
+
+if Gem.win_platform? then
+  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+    SimpleCov::Formatter::HTMLFormatter
+  ]
+  SimpleCov.start do
+    add_filter "/test/"
+    add_filter "/features/"
+  end
+else
+  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter.new(
+    [SimpleCov::Formatter::HTMLFormatter]
+  )
+  SimpleCov.start do
+    add_filter "/test/"
+    add_filter "/features/"
+#    minimum_coverage 30
+  end
+end

data/.travis.yml

@@ -0,0 +1,20 @@
+language: ruby
+rvm:
+  - 2.3.1
+  - 2.3.3
+  - 2.4.5
+cache: bundler
+branches:
+  only:
+    - master
+install:
+  - travis_retry bundle update
+  - gem install pdd
+  - sudo apt-get install cppcheck
+script:
+  - pdd -f /dev/null
+  - cppcheck --enable=all --quiet --suppress=unusedFunction .
+  - export RUBYOPT="-W0"
+  - rake --quiet
+after_success:
+  - "bash <(curl -s https://codecov.io/bash)"

data/Gemfile

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2018-2019 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 NONINFRINGEMENT. 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.
+
+source 'https://rubygems.org'
+ruby '2.6.0'
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+(The MIT License)
+
+Copyright (c) 2018-2019 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 NONINFRINGEMENT. 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.

data/README.md

@@ -0,0 +1,78 @@
+<img src="http://www.zold.io/logo.svg" width="92px" height="92px"/>
+
+[![Donate via Zerocracy](https://www.0crat.com/contrib-badge/CAZPZR9FS.svg)](https://www.0crat.com/contrib/CAZPZR9FS)
+
+[![EO principles respected here](http://www.elegantobjects.org/badge.svg)](http://www.elegantobjects.org)
+[![Managed by Zerocracy](https://www.0crat.com/badge/CAZPZR9FS.svg)](https://www.0crat.com/p/CAZPZR9FS)
+[![DevOps By Rultor.com](http://www.rultor.com/b/yegor256/zold)](http://www.rultor.com/p/yegor256/zold)
+[![We recommend RubyMine](http://www.elegantobjects.org/rubymine.svg)](https://www.jetbrains.com/ruby/)
+
+[![Build Status](https://travis-ci.org/zold-io/zold-ruby-sdk.svg)](https://travis-ci.org/zold-io/zold-ruby-sdk)
+[![PDD status](http://www.0pdd.com/svg?name=zold-io/zold-ruby-sdk)](http://www.0pdd.com/p?name=zold-io/zold-ruby-sdk)
+[![Gem Version](https://badge.fury.io/rb/zold-ruby-sdk.svg)](http://badge.fury.io/rb/zold-ruby-sdk)
+[![Test Coverage](https://img.shields.io/codecov/c/github/zold-io/zold-ruby-sdk.svg)](https://codecov.io/github/zold-io/zold-ruby-sdk?branch=master)
+
+Here is the [White Paper](https://papers.zold.io/wp.pdf).
+
+Join our [Telegram group](https://t.me/zold_io) to discuss it all live.
+
+The license is [MIT](https://github.com/zold-io/zold-ruby-sdk/blob/master/LICENSE.txt).
+
+This is a simple Ruby SDK for making payments, checking balances, and finding transactions in
+Zold wallets via [WTS](https://wts.zold.io) system.
+
+First, you install it:
+
+```
+gem install zold-ruby-sdk
+```
+
+Then, you get your API key [here](https://wts.zold.io/api).
+
+The, you make an instance of class `Zold::WTS`:
+
+```ruby
+require 'zold/wts'
+wts = Zold::WTS.new(key)
+```
+
+Now you can pull your wallet and then check its balance:
+
+```ruby
+job = wts.pull # Initiate PULL and returns the unique ID of the job
+wts.wait(job) # Wait for the job to finish
+b = wts.balance # Retrieve the balance as an instance of Zold::Amount
+puts b
+```
+
+To make a payment you will need to know your
+[keygap](https://blog.zold.io/2018/07/18/keygap.html):
+
+```ruby
+job = wts.pay(keygap, 'yegor256', '19.95', 'For pizza') # Initiate a payment request
+wts.wait(job) # Wait for the job to finish
+```
+
+To find a payment in your wallet, you do this (don't forget to `pull` first):
+
+```ruby
+# Finds all payments that match this query and returns
+# an array of Zold::Txn objects.
+txns = wts.find(id: '123', details: /pizza/)
+```
+
+That's it.
+
+# How to contribute
+
+Read [these guidelines](https://www.yegor256.com/2014/04/15/github-guidelines.html).
+Make sure you build is green before you contribute
+your pull request. You will need to have [Ruby](https://www.ruby-lang.org/en/) 2.3+ and
+[Bundler](https://bundler.io/) installed. Then:
+
+```
+$ bundle update
+$ rake
+```
+
+If it's clean and you don't see any error messages, submit your pull request.

data/Rakefile

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2018-2019 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 NONINFRINGEMENT. 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 'rubygems'
+require 'rake'
+require 'rdoc'
+require 'rake/clean'
+
+def name
+  @name ||= File.basename(Dir['*.gemspec'].first, '.*')
+end
+
+def version
+  Gem::Specification.load(Dir['*.gemspec'].first).version
+end
+
+task default: %i[clean test rubocop copyright]
+
+require 'rake/testtask'
+desc 'Run all unit tests'
+Rake::TestTask.new(:test) do |test|
+  ENV['TEST_QUIET_LOG'] = 'true' if ARGV.include?('--quiet')
+  Rake::Cleaner.cleanup_files(['coverage'])
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+  test.warning = false
+end
+
+require 'rdoc/task'
+desc 'Build RDoc documentation'
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "#{name} #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+require 'rubocop/rake_task'
+desc 'Run RuboCop on all directories'
+RuboCop::RakeTask.new(:rubocop) do |task|
+  task.fail_on_error = true
+  task.requires << 'rubocop-rspec'
+end
+
+task :copyright do
+  sh "grep -q -r '2018-#{Date.today.strftime('%Y')}' \
+    --include '*.rb' \
+    --include '*.txt' \
+    --include 'Rakefile' \
+    ."
+end

data/lib/zold/wts.rb

@@ -0,0 +1,199 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2018-2019 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 'typhoeus'
+require 'cgi'
+require 'zold/age'
+require 'zold/amount'
+require 'zold/id'
+require 'zold/txn'
+
+# WTS gateway.
+#
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2018-2019 Yegor Bugayenko
+# License:: MIT
+module Zold
+  # WTS
+  class WTS
+    # Makes a new object of the class. The <tt>key</tt> you are supposed
+    # to obtain at this page: https://wts.zold.io/api. You will have to login
+    # and confirm your account first. Keep this key secret, to avoid
+    # information lost. However, even knowing the secret no payments can
+    # be sent without they keygap.
+    def initialize(key, log: STDOUT)
+      raise 'Key can\'t be nil' if key.nil?
+      @key = key
+      raise 'Log can\'t be nil' if log.nil?
+      @log = log
+    end
+
+    # Initiate PULL request. The server will pull your wallet form the network,
+    # and make it ready for future requests. Without this operation you won't
+    # be able to perform <tt>find()</tt> or <tt>balance()</tt> requests.
+    #
+    # The method returns the job ID, which you should wait for completion
+    # using the method <tt>wait()</tt>.
+    def pull
+      start = Time.now
+      job = job_of(
+        clean(
+          Typhoeus::Request.get(
+            'https://wts.zold.io/pull',
+            headers: headers
+          )
+        )
+      )
+      debug("PULL job #{job} started in #{Zold::Age.new(start)}")
+      job
+    end
+
+    # Get wallet balance.
+    def balance
+      start = Time.now
+      http = clean(
+        Typhoeus::Request.get(
+          'https://wts.zold.io/balance',
+          headers: headers
+        )
+      )
+      balance = Zold::Amount.new(zents: http.body.to_i)
+      debug("Wallet balance #{balance} retrieved in #{Zold::Age.new(start)}")
+      balance
+    end
+
+    # Get wallet ID.
+    def id
+      start = Time.now
+      http = clean(
+        Typhoeus::Request.get(
+          'https://wts.zold.io/id',
+          headers: headers
+        )
+      )
+      id = Zold::Id.new(http.body.to_s)
+      debug("Wallet ID #{id} retrieved in #{Zold::Age.new(start)}")
+      id
+    end
+
+    # Initiate PAY request. The <tt>keygap</tt> is a string you get
+    # when you confirm the account. The <tt>bnf</tt> is the name of the
+    # GitHub account, the wallet ID or the invoice (up to you). The
+    # <tt>amount</tt> is the amount in ZLD, e.g. "19.99". The <tt>details</tt>
+    # is the text to add to the transaction.
+    #
+    # The method returns the job ID, which you should wait for completion
+    # using the method <tt>wait()</tt>.
+    def pay(keygap, bnf, amount, details)
+      start = Time.now
+      job = job_of(
+        clean(
+          Typhoeus::Request.post(
+            'https://wts.zold.io/do-pay',
+            headers: headers,
+            body: { keygap: keygap, bnf: bnf, amount: amount, details: details }
+          )
+        )
+      )
+      debug("PAY job #{job} started in #{Zold::Age.new(start)}")
+      job
+    end
+
+    # Find transactions by the criteria. All criterias are regular expressions
+    # and their summary result is concatenated by OR. For example, this request
+    # will return all transactions that have "pizza" in details OR which
+    # are coming from the root wallet:
+    #
+    #  find(details: /pizza/, bnf: '0000000000000000')
+    #
+    # The method returns an array of Zold::Txn objects.
+    def find(query)
+      start = Time.now
+      http = clean(
+        Typhoeus::Request.get(
+          'https://wts.zold.io/find?' + query.map do |k, v|
+            "#{CGI.escape(k.to_s)}=#{CGI.escape(v.to_s)}"
+          end.join('&'),
+          headers: headers
+        )
+      )
+      txns = http.body.split("\n").map { |t| Zold::Txn.parse(t) }
+      debug("#{txns.count} transactions found in #{Zold::Age.new(start)}")
+      txns
+    end
+
+    # Wait for the job to complete. If the job completes successfully, the
+    # method returns 'OK' in a few seconds (up to a few minutes). If the
+    # is some error, the exception will be raised.
+    def wait(job, time: 5 * 60)
+      start = Time.now
+      loop do
+        if Time.now - start > time
+          raise "Can't wait any longer for the job #{job} to complete"
+        end
+        http = Typhoeus::Request.get(
+          'https://wts.zold.io/job?id=' + job,
+          headers: headers
+        )
+        raise "Job #{job} not found on the server" if http.code == 404
+        raise "Unpredictable response code #{http.code}" unless http.code == 200
+        next if http.body == 'Running'
+        raise http.body unless http.body == 'OK'
+        debug("Job #{job} completed, in #{Zold::Age.new(start)}")
+        return http.body
+      end
+    end
+
+    private
+
+    def headers
+      {
+        'X-Zold-WTS': @key,
+        'User-Agent': 'zold-ruby-sdk'
+      }
+    end
+
+    def job_of(http)
+      job = http.headers['X-Zold-Job']
+      raise 'Job ID is not returned, for some reason' if job.nil?
+      job
+    end
+
+    def clean(http)
+      error = http.headers['X-Zold-Error']
+      raise error unless error.nil?
+      unless http.code == 200 || http.code == 302
+        debug(http.body)
+        raise "Unexpected response code #{http.code}"
+      end
+      http
+    end
+
+    def debug(msg)
+      if @log.respond_to?(:debug)
+        @log.debug(msg)
+      elsif @log.respond_to?(:puts)
+        @log.puts(msg)
+      end
+    end
+  end
+end

data/test/zold/test_wts.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2018-2019 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/zold/wts'
+
+# WTS test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2018-2019 Yegor Bugayenko
+# License:: MIT
+class TestWTS < Minitest::Test
+  KEY = '8HNxjYuEFp0....LYOWxsEaC3rQ=='
+
+  def test_pulls
+    skip if KEY.length < 50
+    wts = Zold::WTS.new(KEY)
+    job = wts.pull
+    wts.wait(job)
+    assert(!job.nil?)
+  end
+
+  def test_finds_transactions
+    skip if KEY.length < 50
+    wts = Zold::WTS.new(KEY)
+    job = wts.pull
+    wts.wait(job)
+    assert_equal(1, wts.find(details: /^for hosting$/).count)
+  end
+
+  def test_retrieves_wallet_id
+    skip if KEY.length < 50
+    wts = Zold::WTS.new(KEY)
+    assert(!wts.id.nil?)
+  end
+
+  def test_retrieves_balance
+    skip if KEY.length < 50
+    wts = Zold::WTS.new(KEY)
+    job = wts.pull
+    wts.wait(job)
+    assert(!wts.balance.zero?)
+  end
+end

data/zold-ruby-sdk.gemspec

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2018-2019 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 NONINFRINGEMENT. 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 'English'
+Gem::Specification.new do |s|
+  s.specification_version = 2 if s.respond_to? :specification_version=
+  if s.respond_to? :required_rubygems_version=
+    s.required_rubygems_version = Gem::Requirement.new('>= 0')
+  end
+  s.rubygems_version = '2.2'
+  s.required_ruby_version = '>=2.5'
+  s.name = 'zold-ruby-sdk'
+  s.version = '0.1.0'
+  s.license = 'MIT'
+  s.summary = 'Zold score'
+  s.description = 'Ruby SDK for Zold online wallets management system (WTS)'
+  s.authors = ['Yegor Bugayenko']
+  s.email = 'yegor256@gmail.com'
+  s.homepage = 'http://github.com/zold-io/zold-ruby-sdk'
+  s.files = `git ls-files`.split($RS)
+  s.executables = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  s.test_files = s.files.grep(%r{^(test|features)/})
+  s.rdoc_options = ['--charset=UTF-8']
+  s.extra_rdoc_files = ['README.md', 'LICENSE.txt']
+  s.add_runtime_dependency 'typhoeus', '1.3.1'
+  s.add_runtime_dependency 'zold', '0.21.4'
+  s.add_development_dependency 'codecov', '0.1.14'
+  s.add_development_dependency 'minitest', '5.11.3'
+  s.add_development_dependency 'minitest-hooks', '1.5.0'
+  s.add_development_dependency 'rake-compiler', '1.0.4'
+  s.add_development_dependency 'rdoc', '4.3.0'
+  s.add_development_dependency 'rspec-rails', '3.8.1'
+  s.add_development_dependency 'rubocop', '0.62.0'
+  s.add_development_dependency 'rubocop-rspec', '1.31.0'
+end

metadata

@@ -0,0 +1,201 @@
+--- !ruby/object:Gem::Specification
+name: zold-ruby-sdk
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Yegor Bugayenko
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-01-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: typhoeus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.3.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.3.1
+- !ruby/object:Gem::Dependency
+  name: zold
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.21.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.21.4
+- !ruby/object:Gem::Dependency
+  name: codecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.14
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.14
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 5.11.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 5.11.3
+- !ruby/object:Gem::Dependency
+  name: minitest-hooks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.5.0
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.4
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.3.0
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.8.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.8.1
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.62.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.62.0
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.31.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.31.0
+description: Ruby SDK for Zold online wallets management system (WTS)
+email: yegor256@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+- LICENSE.txt
+files:
+- ".0pdd.yml"
+- ".gitattributes"
+- ".gitignore"
+- ".pdd"
+- ".rubocop.yml"
+- ".rultor.yml"
+- ".simplecov"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/zold/wts.rb
+- test/zold/test_wts.rb
+- zold-ruby-sdk.gemspec
+homepage: http://github.com/zold-io/zold-ruby-sdk
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--charset=UTF-8"
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.5'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.1
+signing_key: 
+specification_version: 2
+summary: Zold score
+test_files:
+- test/zold/test_wts.rb