<img src=“https://travis-ci.org/sinisterchipmunk/bitcoin-client.png?branch=master” alt=“Build Status” /> <img src=“https://codeclimate.com/github/sinisterchipmunk/bitcoin-client.png” /> <img src=“https://coveralls.io/repos/sinisterchipmunk/bitcoin-client/badge.png” alt=“Coverage Status” />¶ ↑
mastercoin-clientProvides a Ruby library to the complete Bitcoin and Mastercoin JSON-RPC API. Implements all methods listed at en.bitcoin.it/wiki/Original_Bitcoin_client/API_Calls_list. Plus Mastercoin API functions at github.com/mastercoin-MSC/mastercore/blob/mscore-0.0.8/doc/apidocumentation.md Also supports customizing the host and port number to connect to.
¶ ↑
InstallationOn 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'
¶ ↑
UsageAs with most Ruby gems, you first need to require the library into your project:
require 'bitcoin'
After doing this, the simplest possible usage looks like this:
Mastercoin('username', 'password').balance # => 0.001
Or, if you prefer a somewhat more explicit representation, the following code performs the exact same task:
client = Mastercoin::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 Mastercoin # 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 SSLHere are several examples of how you can change the host information:
Mastercoin('username', 'password', :host => 'example.com', :port => 38332, :ssl => true) client = Mastercoin::Client.new('username', 'password', :host => 'example.com') client.port = 38332 client.ssl = true client.ssl? # => true include Mastercoin host 'example.com' port 38332 ssl? # => false ssl true ssl? # => true
You should see the Mastercoin::Client and Bitcoin::Client class documentation if you’d like to see the other options and methods that are made available.
¶ ↑
DonationsIf 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!