Установка ноды Massa на Ubuntu: из binary или source

Содержание

Мы долгое время участвовали в вознаграждаемом тестнете от L1 проекта Massa, потом нам сообщили о наградах и предложили участвовать в основной сети (Mainnet). Сейчас каждый, кто попал в этот список может развернуть ноду в мейне.

В списке ищите (Ctrl+F) тот адрес, который вы указывали в дашборде Massa, когда указывали там адресс для наград.

Если ваш адрес есть в списке, то вам нужно до 14 января 2024 установить ноду. Если вашего адреса нет — вы сможете поднять ноду после 15 января. Для этого вам потребуется как минимум 100 MAS.

Напротив адреса вы увидите кол-во активных роллов. Один ролл = 100 монетам MAS. Роллы мы будем стейкать на ноду.

Награды

За участие в стейкинге на ноде участники получают вознаграждение.

Во-первых, более 7000 новых монет Massa создаются каждый час и раздаются стейкерам в качестве вознаграждений.
Во-вторых, стейкеры получают долю операционных комиссий, включенных в блоки, которые они производят.
В-третьих, поддерживая безопасность сети, стейкеры увеличивают стоимость принадлежащих им монет Massa.

Насколько будут «приятны» награды, пока сказать сложно. Все зависит от того, сколько будут стоить монеты во время листинга и в момент их продажи. Посмотрим, увидим.

Требования к оборудованию

Рекомендуемые характеристики из официальной документации:
8 cores, 16 GB RAM, 1TB disk

Но на начальном этапе, я думаю, вполне хватит машины от 4 ядер, 8 Гб RAM и 400 Гб диск. Это может быть домашний ПК или VPS/VDS.

Где взять сервер?

Я использую такие для своих нод:

Hetzner / Contabo — (РФ в бане, нужны зарубежные доки/адреса и прокси).
Spacecore.pro (реселлеры hetzner, сам только начал их использовать, за качество не ручаюсь).

Ноду MASSA поднял на VDS в Hetzner, на котором уже стоят другие ноды.

Установка ноды

Официальная документация — будем делать все по ней. Тут нам предлагают 2 варианта установки:

From binaries (simple installation) — простая установка из бинарников. Подойдет если у вас Ubuntu 22.04. На 20.04 — нода не заведется. Если ставите новый сервер, то рекомендую сразу поставить Ubuntu 22.04 и воспользоваться этой установкой.
From source code (advanced installation) — установка из исходников. Подойдет если у вас Ubuntu 20.04.

Проект состоит из 2х приложений:

Нода — создаёт блоки, должен работать постоянно без перебоев;
Клиент — позволяет взаимодействовать с кошельком и сетью с помощью различных команд. Запускается при необходимости во время работающей ноды.

Шаг 1. Установим ноду и запустим Massa Client

Подключайтесь к своему серверу по SSH, используя терминал. Я использую удобную бесплатную прогу: MobaXterm.

В терминале вводим команды, которые будут ниже. После копирования и вставки блока кода (провой кнопкой мыши) — жмем Enter.

Установка из бинарных файлов (Ubuntu 22.04)

Обновляем пакеты и устанавливаем необходимое ПО

 sudo apt update && sudo apt upgrade -y sudo apt install curl git wget htop tmux build-essential jq make lz4 gcc -y

1 2	sudo apt update && sudo apt upgrade -y sudo apt install curl git wget htop tmux build-essential jq make lz4 gcc -y

Скачиваем готовые официальные бинарники с гитхаба Massa

 cd $HOME wget https://github.com/massalabs/massa/releases/download/MAIN.2.3/massa_MAIN.2.3_release_linux.tar.gz tar zxvf massa_MAIN.2.3_release_linux.tar.gz rm massa_MAIN.2.3_release_linux.tar.gz

cd $HOME

wget https://github.com/massalabs/massa/releases/download/MAIN.2.3/massa_MAIN.2.3_release_linux.tar.gz

tar zxvf massa_MAIN.2.3_release_linux.tar.gz

rm massa_MAIN.2.3_release_linux.tar.gz

Ссылка актуальна для MAIN.2.3, если вы читаете этот гайд, но уже доступна новая версия, попробуйте изменить номер 2.3 в ссылке на номер актуальной версии).

Создаем config.toml и задаем ip сервера

 sudo tee <<EOF >/dev/null $HOME/massa/massa-node/config/config.toml [protocol] routable_ip = "`wget -qO- eth0.me`" EOF

sudo tee <<EOF >/dev/null $HOME/massa/massa-node/config/config.toml

[protocol]

routable_ip = "`wget -qO- eth0.me`"

EOF

Создаем сервис, чтобы нода работала в фоновом режиме и не останавливалась после закрытия терминала.

Замените слово ВАШ_ПАРОЛЬ своим паролем — тем же паролем, который вы использовали при создании кошелька.

Скопируйте приведенный ниже блок в Блокнот, замените в 7 строке ВАШ_ПАРОЛЬ. Затем скопируйте весь текст целиком и вставьте его в командную строку.

 printf "[Unit] Description=Massa Node After=network-online.target [Service] User=$USER WorkingDirectory=$HOME/massa/massa-node ExecStart=$HOME/massa/massa-node/massa-node -p ВАШ_ПАРОЛЬ Restart=on-failure RestartSec=3 LimitNOFILE=65535 [Install] WantedBy=multi-user.target" > /etc/systemd/system/massad.service

printf "[Unit]

Description=Massa Node

After=network-online.target

[Service]

User=$USER

WorkingDirectory=$HOME/massa/massa-node

ExecStart=$HOME/massa/massa-node/massa-node -p ВАШ_ПАРОЛЬ

Restart=on-failure

RestartSec=3

LimitNOFILE=65535

[Install]

WantedBy=multi-user.target" > /etc/systemd/system/massad.service

Активируем, запускаем сервис

sudo systemctl daemon-reload
sudo systemctl enable massad
sudo systemctl restart massad

sudo systemctl daemon-reload

sudo systemctl enable massad

sudo systemctl restart massad

И смотрим логи

sudo journalctl -f -n 100 -u massad

1	sudo journalctl -f -n 100 -u massad

Чтобы выйти из логов жмем Ctrl + C.

Запускаем Massa client и задаем пароль

cd && cd $HOME/massa/massa-client/
./massa-client

1 2	cd && cd $HOME/massa/massa-client/ ./massa-client

Установка из исходников (Ubuntu 20.04)

Обновляем пакеты и устанавливаем необходимое ПО

sudo apt update && sudo apt upgrade -y
sudo apt install pkg-config curl git build-essential libssl-dev libclang-dev cmake

1 2	sudo apt update && sudo apt upgrade -y sudo apt install pkg-config curl git build-essential libssl-dev libclang-dev cmake

Устанавливаем Раст (выбираем 1)

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

1	curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs \| sh

Указываем путь

source $HOME/.cargo/env

1	source $HOME/.cargo/env

Ставим rust 1.74.1, делаем его дефолтным и проверяем версию (должна быть 1.74.1)

rustup toolchain install 1.74.1
rustup default 1.74.1
rustc --version

rustup toolchain install 1.74.1

rustup default 1.74.1

rustc --version

Клонируем себе на сервер репозитарий с гитхаба Massa

git clone https://github.com/massalabs/massa.git

1	git clone https://github.com/massalabs/massa.git

Создаем config.toml и указываем там ip сервера

sudo tee <<EOF >/dev/null $HOME/massa/massa-node/config/config.toml
[protocol]
routable_ip = "`wget -qO- eth0.me`"
EOF

sudo tee <<EOF >/dev/null $HOME/massa/massa-node/config/config.toml

[protocol]

routable_ip = "`wget -qO- eth0.me`"

EOF

Создаем сервис, чтобы нода работала в фоновом режиме и не останавливалась после закрытия терминала.

Замените слово ВАШ_ПАРОЛЬ своим паролем — тем же паролем, который вы использовали при создании кошелька.

Скопируйте приведенный ниже блок в Блокнот, замените в 8 строке ВАШ_ПАРОЛЬ. Затем скопируйте весь текст целиком и вставьте его в командную строку.

sudo tee /etc/systemd/system/massad.service > /dev/null << EOF
[Unit]
Description=Massa Node
After=network-online.target
[Service]
User=root
WorkingDirectory=/root/massa/massa-node
ExecStart=/root/.cargo/bin/cargo run --release -- -p <ВАШ_ПАРОЛЬ>
Restart=on-failure
RestartSec=3
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
EOF

sudo tee /etc/systemd/system/massad.service > /dev/null << EOF

[Unit]

Description=Massa Node

After=network-online.target

[Service]

User=root

WorkingDirectory=/root/massa/massa-node

ExecStart=/root/.cargo/bin/cargo run --release -- -p <ВАШ_ПАРОЛЬ>

Restart=on-failure

RestartSec=3

LimitNOFILE=65535

[Install]

WantedBy=multi-user.target

EOF

Активируем, запускаем сервис

systemctl daemon-reload
systemctl enable massad
systemctl start massad

systemctl daemon-reload

systemctl enable massad

systemctl start massad

И смотрим бегущие логи

sudo journalctl -f -n 100 -u massad

1	sudo journalctl -f -n 100 -u massad

В них вы увидите процесс компиляции

Ждите пока не увидите такие логи:

Чтобы выйти из логов жмем Ctrl + C.

Запускаем Massa Client

cd && cd massa/massa-client/ && cargo run --release -- -p ВАШ_ПАРОЛЬ

1	cd && cd massa/massa-client/ && cargo run --release -- -p ВАШ_ПАРОЛЬ

Шаг 2. Добавляем кошелек и включаем стейкинг

Команды ниже вставляются в клиенте (Massa Client) и они одинаковы для обоих вариантов установки.

Восстанавливаем кошелек. Вместо ВАШ_secret_key вставьте Secret key от вашего кошелька

wallet_add_secret_keys ВАШ_secret_key

1	wallet_add_secret_keys ВАШ_secret_key

Чтобы просмотреть адрес кошелька в Massa client. Эта же команда используется для проверки баланса.

wallet_info

1	wallet_info

Включаем стейкинг. Замените ВАШ_АДРЕСС_КОШЕЛЬКА на адрес вашего кошелька

node_start_staking ВАШ_АДРЕСС_КОШЕЛЬКА

1	node_start_staking ВАШ_АДРЕСС_КОШЕЛЬКА

Если все успешно, вы увидите надпись: Keys successfully added!

Выходим из клиента — жмем Ctrl + C.

Firewall
Для ноды нужно открыть порты 31244 и 31245 и установить правила фаервола.

sudo ufw default allow outgoing 
sudo ufw default deny incoming 
sudo ufw allow ssh/tcp 
sudo ufw allow 31244 && sudo ufw allow 31245
sudo ufw enable

sudo ufw default allow outgoing

sudo ufw default deny incoming

sudo ufw allow ssh/tcp

sudo ufw allow 31244 && sudo ufw allow 31245

sudo ufw enable

Проверить открыты ли порты можно на portchecker.co. Вставляем IP своего сервера и порты.

Проверяем статус ноды

Снова заходим в клиента (Massa Client) и там вводим

get_status

1	get_status

Чтобы нода нормально работала, она должна подключиться к другим узлам (peers) сети. В Network stats вы должны видеть, что присутствуют как IN, так и OUT подключения.

IN, OUT

Обновление ноды

Если вышла новая версия, то обновиться довольно просто: останавливаем ноду, скачиваем обнову, запускаем ноду.

Обновление до версии MAIN.2.3

Обновление для тех, кто устанавливал из бинарников

Сделать резервную копию файлов на всякий случай (скачайте себе):

/massa/massa-node/config/node_privkey.key
/massa/massa-client/wallets

1 2	/massa/massa-node/config/node_privkey.key /massa/massa-client/wallets

Скачиваем новую версию с гита, распаковываем и перезапускаем ноду

wget https://github.com/massalabs/massa/releases/download/MAIN.2.3/massa_MAIN.2.3_release_linux.tar.gz
tar zxvf massa_MAIN.2.3_release_linux.tar.gz
sudo systemctl stop massad && sudo systemctl start massad

wget https://github.com/massalabs/massa/releases/download/MAIN.2.3/massa_MAIN.2.3_release_linux.tar.gz

tar zxvf massa_MAIN.2.3_release_linux.tar.gz

sudo systemctl stop massad && sudo systemctl start massad

Обновление для тех, кто ставил из source

Сделать резервную копию файлов (скачайте себе):

/massa/massa-node/config/node_privkey.key
/massa/massa-client/wallets

1 2	/massa/massa-node/config/node_privkey.key /massa/massa-client/wallets

Стопаем ноду

sudo systemctl stop massad

1	sudo systemctl stop massad

Удаляем папку

rm -rf $HOME/massa

1	rm -rf $HOME/massa

Клонируем с гита новую версию

git clone https://github.com/massalabs/massa.git

1	git clone https://github.com/massalabs/massa.git

Закидываем те файлы, которые копировали выше по путям

/massa/massa-node/config/node_privkey.key 
/massa/massa-client/wallets

1 2	/massa/massa-node/config/node_privkey.key /massa/massa-client/wallets

Запускаем ноду

systemctl start massad

1	systemctl start massad

После обновления смотрим логи (sudo journalctl -f -n 100 -u massad), заходим в клиент и проверяем чтобы там был наш кошелек и верный баланс. Также не забудьте включить стейкинг (node_start_staking ВАШ_АДРЕСС_КОШЕЛЬКА).

Полезные команды в клиенте

Покупка ROLL

1 ROLL стоит 100 MAS. После покупки роллов их можно застейкать на нашу ноду.

В Massa Client вставляем команду ниже, меняя там ВАШ_АДРЕС_КОШЕЛЬКА, сколько роллов купить (1) и operation fee (можно ставить 0.01).

buy_rolls ВАШ_АДРЕС_КОШЕЛЬКА 1 0.01

1	buy_rolls ВАШ_АДРЕС_КОШЕЛЬКА 1 0.01

Через минуту или несколько, роллы должны отображаться на балансе (wallet_info).

Продажа ROLL

sell_rolls ВАШ_АДРЕС_КОШЕЛЬКА 1 0

1	sell_rolls ВАШ_АДРЕС_КОШЕЛЬКА 1 0

Создание нового кошелька

wallet_generate_secret_key

1	wallet_generate_secret_key

Отправить монеты MAS на другой адресс

send_transaction ВАШ_АДРЕС_КОШЕЛЬКА АДРЕС_КОМУ_ОТПРАВЛЯЕМ 1 0.01

1	send_transaction ВАШ_АДРЕС_КОШЕЛЬКА АДРЕС_КОМУ_ОТПРАВЛЯЕМ 1 0.01

1 — сколько отправляем, 0.01 — operation fee.

Сделать бекап ноды и кошелька

Сохраните себе на комп файлы

/massa/massa-node/config/node_privkey.key
/massa/massa-client/wallets/

1 2	/massa/massa-node/config/node_privkey.key /massa/massa-client/wallets/

Это пригодится если нужно будет восстановить ноду.

Перезапуск ноды

sudo systemctl restart massad

1	sudo systemctl restart massad

Остановки сервиса и удаление ноды

Перед удалением обязательно сделайте бекап!

systemctl stop massad
systemctl disable massad
rm -rf $HOME/massa

systemctl stop massad

systemctl disable massad

rm -rf $HOME/massa

На сегодня всё.

Гайд буду обновлять, добавлять инфу/править, если что-то изменится. За новостями следите в ТГ-канале, вопросы пишите в чате или комментах.