Токеномика Gonka

После того как предложение отправлено и внесён минимальный депозит, начинается период голосования.

Варианты голосования:

• yes → одобрить предложение
• no → отклонить предложение
• no_with_veto → отклонить и выразить сильное возражение
• abstain → воздержаться, но засчитывается для кворума

Вы можете изменить свой голос в любое время в течение периода голосования; учитывается только последний голос.

Если кворум и пороги достигнуты, предложение проходит и выполняется автоматически через модуль governance.

Для голосования используйте команду:

./inferenced tx gov vote 2 yes   --from <cold_key_name>   --keyring-backend file   --unordered   --timeout-duration=60s --gas=2000000 --gas-adjustment=5.0   --node $NODE_URL/chain-rpc/   --chain-id gonka-mainnet   --yes

Замените yes на нужный вариант голосования.

Вы можете запросить статус предложения в любое время через CLI:

export NODE_URL=http://47.236.19.22:18000
./inferenced query gov tally 2 -o json --node $NODE_URL/chain-rpc/

Минимальные и рекомендуемые характеристики оборудования чётко описаны в разделе Оборудование. Изучите его, чтобы убедиться, что ваше оборудование соответствует требованиям для эффективного участия в сети.

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

• cold key — самое важное, всё остальное можно перегенерировать
• secrets из tmkms: .tmkms/secrets/
• keyring из .inference: .inference/keyring-file/
• node key: .inference/config/node_key.json
• пароль warm key: KEYRING_PASSWORD

Ваш валидатор был помещён в jail, потому что он подписал менее 50 блоков из последних 100 (учитывается общее количество подписанных блоков в этом окне, а не подряд). Это означает, что ваша нода была временно исключена (примерно на 15 минут) из производства блоков для защиты стабильности сети.

Частые причины:

• Несовпадение consensus key: ключ консенсуса, используемый вашей нодой, может отличаться от зарегистрированного в сети.
• Нестабильное сетевое соединение: проблемы с сетью могут помешать вашей ноде достичь консенсуса.

Награды: даже если ваша нода в jail, вы продолжите получать большую часть наград как Host, пока нода остаётся активной в инференсе.

После устранения проблемы выполните команду unjail с использованием cold key:

export NODE_URL=http://<NODE_URL>:<port>
./inferenced tx slashing unjail   --from <cold_key_name>   --keyring-backend file   --chain-id gonka-mainnet   --gas auto   --gas-adjustment 1.5   --fees 200000ngonka   --node $NODE_URL/chain-rpc/

Проверка статуса (должно показать jailed: false):

./inferenced query staking delegator-validators   <cold_key_addr>   --node $NODE_URL/chain-rpc/

1) Отключите каждый ML Node:

curl -X POST http://localhost:9200/admin/v1/nodes/<id>/disable

2) Дождитесь остановки: Ноды, не запланированные для инференса в следующем Proof-of-Compute (PoC), автоматически остановятся. Активные ноды остаются активными ещё одну эпоху. Как только нода помечена как disabled, сервер MLNode можно безопасно выключить.

3) Выключите Network Node:

Рекомендуемые бэкапы: .dapi/api-config.yaml, .dapi/gonka.db, .inference/config/, .inference/keyring-file/, .tmkms/

Сеть не проверяет реальное оборудование. Она валидирует только общий вес участника (total participant weight), который является единственным значением, используемым для распределения весов и расчёта наград.

Любая разбивка этого веса по ML Nodes носит исключительно информационный характер. API-сервис пытается автоматически определить оборудование, но это можно переопределить.

Независимо от конфигурации, награды зависят исключительно от общего веса Host.

Переключитесь на другую seed-ноду, обновив переменные в config.env:

• SEED_API_URL — выберите любую из списка genesis (например, http://node2.gonka.ai:8000)
• SEED_NODE_RPC_URL — используйте тот же хост, но порт 26657
• SEED_NODE_P2P_URL — запросите статус ноды для определения P2P порта

export SEED_NODE_P2P_URL=tcp://node3.gonka.ai:5000

Вариант 1: Ручное редактирование (если уже инициализировано)

Отредактируйте .inference/config/config.toml:

seeds = "<node1_id>@<node1_ip>:<port>,..."

Для просмотра известных peers:

curl http://47.236.26.199:8000/chain-rpc/net_info | jq

Вариант 2: Переинициализация (автоприменение из env)

source config.env
docker compose down node
sudo rm -rf .inference/data/ .inference/.node_initialized
sudo mkdir -p .inference/data/

В документации есть специальный раздел по Key Management. Там описаны процедуры и лучшие практики безопасного управления ключами в сети.

Если используете tmkms, удалите папку .tmkms и перезапустите — новый ключ сгенерируется автоматически. Затем зарегистрируйте его:

./inferenced tx inference submit-new-participant   <PUBLIC_URL>   --validator-key <CONSENSUS_KEY>   --keyring-backend file   --unordered   --from <COLD_KEY_NAME>   --timeout-duration 1m   --node http://<node-url>/chain-rpc/   --chain-id gonka-mainnet

1. Сделайте локальный бэкап cold key
2. Остановите API: docker compose down api --no-deps
3. Установите KEY_NAME в config.env
4. Пересоздайте warm key внутри контейнера:

source config.env && docker compose run --rm --no-deps -it api /bin/sh
printf '%s
%s
' "$KEYRING_PASSWORD" "$KEYRING_PASSWORD" |   inferenced keys add "$KEY_NAME" --keyring-backend file

5. Выдайте права с помощью cold key (локально)

6. Запустите API: docker compose up -d

Симулируйте PoC на ML Node для проверки готовности. Сначала поставьте api на паузу:

docker pause api

Переведите ноду в состояние stopped:

curl -X POST "http://<ml-node-host>:<port>/api/v1/stop"   -H "Content-Type: application/json"

Отправьте запрос генерации (payload доступен в документации):

curl -X POST "http://<ml-node-host>:<port>/api/v1/pow/init/generate" ...

При успехе в логах появятся сообщения о создании GPU групп и отправке сгенерированных батчей.

Cosmovisor создаёт полный бэкап в папке состояния .inference во время обновлений (примерно 150 ГБ по состоянию на ноябрь 2025). Рекомендуется иметь 250+ ГБ свободного места.

Вы можете безопасно удалить старые бэкапы:

rm -rf .inference/data-backup-*

Вы можете заранее скачать бинарники в:

• .dapi/cosmovisor/upgrades/v0.2.5/bin
• .inference/cosmovisor/upgrades/v0.2.5/bin

Сделайте их исполняемыми и проверьте контрольные суммы перед обновлением. Подробный скрипт см. в документации.

По умолчанию NATS хранит сообщения бессрочно. Установите nats-cli и настройте TTL 24 часа для потоков:

nats stream info txs_to_send --server localhost:<port>
nats stream info txs_to_observe --server localhost:<port>

Используйте транзакцию submit-new-participant. Это обновляет InferenceURL без перерегистрации.

Важно: сеть обновляет список ActiveParticipants только в следующую эпоху, поэтому по возможности держите оба URL активными, чтобы избежать простоя.

./inferenced tx inference submit-new-participant <PUBLIC_URL> ...

application.db хранит историю состояний. Вы можете настроить параметры pruning в .inference/config/app.toml:

pruning-keep-recent = "1000"

Для сброса БД можно пересинхронизироваться со snapshot или использовать fresh state sync.

Это было связано с низкими настройками газа. Исправление в релизе v0.2.5-post7.

Скачайте новый бинарник, перезапустите api и принудительно восстановите claim:

curl -X POST http://localhost:9200/admin/v1/claim-reward/recover   -H "Content-Type: application/json"   -d '{"force_claim": true, "epoch_id": 106}'

Это не критическая ошибка. Она означает, что вашей ноде ещё не назначена модель, вероятно потому что она ещё не участвовала в Sprint или не получила Voting Power.

После прохождения PoC (примерно каждые 24 часа) это сообщение должно исчезнуть.