BitWallet is a Ruby-esque interface to a bitcoin daemon. It uses the bitcoin-client gem to execute the RPC calls to the daemon.


Add this line to your application's Gemfile:

gem 'bit_wallet'

And then execute:

$ bundle

Or install it yourself as:

$ gem install bit_wallet


wallet = => 'username', :password => 'password')
# You can also pass :port, :host, :ssl (Boolean)

wallet.accounts.with_balance # returns array of the accounts with balance > 0
 ='account name')
.addresses.count # 1, as it already comes with an address
.balance # returns the balance of the account
address =
address.address # 8hdsakdjh82d9327ccb64642c - the address hash
.send_amount 5.5, to: '8hdsakdjh82d9327ccb64642c' # sends 5.5 bitcoin to the address
.send_amount 5.5, to: address # sends 5.5 bitcoin to the BitWallet::Address#address
.send_many '8hdsakdjh82d9327ccb64642c' => 2.21, address => 0.332
wallet.move 'accountname', 'toanotheraccount', 2.1
wallet.move , , 1.1
.total_received # returns the total amount received by the account
.transactions # returns array of 10 BitWallet::Transaction
.transactions(limit: 5) # returns array of 5 BitWallet::Transaction
address.total_received # returns the total amount received by the address


A transaction has the following methods:

  • account: the account it belongs to
  • address: the address it belongs to
  • amount: how much was transferred
  • category: returns the category value of the transaction
  • confirmations: how many times this has been confirmed by the network
  • id: the transaction id
  • occurred_at: Ruby Time object for the time value returned by bitcoind
  • received_at: Ruby Time object for the timereceived value returned by bitcoind


  • You must set up bitcoind, and it must be in the executable path. See README.txt in spec/testnet as to what version to install.


I suggest you do your development in this Vagrant box. I use it for my development.

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

If you find this useful, consider sharing some BTC love: 1PwQWijmJ39hWXk9X3CdAhEdExdkANEAPk