0.1
No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
Provides a Ruby library to the complete Bitcoin JSON-RPC API. Implements all methods listed at https://en.bitcoin.it/wiki/Original_Bitcoin_client/API_Calls_list and lets you set options such as the host and port number, and whether to use SSL.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.3
~> 0.9
~> 2.6

Runtime

 Project Readme

Provides a Ruby library to the complete Bitcoin JSON-RPC API. Implements all methods listed at en.bitcoin.it/wiki/Original_Bitcoin_client/API_Calls_list. Also supports customizing the host and port number to connect to.

Installation¶ ↑

On Ruby 1.9, you can just install the gem and start using it. On 1.8, the ‘json’ gem is also required, so you’ll need to install that first:

gem install json

Or, if you’re using Bundler (and you should be), just add it to the Gemfile:

gem 'json', '~> 1.5.3'

Usage¶ ↑

As with most Ruby gems, you first need to require the library into your project:

require 'bitcon_client'

After doing this, the simplest possible usage looks like this:

BitcoinClient('username', 'password').balance
# => 0.001

Or, if you prefer a somewhat more explicit representation, the following code performs the exact same task:

client = BitcoinClient::Client.new('username', 'password')
client.balance
# => 0.001

The third and final way to use the library is by taking advantage of a simple DSL:

include BitcoinClient

# set up credentials
username 'username'
password 'password'

balance
# => 0.001

accounts
# => {"account" => 0.001}

The RPC method names available to you are exactly the same as those listed on the Bitcoin wiki (again, that’s en.bitcoin.it/wiki/Original_Bitcoin_client/API_Calls_list). Some aliases have been added to make them more “ruby-ish,” but none of the original names have been changed.

Host, Port and SSL¶ ↑

Here are several examples of how you can change the host information:

BitcoinClient('username', 'password', :host => 'example.com', :port => 38332, :ssl => true)

client = BitcoinClient::Client.new('username', 'password', :host => 'example.com')
client.port = 38332
client.ssl = true
client.ssl?
# => true

include BitcoinClient
host 'example.com'
port 38332
ssl?
# => false
ssl true
ssl?
# => true

You should see the BitcoinClient::Client class documentation if you’d like to see the other options and methods that are made available.

Donations¶ ↑

If you found this library useful and feel inclined to compensate me for my trouble, I’m certainly not going to turn you down!

Bitcoin donations can be sent to:

1HawYer58J9Vy3iju1w7jsRVci5tzaxkwn

Thanks!