How to Join the Nym Testnet - Node Setup Guide

Данный гайд предназначен для Nym Mainnet

!!!!! ОБЯЗАТЕЛЬНО СОХРАНЯЙТЕ ФАЙЛЫ КЛЮЧЕЙ ИЗ ПАПКИ ~/.nym/mixnodes/<ваш_айди>/data – 4 файла с расширением .pem! А так же мнемоник фразу от кошелька. Это единственный способ восстановить ваши данные.

Установка

Замените YOUR_WALLET на адрес вашего нового кошелька (Nym Mainnet wallet).

wallet=YOUR_WALLET
echo 'export wallet='$wallet >> $HOME/.bash_profile

Для установки ноды с нуля выполните однострочный скрипт установки:

wget -O nym_mainnet.sh https://api.nodes.guru/nym_mainnet.sh && chmod +x nym_mainnet.sh && ./nym_mainnet.sh

Открываем кошелек Nym Wallet и авторизуемся с помощью Mnemonic phrase или пароля.
Переходим в раздел Bond и заполняем все строки, данные для заполнения можно узнать выполнив команду:

. $HOME/.bash_profile
nym-mixnode node-details --id $node_id

Замените YOUR_IDENTITY_KEY на ключ полученный выше:

nym-mixnode sign --id $node_id --contract-msg YOUR_IDENTITY_KEY

Нажимаем Confirm, должно все пройти без ошибок. Если всё прошло хорошо должны получить такой результат

Возвращаемся в терминал и дожидаемся начала микса пакетов.
Проверить можно командой:

journalctl -u nym-mixnode -o cat -f | grep "Since startup mixed"

Убедитесь, что на вашей ноде открыты порты 1789, 1790, 8000 (и 443, 22, 80) для правильной работы миксноды . Больше информации о портах в официальной документации.
Если все прошло успешно, ваша нода появится в NG Mixnet Explorer

ДЕЛЕГИРОВАНИЕ

Для делегирования необходимо открыть кошелёк и выбрать пункт Delegate, не забываем оставить монетку на комиссию.
Identity key – Mixnode identity ноды (микснода Nodes.Guru 8D5QgyAGqCgChDCxMqQKZpYPNb8hpDNQS43eBJUWagnW)
Amount to delegate – количество токенов для делегирования
Нажимаем DELEGATE STAKE.

Далее можно проверить, что ваша делегация прибавилась к стэйку миксноды в NG Mixnet Explorer

Полезные команды

Добавить описание для вашей миксноды(имя которое будет отображаться в эксплорере):

nym-mixnode describe --id $node_id
systemctl restart nym-mixnode

Посмотреть сколько пакетов смиксила ваша нода:

journalctl -u nym-mixnode -o cat -f | grep "Since startup mixed"

Перезапустить ноду:

systemctl restart nym-mixnode

Обновление ноды до последнего релиза.
После обновления обязательно укажите новую версию микс ноды в кошельке!

wget -O nym_update.sh https://api.nodes.guru/nym_update.sh && chmod +x nym_update.sh && ./nym_update.sh

Расширить ulimit (важно для работы ноды в будущем):

– вариант в одну строчку

wget -O nym_ulimit.sh https://api.nodes.guru/nym_ulimit.sh && chmod +x nym_ulimit.sh && ./nym_ulimit.sh

– вариант вручную

echo "DefaultLimitNOFILE=65535" >> /etc/systemd/system.conf
sudo systemctl daemon-reload
sudo systemctl stop nym-mixnode
sudo systemctl start nym-mixnode

проверяем, что значение ulimit=65535

grep -i "Max open files" /proc/$(ps -A -o pid,cmd|grep nym-mixnode | grep -v grep |head -n 1 | awk '{print $1}')/limits

Проверка ipv6
Посмотреть свой внешний ipv6:

curl http://v4v6.ipv6-test.com/api/myip.php && echo

Проверить связь с google.de по ipv6:

ping6 www.google.de

Посмотреть есть ли ipv6 в сетевых настройках сервера:

hostname -I

Расшифровка ваших public ключей:
Выполняем команды (snapd на вашей OS может устанавливаться иначе):

apt install snapd
snap install base58
ls -1 $HOME/.nym/mixnodes/*/data/public_identity.pem | while read F; do echo === $F ===; grep -v ^- $F | openssl base64 -A -d | base58; echo; done
ls -1 $HOME/.nym/mixnodes/*/data/public_sphinx.pem | while read F; do echo === $F ===; grep -v ^- $F | openssl base64 -A -d | base58; echo; done

Удаление ноды:

sudo systemctl stop nym-mixnode
sudo systemctl disable nym-mixnode
rm -rf ~/nym ~/.nym
rm -f /etc/systemd/system/nym-mixnode.service
rm -f /usr/bin/nym-mixnode

Troubleshooting

Если нода так и не завелась (например, ошибка could not create TCP Listener; или mixed packets по нулям за 10 минут), проверьте следующее:
1) открыт ли порт TCP 1789 на сервере?
2) открыт ли порт TCP 1789 на входящие-исходящие соединения в Firewall настройках сервера в панели управления сервером?
3) если вы используете Google Cloud, AWS, запускаете ноду не на рекомендованных хостах, или вообще на домашнем компьютере:
4.1) убедитесь, что у вас есть статический ip
4.2) изучите официальную документацию на предмет инициализации ноды с кастомным указанием внутреннего и внешнего айпи адреса
4.3) убедитесь, что в Bond форме вбили верный (внешний) айпи

Анделегейт токенов через cli, НЕ НУЖНО ДЛЯ МИКСНОДЫ.

Установка бинарника:

wget -q -O nyx.sh https://api.nodes.guru/nyx.sh && chmod +x nyx.sh && sudo /bin/bash nyx.sh && source ~/.bash_profile

Добавляем ваш кошелёк:

nyxd keys add wallet --recover

Анделегейт токенов. Замените только $MIX_ID на Mix ID миксноды в которую делегировали, остальные поля оставьте без изменений:

nyxd tx wasm execute n17srjznxl9dvzdkpwpw24gg668wc73val88a6m5ajg6ankwvz9wtst0cznr '{"undelegate_from_mixnode":{"mix_id":"$MIX_ID"}}' --from wallet --fees=50000unym --chain-id nyx --broadcast-mode block --note "undelegating through NG" --node https://rpc-1.nyx.nodes.guru:443/ --gas=auto --gas-adjustment 1.4

Пример полной команды:

nyxd tx wasm execute n17srjznxl9dvzdkpwpw24gg668wc73val88a6m5ajg6ankwvz9wtst0cznr '{"undelegate_from_mixnode":{"mix_id":10}}' --from wallet --fees=50000unym --chain-id nyx --broadcast-mode block --note "undelegating through NG" --node https://rpc-1.nyx.nodes.guru:443/ --gas=auto --gas-adjustment 1.4