Skip to content

adshares/ads

Repository files navigation

Adshares

ADS Blockchain

Report bug · Request feature · Docs


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: 127.0.0.1
Address: 000X-0000000Y-AAAA

[...]

{"run":"get_me"}

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

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

Documentation

Contributing

Please follow our Contributing Guidelines

Versioning

We use SemVer 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 work is licensed under the Creative Commons Attribution-NoDerivatives 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nd/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA. See the LICENSE file for details.

More info