Lisk Service is a web application that allows interaction with various blockchain networks based on Lisk and Bitcoin protocols.

The main focus of Lisk Service is to provide data to the UI clients such as Lisk Desktop and Lisk Mobile. Lisk Service makes it possible to access all live blockchain data in a similar manner to the regular Lisk SDK API. In addition, Lisk Service also provides users with much more detailed information and endpoints, such as geolocation and various statistics about network usage, etc.

The project implementation is based on Microservices. The technical stack is designed to deliver several micro-services, and each of them provides one particular functionality. The data is served in JSON format and exposed by a public RESTful API.

Lisk Service consists of several separate modules, that can be run independently from the others. The Gateway is required to expose the APIs provided by the specific services.

Each service is an independent part of the repository and is placed in a separate directory in the ./services/ directory. Each of them contains its own package.json and Dockerfile that are needed to run the module.

Remarks

• Lisk Service is configured to connect a local node via WebSocket on port 8080 by default.
• The default installation method is based on Docker.
• Some token conversion rates in the market service require their own API keys.

The Gateway service provides the following APIs, which all users of Lisk Service can access and use.

The default port for REST API requests and Socket.io-based communication is 9901, it is possible to access it through the URL http://localhost:9901/. The REST API can be accessed by any HTTP client such as Postman, cURL and HTTPie.

WebSocket-based APIs can by used through a socket.io library available for many modern programming languages and frameworks.

To continue the installation ensure that you have the following dependencies installed:

• NodeJS Active LTS - ^v16.15.0
• MySQL - ^v8.0.29
• Docker with Docker compose
• GNU Make and GNU Tar

Follow the instructions listed below, in order to acquire detailed information regarding the installation of required dependencies for various operating systems.

• Ubuntu 18.04 LTS Bionic Beaver
• Ubuntu 20.04 LTS Focal Fossa
• Debian 10 Buster
• MacOS 10.15 Catalina

Retrieve the latest release from the official repository.

Unpack the source code archive by executing the following commands listed below:

tar xf lisk-service-x.y.z.tar.gz
cd lisk-service

Although the above commands retrieve the entire source code, this instruction does not cover building a custom version of Lisk Service. For more information refer to this document: Building Lisk Service from source

If you wish to build the local version of Lisk Service execute the following command below:

make build

This step is only necessary if you wish to build a custom or pre-release version of Lisk Service that does not have a pre-built Docker image in the Docker Hub. The installation script chooses the last available stable version on Docker Hub, unless there is no local image. If you are unsure about any local builds, use make clean command to remove all locally built docker images.

The default configuration is sufficient to run Lisk Service against the local node.

Before running the application copy the default docker-compose environment file:

cp docker/example.env .env

In the next step, set the required environment variables.

$EDITOR .env

The example below assumes that the Lisk Core node is running on the host machine, and not inside of a Docker container.

## Required
# The local Lisk Core node WebSocket API port
export LISK_CORE_WS="ws://host.docker.internal:8080"

When running Lisk Core inside of a Docker container, the variable needs to refer to the container: LISK_CORE_WS="ws://<your_docker_container>:8080".

It is strongly recommended that you synchronize your Lisk Core node with the network before starting the Lisk Service.

Configuration options are described in this document.

Optional: Check your configuration with the command make print-config

To run the application execute the following command:

make up

To stop the application execute the following command:

make down

Optional: It is possible to use regular docker-compose commands such as docker-compose up -d. Please check the Makefile for more examples.

Assuming lisk-service is running on the localhost:9901, and you are in the root of this repo, you can run the following:

cd tests
LISK_SERVICE_URL=http://localhost:9901 npm run benchmark

The possibility to customize and build Lisk Service from a local source is described in the following document Building Lisk Service from source. This may also be also useful for PM2-based installations.

https://github.com/LiskHQ/lisk-service/graphs/contributors

Copyright 2016-2019 Lisk Foundation

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.