Skip to content
No description, website, or topics provided.
Python Gherkin Shell
Branch: master
Clone or download
m-pilarczyk Merge pull request #20 from adshares/develop
 New error messages and get_log support
Latest commit c36d52b Feb 25, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Project metafiles Aug 3, 2018
docs Project metafiles Aug 3, 2018
tests Add import const ADS_JSON_RPC_SERVER_URL Jan 8, 2019
.gitattributes move from ads repo Jul 26, 2018
.gitignore move from ads repo Jul 26, 2018 v1.3.2 Feb 25, 2019
LICENSE Update LICENSE Aug 27, 2018
ads-json-rpc New error messages and get_log support Feb 12, 2019
ads-monitor +x Jan 3, 2019
ads-service +x Jan 3, 2019


ADS Toolbox

Report bug · Request feature · Wiki

Basic tools for maintenance an ADS blockchain node.

Getting Started

Several quick start options are available:

  • Install from Ubuntu PPA (recommended):
    sudo add-apt-repository ppa:adshares/releases
    sudo apt-get update
    sudo apt-get install ads-tools
  • Download the latest release
  • Clone the repo: git clone


JSON-RPC server

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


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)
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.

You can’t perform that action at this time.