A Node.js KittehCoin Client!

node-kittehcoin is a Kittehcoin client for Node.js. It is a fork of the node-dogecoin client, which is a fork of the excellent Kapitalize Bitcoin Client (now removed from GitHub) intended for use with Kittehcoin. The purpose of this repository is:

• Provide a one-stop resource for the Node.js developer to get started with Kittehcoin integration.
• Prevent would-be Kittehcoin web developers worrying whether a Bitcoin client will work out of the box.
• Promote Node.js development of Kittehcoin web apps.
• Identify and address any incompatibilities with the Kittehcoin and Bitcoin APIs that exist now and/or in the future.

Dependencies

You'll need a running instance of kittehcoind to connect with. If you're running Debian/Ubuntu, the best guide currently out there is in litecoind documentation. Be sure to actually install kittehcoind, not litecoind ;). Feel free to ask for help at the forums: http://kittehcoin.info/forums/

Then, install the node-kittehcoin NPM package.

npm install kittehcoin

Examples

Some code examples follow below, more complete examples to follow.

var kittehcoin = require('node-kittehcoin')()

kittehcoin.auth('myusername', 'mypassword')

kittehcoin.getDifficulty(function() {
    console.log(arguments);
})

Chaining

Nearly verything is chainable.

var kittehcoin = require('node-kittehcoin')()

kittehcoin
.auth('MyUserName', 'mypassword')
.getNewAddress()
.getBalance()

Methods

The Litecoin API is supported as direct methods. Use either camelcase or lowercase.

kittehcoin.getNewAddress(function(err, address) {
    this.validateaddress(address, function(err, info) {

    })
})

.exec(command [string], ...arguments..., callback [function])

Executes the given command with optional arguments. Function callback defaults to console.log. All of the API commands are supported in lowercase or camelcase. Or uppercase. Anycase!

kittehcoin.exec('getNewAddress')

kittehcoin.exec('getbalance', function(err, balance) {

})

.set(key [string, object], value [optional])

Accepts either key & value strings or an Object containing settings, returns this for chainability.

kittehcoin.set('host', '127.0.0.1')

.get(key [string])

Returns the specified option's value

kittehcoin.get('user')

.auth(user [string], pass [string])

Generates authorization header, returns this for chainability

Commands

TODO: Write tests for these.

All Litecoin API commands are supported, in lowercase or camelcase form.

Generation is limited to [genproclimit] processors, -1 is unlimited.

Options

You may pass options to the initialization function or to the set method.

var kittehcoin = require('kittehcoin')({
    user:'user'
})

kittehcoin.set('pass', 'somn')
kittehcoin.set({port:22566})

Available options and default values:

• host localhost
• port 22566
• user
• pass
• passphrasecallback
• https
• ca

Passphrase Callback

With an encryped wallet, any operation that accesses private keys requires a wallet unlock. A wallet is unlocked using the walletpassphrase <passphrase> <timeout> JSON-RPC method: the wallet will relock after timeout seconds.

You may pass an optional function passphrasecallback to the node-kittehcoin initialization function to manage wallet unlocks. passphrasecallback should be a function accepting three arguments:

function(command, args, callback) {}

• command is the command that failed due to a locked wallet.
• args is the arguments for the failed command.
• callback is a typical node-style continuation callback of the form function(err, passphrase, timeout) {}. Call callback with the wallet passphrase and desired timeout from within your passphrasecallback to unlock the wallet.

You may hard code your passphrase (not recommended) as follows:

var kittehcoin = require('node-kittehcoin')({
    passphrasecallback: function(command, args, callback) {
        callback(null, 'passphrase', 30);
    }
})

Because passphrasecallback is a continuation, you can retrieve the passphrase in an asynchronous manner. For example, by prompting the user:

var readline = require('readline')

var rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout
})

var kittehcoin = require('node-kittehcoin')({
  passphrasecallback: function(command, args, callback) {
    rl.question('Enter passphrase for "' + command + '" operation: ', function(passphrase) {
      if (passphrase) {
        callback(null, passphrase, 1)
      } else {
        callback(new Error('no passphrase entered'))
      }
    })
  }
})

Secure RPC with SSL

By default kittehcoind exposes its JSON-RPC interface via HTTP; that is, all RPC commands are transmitted in plain text across the network! To secure the JSON-RPC channel you can supply kittehcoind with a self-signed SSL certificate and an associated private key to enable HTTPS. For example, in your kittehcoin.conf:

rpcssl=1
rpcsslcertificatechainfile=/etc/ssl/certs/kittehcoind.crt
rpcsslprivatekeyfile=/etc/ssl/private/kittehcoind.pem

In order to securely access an SSL encrypted JSON-RPC interface you need a copy of the self-signed certificate from the server: in this case kittehcoind.crt. Pass your self-signed certificate in the ca option and set https: true and node-kittehcoin is secured!

var fs = require('fs')

var ca = fs.readFileSync('kittehcoind.crt')

var kittehcoin = require('node-kittehcoin')({
  user: 'rpcusername',
  pass: 'rpcpassword',
  https: true,
  ca: ca
})

Testing

nodunit test/test-node-kittehcoin.js

Donation and Bounties

The Kittehcoin donation address is KTiU2iYZyykHG9EBbYZ85ygpWNReXtZbFm

Join the conversation on [Kittehcoin Bounties!] (http://www.reddit.com/r/kittehcoin/comments/1yl3x0/what_do_you_think_we_should_be_offering_bounties/)