# BitWallet

BitWallet is a Ruby-esque interface to a bitcoin daemon. It uses the [bitcoin-client](https://github.com/sinisterchipmunk/bitcoin-client) gem to execute the RPC calls to the daemon.

## Installation

Add this line to your application's Gemfile:

    gem 'bit_wallet'

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install bit_wallet

## Usage

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

### Transaction

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
- `confirmation`: 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

## Contributing

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