adshares/ads - Githubissues

ADS Blockchain

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.

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.

Install binaries from official PPA

sudo add-apt-repository ppa:adshares/releases -y
sudo apt-get update
sudo apt-get install ads ads-tools

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

mainnet: https://rpc.adshares.net
testnet: https://rpc.e11.click

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

PicoStocks - architecture, programmer
Jacek Zemło - architecture, programmer

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.

adshares / ads

readme