Gonka CLI Guide — Wallet and Node Commands

ℹ️ Информация: Данная страница является переводом официальной документации Gonka с дополнениями от автора.

inferenced CLI — это утилита командной строки для локального управления аккаунтами и операций в сети Gonka. С её помощью вы можете создавать аккаунты, ключи, регистрировать хосты и выполнять сетевые операции.

Все операции выполняются на вашем локальном компьютере, не на сервере!

🧩 Установка CLI-инструмента

Скачайте последнюю версию бинарника inferenced с GitHub Releases для вашей платформы.

Распакуйте архив в папку. В терминале перейдите в папку:

cd /путь-к-вашей-папке/

Сделайте файл исполняемым:

chmod +x inferenced

Проверьте, что всё работает:

./inferenced --help

⚠️ Пользователям macOS: Файл может быть заблокирован системой безопасности. Если macOS пишет "inferenced cannot be opened because it is from an unidentified developer", идите в System Settings → Privacy & Security, прокрутите вниз до предупреждения об inferenced и нажмите Allow Anyway.

🔑 Создание Account Key (Cold Key)

Это ваш главный ключ в сети Gonka. Он отвечает за:

владение токенами
управление хостами
принятие решений (governance)
доступ к вашему аккаунту

Выполните команду:

./inferenced keys add gonka-account-key --keyring-backend file

CLI попросит придумать пароль (keyring passphrase) — это пароль для локального хранилища ключей.

После этого вы увидите данные созданного ключа:

- address: gonka1rk52j24xj9ej87jas4zqpvjuhrgpnd7h3feqmm
  name: gonka-account-key
  pubkey: ...
  type: local

📝 Мнемоническая фраза (seed phrase)

CLI покажет вам набор из 24 слов:

pyramid sweet dumb critic lamp various remove token talent drink announce tiny ...

‼️ ЭТО САМОЕ ВАЖНОЕ!
Сохраните эту фразу: офлайн, на бумаге, в надёжном месте. НЕ на телефоне, НЕ в облаке.
Никому не передавайте! Если потеряете — восстановить аккаунт невозможно!

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

Просмотр адреса:

./inferenced keys show gonka-account-key -a --keyring-backend file

Список всех аккаунтов:

./inferenced keys list --keyring-backend file

Восстановление из seed-фразы:

./inferenced keys add gonka-account-key --recover --keyring-backend file

🔗 Делегирование прав для ноды

Если ноду настраивают за вас, передайте менеджеру данные ключа (address, name, pubkey) — но НЕ seed-фразу!

Менеджер даст команду для делегирования прав, примерно такую:

./inferenced tx inference grant-ml-ops-permissions   gonka-account-key   gonka16jcwetxnxxzzqrwrggf37z50yw4c8hvy709czj   --from gonka-account-key   --keyring-backend file   --gas 2000000   --node http://node2.gonka.ai:8000/chain-rpc/

Введите пароль от keyring. Через несколько секунд появится:

Waiting for transaction to be included in a block...
Transaction confirmed successfully!
Block height: 1448587

🖥️ Графический интерфейс (опционально)

Для удобства можно использовать Keplr:

Установите Keplr
Нажмите "Import an existing wallet"
Введите вашу seed-фразу
В поиске укажите "gonka" или "GNK"

📋 Резюме

Скачали inferenced
Дали права на запуск
Создали главный ключ (Account Key)
Сохранили seed-фразу
Делегировали права ноде (если нужно)
Установили графический wallet (опционально)

⌨️ Gonka CLI