Light Validator

Last updated 2 months ago

Light Validator

andes-doc

Andes Network

Andes testnet is a testnet focused on enabling validators to test out their infrastructure by running nodes connected to the network.

Network Name

Dill Testnet Andes

RPC URL

https://rpc-andes.dill.xyz/

Chain ID

558329

Currency symbol

DILL

Explorer URL

https://andes.dill.xyz/

Hardware Requirement

Below are the minimum hardware requirements to run Dill light validator node. It is also part of the consensus network, requires staking and earns DILL token for reward.

Minimum

CPU

2 cores

Memory

Disk

20G

Network

1MB/s

If you are using cloud computing platform such as AWS EC2, you can check different instance configurations at https://aws.amazon.com/ec2/instance-types/

Or alternatively, you can use AWS Lightsail, which now offers the first 90 days free for the 2 GB Memory, 2 vCPUs Processing, 60 GB SSD Storage, 3 TB Transfer instances. More details are at https://lightsail.aws.amazon.com/ls/webapp/home/instances

Recommended OS

Ubuntu 22.04 (We are working on support for other Linux-like OS)

MacOS

PORT:

A. INSTALL

Run a light validator

Light validator is a type of node that performs availability validation solely through data sampling without participating in data sharding synchronization. It is also part of a consensus network. These nodes can participate in voting but will not act as proposers to generate new blocks. You can follow the steps below to start a light validator:

Download the light validator binary package from:
- MaxOS specific - https://dill-release.s3.ap-southeast-1.amazonaws.com/macos/dill.tar.gz
or simply run from your command line terminal:
```
curl -O https://dill-release.s3.ap-southeast-1.amazonaws.com/linux/dill.tar.gz
```

Extract the package:

tar -xzvf dill.tar.gz && cd dill

sample output

ubuntu@ip-xxxx:~$ curl -O https://dill-release.s3.ap-southeast-1.amazonaws.com/linux/dill.tar.gz
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 64.5M  100 64.5M    0     0  6655k      0  0:00:09  0:00:09 --:--:-- 8072k
ubuntu@ip-xxxx:~$ tar -xzvf dill.tar.gz && cd dill
dill/
dill/validators.json
dill/genesis.ssz
dill/dill_validators_gen
dill/start_light.sh
dill/dill-node
ubuntu@ip-xxxx:~/dill$

Generate validator keys using the key generation tool:

./dill_validators_gen new-mnemonic --num_validators=1 --chain=andes --folder=./

sample output

ubuntu@ip-xxxx:~/dill$ ./dill_validators_gen new-mnemonic --num_validators=1 --chain=andes --folder=./

***Using the tool on an offline and secure device is highly recommended to keep your mnemonic safe.***

Please choose your language ['1. العربية', '2. ελληνικά', '3. English', '4. Français', '5. Bahasa melayu', '6. Italiano', '7. 日本語', '8. 한국어', '9. Português do Brasil', '10. român', '11. Türkçe', '12. 简体中文']:  [English]: 3
Please choose the language of the mnemonic word list ['1. 简体中文', '2. 繁體中文', '3. čeština', '4. English', '5. Italiano', '6. 한국어', '7. Português', '8. Español']:  [english]: 4
Create a password that secures your validator keystore(s). You will need to re-enter this to decrypt them when you setup your Dill validators.:
Repeat your keystore password for confirmation:
The amount of DILL token to be deposited(2500 by default). [2500]:
This is your mnemonic (seed phrase). Write it down and store it safely. It is the ONLY way to retrieve your deposit.

Creating your keys.
Creating your keystores:	  [####################################]  1/1
Verifying your keystores:	  [####################################]  1/1
Verifying your deposits:	  [####################################]  1/1

Success!
Your keys can be found at: ./validator_keys

Press any key.
ubuntu@ip-xxxx:~/dill$

This will generate the validator keys and save them in ./validator_keys directory

ubuntu@ip-xxxxx:~/dill$ ls -ltr ./validator_keys
total 8
-r--r----- 1 ubuntu ubuntu 710 Jul 13 08:06 keystore-m_12381_3600_0_0_0-xxxxxx.json
-r--r----- 1 ubuntu ubuntu 706 Jul 13 08:06 **deposit_data-xxxx.json**
ubuntu@ip-xxxxx:~/dill$

Import your keys to your keystore:

./dill-node accounts import --andes --wallet-dir ./keystore --keys-dir validator_keys/ --accept-terms-of-use

During this process, you need to configure and save your keystore password.

sample output


ubuntu@ip-xxxxx:~/dill$ ./dill-node accounts import --andes --wallet-dir ./keystore --keys-dir validator_keys/ --accept-terms-of-use
[2024-07-13 08:08:34]  INFO flags: Running on the Andes Beacon Chain Testnet
Password requirements: at least 8 characters
New wallet password:
Confirm password:
[2024-07-13 08:08:39]  INFO wallet: Successfully created new wallet walletPath=/home/ubuntu/dill/keystore
[2024-07-13 08:08:39]  WARN client: You are using an insecure gRPC connection. If you are running your beacon node and validator on the same machines, you can ignore this message. If you want to know how to enable secure connections, see: https://docs.prylabs.network/docs/prysm-usage/secure-grpc
[2024-07-13 08:08:39]  INFO accounts: importing validator keystores...
[2024-07-13 08:08:39]  INFO accounts: checking directory for keystores: /home/ubuntu/dill/validator_keys
Enter the password for your imported accounts:
Importing accounts, this may take a while...
Importing accounts... 100% [===================================================================================]  [1s:0s]
[2024-07-13 08:08:44]  INFO local-keymanager: Reloaded validator keys into keymanager
[2024-07-13 08:08:44]  INFO local-keymanager: Successfully imported validator key(s) pubkeys=0xxxxx
[2024-07-13 08:08:44]  INFO accounts: Imported accounts [xxxxxx], view all of them by running `accounts list`
ubuntu@ip-xxxxx:~/dill$

Write the password you configured in the previous step into a file:
```
echo <my-password> > walletPw.txt
```

Start the light validator node

Here you need to specify your password file as a startup parameter. You can start the program with the following command:

./start_light.sh -p <password-path>

sample output

ubuntu@xxxxx:~/dill$ ./start_light.sh -p walletPw.txt
Option --pwdfile, argument 'walletPw.txt'
Remaining arguments:
using password file at walletPw.txt
start light node
start light node done
ubuntu@xxxxx:~/dill$ nohup: redirecting stderr to stdout

to check if the node is up and running and there should be one dill process running:
```
ps -ef | grep dill
```

sample output

ubuntu      1981       1 86 08:09 pts/0    00:00:43 /home/ubuntu/dill/dill-node --light --embedded-geth --datadir /home/ubuntu/dill/light_node/data/beacondata --genesis-state /home/ubuntu/dill/genesis.ssz --grpc-gateway-host 0.0.0.0 --initial-validators /home/ubuntu/dill/validators.j
...

Staking

visit https://staking.dill.xyz/
upload deposit_data-*.json
- you can use scp to copy to local or simply ubuntu@ip-xxx:~/dill$ cat ./validator_keys/deposit_data-xxxx.json to get the content and make a copy in your local machine

Connect to MetaMask，make sure you have enough balance（>2500 DILL）

Send deposit，using MetaMask to send a deposit transaction

B. MANAGEMENT:

1. Services Management

cd $HOME/dill

1.1 Check health node

./health_check.sh -v

1.2 Stop node

ps -ef | grep dill-node | grep -v grep | awk '{print $2}' | xargs kill

1.3 Start node

./start_light.sh -p walletPw.txt

1.4 Check logs

tail -f -n 100 $HOME/dill/light_node/logs/dill.log

1.5 Check on Explorer

Copy your pubkey in file deposit_data-xxxx.json and search it on explorer: https://andes.dill.xyz/validators?p=1&ps=1000

2. Fix port 8080 (change to 8081)

2.1 Stop node

cd $HOME/dill

ps -ef | grep dill-node | grep -v grep | awk '{print $2}' | xargs kill

2.2 Update file (use port 8081)

rm -rf $HOME/dill/health_check.sh && rm -rf $HOME/dill/start_light.sh && \
wget -O  $HOME/dill/start_light.sh https://raw.githubusercontent.com/nodesynctop/Dill/main/start_light.sh && \
wget -O  $HOME/dill/health_check.sh https://raw.githubusercontent.com/nodesynctop/Dill/main/health_check.sh && \
chmod +x health_check.sh && chmod +x start_light.sh

2.3 Start node

./start_light.sh -p walletPw.txt

PreviousEVM-eco NextDILL

Last updated 2 months ago

andes-doc

Andes Network

Andes testnet is a testnet focused on enabling validators to test out their infrastructure by running nodes connected to the network.

Network Name

Dill Testnet Andes

RPC URL

https://rpc-andes.dill.xyz/

Chain ID

558329

Currency symbol

DILL

Explorer URL

https://andes.dill.xyz/

Hardware Requirement

Below are the minimum hardware requirements to run Dill light validator node. It is also part of the consensus network, requires staking and earns DILL token for reward.

Minimum

CPU

2 cores

Memory

Disk

20G

Network

1MB/s

If you are using cloud computing platform such as AWS EC2, you can check different instance configurations at https://aws.amazon.com/ec2/instance-types/

Recommended OS

Ubuntu 22.04 (We are working on support for other Linux-like OS)

MacOS

PORT:

A. INSTALL

Run a light validator

Download the light validator binary package from:
- General Linux-like
- MaxOS specific - https://dill-release.s3.ap-southeast-1.amazonaws.com/macos/dill.tar.gz
or simply run from your command line terminal:
```
curl -O https://dill-release.s3.ap-southeast-1.amazonaws.com/linux/dill.tar.gz
```

Extract the package:

tar -xzvf dill.tar.gz && cd dill

sample output

ubuntu@ip-xxxx:~$ curl -O https://dill-release.s3.ap-southeast-1.amazonaws.com/linux/dill.tar.gz
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 64.5M  100 64.5M    0     0  6655k      0  0:00:09  0:00:09 --:--:-- 8072k
ubuntu@ip-xxxx:~$ tar -xzvf dill.tar.gz && cd dill
dill/
dill/validators.json
dill/genesis.ssz
dill/dill_validators_gen
dill/start_light.sh
dill/dill-node
ubuntu@ip-xxxx:~/dill$

Generate validator keys using the key generation tool:

./dill_validators_gen new-mnemonic --num_validators=1 --chain=andes --folder=./

sample output

ubuntu@ip-xxxx:~/dill$ ./dill_validators_gen new-mnemonic --num_validators=1 --chain=andes --folder=./

***Using the tool on an offline and secure device is highly recommended to keep your mnemonic safe.***

Please choose your language ['1. العربية', '2. ελληνικά', '3. English', '4. Français', '5. Bahasa melayu', '6. Italiano', '7. 日本語', '8. 한국어', '9. Português do Brasil', '10. român', '11. Türkçe', '12. 简体中文']:  [English]: 3
Please choose the language of the mnemonic word list ['1. 简体中文', '2. 繁體中文', '3. čeština', '4. English', '5. Italiano', '6. 한국어', '7. Português', '8. Español']:  [english]: 4
Create a password that secures your validator keystore(s). You will need to re-enter this to decrypt them when you setup your Dill validators.:
Repeat your keystore password for confirmation:
The amount of DILL token to be deposited(2500 by default). [2500]:
This is your mnemonic (seed phrase). Write it down and store it safely. It is the ONLY way to retrieve your deposit.

Creating your keys.
Creating your keystores:	  [####################################]  1/1
Verifying your keystores:	  [####################################]  1/1
Verifying your deposits:	  [####################################]  1/1

Success!
Your keys can be found at: ./validator_keys

Press any key.
ubuntu@ip-xxxx:~/dill$

This will generate the validator keys and save them in ./validator_keys directory

ubuntu@ip-xxxxx:~/dill$ ls -ltr ./validator_keys
total 8
-r--r----- 1 ubuntu ubuntu 710 Jul 13 08:06 keystore-m_12381_3600_0_0_0-xxxxxx.json
-r--r----- 1 ubuntu ubuntu 706 Jul 13 08:06 **deposit_data-xxxx.json**
ubuntu@ip-xxxxx:~/dill$

Import your keys to your keystore:

./dill-node accounts import --andes --wallet-dir ./keystore --keys-dir validator_keys/ --accept-terms-of-use

During this process, you need to configure and save your keystore password.

sample output


ubuntu@ip-xxxxx:~/dill$ ./dill-node accounts import --andes --wallet-dir ./keystore --keys-dir validator_keys/ --accept-terms-of-use
[2024-07-13 08:08:34]  INFO flags: Running on the Andes Beacon Chain Testnet
Password requirements: at least 8 characters
New wallet password:
Confirm password:
[2024-07-13 08:08:39]  INFO wallet: Successfully created new wallet walletPath=/home/ubuntu/dill/keystore
[2024-07-13 08:08:39]  WARN client: You are using an insecure gRPC connection. If you are running your beacon node and validator on the same machines, you can ignore this message. If you want to know how to enable secure connections, see: https://docs.prylabs.network/docs/prysm-usage/secure-grpc
[2024-07-13 08:08:39]  INFO accounts: importing validator keystores...
[2024-07-13 08:08:39]  INFO accounts: checking directory for keystores: /home/ubuntu/dill/validator_keys
Enter the password for your imported accounts:
Importing accounts, this may take a while...
Importing accounts... 100% [===================================================================================]  [1s:0s]
[2024-07-13 08:08:44]  INFO local-keymanager: Reloaded validator keys into keymanager
[2024-07-13 08:08:44]  INFO local-keymanager: Successfully imported validator key(s) pubkeys=0xxxxx
[2024-07-13 08:08:44]  INFO accounts: Imported accounts [xxxxxx], view all of them by running `accounts list`
ubuntu@ip-xxxxx:~/dill$

Write the password you configured in the previous step into a file:
```
echo <my-password> > walletPw.txt
```

Start the light validator node

Here you need to specify your password file as a startup parameter. You can start the program with the following command:

./start_light.sh -p <password-path>

sample output

ubuntu@xxxxx:~/dill$ ./start_light.sh -p walletPw.txt
Option --pwdfile, argument 'walletPw.txt'
Remaining arguments:
using password file at walletPw.txt
start light node
start light node done
ubuntu@xxxxx:~/dill$ nohup: redirecting stderr to stdout

to check if the node is up and running and there should be one dill process running:
```
ps -ef | grep dill
```

sample output

ubuntu      1981       1 86 08:09 pts/0    00:00:43 /home/ubuntu/dill/dill-node --light --embedded-geth --datadir /home/ubuntu/dill/light_node/data/beacondata --genesis-state /home/ubuntu/dill/genesis.ssz --grpc-gateway-host 0.0.0.0 --initial-validators /home/ubuntu/dill/validators.j
...

Staking

visit https://staking.dill.xyz/
upload deposit_data-*.json
- you can use scp to copy to local or simply ubuntu@ip-xxx:~/dill$ cat ./validator_keys/deposit_data-xxxx.json to get the content and make a copy in your local machine

Connect to MetaMask，make sure you have enough balance（>2500 DILL）

Send deposit，using MetaMask to send a deposit transaction
image

B. MANAGEMENT:

1. Services Management

cd $HOME/dill

1.1 Check health node

./health_check.sh -v

1.2 Stop node

ps -ef | grep dill-node | grep -v grep | awk '{print $2}' | xargs kill

1.3 Start node

./start_light.sh -p walletPw.txt

1.4 Check logs

tail -f -n 100 $HOME/dill/light_node/logs/dill.log

1.5 Check on Explorer

Copy your pubkey in file deposit_data-xxxx.json and search it on explorer: https://andes.dill.xyz/validators?p=1&ps=1000

2. Fix port 8080 (change to 8081)

2.1 Stop node

cd $HOME/dill

ps -ef | grep dill-node | grep -v grep | awk '{print $2}' | xargs kill

2.2 Update file (use port 8081)

rm -rf $HOME/dill/health_check.sh && rm -rf $HOME/dill/start_light.sh && \
wget -O  $HOME/dill/start_light.sh https://raw.githubusercontent.com/nodesynctop/Dill/main/start_light.sh && \
wget -O  $HOME/dill/health_check.sh https://raw.githubusercontent.com/nodesynctop/Dill/main/health_check.sh && \
chmod +x health_check.sh && chmod +x start_light.sh

2.3 Start node

./start_light.sh -p walletPw.txt