Skip to content
Switch branches/tags
This branch is up to date with master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


ADS Blockchain

Report bug · Request feature · Wiki

The ADS Blockchain is a fork of the Enterprise Service Chain (ESC), a blockchain software technology capable of facilitating high volumes of simple transactions which, similarly to other cryptocurrencies, allows sending tokens between user accounts. ESC derives its name from the concept of the Enterprise Service Bus, where a cryptocurrency is used as the communication protocol.

Quality Status Reliability Rating Security Rating Build Status

Getting Started

Master node

To set up the master node, you will need to provide a secret key (64 hexadecimal digits) and a node identifier (4 hexadecimal digits). Usually, you will also need to specify an IP address.

  1. Install binaries from official PPA

    sudo add-apt-repository ppa:adshares/releases -y
    sudo apt-get update
    sudo apt-get install ads ads-tools
  2. Configure and start the node

    The ADS node uses two TCP ports: 6510 and 6511 (by defaults). You will need to open both on the firewall. You must also remember to enable server time synchronization.

    Configuration tool will ask you about a secret key, the node identifier, and an IP address.

    ads-service configure
    ads-service start
  3. Check the node status

    ads-monitor status -v

    If that works, you should see current time, block time and node number.

Connecting to the node

To connect to the node, you will usually need to provide an account address and secret key. If the node runs on a machine other than the one where you log in, you will also need to specify a hostname. Once you know the proper parameters, you should be able to connect like this:

ads --host=HOST --address=ADDRESS -s
ENTER passphrase or secret key

If that works, you should see some introductory information. Then you can enter commands, for example, to get the current status of the user:

Working dir: /home/user/.ads
Public key: XYZ
Node port: 6511
Node host:
Address: 000X-0000000Y-AAAA



See a list of all available commands.

JSON-RPC client for ADS

The JSON-RPC client for ADS (ads-json-rpc) was created to simplify ads wallet program usage. It supports most of ADS-API methods and complies JSON-RPC specification version 2.0. The ads-json-rpc is part of ads-tool package. It's installation and usage is described in details on ads-tools project page.

Adshares made publicly available JSON-RPC clients for ADS Mainnet and Testnet.

More information about can be found on wiki.

Updating the node

Updating binaries from official PPA:

ads-service stop
sudo apt-get update
sudo apt-get install ads ads-tools
ads-service start



Please follow our Contributing Guidelines


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


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


This work is licensed under the Creative Commons Attribution-NoDerivatives 4.0 International License. To view a copy of this license, visit or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA. See the LICENSE file for details.

More info