Registering a legacy Pillar
Before you begin, ensure you have the necessary tools and code installed on your Pillar node.
Prerequisites
- Ensure that GCC is installed on your system. If not, install it using your package manager, e.g., for Ubuntu:
sudo apt-get install gcc
- Install Dart SDK (>2.14.0 < 3.0.0)
The cli tool does not support the latest Dart SDK yet it is constrained to >2.14.0 < 3.0.0.
Also the znn_sdk_dart (to Sentrify nodes) requires >=2.19.0 <3.0.0. So it is advised to download Dart SDK 2.19.0 (?).
cd ~
wget https://storage.googleapis.com/dart-archive/channels/stable/release/2.19.0/sdk/dartsdk-linux-x64-release.zip
unzip dartsdk-linux-x64-release.zip
sudo cp dart-sdk/bin/dart /usr/local/bin/
export PATH="$PATH:/usr/local/bin"
- Download the znn_controller in order to start syncing znnd, this will also give you the Producer address.
wget https://github.com/zenon-network/znn_controller_dart/releases/download/v0.0.4-alpha/znn_controller-linux-x86_64.zip
unzip znn_controller-linux-x86_64.zip
sudo ./znn_controller
Select deploy.
- Setting up your Firewall. Install UFW (Uncomplicated Firewall) and configure it to allow all outbound and inbound traffic on ports 22 and 35995 for both TCP and UDP:
4.1 Install UFW:
Open a terminal and run the following command to install UFW:
sudo apt update
sudo apt install ufw
4.2 Enable UFW:
After installing, you need to enable UFW with the following command:
sudo ufw enable
4.3 Allow SSH (Port 22):
By default, SSH operates on port 22. To allow inbound and outbound traffic on this port, run:
sudo ufw allow 22/tcp
4.4 Allow Traffic on Port 35995 (TCP and UDP):
To allow both inbound and outbound traffic on port 35995 for both TCP and UDP, execute the following commands:
sudo ufw allow 35995/tcp
sudo ufw allow 35995/udp
4.5 Verify the Rules:
To ensure that the rules have been added correctly, you can list all the active rules with:
sudo ufw status
This should display the rules you’ve just added, among others.
4.6 Optional - Deny All Incoming Traffic:
If you want to deny all other incoming traffic (recommended for security reasons) but allow outgoing traffic, you can set the default policies as follows:
sudo ufw default deny incoming
sudo ufw default allow outgoing
Note: This step is optional and is recommended for security. If you perform this step, only the ports you’ve explicitly allowed (like 22 and 35995) will accept incoming traffic.
4.7 Reload UFW:
After making all the changes, reload UFW to apply the new rules:
sudo ufw reload
That’s it! You’ve now installed UFW and configured it to allow traffic on ports 22 and 35995 for both TCP and UDP. Remember to periodically check and update your firewall rules to ensure the security of your system.
- Clone the required repository and switch to the correct branch:
cd ~
git clone https://github.com/vilkris4/znn_cli_dart.git
cd znn_cli_dart
git checkout register_legacy_pillar
- Build the project:
make
cd build
Once you have the necessary tools set up and have obtained a valid public key and signature needed to register a legacy Pillar, follow these instructions. Every command should be accompanied by the -u ws://127.0.0.1:35998
flag to connect to the right node. You cannot use a node with big int support. These instructions assume you are using the public node provided by deeZNNodez. Reference instructions: https://github.com/vilkris4/znn_cli_dart/blob/register_legacy_pillar/docs/tutorials/legacy_pillar_registration.md
Step 1
Fuse 150 QSR as Plasma to the address (NOT the producer address) you will be using for the Pillar.
(Optional) If you decide to create a separate wallet in Syrius (withdraw address), you will have to import your keystore in the .cli.
./znn-cli wallet.createFromMnemonic "24 words" passphrase [KeyStoreName]
!IMPORTANT!
In order to complete the next steps, you would need to add -k [KeystoreName] to each command in order to call the right address. If you are using Syrius, you can view the address list to get the index of the address. The index of the first address is 0, the second one is 1, the third one is 2, etc.
Step 2
Verify that the address you will be using for the Pillar has the required ZNN (15,000) and QSR (150,000). Add the -i
flag to the end of the command and specify the index of the address you will be using for the Pillar. If you are using Syrius, you can view the address list to get the index of the address. The index of the first address is 0, the second one is 1, the third one is 2, etc.
Linux
./znn-cli balance -i 0 -u wss://secure.deeznnodez.com:35998
or
./znn-cli balance -i 0 -k [KeystoreName] -u wss://secure.deeznnodez.com:35998
Step 3
Deposit the 150,000 QSR needed to register the Pillar. The QSR will be burned when the Pillar is registered. Again, add the -i
flag to the end of the command to specify the index of the address.
Linux
./znn-cli pillar.depositQsr 150000 -i 0 -u wss://secure.deeznnodez.com:35998
Step 4
Wait a short while and verify the QSR was deposited successfully.
Linux
./znn-cli pillar.getDepositedQsr -i 0 -u wss://secure.deeznnodez.com:35998
Step 5
Everything is now set up and the pillar can be registered. You should have obtained the legacyPillarPubKey
and legacyPillarSignature
from the seller of the legacy Pillar slot.
Register the pillar with the following command. Replace the arguments with your own values and remember to add the -i
flag to the end of the command to specify the index of the address you are using.
Double check that there are no typos in the name, since it cannot be changed once the Pillar has been registered.
Linux
./znn-cli pillar.registerLegacy name producerAddress rewardAddress giveBlockRewardPercentage giveDelegateRewardPercentage legacyPillarPubKey legacyPillarSignature -i 0 -u wss://secure.deeznnodez.com:35998
Example command with real arguments:
./znn-cli pillar.registerLegacy Anvil z1qzkd8urw7c4wg6x0cvd2nrzr4ke9d4zh0tvd8s z1qptjd99906x57ej6n55zvmsdm234lngrsreyc2 0 0 BGAjJAT6H2LkTDe3I1Iwoh2XGr+17u8gXI6k1bESJALhW/pInYwN8FEi8zCVUqQc55Tb+GpyP6MpiwCglm2M/Po= H0+k3lo/QvW+myeQ2GzKKjUWyJh96xERkiuyXStNNTocL+5NaCiTjC/b+E2NEHcT1jt/B3gf5L5T1rbXlCfA7VA= -i 0 -u wss://secure.deeznnodez.com:35998
Step 6
Wait a short while and verify the Pillar was registered successfully by checking the Pillar list.
Linux
./znn-cli pillar.list -u wss://secure.deeznnodez.com:35998
Now the instructions are updated with the node URL flag and the prerequisites for GCC and cloning the repository.