npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

node-raiblocks-rpc

v0.2.0

Published

A NodeJS client for the RaiBlocks' RPC API

Downloads

4

Readme

RaiBlocks NodeJS RPC Client

npm version

FOSSA Status npm version

RaiBlocks 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/clemahieu/raiblocks/wiki/RPC-protocol

Become a patron  ~  Donate

Table of Contents

Getting Started

  1. Install the npm package:
$ yarn add node-raiblocks-rpc
# or
$ npm install node-raiblocks-rpc --save
  1. Require the RPC client into your project:
const RaiClient = require('node-raiblocks-rpc');
const NODE_ADDRESS = 'http://[urltonode|iptonode]:port';

/**
 * decodeJSON is an optional boolean argument.
 * When set to true (default), the JSON string response is
 * parsed into a JSON object. Otherwise the string is returned.
 */
const client = new RaiClient(NODE_ADDRESS [, decodeJSON]);
  1. Use methods attached to client to send RPC calls:

Examples

Head to the examples.js file for even more!

const client = new RaiClient(NODE_ADDRESS [, decodeJSON]);

// Some methods do not require arguments:
client
  .block_count()
  .then(count => {
    console.log(count);
    /**
     * {
     *   "count": "1826834",
     *   "unchecked": "3385205"
     * }
     */
  })
  .catch(e => {
    // Deal with your errors here.
  });

// Some methods require arguments:
client
  .account_balance("xrb_mySuperAddress")
  .then(balance => {
    console.log(balance);
    /**
     * {
     *   "balance": "325586539664609129644855132177",
     *   "pending": "2309370929000000000000000000000000"
     * }
     */
  })
  .catch(e => {
    // Deal with your errors here.
  });

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.

Arguments

The arguments to use for those methods are detailed in the inline documentation of the index.js. There are the same as those mentioned in the Monero documentation: https://github.com/clemahieu/raiblocks/wiki/RPC-protocol

Returned value

If you havent specified any decodeJSON argument when you instantiated RaiClient, by default the returned data will already be parsed into a JSON object for you. Otherwise you will receive the original JSON string returned by the RaiBlocks network.

Testing

Testing is done with mocha, chai and chai-as-promised to test promises.

To run the tests:

$ yarn test
# or
$ npm run test

The tests are located in the lib/tests.js file. They perform actual API calls to the RaiBlocks network through a local node. In order to prevent the tests from failing because of a timeout, tests are run with a timeout option of 100s. Tests can still fail if the local node is too slow.

If you want to just run one set of test (i.e a describe block), for let's say the account_balance() function, you can do so with this command:

$ ./node_modules/mocha/bin/mocha --grep [functionNameHere] --timeout 10000

For example, if you want to test account_balance:

$ ./node_modules/mocha/bin/mocha --grep account_balance --timeout 10000

You can be even more specific by adding only to the individual tests. Example for account_balance():

describe("RaiClient.account_balance()", done => {
+ it.only("should retrieve account balance", () => {
- it("should retrieve account balanve", () => {
    expect(client.account_balance(WALLET_ADDRESS))
      .to.eventually.contain('"balance"')
      .and.to.eventually.contain('"pending"')
      .notify(done);
  });
});

Possible future features

  • Caching of some responses
    • First with javascript objects
    • Then with some external db, like Redis or SQLLite
  • Make the library Isomorphic, i.e work in web-browsers as well
  • Make the method calls also support callbacks
  • Setup automated testing with travis. Will need first to build a mock object for RaiBlocks to have deterministic tests

Donations

I currently work on this project during my free-time, but also during my work-time. As I'm my own boss, I take work time to work on personnal projects that I really believes in. But during this time, I don't win any money. I'm not doing that for money.

Anyway, if you consider support me, you can pay me a pack of Monster's cans for moore productive coding, :D.

I accept donations in form of RaiBlocks, Monero, Bitcoin, Etherum & IntenseCoin. You can also Patreon me !

Become a patron

1. Monero (XMR): 47XpVhUHahViCZHuZPc2Z6ivLraidX7AxbM8b2StdPcQGwjDGY14eqj9ippW7Pdrqj9d2y4xvwChzePQAqG1NvqQ775FKxg
2. Bitcoin (BTC/XBT): 18BqyV9mNbFLi5HNNnfUprnPJyJDFP59Xh
3. Etherum (ETH): 0x56E3273D42B40d47E122fF62108dEDC974A4206e
4. RaiBlocks (XRB): xrb_1ezazq8dkyashxeorb6kwncoc1imodd36yfetsje1ase71joy3qsnk8papku
4. IntenseCoin (ITNS): iz5F814eDfX7gbUucu17E5YUBGADYGLDRhMfKQjfXwv9S1UDPaJKcgEiUUWm9vDeJ7JVcPWo7kZRmTFtcVcssc1h28zguw8iE

If you wish to support me, but doesn't have money for, you can still message me on Wire and give me some free hugs! :D

  • Wire handle: @SkyzohKey

License

You can find an in-depth analysis of the dependencies license on FOSSA

This project is licensed under The MIT License.

FOSSA Status