# Руководство для операторов

В этом руководстве описаны шаги, необходимые для настройки и регистрации ноды для Cyber MACH AVS.

#### Минимальные системные требования <a href="#minimalnye-sistemnye-trebovaniya" id="minimalnye-sistemnye-trebovaniya"></a>

* 4 ПРОЦЕССОРА
* 16 ГБ памяти
* 50 ГБ SSD
* Ubuntu 22.04 LTS
* ​[Docker](https://docs.docker.com/engine/install/) v24 и выше
* EigenLayer CLI
* Полная нода с RPC-сервисом или управляемыми RPC-сервисами для целевого роллапа

#### Минимальные требования для стейкинга <a href="#minimalnye-trebovaniya-dlya-steikinga" id="minimalnye-trebovaniya-dlya-steikinga"></a>

💡 Для удобства подключения операторов мы установим минимальное значение стейка на уровне 0.

#### Поддерживаемая стратегия токенов <a href="#podderzhivaemaya-strategiya-tokenov" id="podderzhivaemaya-strategiya-tokenov"></a>

Эфир Beacon Chain и все LST, поддерживаемые EigenLayer, поддерживаются нашей AVS.

### Настройка оператора <a href="#nastroika-operatora" id="nastroika-operatora"></a>

**Генерация ключей и пополнение кошелька**

1. 1.Следуйте [руководству EigenLayer](https://docs.eigenlayer.xyz/eigenlayer/operator-guides/operator-installation#installation-1) и установите EigenLayer CLI
2. 2.Сгенерируйте пары ключей ECDSA и BLS с помощью следующей команды

eigenlayer operator keys create --key-type ecdsa \[keyname]eigenlayer operator keys create --key-type bls \[keyname]

**💡 Пожалуйста, убедитесь, что вы сохранили резервные копии своих приватных ключей в безопасном месте. По умолчанию зашифрованные ключи будут храниться в \~/.eigenlayer/operator\_keys/**

1. 1.Внесите не менее 0,3 ETH на сгенерированный ECDSA-адрес. Он потребуется для регистрации ноды на последующих этапах.
2. 2.Пожалуйста, отправьте ECDSA-адрес через форму заинтересованности MACH AVS [https://forms.gle/3A6xNWwRf9ip9CnN9](https://forms.gle/3A6xNWwRf9ip9CnN9).

**Зарегистрируйтесь в EigenLayer в качестве оператора**&#x20;

#### 💡 Вы можете пропустить следующие шаги, если вы уже являетесь зарегистрированным оператором в мейннете EigenLayer.

1. Создайте конфигурационные файлы, необходимые для регистрации оператора, с помощью следующих команд. Следуйте пошаговым инструкциям. После завершения будут созданы файлы `operator.yaml` и `metadata.json`.

```
eigenlayer operator config create
```

2. Отредактируйте файл `metadata.json` и заполните данные о своем операторе.

<pre><code><strong>{
</strong>  "название": "пример оператора",
  "вебсайт": "&#x3C;https://example.com/>",
  "описание": "пример описания",
  "логотип": "&#x3C;https://example.com/logo.png>",
  "twitter": "&#x3C;https://twitter.com/example>"
}
</code></pre>

3. Загрузите файл `metadata.json` на публичный URL. Затем обновите файл `operator.yaml`, указав в нем URL (`metadata_url`). Если вам нужен хостинг для размещения метаданных, вы можете загрузить [gist](https://gist.github.com/) метаданных и получить `raw` URL.
4. Если вы впервые регистрируете этот оператор, выполните следующую команду для регистрации и обновления оператора

```
eigenlayer operator update operator.yaml
```

После успешной регистрации вы увидите&#x20;

`✅ Operator is registered successfully to EigenLayer`

Если в будущем вам понадобится отредактировать метаданные, просто обновите файл `metadata.json` и выполните следующую команду

```
eigenlayer operator update operator.yaml
```

5. После того, как ваш оператор будет зарегистрирован, он будет отражен на странице оператора EigenLayer.

<figure><img src="https://3717563343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1soFQfuVBq5slIkoQQDX%2Fuploads%2FHBGV4Q9JVcz7L55E55Zw%2Fimage.png?alt=media&#x26;token=d2c0e251-fb46-4747-a24b-e0c1029ddf75" alt=""><figcaption></figcaption></figure>

Вы также можете проверить статус регистрации оператора с помощью следующей команды.

```
eigenlayer operator status operator.yaml
```

## Присоединение к MACH AVS&#x20;

💡 **Обучающие модули** Cyber Mach AVS первоначально будет запущен в режиме allowlist для операторов. Заинтересованные операторы могут подать заявку, используя эту форму: [https://forms.gle/LmPABTNQcwJhw4UB7](https://forms.gle/LmPABTNQcwJhw4UB7)&#x20;

## Настройка Mach AVS <a href="#mach-avs-setup" id="mach-avs-setup"></a>

**Клонирование репозитория Mach AVS**&#x20;

Выполните следующую команду для клонирования [репозитория оператора MACH AVS](https://github.com/alt-research/mach-avs-operator-setup)

```javascript
git clone https://github.com/alt-research/mach-avs-operator-setup.git
cd mach-avs-operator-setup/ethereum/mach-avs/cyber
```

**Подключение и отключение MACH AVS**

Для подключения и отключения скопируйте следующие env

```
cp .env.opt-example .env.opt
```

Обновите разделы `TODO` в `.env.opt`

```
###############################################################################
####### TODO: Операторы, пожалуйста, обновите следующие значения для вашей ноды ##############
###############################################################################
# TODO: Установите url метаданных для оператора
METADATA_URI=https://path/to/metadata.json

# TODO: Операторы должны обновить это значение в соответствии с их собственными адресами
USER_HOME=${HOME}
EIGENLAYER_HOME=${USER_HOME}/.eigenlayer

# TODO: Операторы должны обновить это с учетом собственных ключей
NODE_ECDSA_KEY_FILE_HOST=${EIGENLAYER_HOME}/operator_keys/opr.ecdsa.key.json
NODE_BLS_KEY_FILE_HOST=${EIGENLAYER_HOME}/operator_keys/opr.bls.key.json

# TODO: Операторам необходимо добавить пароль для расшифровки вышеуказанных ключей
# Если ваш пароль содержит пробел, / или $, пожалуйста, используйте одинарную кавычку, чтобы 
# обозначить ваш пароль, например, 'mypassword /$'
OPERATOR_BLS_KEY_PASSWORD=
OPERATOR_ECDSA_KEY_PASSWORD=
```

**Подключение**

💡 Перед тем как подключиться к MACH AVS, убедитесь, что

1. Вы обеспечены необходимой инфраструктурой (например, облачным хранилищем) для поддержания работоспособности оператора. Операторы AVS, не справляющиеся со своими обязанностями, могут быть исключены из MACH AVS.
2. Вы уже были внесены в белый список операторов MACH AVS.

```
./run.sh opt-in 
```

**Если вы больше не хотите обслуживать AVS, вы можете отказаться от участия, запустив команду**

```
./run.sh opt-out 
```

💡 Обновление EigenLayer AVS и страницы оператора может занять несколько минут. Это автоматический процесс.

#### Запуск MACH AVS&#x20;

**Создайте файл рабочей среды**

```
cp .env.example .env
```

**Настройка оператора MACH AVS**

Обновите секции `TODO` в файле `.env`

**💡 Стандартный каталог, где хранятся сгенерированные ключи, \~/.eigenlayer/operator\_keys/**

```
###############################################################################
####### TODO: Операторы, пожалуйста, обновите следующие значения для вашей ноды ##############
###############################################################################
# TODO: Операторы должны обновить эти значения для своих путей
USER_HOME=${HOME}
EIGENLAYER_HOME=${USER_HOME}/.eigenlayer

# TODO: Операторам необходимо установить адрес ecdsa.
# можно получить из списка `eigenlayer operator keys list`, адрес находится в `Key Type: ECDSA`
OPERATOR_ECDSA_ADDRESS=

# TODO: Операторы должны обновить этот адрес до своих собственных ключей
NODE_BLS_KEY_FILE_HOST=${EIGENLAYER_HOME}/operator_keys/opr.bls.key.json

# TODO: Операторам необходимо добавить пароль для расшифровки вышеуказанных ключей
# Если ваш пароль содержит пробел, / или $, пожалуйста, используйте одинарную кавычку, чтобы 
# инкапсулировать ваш пароль, например, 'mypassword /$'
OPERATOR_BLS_KEY_PASSWORD=
```

**Настройка конечной точки роллапа**

Мы предварительно сконфигурировали `mach-config.toml` с RPC, размещенным AltLayer. Также вы можете обратиться к членам команды AltLayer в рабочей группе Slack за инструкциями о том, как настроить свою собственную RPC-ноду.

### Запуск MACH AVS&#x20;

Для запуска MACH AVS используйте docker compose.

```
docker compose pull
docker compose up -d 
```

### Схема Helm

Чтобы запустить MACH AVS в кластере Kubernetes, вы можете использовать образец схемы Helm, доступный в репозитории MACH AVS Operator Setup. Вы можете найти эту схему по следующей ссылке: [MACH Operator Helm Chart](https://github.com/alt-research/mach-avs-operator-setup/tree/master/helm-charts/mach-operator).

### Часто задаваемые вопросы

1. **Как узнать, запущен ли мой оператор?**

Для начала проверьте, запущен ли ваш докер-контейнер оператора, выполнив команду `docker compose ps`.

```
docker compose ps    
NAME                         IMAGE                                          COMMAND                  SERVICE                  CREATED          STATUS          PORTS
mach-avs-operator-node       public.ecr.aws/altlayer/mach-operator:latest   "operator"               mach-operator-node       33 seconds ago   Up 32 seconds   0.0.0.0:9092->9092/tcp, :::9092->9092/tcp
mach-avs-operator-verifier   public.ecr.aws/altlayer/mach:latest            "/usr/local/bin/op-m…"   mach-operator-verifier   33 seconds ago   Up 32 seconds   0.0.0.0:9094->9094/tcp, :::9094->9094/tcp, 9715/tcp
mach-avs-reverse-proxy-1     nginx:latest                                   "/docker-entrypoint.…"   reverse-proxy            33 seconds ago   Up 32 seconds   80/tcp, 0.0.0.0:9091->9091/tcp, :::9091->9091/tcp
```

Далее вы можете проверить логи, чтобы узнать, были ли запущены сервисы или нет

```
2024-04-01T17:04:29.613Z        INFO    logging/zap_logger.go:49        Start operator  {"address": "0xAD6B95793DD4D2b8e184FB4666D1cfb14871A035"}
2024-04-01T17:04:29.956Z        INFO    logging/zap_logger.go:69        Starting operator.
2024-04-01T17:04:29.956Z        INFO    logging/zap_logger.go:69        Starting node api server at address 0.0.0.0:9091
2024-04-01T17:04:29.956Z        INFO    logging/zap_logger.go:69        Starting metrics server at port 0.0.0.0:9092
2024-04-01T17:04:29.956Z        INFO    logging/zap_logger.go:49        start rpc server for got alert
2024-04-01T17:04:29.957Z        INFO    logging/zap_logger.go:49        node api server running {"addr": "0.0.0.0:9091"}
```

Наконец, чтобы определить, валидирует ли ваша AVS целевой роллап, можно просмотреть логи верификационного контейнера на предмет активности валидации блоков.

```
docker logs <name of container> 
```

```

[2024-04-01T17:06:28Z INFO  actor::scheduler] Validate block #166853(0x7ddde84c28da088639bb699a8982e206ca4aea4031fe37b2aa9c69fd23bac940) passed
[2024-04-01T17:06:32Z INFO  actor::block-fetcher] Finalized block #166666(0x747828ae5886e1c254462ab586a32ac2fd69f93c06af8b339819160997de3879)
[2024-04-01T17:06:32Z INFO  actor::block-fetcher] Latest block #166853(0x7ddde84c28da088639bb699a8982e206ca4aea4031fe37b2aa9c69fd23bac940)
[2024-04-01T17:06:36Z INFO  actor::block-fetcher] Finalized block #166666(0x747828ae5886e1c254462ab586a32ac2fd69f93c06af8b339819160997de3879)
[2024-04-01T17:06:37Z INFO  actor::block-fetcher] Latest block #166854(0x6f3029b754134107c4e341e1d37a4be99709b1781ba281a7d8483b5dc63b1dbb)
[2024-04-01T17:06:37Z INFO  actor::scheduler] Pre validate block #166854(0x6f3029b754134107c4e341e1d37a4be99709b1781ba281a7d8483b5dc63b1dbb) passed
[2024-04-01T17:06:37Z INFO  actor::scheduler] There are 1 block validation tasks waiting for result
[2024-04-01T17:06:37Z INFO  actor::scheduler] Validate block #166854(0x6f3029b754134107c4e341e1d37a4be99709b1781ba281a7d8483b5dc63b1dbb) passed
[2024-04-01T17:06:41Z INFO  actor::block-fetcher] Finalized block #166666(0x747828ae5886e1c254462ab586a32ac2fd69f93c06af8b339819160997de3879)
[2024-04-01T17:06:41Z INFO  actor::block-fetcher] Latest block #166854(0x6f3029b754134107c4e341e1d37a4be99709b1781ba281a7d8483b5dc63b1dbb)
[2024-04-01T17:06:46Z INFO  actor::block-fetcher] Finalized block #166666(0x747828ae5886e1c254462ab586a32ac2fd69f93c06af8b339819160997de3879)
[2024-04-01T17:06:46Z INFO  actor::block-fetcher] Latest block #166855(0x07fbc09cf59e93b965c471153d4fabbff38ed0f72a7a2da43a141861b500fea1)
[2024-04-01T17:06:46Z INFO  actor::scheduler] Pre validate block #166855(0x07fbc09cf59e93b965c471153d4fabbff38ed0f72a7a2da43a141861b500fea1) passed
[2024-04-01T17:06:46Z INFO  actor::scheduler] There are 1 block validation tasks waiting for result
[2024-04-01T17:06:46Z INFO  actor::scheduler] Validate block #166855(0x07fbc09cf59e93b965c471153d4fabbff38ed0f72a7a2da43a141861b500fea1) passed
```

2. **Кто управляет агрегатором и выполняет агрегацию подписей BLS?**

AltLayer предоставит агрегатор, к которому ваш MACH AVS сможет подключиться и отправить подписи для агрегации. Конечная точка агрегатора предварительно настроена в конфигурационном файле.

3. **Я не могу зарегистрироваться и сталкиваюсь с проблемой**&#x20;

**`Unable to register operator with avs registry coordinator`**

Пожалуйста, проверьте, достаточно ли средств на вашем ECDSA-адресе. Мы рекомендуем хранить не менее 0,3 ETH, чтобы обеспечить достаточное количество газа для регистрации, подключения и отключения оператора AVS.
