How to register a legacy pillar

Development
1

Registering a legacy Pillar

Before you begin, ensure you have the necessary tools and code installed on your Pillar node.

Prerequisites

  1. 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
  1. 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"
  1. 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.

  1. 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.

  1. 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
  1. 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.

3 Likes
2

Nice work! Thanks for sharing! It’s not easy to figure out how to do this.

1 Like
3

I wouldn’t advise on registering the pillar on the VM. Importing your wallet keystore onto a VM is not a good idea.

If you have the address you’ll be using for the pillar on your local machine in Syrius, then you can do the pillar registration on your local machine.

The producer address/node still has to be set up on the VM.

1 Like
5

You are right. These instructions got a little expanded based on feedback from multiple participants. Initially they were generic but we have expanded them with each not launch.

But I agree, the 24 seed wallet should NOT be imported into the pillar. I’m going to adjust these instructions. I think the issue is many users probably don’t have multiple linux machines to do this from. So doing it from the Pillar is “EZ” but not safe.

6

I also wanted to point out that I took down my legacy node recently. I forgot that users needed it for Legacy Pillar launches. I will need to get one running again.

7

Maybe I’m missing something but why the need for multiple linux machines?

The producer node will of course have to be on a linux machine, but I would think it’s easier to register the pillar with your Syrius keystore on your local machine and then use Syrius to control the pillar.

1 Like
8

The issue for me was windows. I run syrius on windows and suck at everything else on windows. So I needed another linux machine to build the tool.

So when I did it I had the Pillar on a VPS, SYRIUS on windows, and then spun up a local VM on ubuntu to activate the legacy pillar.