Note: DogeAPI is shutting down. For an alternative digital wallet API that supports Dogecoin, Litecoin, and Bitcoin, give Block.io a try. Their Ruby client is under development here.
dogecoin
Ruby wrapper for the DogeAPI. Send and receive Dogecoins. Currently very alpha, while the API is so beta. Such wow, regardless — with much amaze planned for the future.
Installation
You can either gem install dogecoin
or add gem 'dogecoin'
to your Gemfile and bundle
it, doge.
Configuration
Most methods require an API key. Get yours — and many free coin! — here. Configure like so, plz:
@shibe = DogeCoin::Client.new
@shibe.configure do |config|
config.api_key = 'YOUR_API_KEY'
end
Usage
Descriptions and examples of the supported actions are below.
- Returns the DOGE balance of your entire account to 8 decimal places.
@shibe.get_balance
- Withdraws
amount
doge to apayment_address
you specify. For now, this must be more than 5 doge, and you must have enough extra in your wallet to pay all fees (another 1-3 doge).
@shibe.withdraw(amount, payment_address)
- Returns a new payment address for your account.
@shibe.get_new_address
You can also pass an optional alphanumeric address_label
as a label for the address.
@shibe.get_new_address(address_label)
- Returns an array of all payment addresses/address IDs for your account.
@shibe.get_my_addresses
- Returns the current amount received to all addresses with
payment_address
oraddress_label
.
@shibe.get_address_received(payment_address_or_address_label)
- Returns the payment address for the given
address_label
.
@shibe.get_address_by_label(address_label)
- Returns the current difficulty. This doesn't require an API key.
@shibe.get_difficulty
- Returns the current block. This doesn't require an API key.
@shibe.get_current_block
Contributing to dogecoin
- Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
- Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
- Fork the project.
- Start a feature/bugfix branch.
- Commit and push until you are happy with your contribution.
- Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
- Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
Copyright
Copyright (c) 2014 Rahul Horé. See LICENSE.txt for further details.