simple guides - esherproject/esher-core GitHub Wiki

Guide for Esher beginners

This tutorial helps you to getting started quickly from creating account to running a witness node.

Requirements

Linux VPS with Ubuntu 20.04 OS installed.
ESH Coin to pay some fees.

Create and backup account

The simplest way to create account is through online wallet at https://wallet.eshercrypto.com/. Create account and save your password.
Backup your account's keys using Paper Wallet.
- Open Settings > Account
- Click View Keys
- Click Create Paper Wallet button, it will download your paper wallet. In the paper wallet you will find all your private and public keys that we will be using in the next steps.

Download Binaries

Download the binaries from your VPS terminal

wget https://github.com/esherproject/esher-core/releases/download/2.0.0/esher-core-2.0.0-linux-amd64-bin.zip

Then extract

unzip esher-core-2.0.0-linux-amd64-bin.zip

Run the witness_node

Run a witness_node program doesn't make you automatically become a witness. However, to be a witness you must run a witness_node, so this is a preparation to become a witness.

Step 1:

Enter this command to run witness_node program

./witness_node

Optional but reommended Install and use screen to run it in the background

apt install screen
screen -S esher
./witness_node

Press ctrl + a + d keys to detach from the active screen and to go back to the witness_node screen, enter command screen -r esher

Step 2:

Open P2P Port
```
ufw allow 29310
```
Set RPC Port
- Open config.ini file in witness_node_data_dir
```
nano witness_node_data_dir/config.ini
```
- Edit parameters or add if not listed yet
```
rpc-endpoint =  127.0.0.1:29311
```
  Save and close the file
```
ctrl + o
enter
ctrl + x
```
Node will find peers and sync automatically. If it doesn't, follow these steps:
- Open config.ini file in witness_node_data_dir
- Edit parameters or add if not yet listed
```
p2p-endpoint = 0.0.0.0:29310
seed-node = 149.28.145.13:29310
seed-node = 202.182.125.231:29310
seed-node = 184.174.39.162:29310
seed-node = 45.32.118.13:29310
```
  Save and close the file
- Restart witness_node

Run cli_wallet

After node is synced, run this command to use cli_wallet

./cli_wallet --server-rpc-endpoint=ws://127.0.0.1:29311 --rpc-http-endpoint=127.0.0.1:8093 -u '' -p ''

Step 1: First time running you need to set password

new >>> set_password
Enter password: 
locked >>> unlock
Enter password:
unlocked >>>

Step 2: Import account from paper wallet

Import keys

import_key <account_name> <private_key>
import_key nathan "5JGi7DM7J8fSTizZ4D9roNgd8dUc5pirUe9taxYCUUsnXXXXXXX"

result: true

IMPORTANT! REPEAT THIS PROCESS FOR ALL YOUR THREE KEYS: Active Key, Owner Key, Memo Key

Import Balance

import_balance nathan ["5JGi7DM7J8fSTizZ4D9roNgd8dUc5pirUe9taxYCUUsnXXXXXXX"] true

Viewing imported account

get_account nathan

Listing the account balance

list_account_balances nathan

result sample: 1000.00000 ESH

Step 3: Upgrade account to lifetime member

upgrade_account nathan true

This operation will fail if you don't have ESH in your account

Exit cli_wallet press keys: ctrl + c

Congratulation! Now your account is upgraded to lifetime member and your witness_node is running, you are ready to be a witness and get reward by producing blocks. Tutorial to become a witness will be covered in a different document.