1.0.0 • Published 9 years ago

gabencoin v1.0.0

Weekly downloads
6
License
-
Repository
github
Last release
9 years ago

node-GabeNCoin

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

Install

npm install gabencoin

Examples

Create client

// all config options are optional
var client = new gabencoin.Client({
  host: 'localhost',
  port: 56883,
  user: 'username',
  pass: 'password',
  timeout: 30000
});

Get balance across all accounts with minimum confirmations of 6

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

Getting the balance directly using cmd

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

Batch multiple RPC calls into single HTTP request

var batch = [];
for (var i = 0; i < 10; ++i) {
  batch.push({
    method: 'getnewaddress',
    params: ['myaccount']
  });
}
client.cmd(batch, function(err, address, resHeaders) {
  if (err) return console.log(err);
  console.log('Address:', address);
});

SSL

See Enabling SSL on original client.

If you're using this to connect to gabencoind across a network it is highly recommended to enable ssl, otherwise an attacker may intercept your RPC credentials resulting in theft of your gabencoins.

When enabling ssl by setting the configuration option to true, the sslStrict option (verifies the server certificate) will also be enabled by default. It is highly recommended to specify the sslCa as well, even if your gabencoind has a certificate signed by an actual CA, to ensure you are connecting to your own gabencoind.

var client = new gabencoin.Client({
  host: 'localhost',
  port: 56883,
  user: 'username',
  pass: 'password',
  ssl: true,
  sslStrict: true,
  sslCa: fs.readFileSync(__dirname + '/myca.cert')
});