🛠 Aztec Sequencer Node — Пошаговый гайд по установке

Гайд написан и обновляется автором канала:

Rocky_crypto

📌 Системные требования:

CPU: 8 ядер
RAM: 16 GB
SSD: 1 TB (желательно NVMe)
Интернет: минимум 25 Mbps
Поддерживаемые ОС: Ubuntu 22.04+

1️⃣ Установка зависимостей

Открываем терминал и выполняем:

sudo apt update && sudo apt upgrade -y && \
sudo apt autoremove -y && \
sudo apt install apt-transport-https ca-certificates curl software-properties-common -y && \
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg && \
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null && \
sudo apt update && \
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y && \
sudo systemctl enable docker && sudo systemctl start docker

Что происходит:

🔧 Обновляем систему, удаляем мусор, устанавливаем curl и зависимости
📦 Устанавливаем Docker — он нужен для запуска контейнера с нодой
🟢 После установки Docker автоматически включается и запускается как служба

Чтобы убедиться, что всё ок:

docker --version

2️⃣ Установка Aztec CLI (Sandbox-утилита)

bash -i <(curl -s https://install.aztec.network)

Что происходит:

⚙️ Загружается и запускается скрипт установки CLI-инструмента aztec
Это основная утилита для запуска ноды, регистрации, обновлений

После установки обновляемся до нужной версии тестнета:

aztec-up alpha-testnet

Что происходит:

⬆️ CLI переключается на ветку alpha-testnet, которая используется в текущем публичном тестнете

3️⃣ Подготовка рабочей директории

mkdir -p ~/aztec-sequencer && cd ~/aztec-sequencer

Что происходит:

🗂 Создаётся папка для конфигурации и запуска ноды
📌 Все файлы будут размещены внутри неё (удобно управлять)

4️⃣ Создание `.env` файла

nano .env

Вставьте:

VALIDATOR_PRIVATE_KEY=ВАШ_ПРИВАТНЫЙ_КЛЮЧ_ОТ_КОШЕЛЬКА
P2P_IP=ВАШ_ПУБЛИЧНЫЙ_IP_АДРЕС

💡 Публичный IP можно узнать командой:

curl ipv4.icanhazip.com

Что происходит:

🗝️ Указывается приватный ключ валидатора (используется для подписи блоков)
🌐 Указывается IP сервера — нужен для участия в p2p-сети

5️⃣ Создание `docker-compose.yml`

nano docker-compose.yml

Вставьте:

version: '3.8'

services:
  node:
    image: aztecprotocol/aztec:alpha-testnet
    container_name: aztec-sequencer
    environment:
      ETHEREUM_HOSTS: "https://ethereum-sepolia-rpc.publicnode.com"
      L1_CONSENSUS_HOST_URLS: "https://ethereum-sepolia-beacon-api.publicnode.com"
      DATA_DIRECTORY: /data
      VALIDATOR_PRIVATE_KEY: ${VALIDATOR_PRIVATE_KEY}
      P2P_IP: ${P2P_IP}
      LOG_LEVEL: debug
    entrypoint: >
      sh -c 'node --no-warnings /usr/src/yarn-project/aztec/dest/bin/index.js start --network alpha-testnet --node --archiver --sequencer'
    network_mode: host
    volumes:
      - /home/$(whoami)/aztec-sequencer:/data
    restart: unless-stopped

Что происходит:

📦 Настраивается контейнер с образом Aztec Sequencer
🔄 Устанавливается автоматический перезапуск при сбое
🔧 Указываются все переменные: RPC, приватный ключ, IP, логгинг
⚙️ Используются RPC-сервисы Sepolia (Execution и Consensus)

ВАЖНО! Обратите внимание, что в гайде указан бесплатный RPC, который имеет свои лимиты. Для полноценной корректной работы требуется приобретать платные RPC.

💰 Рекомендуемые платные RPC для Sequencer-ноды

Ankr
✅ Поддерживает Execution + Beacon
💸 Цена: от ~$10/мес
🔹 Отличная стабильность
🔹 Beacon RPC расходует мало трафика
🔹 Подходит для одиночной ноды
DRPC
✅ Поддерживает Execution + Beacon
💸 Цена: от ~$5/мес
🔹 Самый доступный вариант
🔹 Поддержка Beacon работает стабильно
🔹 Идеален для тех, кто запускает 1–2 ноды
QuickNode
✅ Поддерживает Execution + Beacon
💸 Цена: от ~$20/мес
🔹 Высочайшая надёжность
🔹 Очень быстрая синхронизация
🔹 Подходит, если нужна производительность без компромиссов
GetBlock
✅ Поддерживает Execution + Beacon
💸 Цена: от ~$15/мес
🔹 Хорош для сценариев с несколькими нодами
🔹 Удобная панель управления
🔹 Поддержка WebSocket и API-метрик

6️⃣ Запуск ноды

docker compose up -d

Что происходит:

🚀 Контейнер запускается в фоне
🔗 Нода подключается к сети Aztec, начинает синхронизацию
🧩 Появляются логи (можно проверить, что всё работает)

7️⃣ Проверка логов

docker-compose logs -f

Что происходит:

📄 Выводятся текущие логи работы ноды
🔍 Можно отслеживать ошибки, подключение к p2p, синхронизацию и т.д.

8️⃣ Управление нодой

Остановка:

docker compose down -v

Рестарт:

docker restart aztec-sequencer

📎 На этом этапе:

Если всё сделано правильно, нода будет:

⛓ Синхронизироваться с Aztec alpha-testnet
🧱 Формировать блоки и участвовать в их сборке
🧾 Хранить данные архива (archiver)
🛡 Принимать участие в сети как потенциальный валидатор

🎯 Получение роли Apprentice в Discord

После установки и запуска ноды можно получить специальную роль Apprentice — это подтверждение, что ваша нода работает корректно и вы участвуете в тестнете.

Что делаем:

1️⃣ Переходим в Discord Aztec
2️⃣ Ждём 20–30 минут после запуска — нужно, чтобы нода синхронизировалась
3️⃣ Открываем терминал, подключаемся к серверу и запрашиваем данные:

docker logs --tail 100 aztec-sequencer

4️⃣ Находим строку с данными (обычно JSON или хеш вида 0x...), она будет содержать:

Адрес кошелька
Блок
Подпись

5️⃣ Идём в Discord в канал #operators → start-here
6️⃣ Пишем команду:

/operator start

И в поля вставляем:

Адрес кошелька
Номер последнего блока
Данные хеша из логов

7️⃣ После успешной проверки вы получите роль Apprentice

🛡 Регистрация валидатора (по желанию)

Можно дополнительно зарегистрировать свой адрес как валидатор в L1-сети Sepolia. Это не обязательно, но усиливает ваше участие.

1️⃣ Выполняем команду:

aztec add-l1-validator \
  --l1-rpc-urls https://ethereum-sepolia-rpc.publicnode.com \
  --private-key 0xВАШ_ПРИВАТНЫЙ_КЛЮЧ \
  --attester 0xВАШ_АДРЕС \
  --proposer-eoa 0xВАШ_АДРЕС \
  --staking-asset-handler 0xF739D03e98e23A7B65940848aBA8921fF3bAc4b2 \
  --l1-chain-id 11155111

Если получите сообщение вроде ValidatorQuotaFilledUntil(...) — это значит, что на сегодня лимит регистраций исчерпан. Попробуйте повторить позже.

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

🔹 Просмотр логов:

docker logs --tail 100 -f aztec-sequencer

🔹 Удаление ноды полностью:

docker stop aztec-sequencer && \
docker rm aztec-sequencer && \
rm -rf ~/aztec-sequencer

🔹 Перезапуск контейнера:

docker restart aztec-sequencer

⚠️ Возможные ошибки:

1)The computed genesis archive tree root...

После установки версии v0.87.2 у некоторых пользователей появляется критическая ошибка, связанная с genesis archive tree root. Это баг, возникающий из-за конфликта данных или кэша.

🔧 Решение от команды Aztec:

Полностью удалите старые данные Aztec:

rm -rf ~/.aztec

2 После этого перезапустите установку или обновление:

bash -i <(curl -s https://install.aztec.network

Обновите до актуальной версии:

aztec-up alpha-testnet

Убедитесь, что версия корректная:

aztec --version

Актуальная рабочая версия должна быть 0.87.2 или выше. После удаления кэша и переустановки ошибка должна исчезнуть.

⚙️ Заключение

Нода Aztec достаточно требовательна, особенно к оперативной памяти. Если вы уже держите другие проекты — убедитесь, что у сервера хватает ресурсов. При необходимости можно разместить Sequencer на выделенном VPS.

Обязательно пробрасывайте порты 40400 (TCP+UDP) и 8080, если ваш хостинг/роутер требует этого вручную.

Если всё настроено правильно — нода начнёт формировать блоки и участвовать в сети. Даже если награды прямо не объявлены, участие может быть учтено при будущем TGE или при валидации активности.

Гайд написан и обновляется автором канала:

Rocky_crypto

1️⃣ Установка зависимостей

Что происходит:

2️⃣ Установка Aztec CLI (Sandbox-утилита)

Что происходит:

Что происходит:

3️⃣ Подготовка рабочей директории

Что происходит:

4️⃣ Создание .env файла

Что происходит:

5️⃣ Создание docker-compose.yml

Что происходит:

💰 Рекомендуемые платные RPC для Sequencer-ноды

6️⃣ Запуск ноды

Что происходит:

7️⃣ Проверка логов

Что происходит:

8️⃣ Управление нодой

📎 На этом этапе:

🎯 Получение роли Apprentice в Discord

Что делаем:

🛡 Регистрация валидатора (по желанию)

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

⚠️ Возможные ошибки:

⚙️ Заключение

Гайд написан и обновляется автором канала:

Rocky_crypto

4️⃣ Создание `.env` файла

5️⃣ Создание `docker-compose.yml`