Need help with eth-utils?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

134 Stars 87 Forks 10 Commits 7 Opened issues


ethereum utilities, dev tools, scripts, etc

Services available


Need anything else?

Contributors list

# 2,822
10 commits


ethereum utilities, dev tools, scripts, etc

    : primitive wrapper to geth
    : launch local clusters non-interactively (
    : auto-generate the json config of your local cluster for netstat (


Launch an instance

GETH=./geth bash /path/to/eth-utils/  

This will - if it does not exist yet, then create an account with password dd [NEVER USE THIS LIVE] - bring up a node with instance id dd (double digit) - using rootdir/dd as data directory (where blockchain etc. are stored) - listening on port 303dd, (like 30300, 30301, ...) - with the account unlocked - launching json-rpc server on port 81dd (like 8100, 8101, 8102, ...) - extra params are passed to

$ GETH=./geth bash ~/eth-utils/ ~/tmp/eth/ 04 09 --mine console 
Welcome to the FRONTIER
> eth.getBalance(eth.coinbase)

Launch a cluster

Running a cluster of 8 instances under dir

isolated on local eth network (id 3301), launch 05. Give external IP and pass extra param
GETH=./geth bash      [[params]...]

This will set up a local cluster of nodes -

 is the number of clusters
 is the root directory for the cluster, the nodes are set up 
  with datadir 
, ... - new accounts are created for each node - they listening on port 303dd (like 30300, 30301, ...) - json-rpc server is launched on port 81dd (like 8100, 8101, ...) - by collecting the nodes' node-urls, they get connected to each other - if enode has no IP,
 is substituted
- if 
 is not 0, they will not connect to a default client,
  resulting in a private isolated network
- the nodes log into 
, ... -
 is just an arbitrary tag or index you can use to log multiple 
  subsequent launches of the same cluster, I recommend sequential double digit ids
- the cluster can be killed with 
killall -QUIT geth
(FIXME: should record PIDs) - the nodes can be restarted from the same state individually using the
script - if you want to interact with the nodes, use a json-rpc client - you can supply additional params on the command line which will be passed to
and eventually to
for each node, for instance
-vmodule=http=6 -mine -minerthreads=8
is a good one.
GETH=./geth bash ./leagues/3301/cicada 2 3301 05 -mine 
launching node 0/2 ---> tail -f ./leagues/3301/cicada/00.05.log
Welcome to the FRONTIER
launching node 1/2 ---> tail -f ./leagues/3301/cicada/01.05.log
Welcome to the FRONTIER

fill create:


You can kill and restart individual nodes or the entire cluster safely, by using different runid you can separate logs for the individual runs in a neat way.

killall -QUIT geth

Using the

signal is very useful because it dumps the stacktrace into the glog file which you can attach to any bugreport or issue.

Monitor your local cluster:

Installing the eth-netstats monitor

git clone
cd eth-netstats
npm install

Configuring netstat for your cluster

bash /path/to/eth-utils/     
  • will output resulting app.json to stdout
  • number_of_clusters
    is the number of nodes in the cluster.
  • name_prefix
    is a prefix for the node names as will appear in the listing.
  • ws_server
    is the eth-netstats server. Make sure you write the full URL, for example: http://localhost:3000.
  • ws_secret
    is the eth-netstats secret.

For example:

git clone
cd eth-utils
bash ./ 8 cicada http://localhost:3301 kscc > ~/leagues/3301/cicada.json

Installing eth-net-intelligence-api

git clone
cd eth-net-intelligence-api
npm install
sudo npm install -g pm2

Starting the eth-net-intelligence-api

to start the eth-net-intelligence-api client for your cluster

cd eth-net-intelligence-api
pm2 start ~/leagues/3301/cicada.json
[PM2] Process launched
[PM2] Process launched
│ App name │ id │ mode │ pid   │ status │ restart │ uptime │ memory      │ watching │
│ cicada-0 │ 1  │ fork │ 93855 │ online │ 0       │ 0s     │ 10.289 MB   │ disabled │
│ cicada-1 │ 2  │ fork │ 93858 │ online │ 0       │ 0s     │ 10.563 MB   │ disabled │
 Use `pm2 show ` to get more details about an app

Starting the monitor

Use your own eth-netstat server to monitor a league on a port corresponding to a league

cd eth-netstat
PORT=3301 WS_SECRET=kscc npm start &

and enjoy:

open http://localhost:3301

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.