bit_wallet 0.0.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.rvmrc

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "spec/testnet"]
+	path = spec/testnet
+	url = git://github.com/freewil/bitcoin-testnet-box.git

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in bit_wallet.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 TODO: Write your name
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,37 @@
+# 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')
+    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.total_received # returns the total amount received by the account
+    address.total_received # returns the total amount received by the address
+
+## 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

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bit_wallet.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'bit_wallet/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "bit_wallet"
+  gem.version       = BitWallet::VERSION
+  gem.authors       = ["Ramon Tayag"]
+  gem.email         = ["ramon.tayag@gmail.com"]
+  gem.description   = %q{Ruby-esque handling of Bitcoin wallet}
+  gem.summary       = %q{Ruby-esque handling of Bitcoin wallet.}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency 'bitcoin-client', '0.0.1'
+  gem.add_dependency 'activesupport', '3.2.11'
+  gem.add_development_dependency 'rspec', '2.12.0'
+  gem.add_development_dependency 'pry'
+  gem.add_development_dependency 'factory_girl', '4.2.0'
+end

data/lib/bit_wallet/account.rb

@@ -0,0 +1,36 @@
+module BitWallet
+  class Account
+
+    attr_reader :wallet, :name
+    delegate :client, to: :wallet
+
+    def initialize(wallet, name)
+      @wallet = wallet
+      @name = name
+      self.addresses.new
+    end
+
+    def addresses
+      @addresses ||= Addresses.new(self)
+    end
+
+    def balance(min_conf=BitWallet.config.min_conf)
+      client.getbalance(self.name, min_conf)
+    end
+
+    def send_amount(amount, options={})
+      unless options[:to]
+        fail ArgumentError, 'address must be specified'
+      end
+      client.sendfrom(self.name,
+                      options[:to],
+                      amount,
+                      BitWallet.config.min_conf)
+    end
+
+    def total_received
+      client.getreceivedbyaccount(self.name, BitWallet.config.min_conf)
+    end
+
+  end
+end

data/lib/bit_wallet/accounts.rb

@@ -0,0 +1,36 @@
+module BitWallet
+  class Accounts < Array
+
+    attr_reader :wallet
+    delegate :client, to: :wallet
+
+    def initialize(wallet)
+      @wallet = wallet
+
+      existing_accounts.each do |name|
+        self.new(name)
+      end
+    end
+
+    def new(name)
+      if self.includes_account_name?(name)
+        account = self.find {|a| a.name == name}
+      else
+        account = BitWallet::Account.new(wallet, name)
+        self << account
+      end
+      account
+    end
+
+    def includes_account_name?(account_name)
+      self.find {|a| a.name == account_name}.present?
+    end
+
+    private
+
+    def existing_accounts
+      client.listaccounts.keys
+    end
+
+  end
+end

data/lib/bit_wallet/address.rb

@@ -0,0 +1,22 @@
+module BitWallet
+  class Address
+
+    attr_reader :account, :address
+    delegate :wallet, to: :account
+    delegate :client, to: :wallet
+
+    def initialize(account, address=nil)
+      @account = account
+      @address = if address
+                   address
+                 else
+                   client.getnewaddress(@account.name)
+                 end
+    end
+
+    def total_received
+      client.getreceivedbyaddress(self.address, BitWallet.config.min_conf)
+    end
+
+  end
+end

data/lib/bit_wallet/addresses.rb

@@ -0,0 +1,17 @@
+module BitWallet
+  class Addresses < Array
+
+    attr_reader :account
+
+    def initialize(account)
+      @account = account
+    end
+
+    def new(address_str=nil)
+      address = Address.new(@account, address_str)
+      self << address
+      address
+    end
+
+  end
+end

data/lib/bit_wallet/version.rb

@@ -0,0 +1,3 @@
+module BitWallet
+  VERSION = '0.0.1'
+end

data/lib/bit_wallet/wallet.rb

@@ -0,0 +1,21 @@
+module BitWallet
+  class Wallet
+
+    def initialize(config={})
+      @config = config
+    end
+
+    def accounts
+      @accounts ||= Accounts.new(self)
+    end
+
+    private
+
+    def client
+      @client ||= Bitcoin::Client.new(@config[:username],
+                                      @config[:password],
+                                      @config.slice(:port))
+    end
+
+  end
+end

data/lib/bit_wallet.rb

@@ -0,0 +1,23 @@
+require "bit_wallet/version"
+require 'ostruct'
+require 'active_support/core_ext/module/attribute_accessors'
+require 'active_support/core_ext/module/delegation'
+require 'active_support/core_ext/string'
+require 'bitcoin'
+
+require 'bit_wallet/wallet'
+require 'bit_wallet/account'
+require 'bit_wallet/accounts'
+require 'bit_wallet/addresses'
+require 'bit_wallet/address'
+
+module BitWallet
+
+  mattr_accessor :config
+  @@config = OpenStruct.new
+
+  def self.at(*args)
+    Wallet.new(*args)
+  end
+
+end

data/rvmrc.sample

@@ -0,0 +1 @@
+rvm use ruby-1.9.3-p286

data/spec/bit_wallet/account_spec.rb

@@ -0,0 +1,80 @@
+require 'spec_helper'
+
+describe BitWallet::Account do
+
+  let(:wallet) { build(:wallet) }
+  subject { described_class.new(wallet, 'name') }
+
+  its(:wallet) {should == wallet}
+  its(:addresses) { should be_kind_of(BitWallet::Addresses) }
+
+  describe 'on initialization' do
+    it 'should have a default name' do
+      subject.name.should_not be_blank
+      subject.name.should be_kind_of(String)
+    end
+
+    it 'should be assigned that name' do
+      wallet = BitWallet::Wallet.new(Config.slice(:username,
+                                                  :port,
+                                                  :password))
+      account = wallet.accounts.new('nona')
+
+      wallet.accounts.includes_account_name?('nona').should be_true
+    end
+
+    context 'when the account name already exists' do
+      it 'should return that same address' do
+        wallet = BitWallet::Wallet.new(Config.slice(:username,
+                                                    :port,
+                                                    :password))
+        account = wallet.accounts.new('nona')
+
+        expect {
+          wallet.accounts.new('nona')
+        }.to_not change(wallet.accounts, :size)
+      end
+    end
+  end
+
+  describe '#balance' do
+    subject { wallet.accounts.new('nona') }
+
+    it 'should return the balance of the account' do
+      subject.balance.should ==
+        subject.client.getbalance(subject.name, BitWallet.config.min_conf)
+    end
+
+    it 'should default to the config min_conf' do
+      BitWallet.config.min_conf = 2
+      subject.client.should_receive(:getbalance).with(subject.name, 2)
+      subject.balance(2)
+    end
+
+    it 'should be able to override the min_conf' do
+      subject.client.should_receive(:getbalance).with(subject.name, 'min_conf')
+      subject.balance('min_conf')
+    end
+  end
+
+  describe '#send_amount' do
+    it 'should send money to the given address' do
+      default_account = wallet.accounts.new('')
+      nona_account = wallet.accounts.new('nona')
+      nona_address_str = nona_account.addresses.first.address
+      expected_balance = nona_account.balance + 5.5
+      default_account.send_amount 5.5, to: nona_address_str
+      nona_account.balance.should == expected_balance
+    end
+  end
+
+  describe '#total_received' do
+    it 'should return the total amount received by the address' do
+      subject.client.stub(:getreceivedbyaccount).
+        with(subject.name, BitWallet.config.min_conf).
+        and_return(2.1)
+      subject.total_received.should == 2.1
+    end
+  end
+
+end

data/spec/bit_wallet/accounts_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe BitWallet::Accounts do
+
+  let(:wallet) do
+    build(:wallet)
+  end
+
+  subject do
+    BitWallet::Accounts.new(wallet)
+  end
+
+  its(:wallet) { should == wallet }
+
+  describe '#new' do
+    it 'should create a new BitWallet::Account with a default address' do
+      account = wallet.accounts.new('accountname')
+      account.should be_kind_of(BitWallet::Account)
+      account.addresses.count.should == 1
+    end
+  end
+
+  describe '#includes_account_name?(account)' do
+    it 'should return true if the array includes the account' do
+      account = subject.new('accountname')
+      subject.includes_account_name?('accountname').should == true
+    end
+  end
+
+end

data/spec/bit_wallet/address_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+
+describe BitWallet::Address do
+
+  let(:account) { build(:account) }
+  subject { build(:address, account: account) }
+
+  its(:account) { should == account }
+
+  describe 'on initialization' do
+    context 'no address is given' do
+      it 'should create an address' do
+        address = described_class.new(account)
+        address.address.should_not be_blank
+      end
+    end
+
+    context 'address given already exists' do
+      it 'should not create an address' do
+        described_class.new(account, 'addr')
+        expect {
+          described_class.new(account, 'addr')
+        }.to_not change(account.addresses, :count)
+      end
+    end
+  end
+
+  describe '#total_received' do
+    it 'should return the total amount received by the address' do
+      subject.client.stub(:getreceivedbyaddress).
+        with(subject.address, BitWallet.config.min_conf).
+        and_return(2.1)
+      subject.total_received.should == 2.1
+    end
+  end
+
+end

data/spec/bit_wallet/addresses_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe BitWallet::Addresses do
+
+  let(:account) { build(:account) }
+  subject { BitWallet::Addresses.new(account) }
+
+  its(:account) { should == account }
+  its(:new) { should be_kind_of(BitWallet::Address) }
+
+  describe '#new' do
+    context 'without any address string given' do
+      it 'should return an Address that points to the same account' do
+        subject.new.account.should == account
+      end
+    end
+
+    context 'with address string given' do
+      it 'should return an Address with the given address string' do
+        subject.new('myaddress').address.should == 'myaddress'
+      end
+    end
+  end
+
+end

data/spec/bit_wallet/wallet_spec.rb

@@ -0,0 +1,12 @@
+require 'spec_helper'
+
+describe BitWallet::Wallet do
+
+  describe '#accounts' do
+    it 'should return array of BitWallet::Accounts' do
+      wallet = build(:wallet)
+      wallet.accounts.should be_kind_of(BitWallet::Accounts)
+    end
+  end
+
+end

data/spec/bit_wallet_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe BitWallet do
+
+  describe '.config' do
+    it 'should be a configurable object' do
+      described_class.config.min_conf = 22
+      described_class.config.min_conf.should == 22
+    end
+  end
+
+  describe '.at' do
+    it 'should wrap the a wallet wrapping the Bitcoin client' do
+      wallet = double
+      BitWallet::Wallet.should_receive(:new).with(args: 'a').and_return(wallet)
+      described_class.at(args: 'a').should == wallet
+    end
+  end
+
+end

data/spec/config.yml

@@ -0,0 +1,3 @@
+rpcport: 19001
+rpcuser: admin1
+rpcpassword: 123

data/spec/factories.rb

@@ -0,0 +1,24 @@
+FactoryGirl.define do
+
+  factory :wallet, class: BitWallet::Wallet do
+    initialize_with { BitWallet::Wallet.new(Config.slice(:username,
+                                                         :password,
+                                                         :port)) }
+  end
+
+  factory :account, class: BitWallet::Account do
+    ignore do
+      wallet { build(:wallet) }
+      name { 'name' }
+    end
+    initialize_with { BitWallet::Account.new(wallet, name) }
+  end
+
+  factory :address, class: BitWallet::Address do
+    ignore do
+      account { build(:account) }
+    end
+    initialize_with { BitWallet::Address.new(account) }
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,37 @@
+require 'bundler/setup'
+APP_ENV = 'test'
+Bundler.require(APP_ENV)
+
+require 'bit_wallet'
+require 'ostruct'
+require 'active_support/core_ext/hash/indifferent_access'
+require 'active_support/core_ext/hash/slice'
+require 'pry'
+require 'factory_girl'
+require_relative 'factories'
+
+Config = {}
+yaml_config_file = File.open(File.join(File.dirname(__FILE__), 'config.yml'))
+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')
+
+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

@@ -0,0 +1,159 @@
+--- !ruby/object:Gem::Specification
+name: bit_wallet
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Ramon Tayag
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bitcoin-client
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.1
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.2.11
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.2.11
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: factory_girl
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.2.0
+description: Ruby-esque handling of Bitcoin wallet
+email:
+- ramon.tayag@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .gitmodules
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bit_wallet.gemspec
+- lib/bit_wallet.rb
+- lib/bit_wallet/account.rb
+- lib/bit_wallet/accounts.rb
+- lib/bit_wallet/address.rb
+- lib/bit_wallet/addresses.rb
+- lib/bit_wallet/version.rb
+- lib/bit_wallet/wallet.rb
+- rvmrc.sample
+- spec/bit_wallet/account_spec.rb
+- spec/bit_wallet/accounts_spec.rb
+- spec/bit_wallet/address_spec.rb
+- spec/bit_wallet/addresses_spec.rb
+- spec/bit_wallet/wallet_spec.rb
+- spec/bit_wallet_spec.rb
+- spec/config.yml
+- spec/factories.rb
+- spec/spec_helper.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Ruby-esque handling of Bitcoin wallet.
+test_files:
+- spec/bit_wallet/account_spec.rb
+- spec/bit_wallet/accounts_spec.rb
+- spec/bit_wallet/address_spec.rb
+- spec/bit_wallet/addresses_spec.rb
+- spec/bit_wallet/wallet_spec.rb
+- spec/bit_wallet_spec.rb
+- spec/config.yml
+- spec/factories.rb
+- spec/spec_helper.rb
+has_rdoc: