[](https://www.0crat.com/contrib/CAZPZR9FS) [](http://www.elegantobjects.org) [](https://www.0crat.com/p/CAZPZR9FS) [](http://www.rultor.com/p/yegor256/zold) [](https://www.jetbrains.com/ruby/) [](https://travis-ci.org/zold-io/zold-ruby-sdk) [](http://www.0pdd.com/p?name=zold-io/zold-ruby-sdk) [](http://badge.fury.io/rb/zold-ruby-sdk) [](https://codecov.io/github/zold-io/zold-ruby-sdk?branch=master) [](http://rubydoc.info/github/zold-io/zold-ruby-sdk/master/frames) [](https://github.com/yegor256/takes/blob/master/LICENSE.txt) [](https://hitsofcode.com/view/github/zold-io/zold-ruby-sdk) 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. This is a simple Ruby SDK for making payments, checking balances, and finding transactions in Zold wallets via [WTS](https://wts.zold.io) system. There are other languages too: [Java SDK](https://github.com/amihaiemil/zold-java-client). First, you install it: ```bash 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 $ bundle exec rake ``` If it's clean and you don't see any error messages, submit your pull request.