Navigation Menu

Skip to content


Repository files navigation


ADS Toolbox

Report bug · Request feature · Docs

Basic tools for maintenance an ADS blockchain node.

Getting Started

Several quick start options are available:

Release version (recommended)

sudo add-apt-repository ppa:adshares/releases
sudo apt-get update
sudo install ads-tools

Snapshot version

sudo add-apt-repository ppa:adshares/snapshots
sudo apt-get update
sudo install ads-tools

Install from Source Code

sudo apt-get install python
git clone
cd ads-tools


JSON-RPC server

sudo apt install python-pip
pip install flask flask_jsonrpc waitress requests


ADS Service

usage: ads-service [-h] [-w WORKING_DIR] [-g GENESIS_URL] [-f]

Maintenance service for the ADS network.

positional arguments:

optional arguments:
  -h, --help            show this help message and exit
  -w WORKING_DIR, --working-dir WORKING_DIR
                        working directory (default "~/.adsd")
  -g GENESIS_URL, --genesis-url GENESIS_URL
                        URL to genesis file (default official genesis)
  -f, --force


ads-service configure

The interactive ads-service configure will walk you through the configuration. Some of the steps can be skipped by accepting the default option. For the configuration process to be successful, you'll need to provide:

  • private key
  • node identifier
  • node interface (ip)

!!! WARNING Private key will be stored in plain text in file $WORKING_DIR/key/key.txt !!!

Starting the node
ads-service start
ads-service status

ADS Monitor

ads-monitor [options] <command>

  status                   checks if the node is alive
  tps                      transactions per second
  txs                      the number of awaiting transactions
  peers                    the number of active peers
  conns                    the number of currently open connections

  -w, --working-dir <DIR>  working directory
  -e, --stderr-path <FILE> path to STDERR
  -v, --verbose            verbose mode
  -c, --continuous         continuous monitoring
  -h, --help               display this help and exit


Continuous checking transactions in block with more info:

ads-monitor -vc txs

JSON-RPC server

usage: ads-json-rpc [-h] [--port PORT] [--host HOST] [--ads ADS] [-f FLIMIT]
                    [-i ILIMIT] [-d] [-w WORKING_DIR] [-t TRANSACTIONS_DIR]
                    [-a ACCOUNTS_DIR]

Run JSON-RPC proxy server to ADS client

optional arguments:
  -h, --help            show this help message and exit
  --port PORT           Server port
  --host HOST           Server listening interface
  --ads ADS             ADS client
  -f FLIMIT, --flimit FLIMIT
                        Minimal creation interval of free account in seconds
  -i ILIMIT, --ilimit ILIMIT
                        Minimal creation interval of free account from the
                        same IP address in seconds
  -d, --debug           Debug mode
  -w WORKING_DIR, --working-dir WORKING_DIR
                        Path to ads working directory
                        Path to ads working directory for transactions
  -a ACCOUNTS_DIR, --accounts-dir ACCOUNTS_DIR
                        Path to ads working directories for creating free


Starting the server on

ads-json-rpc --host --port 6868


We use Semantic Versioning for versioning. For the versions available, see the tags on this repository.


See also the list of contributors who participated in this project.


This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.