Lisk Commander allows you to communicate with a remote or local node and carry out Lisk-related functionality.
Lisk Commander requires Node.js as the underlying engine for code execution. Node.js is supported on most operating systems. Follow the instructions for your operating system on the Node.js downloads page. We currently require Node.js versions 8.3 and above. NPM is automatically installed along with Node.js.
$ npm install --global --production lisk-commander
Upon successful completion, NPM will add the
lisk to your PATH.
Clone the Lisk Commander repository using Git and install the dependencies:
$ git clone https://github.com/LiskHQ/lisk-commander.git $ cd lisk-commander $ npm install
Before running the executable you will need to build Lisk Commander:
npm run build
Adding the Lisk Commander executable to your PATH
WARNING: If you have installed Lisk Commander globally via NPM (see Install Lisk Commander via NPM), following the instructions in this section is not recommended as they will introduce conflicts.
If you would like to add the
lisk executable to your PATH you have two options: option 1 will install the current state of the code you are installing globally, while option 2 will only link to the code and therefore automatically reflect changes you make going forward.
1. Install globally
Running this command from within the repository will add Lisk Commander to your global NPM packages, and add the
lisk executable to your PATH. Be aware that any previous globally installed Lisk Commander version will get overridden with this local version.
$ npm install --global --production
Note that you will have to repeat this process for each subsequent build of Lisk Commander.
2. Create a symlink
The other option is to ask NPM to create a symlink in the global folder that links to the package.
$ npm link
This will also add
lisk to your PATH, but you won't have to repeat the process if you pull or create a new build. Be aware that any previous globally installed Lisk Commander version will get overridden with this local version.
$ lisk COMMAND running command... $ lisk (-v|--version|version) lisk-commander/2.0.0 darwin-x64 node-v8.12.0 $ lisk --help [COMMAND] A command line interface for Lisk VERSION lisk-commander/2.0.0 darwin-x64 node-v8.12.0 USAGE $ lisk [COMMAND] COMMANDS account Commands relating to Lisk accounts. block Commands relating to Lisk blocks. config Manages Lisk Commander configuration. copyright Displays copyright notice. delegate Commands relating to Lisk delegates. help Displays help. message Commands relating to user messages. node Commands relating to Lisk node. passphrase Commands relating to Lisk passphrases. signature Commands relating to signatures for Lisk transactions from multisignature accounts. transaction Commands relating to Lisk transactions. warranty Displays warranty notice.
lisk account- Commands relating to Lisk accounts.
lisk block- Commands relating to Lisk blocks.
lisk config- Manages Lisk Commander configuration.
lisk copyright- Displays copyright notice.
lisk delegate- Commands relating to Lisk delegates.
lisk help- Displays help.
lisk message- Commands relating to user messages.
lisk node- Commands relating to Lisk node.
lisk passphrase- Commands relating to Lisk passphrases.
lisk signature- Commands relating to signatures for Lisk transactions from multisignature accounts.
lisk transaction- Commands relating to Lisk transactions.
lisk warranty- Displays warranty notice.
Further information can be found on our documentation site:
Lisk Commander is an open-source project and all contributions are welcome.
If you find a bug or want to make feature request, please create an issue with as much detail as you can.
Lisk Commander has an extensive set of unit tests. To run the tests, please install Lisk Commander from source, and then run the command:
$ npm test
Something else went wrong. What should I do?
- Make sure you’re on the network you intend to be on.
- Remove the configuration file (
config.json) located in your Lisk Commander configuration directory (
~/.liskby default). When you restart Lisk Commander the default configuration will be recreated.
- Get in contact on Lisk Chat or Gitter.
- If it seems like a bug, open an issue on GitHub. See the Contribution Guidelines.
Copyright © 2017–2018 Lisk Foundation
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.