Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Adshares

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 update
    sudo apt install ads-tools
    
  • Download the latest release
  • Clone the repo: git clone https://github.com/adshares/ads-tools.git

Requirements

JSON-RPC server

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

Usage

ADS Service

usage: ads-service [-h] [-w WORKING_DIR] [-g GENESIS_URL] [-f]
                   {start,stop,restart,configure,status}

Maintenance service for the ADS network.

positional arguments:
  {start,stop,restart,configure,status}

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

Examples

Configuration
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>

Commands
  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

Options
  -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

Examples

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
  -t TRANSACTIONS_DIR, --transactions-dir TRANSACTIONS_DIR
                        Path to ads working directory for transactions
  -a ACCOUNTS_DIR, --accounts-dir ACCOUNTS_DIR
                        Path to ads working directories for creating free
                        accounts

Examples

Starting the server on http://127.0.0.1:6868/:

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

Versioning

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

Authors

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

License

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