Nano NodeJS RPC Client

Nano RPC client written with NodeJS.
It produces JSON objects or strings as output, wrapped in native promises.

All RPC calls are defined here: https://github.com/nanocurrency/nano-node/wiki/RPC-protocol

Table of Contents

• Getting Started
  • Examples
  • Promise-wrapped responses
  • Methods Names
  • Arguments
  • Returned value
• Testing
• Possible future features
• Donations
• License (MIT)

Getting Started

Install

npm install nano-node-rpc

Nanode Node API

1const NanoClient = require('nano-node-rpc');
2const client = NanoClient({apiKey: process.env.NINJA_API_KEY})

Your own Nano RPC server

1const NanoClient = require('nano-node-rpc');
2const client = NanoClient({url: 'http://localhost:7076'})

Use methods attached to client to send RPC calls

Examples

Head to the examples.js file for even more!

1const client = new RaiClient(NODE_ADDRESS [, decodeJSON]);
2
3// Some methods do not require arguments:
4client
5  .block_count()
6  .then(count => {
7    console.log(count);
8    /**
9     * {
10     *   "count": "1826834",
11     *   "unchecked": "3385205"
12     * }
13     */
14  })
15  .catch(e => {
16    // Deal with your errors here.
17  });
18
19// Some methods require arguments:
20client
21  .account_balance("xrb_mySuperAddress")
22  .then(balance => {
23    console.log(balance);
24    /**
25     * {
26     *   "balance": "325586539664609129644855132177",
27     *   "pending": "2309370929000000000000000000000000"
28     * }
29     */
30  })
31  .catch(e => {
32    // Deal with your errors here.
33  });

Promise-wrapped responses

All method calls return native NodeJS promises. You need to use the then() / catch() pattern shown above. If the call was succesful, the data will be passed to then(), otherwise the error will be passed to catch().

Methods Names

The method calls are the same as the original RPC actions defined on the RaiBlocks wiki. (See https://github.com/clemahieu/raiblocks/wiki/RPC-protocol)

Example1: on the RaiBlocks wiki account_balance is called with account. For the NodeJS client, the method is account_balance and the argument is the account string.