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
Permalink
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
CHANGELOG.md v1.3.2 Feb 25, 2019
LICENSE Update LICENSE Aug 27, 2018
README.md
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

README.md

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-get update
    sudo apt-get 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-get install python-pip
pip install flask flask_jsonrpc waitress

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.

You can’t perform that action at this time.