node-bitcoin

node-bitcoin is a simple wrapper for the Bitcoin client's JSON-RPC API.

The API is equivalent to the API document here. The methods are exposed as lower camelcase methods on the bitcoin.Client object.

You can choose to ignore the helper methods and call the api directly like so:

client.cmd('getbalance', '*', 6, function(err, balance){
  if (err) return console.log(err);
  console.log('Balance:', balance);
});

Install

npm install bitcoin

Setup

1. Traverse to ~/.bitcoin or ~/Library/Application Support/Bitcoin and add a file called bitcoin.conf if it doesn't already exist.

2. Add these lines to the file:

   rpcuser=username

   rpcpassword=password

You will use these to login to the server.

3. Start your Bitcoin client with the -server argument or run bitcoind

4. You should now be able to communicate with Bitcoin JSON-RPC API using the node-bitcoin library, try it out!

Examples

Create client

var bitcoin = require('bitcoin');
var client = new bitcoin.Client('localhost', 8332, 'username', 'password');

Create client with single object

var client = new bitcoin.Client({
  host: 'localhost',
  port: 8332,
  username: 'username',
  password: 'password'
});

Get balance across all accounts with minimum confirmations of 6

client.getBalance('*', 6, function(err, balance) {
  if (err) return console.log(err);
  console.log('Balance:', balance);
});