[testnet] Comment déployer un nœud NuLink ?¶

Configuration Requise¶

• Système d’exploitation : Debian GNU/Linux ;

• Architecture : x86-64 ;

• Espace disque : 30 Gio NVMe ;

• Mémoire : 4 Gio de RAM ;

• Une adresse IP statique ;

• Le port 9951 ouvert.

À savoir, il te faudra deux comptes :

1. un compte staker qui stake ses NLK, n’importe quel compte Metamask ou Rabby fait l’affaire ;

2. un compte worker qui sera lié au compte staker (on parle de bond en anglais), et nous verrons comment le créer par la suite.

Avant-propos¶

Les futures commandes à taper dans une console sont précédées par une légende pour indiquer sur quel environnement elles doivent être exécutées.

Exemple avec une commande qui devra être tapée dans la console de l’ordinateur (PC) :

echo 'Coucou depuis le PC !'

Et une commande qui devra être tapée dans la console du serveur (VPS, pour Virtual Private Server) sur lequel le nœud sera déployé :

echo 'Coucou depuis le serveur !'

Créer un Compte Worker¶

Nous devons passer par Geth pour la création du compte.

Donc, sur ton PC, installe Geth :

GETH_VERSION='1.13.11-8f7eb9cc'
GETH_FOLDER="geth-linux-amd64-${GETH_VERSION}"

wget "https://gethstore.blob.core.windows.net/builds/${GETH_FOLDER}.tar.gz" \
    && tar -xzf "${GETH_FOLDER}.tar.gz" \
    && cd "${GETH_FOLDER}" \
    && echo 'OK'

Et créé le compte :

./geth account new --keystore ./keystore \
    && echo 'OK'

Le fichier de la clé privée se trouve dans le dossier keystore et se nomme quelque chose comme UTC–xxx (où « xxx » est spécifique à chacun).

Hébergement¶

Créé ton compte sur Contabo, et utilise ce lien vers le serveur à louer avec la bonne configuration présélectionnée. À l’heure où j’écris ces lignes, la première facture est de 18,60 €, puis 11,40 €/mois.

Si tu décides d’utiliser un autre fournisseur, voire un ordinateur local, voici la configuration sélectionnée :

• 6 vCPU Cores

• 16 GB RAM

• 200 GB NVMe

• Debian 12

cat << EOF >> ~/.ssh/config
Host nulink
    User root
    HostName ADRESSE_IP
    Port 22
EOF

scp keystore/UTC--* nulink:/root \
    && echo 'OK'

ssh nulink

apt update \
    && apt full-upgrade -y \
    && apt autoremove -y \
    && apt install -y unattended-upgrades \
    && reboot

apt install -y ufw \
    && ufw limit ssh \
    && ufw allow 9151/tcp \
    && ufw enable \
    && echo 'OK'

curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc \
    && echo \
        "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
        $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
        tee /etc/apt/sources.list.d/docker.list > /dev/null \
    && apt update \
    && apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin \
    && echo 'OK'

mkdir nulink \
    && mv UTC--* nulink/ \
    && chmod -R 777 nulink \
    && echo 'OK'

docker pull nulink/nulink:latest \
    && echo 'OK'

echo "export NULINK_KEYSTORE_PASSWORD='TON_MOT_DE_PASSE_POUR_NULINK'" >> ~/.profile

echo "export NULINK_OPERATOR_ETH_PASSWORD='LE_MOT_DE_PASSE_DU_COMPTE_WORKER'" >> ~/.profile

exit

echo "${NULINK_KEYSTORE_PASSWORD}" \
    && echo "${NULINK_OPERATOR_ETH_PASSWORD}" \
    && echo 'OK'

docker run -it --rm \
    -p 9151:9151 \
    -v /root/nulink:/code \
    -v /root/nulink:/home/circleci/.local/share/nulink \
    -e NULINK_KEYSTORE_PASSWORD \
    nulink/nulink nulink ursula init \
    --signer keystore:///code/FICHIER_CLEF_PRIVEE \
    --eth-provider https://data-seed-prebsc-2-s2.binance.org:8545 \
    --network horus \
    --payment-provider https://data-seed-prebsc-2-s2.binance.org:8545 \
    --payment-network bsc_testnet \
    --operator-address ADRESSE_WORKER \
    --max-gas-price 10000000000 \
    && echo 'OK'

scp nulink:'/root/nulink/keystore/*' . \
    && echo 'OK'

docker run --restart on-failure -d \
    --name ursula \
    -p 9151:9151 \
    -v /root/nulink:/code \
    -v /root/nulink:/home/circleci/.local/share/nulink \
    -e NULINK_KEYSTORE_PASSWORD \
    -e NULINK_OPERATOR_ETH_PASSWORD \
    nulink/nulink nulink ursula run --no-block-until-ready \
    && echo 'OK'

docker logs -f ursula

docker stop ursula \
    && docker rm ursula \
    && docker pull nulink/nulink:latest \
    && echo 'OK'

Lier les Comptes¶

Le site web pour la gestion du staking est https://dashboard.testnet.nulink.org/staking. Plus bas dans cette page, il y a un bouton « Bond worker », clique dessus et renseigne l’adresse du compte worker. Et voilà !

📜 Historique¶

2024-03-03

Installation de unattended-upgrades pour garder le système d’exploitation à jour et réduire le temps de maintenance.

2024-02-17

Règle SSH du pare-feu plus protectrice.

2024-02-10

Simplification des étapes nécessitant SSH.

Mise à jour de l’adresse du token NLKTest (0xa22bfb00be8938c50833bfd2444ec721a9eeacc1 → 0x06a0f0fa38ae42b7b3c8698e987862afa58e90d9) suite à la migration de la phase 1 aux phases 2 & 3.

2024-01-27

Premier jet.