Cascadia: Справочник AWS

7 min readJun 4, 2023

В следующем руководстве вы узнаете, как настроить Amazon Web Services, установить узел и запустить валидатор. Валидаторы играют ключевую роль в механизме консенсуса, проверяя транзакции, создавая новые блоки и распространяя аутентифицированные голоса. Валидаторы Cascadia получают CC от комиссий за транзакции и вознаграждения за блоки.

Шаг 1: Создайте учетную запись Amazon Web Services

Зарегистрируйте учетную запись на сайте https://aws.amazon.com.

Шаг 2: Создайте экземпляр виртуальной машины

В главной консоли управления AWS нажмите на меню “Сервисы” в левом верхнем углу, а затем нажмите “EC2”. Если вы впервые обращаетесь к EC2, вам может понадобиться нажать кнопку “Начать работу”.
Оказавшись на приборной панели EC2, вы можете создать новый экземпляр, нажав кнопку “Запустить экземпляр”.

Шаг 3: Настройка экземпляра виртуальной машины

Выберите имя: это зависит от ваших личных предпочтений.
Выберите образ машины Amazon (AMI): в списке доступных AMI найдите “Ubuntu 20.04 LTS” или более позднюю версию (например, “Ubuntu 21.04” или “Ubuntu 22.04 LTS”, в зависимости от их доступности). Нажмите кнопку “Выбрать” рядом с нужным AMI.

3. Выберите тип экземпляра: Прокручивая вниз, вы можете выбрать один из предопределенных типов экземпляров, которые предлагают комбинацию vCPU (виртуальных центральных процессоров) и памяти. Выберите подходящий тип экземпляра. Серия “t2”, “t2.micro”, включена в Free Tier. Рекомендуется использовать “T3.large”.

Шаг 4: Создайте пару ключей

Создайте новую пару ключей (или выберите существующую, если она уже установлена).
Назовите свою пару ключей, не забудьте загрузить файл закрытого ключа (*.pem) и надежно сохраните его.
Завершите процесс, нажав кнопку ‘’Создать пару ключей’’.

Шаг 5: Настройте параметры брандмауэра

Создайте новую группу безопасности или выберите существующую.
По умолчанию правило трафика “SSH” добавляется для порта 22. Мы рекомендуем добавить правила, разрешающие трафик на портах 80 (HTTP) и 443 (HTTPS).

Шаг 6: Настройка хранилища и запуск экземпляра

Убедитесь, что размер диска достаточно велик, чтобы удовлетворить потребности ваших приложений и данных. На бесплатном уровне вы получите 30 ГБ SSD.
Просмотрите настройки и нажмите “Запустить экземпляр”, чтобы создать свой экземпляр.

Шаг 7: Подключитесь к вашему экземпляру

После выполнения последнего шага вы должны увидеть сообщение об успехе. Теперь пришло время подключиться к вашему экземпляру. Посмотрите на изображение ниже:

2. Откроется новое окно. Обязательно настройте имя пользователя (в нашем случае это “ubuntu”, а затем нажмите кнопку “Connect”.

После открытия окна командной строки (или окна терминала) вы можете начать установку своего узла и взаимодействовать с блокчейном Cascadia.

Поздравляем! Вы успешно создали экземпляр AWS EC2.

Теперь пришло время установить ваш узел.

Обязательно следите за последней информацией в Gitbook’е Cascadia.

Установите свой узел

Шаг 1: Установите предварительные условия.

Обновите локальный список пакетов и установите доступные обновления.

sudo apt update && sudo apt upgrade -y
sudo apt install make build-essential gcc git

Шаг 2: Установите Go.

wget https://golang.org/dl/go1.19.2.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.19.2.linux-amd64.tar.gz

Если вы хотите установить нестандартную конфигурацию, используйте домашнюю папку пользователя .profile (т.е. ~/).

Шаг 3: Экспорт.

GOROOT=/usr/local/go
GOPATH=$HOME/go
GO111MODULE=on
PATH=$PATH:/usr/local/go/bin:$HOME/go/bin

Шаг 4: После обновления вашего ~/.profile, создайте его исходный текст.

source ~/.profile

Шаг 5: Соберите Cascadia из исходного кода.

curl -L https://github.com/CascadiaFoundation/cascadia/releases/download/v0.1.2/cascadiad-v0.1.2-linux-amd64 -o cascadiad
sudo chmod u+x cascadiad
sudo cp cascadiad /usr/local/bin/cascadiad

Ниже замените <имя пользователя> на свое собственное.

sudo chown <имя пользователя> /usr/local/bin/cascadiad

Для примера мы используем имя ubuntu. Если вы используете Google Cloud, замените имя ubuntu на имя вашей учетной записи у поставщика облачных услуг.

sudo chown ubuntu /usr/local/bin/cascadiad

Шаг 6: Чтобы подтвердить, что установка прошла успешно, запустите:

cascadiad version

Шаг 7: Инициализируйте цепочку.

Замените [moniker] на свое имя и инициализируйте cascadiad.

cascadiad init [moniker] - chain-id cascadia_6102–1

Moniker будет отображаемым идентификатором вашего узла при подключении к Cascadia. При указании имени моникера опустите квадратные скобки.

Пример:

cascadiad init ubuntu - chain-id cascadia_6102–1

Шаг 8: Загрузите файл genesis.

Загрузите и замените файл Cascadia genesis.json на:

curl -LO https://github.com/CascadiaFoundation/chain-configuration/raw/master/testnet/genesis.json.gz
gunzip genesis.json.gz
cp genesis.json ~/.cascadiad/config/

Шаг 9: Установите постоянные сверстники.

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

sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$(curl https://raw.githubusercontent.com/CascadiaFoundation/chain-configuration/master/testnet/persistent_peers.txt)\"/" ~/.cascadiad/config/config.toml

Шаг 10: Установите минимальную цену на газ.

В ~/.cascadiad/config/app.toml обновите минимальную цену на газ, чтобы избежать спама транзакций.

sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.0025aCC\"/" ~/.cascadiad/config/app.toml

Шаг 11: Создайте файл службы systemd.

sudo nano /etc/systemd/system/cascadiad.service

Шаг 12: Скопируйте/вставьте следующую конфигурацию, сохраните и выйдите.

Замените <username> именем собственной учетной записи.

[Unit]
Description=Cascadia Node
After=network.target

[Service]
Type=simple
User=<username>
WorkingDirectory=/usr/local/bin
ExecStart=/usr/local/bin/cascadiad start — trace — log_level info — json-rpc.api eth,txpool,personal,net,debug,web3 — api.enable
Restart=on-failure
StartLimitInterval=0
RestartSec=3
LimitNOFILE=65535
LimitMEMLOCK=209715200

[Install]
WantedBy=multi-user.target

Например, <username> — ubuntu, ниже:

[Unit]
Description=Cascadia Node
After=network.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/usr/local/bin
ExecStart=/usr/local/bin/cascadiad start — trace — log_level info — json-rpc.api eth,txpool,personal,net,debug,web3 — api.enable
Restart=on-failure
StartLimitInterval=0
RestartSec=3
LimitNOFILE=65535
LimitMEMLOCK=209715200

[Install]
WantedBy=multi-user.target

Нажмите ctrl + s для сохранения, затем ctrl + x для выхода.

Шаг 13: Запустите свой узел

# reload service files
sudo systemctl daemon-reload

# create the symlink
sudo systemctl enable cascadiad.service

# start the node
sudo systemctl start cascadiad.service

# show logs
journalctl -u cascadiad -f

Это изображение вы увидите в командной строке. Это означает, что ваш узел синхронизируется с блокчейном.

Поздравляем! Вы успешно настроили узел Cascadia!

Далее, пришло время запустить ваш валидатор.

Небольшое примечание: Обязательно следите за последней информацией в Gitbook’е Cascadia.

Запустите ваш валидатор

Если вы все еще находитесь в той же командной строке, нажмите Ctrl + C.

Шаг 1: Убедитесь, что ваш узел полностью синхронизирован.

cascadiad status

Если catching_up возвращает false, ваш узел полностью синхронизирован.

Если catching_up возвращает true, ваш узел все еще догоняет.

Подождите, пока ваш узел синхронизируется, прежде чем продолжить — это может занять некоторое время.

Шаг 2: Сгенерируйте и сохраните адрес и ключи валидатора.

Выполните следующую команду для создания новой пары ключей валидатора:

cascadiad keys add <имя_ключа>

Замените <имя_ключа> именем ключа валидатора.

Пример:

cascadiad keys add yourname

Эта команда предложит вам сгенерировать ключевую фразу и создать новую пару ключей валидатора, которая состоит из адреса кошелька Cascadia, открытого ключа и мнемонической фразы.

Храните парольную фразу и мнемоническую фразу вашего брелка в тайне и в надежном месте. Открытый ключ будет использоваться для идентификации вашего валидатора в сети Cascadia.

Шаг 3: Конвертируйте адрес Cascadia в адрес EVM.

После создания открытого ключа выполните следующую команду, чтобы преобразовать адрес вашего кошелька Cascadia из Шага 2 в адрес EVM:

cascadiad address-converter <ваш_адрес_кошелька>

Замените <ваш_адрес_кошелька> адресом вашего кошелька Cascadia из Шага 2.

Шаг 4: пополните EVM-адрес вашего валидатора.

Переведите токены CC на EVM-адрес вашего валидатора или воспользуйтесь краном. Введите в кран свой конвертированный EVM-адрес из Шага 3, а не адрес Cascadia.

Шаг 5: Подтвердите получение токенов CC.

Подтвердите получение токенов CC, введя адрес EVM, полученный на этапе 4, в блокчейн-проводник Cascadia.

Шаг 6: Создайте начальный валидатор финансирования tx.

Чтобы создать ткс валидатора, выполните следующую команду:

cascadiad tx staking create-validator \
--from <KEY_NAME> \
--chain-id cascadia_6102–1 \
--moniker=”<VALIDATOR_NAME>”
--commission-max-change-rate=0.01 \
--commission-max-rate=1.0 \
--commission-rate=0.05 \
--details=”<DESCRIPTION>” \
--security-contact=”<SECURITY_CONTACT_EMAIL>” \
--website=”<YOUR_WEBSITE>” \
--pubkey $(cascadiad tendermint show-validator) \
--min-self-delegation=”1" \
--amount <TOKEN_DELEGATION>aCC \
--gas “auto” \
--gas-adjustment=1.2 \
--gas-prices=”7aCC” \
--broadcast-mode block

Заполните эти параметры:

<KEY_NAME>: Имя, которое вы создали в Шаге 2
<VALIDATOR_NAME>: Имя, которое вы хотите дать вашему валидатору
<DESCRIPTION>: Подробная информация о вашем узле валидатора
<SECURITY_CONTACT_EMAIL>: Ваш адрес электронной почты
<YOUR_WEBSITE>: URL вашего сайта, если доступен
<TOKEN_DELEGATION>: Количество токенов, которые вы хотите делегировать. Это количество выражается в aCC, что эквивалентно 1e18 CC, т.е. 1 CC = 1 000 000 000 000 000 000 000 000 000 000 aCC.

Для цен на газ стандартным является около 7 aCC. Однако вам может понадобиться скорректировать эту сумму в случае неудачного ткс.

Пример:

cascadiad tx staking create-validator \
--from yourname \
--chain-id cascadia_6102–1 \
--moniker=”ubuntu” \
--commission-max-change-rate=0.01 \
--commission-max-rate=1.0 \
--commission-rate=0.05 \
--details=”The World’s First Neocybernetic Blockchain” \
--security-contact=”admin@cascadia.foundation” \
--website=”cascadia.foundation” \
--pubkey $(cascadiad tendermint show-validator) \
--min-self-delegation=”1" \
--amount 1000000000000000000aCC \
--gas “auto” \
--gas-adjustment=1.2 \
--gas-prices=”7aCC” \
--broadcast-mode block

Введите парольную фразу из шага 2, затем подтвердите операцию (y).

Для подтверждения посмотрите, появился ли ваш валидатор в проводнике валидаторов Cascadia.

Поздравляем! Теперь вы валидатор Каскадии!

Присоединяйтесь к нашему Discord, чтобы получить роль @Validator.

Поддерживаемая более чем сотней участников по всему миру, Cascadia — это блокчейн первого уровня, созданный для изучения природы стимулов в сетевых эффектах, начиная с ве-токеномики. Узнайте больше на сайте cascadia.foundation.

Перевод. Оригинал статьи доступен здесь.