/tendermint-node

Run a Tendermint full node from Node.js

Primary LanguageJavaScript

tendermint-node

Run a Tendermint full node.

On install, this package downloads a prebuilt Tendermint binary from the official Tendermint releases, and checks it against a known SHA256 hash.

Usage

npm install tendermint-node

let tendermint = require('tendermint-node')

// init a directory for running tendermint
tendermint.initSync({ home: './tendermint' })

// start the full node
let node = tendermint.node({
  home: './tendermint',
  rpc: {
    laddr: 'tcp://0.0.0.0:8888'
  }
  // these options are equivalent to CLI flags
})
node.stdout.pipe(process.stdout)

tendermint.init(path)

Initializes a data directory to be used by a full node. path should be the path to the directory to be initialized.

Returns a Promise.

tendermint.initSync(path)

The synchronous version of tendermint.init().

tendermint.node(path, opts)

Spawns a Tendermint full node.

Returns a ChildProcess object representing the Tendermint process. It has an rpc property which is a client for the node's RPC server (RpcClient). path should be a path to the directory (initialized by init or initSync).

opts may be an object containing options passed to Tendermint as CLI arguments (you may use any flag supported by Tendermint). To see all supported options, run npm i -g tendermint-node && tendermint node --help.

tendermint.lite(target, path, opts)

Spawns a Tendermint light node (talks to a full node and verifies its RPC data).

Returns a ChildProcess object representing the Tendermint process. It has an rpc property which is a client for the node's RPC server (RpcClient).

target should be the URL of a full node's RPC server (e.g. http://somefullnode.com:46657).

path should be a path to a directory where light client data will be stored.

opts may be an object containing options passed to tendermint as CLI arguments (you may use any flag supported by tendermint). To see all supported options, run npm i -g tendermint-node && tendermint lite --help.

tendermint.version()

Returns the tendermint binary's version string.

tendermint.genValidator()

Generates a validator private key, returned as stringified JSON.