For the best viewing experience, please turn your phone to portrait mode.

Lisk Elements Documentation

Lisk Elements is a JavaScript library containing several separately-installable npm packages, each covering a distinct region of Lisk-related functionality.

Versions

Documentation on lisk.io remains up to date with version updates. The table below provides an overview about the former releases and documentation versions of Lisk Elements.

Version Release date
(yy/mm/dd)
Documentation reference
v2.3.0 19/08/02 Current version, live on lisk.io/documentation
v2.2.0 19/07/24 Lisk Elements 2.2 docs
v2.1.0 19/06/24 Lisk Elements 2.1 docs
v2.0.0 19/01/07 Lisk Elements 2.0 docs
v1.1.3 18/11/22 Lisk Elements 1.1 docs
v1.0.0 18/08/06 Lisk Elements 1.0 docs

Setup

Supported Platforms

  • Platforms with Node.js version 8.10 and above.

Pre-Installation

Lisk Elements requires Node.js as the underlying engine for code execution.
This document describes how to install Node and NPM for installation via NPM.

Install Node

Follow the instructions for your operating system on the Node.js downloads page.

NPM is automatically installed along with Node.js.

Verify Installation

Confirm that Node.JS and NPM have been successfully installed by running

node --version
npm --version

Installation

This section details how to install Lisk Elements for a given distribution.

As all packages in Lisk Elements are independent from each other, they can be installed seperately.

Installation via NPM

To install the latest version of Lisk Elements for use as a dependency in a Node.js project, please proceed with the following:

Complete library

npm install --save lisk-elements

Specific package

npm install --save @liskhq/<package-name>

where <package-name> can be any of the sub packages in Lisk Elements.

For concrete code examples for each package, check the Packages section.

Upon successful completion, NPM will add the Lisk Elements package to your package.json file.

Load via CDN

Include the following script using the following HTML. The lisk variable will be exposed.

Client library

<script src="https://js.lisk.io/lisk-client-2.1.1.js"></script>

Or minified:

<script src="https://js.lisk.io/lisk-client-2.1.1.min.js"></script>

To include other packages of Lisk Elements, replace lisk-client with any of the packages of Lisk Elements.

Upgrade

To update your installation to the latest version of Lisk Elements, simply run the following command:

npm update --save lisk-elements

Contribute to the Codebase

Everyone is invited to contribute to the Lisk Elements codebase. We welcome and appreciate all contributions.

Github

All necessary information can be found on our Lisk Elements Github.

Contribution Guidelines

Please be sure to read and follow our Contribution Guidelines.

Gitter

If you have any further questions please join our Gitter channel.


What's next?
Packages