bit_wallet 0.0.3 → 0.1.0

data/README.md

@@ -19,15 +19,32 @@ Or install it yourself as:
 ## 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

data/bit_wallet.gemspec

@@ -22,4 +22,5 @@ Gem::Specification.new do |gem|
   gem.add_development_dependency 'rspec', '2.12.0'
   gem.add_development_dependency 'pry'
   gem.add_development_dependency 'factory_girl', '4.2.0'
+  gem.add_development_dependency 'bitcoin_testnet', '0.0.1'
 end

data/lib/bit_wallet/account.rb

@@ -19,9 +19,12 @@ module BitWallet
     end
 
     def send_amount(amount, options={})
-      unless options[:to]
+      if options[:to]
+        options[:to] = options[:to].address if options[:to].is_a?(Address)
+      else
         fail ArgumentError, 'address must be specified'
       end
+
       client.sendfrom(self.name,
                       options[:to],
                       amount,
@@ -34,6 +37,15 @@ module BitWallet
       client.getreceivedbyaccount(self.name, BitWallet.config.min_conf)
     end
 
+    def ==(other_account)
+      self.name == other_account.name
+    end
+
+    def recent_transactions(options={})
+      count = options.delete(:limit) || 10
+      client.listtransactions self.name, count
+    end
+
     private
 
     def parse_error(response)

data/lib/bit_wallet/accounts.rb

@@ -4,6 +4,10 @@ module BitWallet
     attr_reader :wallet
     delegate :client, to: :wallet
 
+    def with_balance
+      self.select { |account| account.balance > 0 }
+    end
+
     def initialize(wallet)
       @wallet = wallet
 

data/lib/bit_wallet/address.rb

@@ -18,5 +18,9 @@ module BitWallet
       client.getreceivedbyaddress(self.address, BitWallet.config.min_conf)
     end
 
+    def ==(other_address)
+      self.address == other_address.address
+    end
+
   end
 end

data/lib/bit_wallet/transaction.rb

@@ -0,0 +1,32 @@
+module BitWallet
+  class Transaction
+
+    attr_reader(:account,
+                :amount,
+                :category,
+                :confirmations,
+                :id,
+                :occurred_at,
+                :received_at)
+
+    def initialize(wallet, args)
+      args = args.with_indifferent_access
+      @wallet = wallet
+      @account = wallet.accounts.new(args[:account])
+      @id = args[:txid]
+      @address_str = args[:address]
+      @amount = args[:amount]
+      @confirmations = args[:confirmations]
+      @occurred_at = Time.at(args[:time])
+      @received_at = Time.at(args[:timereceived])
+      @category = args[:category]
+    end
+
+    def address
+      @address ||= @account.addresses.find do |address|
+        address.address == @address_str
+      end
+    end
+
+  end
+end

data/lib/bit_wallet/version.rb

@@ -1,3 +1,3 @@
 module BitWallet
-  VERSION = '0.0.3'
+  VERSION = '0.1.0'
 end

data/lib/bit_wallet/wallet.rb

@@ -9,6 +9,13 @@ module BitWallet
       @accounts ||= Accounts.new(self)
     end
 
+    def recent_transactions(options={})
+      count = options.delete(:limit) || 10
+      client.listtransactions(nil, count).map do |hash|
+        Transaction.new self, hash
+      end
+    end
+
     private
 
     def client

data/lib/bit_wallet.rb

@@ -11,6 +11,7 @@ require 'bit_wallet/account'
 require 'bit_wallet/accounts'
 require 'bit_wallet/addresses'
 require 'bit_wallet/address'
+require 'bit_wallet/transaction'
 require 'bit_wallet/errors'
 
 module BitWallet

data/spec/bit_wallet/account_spec.rb

@@ -67,6 +67,18 @@ describe BitWallet::Account do
       nona_account.balance.should == expected_balance
     end
 
+    context ':to is a BitWallet::Address' do
+      it 'should send it to the #address of the given BitWallet::Address' do
+        default_account = wallet.accounts.new('')
+        nona_account = wallet.accounts.new('nona')
+        nona_address = nona_account.addresses.first
+
+        expected_balance = nona_account.balance + 5.2
+        default_account.send_amount 5.2, to: nona_address
+        nona_account.balance.should == expected_balance
+      end
+    end
+
     context 'account does not have enough money' do
       it 'should fail with the InsufficientFunds error' do
         default_account = wallet.accounts.new('')
@@ -89,4 +101,32 @@ describe BitWallet::Account do
     end
   end
 
+  describe '#recent_transactions' do
+    it 'should default to list 10 transactions' do
+      wallet = build(:wallet)
+      default_account = wallet.accounts.new('')
+      account_1 = wallet.accounts.new('1')
+
+      1.upto(11).each do |n|
+        default_account.send_amount n, to: account_1.addresses.first
+      end
+
+      account_1.recent_transactions.size.should == 10
+    end
+
+    context 'when transaction limit is 5' do
+      it 'should list the 5 most recent transactions' do
+        wallet = build(:wallet)
+        default_account = wallet.accounts.new('')
+        account_1 = wallet.accounts.new('1')
+
+        1.upto(6).each do |n|
+          default_account.send_amount n, to: account_1.addresses.first
+        end
+
+        account_1.recent_transactions(limit: 5).size.should == 5
+      end
+    end
+  end
+
 end

data/spec/bit_wallet/accounts_spec.rb

@@ -27,4 +27,23 @@ describe BitWallet::Accounts do
     end
   end
 
+  describe '.with_balance' do
+    it 'should return accounts with a balance > 0' do
+      default_account = subject.new('')
+      account_1 = subject.new('nomoney')
+      account_2 = subject.new('moneyd')
+
+      default_account.send_amount 10, to: account_2.addresses.first
+
+      accounts_with_balance = subject.with_balance
+      accounts_with_balance.should include(default_account)
+      accounts_with_balance.should_not include(account_1)
+      accounts_with_balance.should include(account_2)
+
+      account_1.send_amount account_1.balance, to: default_account.addresses.first
+
+      subject.with_balance.should_not include(account_1)
+    end
+  end
+
 end

data/spec/bit_wallet/transaction_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe BitWallet::Transaction do
+
+  describe 'on initialization' do
+    it 'should be able to take a bitcoind hash' do
+      wallet = build(:wallet)
+      account = wallet.accounts.new('numba')
+      address = account.addresses.new('mi3G43CcN')
+      args = {"account" => 'numba',
+              "address" => "mi3G43CcN",
+              "category" => "receive",
+              "amount" => 1.5,
+              "confirmations" => 0,
+              "txid" => "a363e027",
+              "time" => 1362239334,
+              "timereceived" => 1362239346}
+      transaction = described_class.new(wallet, args)
+      transaction.account.should == account
+      transaction.address.should == address
+      transaction.category.should == 'receive'
+      transaction.amount.should == 1.5
+      transaction.confirmations.should == 0
+      transaction.id.should == 'a363e027'
+      transaction.occurred_at.to_i.should == 1362239334
+      transaction.received_at.to_i.should == 1362239346
+    end
+  end
+
+end

data/spec/bit_wallet/wallet_spec.rb

@@ -9,4 +9,31 @@ describe BitWallet::Wallet do
     end
   end
 
+  describe '#recent_transactions' do
+    it 'should return the most recent transactions of all accounts defaulting to 10 transactions' do
+      wallet = build(:wallet)
+      default_account = wallet.accounts.new('')
+      account_1 = wallet.accounts.new('1')
+
+      1.upto(11).each do |n|
+        default_account.send_amount n, to: account_1.addresses.first
+      end
+
+      wallet.recent_transactions.size.should == 10
+    end
+
+    it 'should allow overriding of the transaction limit' do
+      pending "Fix when bitcoin-client this is resolved: https://github.com/sinisterchipmunk/bitcoin-client/issues/4"
+      wallet = build(:wallet)
+      default_account = wallet.accounts.new('')
+      account_1 = wallet.accounts.new('1')
+
+      1.upto(11).each do |n|
+        default_account.send_amount n, to: account_1.addresses.first
+      end
+
+      wallet.recent_transactions(limit: 5).size.should == 5
+    end
+  end
+
 end

data/spec/spec_helper.rb

@@ -1,6 +1,6 @@
 require 'bundler/setup'
 APP_ENV = 'test'
-Bundler.require(APP_ENV)
+Bundler.require(:default, APP_ENV)
 
 require 'bit_wallet'
 require 'ostruct'
@@ -9,6 +9,7 @@ require 'active_support/core_ext/hash/slice'
 require 'pry'
 require 'factory_girl'
 require_relative 'factories'
+require 'bitcoin_testnet'
 
 Config = {}
 yaml_config_file = File.open(File.join(File.dirname(__FILE__), 'config.yml'))
@@ -16,22 +17,14 @@ yaml_config = YAML.load(yaml_config_file).with_indifferent_access
 Config[:username] = yaml_config[:rpcuser]
 Config[:port] = yaml_config[:rpcport]
 Config[:password] = yaml_config[:rpcpassword]
-TESTNET_DIR = File.join(File.dirname(__FILE__), 'testnet')
+
+BitcoinTestnet.configure_rspec!
+BitcoinTestnet.dir = File.join(File.dirname(__FILE__), 'testnet')
 
 RSpec.configure do |config|
   config.include FactoryGirl::Syntax::Methods
-  config.before(:suite) do
-    # Ensure that the testnet is running.
-    bitcoin_processes = `ps -ef | grep bitcoin | grep -v grep`.split("\n")
-    unless bitcoin_processes.size == 2
-      fail "Please make sure the testnet has started. Run `cd #{TESTNET_DIR} && make start`"
-    end
-  end
 
   config.before(:each) do
-    system("cd #{TESTNET_DIR} && make clean > /dev/null")
-
-    # Do not wait for confirmations in tests -- too long!
     BitWallet.config.min_conf = 0
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bit_wallet
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-01 00:00:00.000000000 Z
+date: 2013-03-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bitcoin-client
@@ -91,6 +91,22 @@ dependencies:
     - - '='
       - !ruby/object:Gem::Version
         version: 4.2.0
+- !ruby/object:Gem::Dependency
+  name: bitcoin_testnet
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.1
 description: Ruby-esque handling of Bitcoin wallet
 email:
 - ramon.tayag@gmail.com
@@ -110,6 +126,8 @@ files:
 - lib/bit_wallet/accounts.rb
 - lib/bit_wallet/address.rb
 - lib/bit_wallet/addresses.rb
+- lib/bit_wallet/errors.rb
+- lib/bit_wallet/transaction.rb
 - lib/bit_wallet/version.rb
 - lib/bit_wallet/wallet.rb
 - rvmrc.sample
@@ -117,7 +135,7 @@ files:
 - spec/bit_wallet/accounts_spec.rb
 - spec/bit_wallet/address_spec.rb
 - spec/bit_wallet/addresses_spec.rb
-- spec/bit_wallet/errors.rb
+- spec/bit_wallet/transaction_spec.rb
 - spec/bit_wallet/wallet_spec.rb
 - spec/bit_wallet_spec.rb
 - spec/config.yml
@@ -152,7 +170,7 @@ test_files:
 - spec/bit_wallet/accounts_spec.rb
 - spec/bit_wallet/address_spec.rb
 - spec/bit_wallet/addresses_spec.rb
-- spec/bit_wallet/errors.rb
+- spec/bit_wallet/transaction_spec.rb
 - spec/bit_wallet/wallet_spec.rb
 - spec/bit_wallet_spec.rb
 - spec/config.yml