Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
47 lines (30 sloc) 1.07 KB


This is a JSON-RPC server and client library for node.js, the V8 based evented IO framework.


To install node-jsonrpc2 in the current directory, run:

npm install jsonrpc2

Important: If you run this command, you will get not this repository, but bitconjs repository.


Firing up an efficient JSON-RPC server becomes extremely simple:

var rpc = require('jsonrpc2');

var server = new rpc.Server();

function add(args, opt, callback) {
  callback(args[0] + args[1]);
server.expose('add', add);

server.listen(8000, 'localhost');

And creating a client to speak to that server is easy too:

var rpc = require('jsonrpc2');
var sys = require('sys');

var client = new rpc.Client(8000, 'localhost');'add', [1, 2], function(err, result) {
    sys.puts('1 + 2 = ' + result);

To learn more, see the examples directory, peruse test/jsonrpc-test.js, or simply "Use The Source, Luke".

More documentation and development is on its way.