EVM-Lite CLI
A Command Line Interface to interact with an EVM-Lite node.
Table of Contents
Installation
You can easily install evmlc
with NPM
$ npm install -g evm-lite-cli
or with yarn
$ yarn global add evm-lite-cli
Commands
Flags
The global flag -d, --datadir
specifies the directory where keystore
and evmlc.toml
are stored unless overwritten by specific flags.
$ evmlc --datadir <path> <command>
Commands also have two logging level flags --silent
and --debug
which will silence and show debug logs respectively.
By default all commands will output formatted output. If you wish to script or require a JSON output use the -j, --json
flag.
For example to show JSON output for the info
command:
$ evmlc info --json evmlc http GET camille.monet.network:8080/info {"consensus_events":"4121","consensus_transactions":"99","events_per_second":"0.00","id":"3048798009","last_block_index":"112","last_consensus_round":"445","last_peer_change":"258","min_gas_price":"10","moniker":"mosaic","num_peers":"4","round_events":"0","rounds_per_second":"0.00","state":"Babbling","sync_rate":"1.00","time":"1574268876085188708","transaction_pool":"0","type":"babble","undetermined_events":"19"}
Data Directory
The first time evmlc
runs, and if no options are specified, it creates a
special directory in a default location, where it
stores any relevant information.
- Linux:
~/.evmlite
- Mac OS:
~/Library/EVMLITE
- Windows:
~/AppData/Roaming/EVMLITE
In particular, this directory contains the following items:
- evmlc.toml: where global options are specified
- keystore: where all encrypted account keys are stored
This directory is shared by EVM-Lite.
evmlc.toml
Example evmlc.toml:
[connection] # The IP address of the EVM-Lite nodehost = "localhost" # The listening port of the EVM-Lite serviceport = 8080 [defaults] # Moniker of the account to be used as default# usually the filename of the keyfilefrom = "moniker" # Gas will only default to this value for contract# calls as transfer will take a maximum of 21000 gasgas = 1000000 # DEPRECATED# Commands requiring gas price will pull the# minimum gas price of the requested node and# use with the transaction.gasPrice = 0
Note: from
refers to the moniker
of the account not the address
.
To change default configuration values run evmlc config set -i
or evmlc c s -i
. You will be
taken to an interactive prompt to change connection and default values.
$ evmlc config set -i ? Host: localhost? Port: 8080? From: moniker? Gas: 1000000? Gas Price: 0