Skip to content

The implementation of the bitcoin protocol for ruby.

License

Notifications You must be signed in to change notification settings

kannapoix/bitcoinrb

 
 

Repository files navigation

Bitcoinrb Build Status Gem Version MIT License

Bitcoinrb is a Ruby implementation of Bitcoin Protocol.

NOTE: Bitcoinrb work in progress, and there is a possibility of incompatible change.

Features

Bitcoinrb supports following feature:

Requirements

use Node implementation

If you use node features, please install level DB as follows.

install LevelDB

  • for Ubuntu

    $ sudo apt-get install libleveldb-dev

  • for Mac

    $ brew install leveldb

and put leveldb-native in your Gemfile and run bundle install.

gem 'leveldb-native'

Installation

Add this line to your application's Gemfile:

gem 'bitcoinrb', require: 'bitcoin'

And then execute:

$ bundle

Or install it yourself as:

$ gem install bitcoinrb

And then add to your .rb file:

require 'bitcoin'

Usage

Chain selection

The parameters of the blockchain are managed by Bitcoin::ChainParams. Switch chain parameters as follows:

  • mainnet
Bitcoin.chain_params = :mainnet

This parameter is described in https://github.com/chaintope/bitcoinrb/blob/master/lib/bitcoin/chainparams/mainnet.yml.

  • testnet
Bitcoin.chain_params = :testnet

This parameter is described in https://github.com/chaintope/bitcoinrb/blob/master/lib/bitcoin/chainparams/testnet.yml.

  • regtest
Bitcoin.chain_params = :regtest

This parameter is described in https://github.com/chaintope/bitcoinrb/blob/master/lib/bitcoin/chainparams/regtest.yml.

  • default signet
Bitcoin.chain_params = :signet

This parameter is described in https://github.com/chaintope/bitcoinrb/blob/master/lib/bitcoin/chainparams/signet.yml.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/bitcoinrb. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.

About

The implementation of the bitcoin protocol for ruby.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 100.0%