Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including eth-tools with all npm packages installed. Try it out:

var ethTools = require("eth-tools")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

eth-tools v0.0.39

Eth Tools

Command line tools for easy interaction with Ethereum nodes.

At the moment:

  • Ethereum node detection
  • account balance inspector

more coming as needs arise.


Summary: node.js and git. You can skip to the next section if you already have these.

  • node.js spectacular platform. LTS (Long-term support) is the right choice for most.

  • git incredible version control (needed in the background to install some dependencies on first install).

Optional: if you want easy switching between different node.js versions in the future and you are using unix based systems (macOS, Linux), you can install node.js via fantastic n (don't download it from in this case).

You can also install both node.js and git via Homebrew friendly package manager for macOS. n is still recommended for node.js though.

npm (Node Package Manager) is installed automatically with node.js install (just FYI).


npm install -g eth-tools




eth -h


Create or edit the file ~/.eth-tools.json (Linux/MacOS: /home/[user], Windows: c:\Users\[user]) containing instructions where to search for Ethereum nodes.

Config file example

  "clients": ["geth", "parity", "testrpc"],
  "nodes": {
    "localhost": [8545, 8600, 8700],
    "": [8545]


Usage: eth [options] [command]


    info               show the accessible nodes info (nodes are specified in config file)
    balance [address]  get the balance on a given address

  Eth command line tools


    -h, --help         output usage information
    -V, --version      output the version number
    --host <host>      [Config]: Host of Ethereum node
    -p, --port <port>  [Config]: Port on which the node is running


If you run eth without this file present, it will create an example file for your convenience.


  • Ethereum nodes have to have RPC enabled on the given port (parity has by default, geth doesn't - use --rpc)


RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free