dogecoin-client 0.0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ed8a191e38c223a2ad66b5743b0a436ce9686775
+  data.tar.gz: b07d1916800f7c3b8c3b342bc0346b1b5a88fcb6
+SHA512:
+  metadata.gz: 8c00236aa985180ee251ad90d5588f2a2e2452bd1eeeefda522b792ef77403ea56a60cf79231394b30e1a2ba5ce2a08fb06f9460a7a73516691393af4894b355
+  data.tar.gz: 37f5fedd23d786e170d018c01026feeb772c3979b2b065f59712b38042441631c544e7f1996f39875068ca64383e7a85762f16fd32f4a91936a2326fa5890c62

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+coverage

data/.travis.yml

@@ -0,0 +1,18 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0
+  - ree
+  - jruby
+  - ruby-head
+  - rbx-2.0
+
+matrix:
+  allow_failures:
+    - rvm: rbx-2.0
+    - rvm: jruby
+    - rvm: ruby-head
+    - rvm: 1.8.7
+    - rvm: ree
+    - rvm: 1.9.2

data/Gemfile

@@ -0,0 +1,13 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in dogecoin-client.gemspec
+gemspec
+
+platforms :ruby_18 do
+  gem 'json'
+end
+
+platforms :jruby do
+  gem 'json'
+  gem 'jruby-openssl'
+end

data/README.rdoc

@@ -0,0 +1,71 @@
+== dogecoin-ruby
+
+Provides a Ruby library to the complete Dogecoin JSON-RPC API. 
+
+== Installation
+
+On 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
+
+== Usage
+
+As with most Ruby gems, you first need to require the library into your project:
+
+  require 'dogecoin'
+
+After doing this, the simplest possible usage looks like this:
+
+  Dogecoin('username', 'password').balance
+  # => 0.001
+
+Or, if you prefer a somewhat more explicit representation, the following code performs the exact
+same task:
+
+  client = Dogecoin::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 Dogecoin
+  
+  # set up credentials
+  username 'username'
+  password 'password'
+  
+  balance
+  # => 0.001
+  
+  accounts
+  # => {"account" => 0.001}
+  
+== Host, Port and SSL
+
+Here are several examples of how you can change the host information:
+
+  
+  Dogecoin('username', 'password', :host => 'example.com', :port => 22555, :ssl => true)
+  client = Dogecoin::Client.new('username', 'password', :host => 'example.com')
+  client.port = 22555
+  port 22555
+  ssl?
+  # => false
+  ssl true
+  ssl?
+  # => true
+
+You should see the Dogecoin::Client class documentation if you'd like to see the other options and methods
+that are made available.
+
+
+== Donations
+
+If you found this library useful and feel inclined to compensate me for my trouble, I'm certainly not going to turn you down!
+
+Dogecoin donations can be sent to:
+
+  DNjbbUqsNipNkPeoEit5maYryxAJdLCWz8
+
+Thanks!
+

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+desc 'Default: run specs.'
+task :default => :spec
+
+desc "Run specs"
+RSpec::Core::RakeTask.new

data/dogecoin-client.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "dogecoin/version"
+
+Gem::Specification.new do |s|
+  s.licenses    = [ 'MIT' ]
+  s.name        = "dogecoin-client"
+  s.version     = Dogecoin::VERSION
+  s.authors     = ["Anthony Eufemio"]
+  s.email       = ["tymat@pris.im"]
+  s.homepage    = "http://github.com/tymat/dogecoin-client"
+  s.summary     = %q{Provides a Ruby library to the complete Dogecoin JSON-RPC API.}
+  s.description = "Provides a Ruby library to the complete Dogecoin JSON-RPC API. "
+
+  s.rubyforge_project = "dogecoin-client"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "rake",    '~> 0.9'
+  s.add_development_dependency "bundler"
+  s.add_development_dependency "rspec",   '~> 2.6'
+  s.add_development_dependency "fakeweb", '~> 1.3'
+  s.add_development_dependency "coveralls"
+  s.add_runtime_dependency "rest-client"
+end

data/lib/dogecoin/api.rb

@@ -0,0 +1,33 @@
+class Dogecoin::API
+  attr_reader :options
+  attr_reader :params
+  
+  def user; options[:user]; end
+  def pass; options[:pass]; end
+  def host; options[:host]; end
+  def port; options[:port]; end
+  def ssl;  options[:ssl];  end
+  def ssl?; options[:ssl];  end
+  def user=(a); options[:user] = a; end
+  def pass=(a); options[:pass] = a; end
+  def host=(a); options[:host] = a; end
+  def port=(a); options[:port] = a; end
+  def ssl=(a);  options[:ssl]  = a; end
+
+  def initialize(options = {})
+    @options = {
+      :host => 'localhost',
+      :port => 22555,
+      :ssl  => false
+    }.merge(options)
+  end
+  
+  def to_hash
+    @options.dup
+  end
+  
+  def request(service_name, *params)
+    req = Dogecoin::Request.new(service_name, params)
+    Dogecoin::RPC.new(to_hash).dispatch(req)
+  end
+end

data/lib/dogecoin/client.rb

@@ -0,0 +1,279 @@
+class Dogecoin::Client
+  attr_reader :api
+  def user; api.user; end
+  def pass; api.pass; end
+  def host; api.host; end
+  def port; api.port; end
+  def ssl;  api.ssl;  end
+  def ssl?; api.ssl?; end
+  def user=(a); api.user = a; end
+  def pass=(a); api.pass = a; end
+  def host=(a); api.host = a; end
+  def port=(a); api.port = a; end
+  def ssl=(a);  api.ssl  = a; end
+
+  def options
+    api.options
+  end
+
+  def initialize(user, pass, options = {})
+    @api = Dogecoin::API.new({ :user => user, :pass => pass }.merge(options))
+  end
+
+  # Safely copies wallet.dat to destination, which can be a directory or a path with filename.
+  def backupwallet(destination)
+    @api.request 'backupwallet', destination
+  end
+
+  # Returns the account associated with the given address.
+  def getaccount(dogecoinaddress)
+    @api.request 'getaccount', dogecoinaddress
+  end
+
+  # Returns the current dogecoin address for receiving payments to this account.
+  def getaccountaddress(account)
+    @api.request 'getaccountaddress', account
+  end
+
+  # Returns the list of addresses for the given account.
+  def getaddressesbyaccount(account)
+    @api.request 'getaddressesbyaccount', account
+  end
+
+  # If +account+ is not specified, returns the server's total available balance.
+  # If +account+ is specified, returns the balance in the account.
+  def getbalance(account = nil, minconf = 1)
+    @api.request 'getbalance', account, minconf
+  end
+
+  # Dumps the block existing at specified height.
+  # Note: this is not available in the official release
+  def getblockbycount(height)
+    @api.request 'getblockbycount', height
+  end
+
+  # Dumps the block existing with specified hash.
+  def getblock(hash)
+    block = @api.request 'getblock', hash
+    block["time"] = Time.at(block["time"]).utc
+    block
+  end
+
+  # Returns the number of blocks in the longest block chain.
+  def getblockcount
+    @api.request 'getblockcount'
+  end
+
+  # Returns the block number of the latest block in the longest block chain.
+  def getblocknumber
+    @api.request 'getblocknumber'
+  end
+
+  # Returns the number of connections to other nodes.
+  def getconnectioncount
+    @api.request 'getconnectioncount'
+  end
+
+  # Returns the proof-of-work difficulty as a multiple of the minimum difficulty.
+  def getdifficulty
+    @api.request 'getdifficulty'
+  end
+
+  # Returns true or false whether dogecoind is currently generating hashes
+  def getgenerate
+    @api.request 'getgenerate'
+  end
+
+  # Returns a recent hashes per second performance measurement while generating.
+  def gethashespersec
+    @api.request 'gethashespersec'
+  end
+
+  # Returns the hash given a block id 
+  def getblockhash(idx)
+    @api.request 'getblockhash', idx
+  end
+ 
+  # Returns the hash of the best (tip) block in the longest block chain.
+  def getbestblockhash
+    @api.request 'getbestblockhash'
+  end
+
+  # Returns an object containing various state info.
+  def getinfo
+    @api.request 'getinfo'
+  end
+
+  # Returns an object containing mining info.
+  def getmininginfo
+    @api.request 'getmininginfo'
+  end
+
+  # Returns a new dogecoin address for receiving payments. If +account+ is specified (recommended),
+  # it is added to the address book so payments received with the address will be credited to +account+.
+  def getnewaddress(account = nil)
+    @api.request 'getnewaddress', account
+  end
+
+  # Returns the total amount received by addresses with +account+ in transactions
+  # with at least +minconf+ confirmations.
+  def getreceivedbyaccount(account, minconf = 1)
+    @api.request 'getreceivedbyaccount', account, minconf
+  end
+
+  # Returns the total amount received by +dogecoinaddress+ in transactions with at least +minconf+ confirmations.
+  def getreceivedbyaddress(dogecoinaddress, minconf = 1)
+    @api.request 'getreceivedbyaddress', dogecoinaddress, minconf
+  end
+
+  # Get detailed information about +txid+
+  def gettransaction(txid)
+    @api.request 'gettransaction', txid
+  end
+
+  # If +data+ is not specified, returns formatted hash data to work on:
+  #
+  #  :midstate => precomputed hash state after hashing the first half of the data
+  #  :data     => block data
+  #  :hash1    => formatted hash buffer for second hash
+  #  :target   => little endian hash target
+  #
+  # If +data+ is specified, tries to solve the block and returns true if it was successful.
+  def getwork(data = nil)
+    @api.request 'getwork', data
+  end
+
+  # List commands, or get help for a command.
+  def help(command = nil)
+    @api.request 'help', command
+  end
+
+  # Returns Object that has account names as keys, account balances as values.
+  def listaccounts(minconf = 1)
+    @api.request 'listaccounts', minconf
+  end
+
+  # Returns an array of objects containing:
+  #
+  #   :account       => the account of the receiving addresses
+  #   :amount        => total amount received by addresses with this account
+  #   :confirmations => number of confirmations of the most recent transaction included
+  #
+  def listreceivedbyaccount(minconf = 1, includeempty = false)
+    @api.request 'listreceivedbyaccount', minconf, includeempty
+  end
+
+  # Returns an array of objects containing:
+  #
+  #   :address       => receiving address
+  #   :account       => the account of the receiving address
+  #   :amount        => total amount received by the address
+  #   :confirmations => number of confirmations of the most recent transaction included
+  #
+  # To get a list of accounts on the system, execute dogecoind listreceivedbyaddress 0 true
+  def listreceivedbyaddress(minconf = 1, includeempty = false)
+    @api.request 'listreceivedbyaddress', minconf, includeempty
+  end
+
+  # Returns up to +count+ most recent transactions for account +account+.
+  def listtransactions(account, count = 10)
+    @api.request 'listtransactions', account, count
+  end
+
+  # Move from one account in your wallet to another.
+  def move(fromaccount, toaccount, amount, minconf = 1, comment = nil)
+    @api.request 'move', fromaccount, toaccount, amount, minconf, comment
+  end
+
+  # +amount+ is a real and is rounded to 8 decimal places. Returns the transaction ID if successful.
+  def sendfrom(fromaccount, todogecoinaddress, amount, minconf = 1, comment = nil, comment_to = nil)
+    @api.request 'sendfrom', fromaccount, todogecoinaddress, amount, minconf, comment, comment_to
+  end
+
+  # +amount+ is a real and is rounded to 8 decimal places
+  def sendtoaddress(dogecoinaddress, amount, comment = nil, comment_to = nil)
+    @api.request 'sendtoaddress', dogecoinaddress, amount, comment, comment_to
+  end
+
+  def sendmany(fromaccount, addresses_amounts, minconf = 1, comment = nil)
+    @api.request 'sendmany', fromaccount, addresses_amounts, minconf, comment
+  end
+
+  # Sets the account associated with the given address.
+  def setaccount(dogecoinaddress, account)
+    @api.request 'setaccount', dogecoinaddress, account
+  end
+
+  # +generate+ is true or false to turn generation on or off.
+  # Generation is limited to +genproclimit+ processors, -1 is unlimited.
+  def setgenerate(generate, genproclimit = -1)
+    @api.request 'setgenerate', generate, genproclimit
+  end
+
+  # Stop dogecoin server.
+  def stop
+    @api.request 'stop'
+  end
+
+  # Return information about +dogecoinaddress+.
+  def validateaddress(dogecoinaddress)
+    @api.request 'validateaddress', dogecoinaddress
+  end
+
+  # Sign a message using +dogecoinaddress+.
+  def signmessage(dogecoinaddress, message)
+    @api.request 'signmessage', dogecoinaddress, message
+  end
+
+  # Verify signature made by +dogecoinaddress+.
+  def verifymessage(dogecoinaddress, signature, message)
+    @api.request 'verifymessage', dogecoinaddress, signature, message
+  end
+
+  # Stores the wallet decryption key in memory for +timeout+ seconds.
+  def walletpassphrase(passphrase, timeout)
+    @api.request 'walletpassphrase', passphrase, timeout
+  end
+
+  # Removes the wallet encryption key from memory, locking the wallet.
+  # After calling this method, you will need to call walletpassphrase again
+  # before being able to call any methods which require the wallet to be
+  # unlocked.
+  def walletlock
+    @api.request 'walletlock'
+  end
+
+  alias account getaccount
+  alias account_address getaccountaddress
+  alias addresses_by_account getaddressesbyaccount
+  alias balance getbalance
+  alias block_by_count getblockbycount
+  alias block_count getblockcount
+  alias block_number getblocknumber
+  alias connection_count getconnectioncount
+  alias difficulty getdifficulty
+  alias generate? getgenerate
+  alias hashes_per_sec gethashespersec
+  alias info getinfo
+  alias new_address getnewaddress
+  alias received_by_account getreceivedbyaccount
+  alias received_by_address getreceivedbyaddress
+  alias transaction gettransaction
+  alias work getwork
+  alias get_work getwork
+  alias accounts listaccounts
+  alias list_received_by_account listreceivedbyaccount
+  alias list_received_by_address listreceivedbyaddress
+  alias transactions listtransactions
+  alias list_transactions listtransactions
+  alias send_from sendfrom
+  alias send_to_address sendtoaddress
+  alias send_many sendmany
+  alias account= setaccount
+  alias set_account setaccount
+  alias generate= setgenerate
+  alias set_generate setgenerate
+  alias validate_address validateaddress
+  alias sign_message signmessage
+  alias verify_message verifymessage
+end