Telegram
GonkaAI community site, created and maintained by community members
← Wallets

⌨️ Gonka CLI

Console wallet for Gonka blockchain

ℹ️ Information: This page is a translation of the official Gonka documentation with additions from the author.

inferenced CLI is a command-line utility for local account management and network operations in Gonka. It allows you to create accounts, keys, register hosts, and perform network operations.

All operations are performed on your local computer, not on the server!

🧩 Installing the CLI tool

Download the latest inferenced binary from GitHub Releases for your platform.

Extract the archive to a folder. In terminal, navigate to the folder:

cd /path-to-your-folder/

Make the file executable:

chmod +x inferenced

Verify it works:

./inferenced --help
⚠️ macOS users: On macOS, you may need to allow execution in System Settings → Privacy & Security if prompted. Scroll down to the warning about inferenced and click Allow Anyway.

🔑 Creating Account Key (Cold Key)

This is your main key in the Gonka network. It's responsible for:

  • token ownership
  • host management
  • governance decisions
  • account access

Run the command:

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

CLI will ask you to create a password (keyring passphrase) — this is for your local keyring storage.

After that, you'll see the created key data:

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

📝 Mnemonic phrase (seed phrase)

CLI will show you a set of 24 words:

pyramid sweet dumb critic lamp various remove token talent drink announce tiny ...
‼️ THIS IS THE MOST IMPORTANT!
Save this phrase: offline, on paper, in a secure place. NOT on phone, NOT in cloud.
Never share it! If you lose it — account recovery is impossible!

📋 Useful commands

View address:

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

List all accounts:

./inferenced keys list --keyring-backend file

Recover from seed phrase:

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

🔗 Delegating permissions to node

If someone is setting up the node for you, share the key data (address, name, pubkey) — but NOT the seed phrase!

The manager will give you a delegation command like this:

./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/

Enter your keyring password. After a few seconds you'll see:

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

🖥️ Graphical interface (optional)

For convenience, you can use Keplr:

  1. Install Keplr
  2. Click "Import an existing wallet"
  3. Enter your seed phrase
  4. Search for "gonka" or "GNK"

📋 Summary

  1. Downloaded inferenced
  2. Made it executable
  3. Created main key (Account Key)
  4. Saved seed phrase
  5. Delegated permissions to node (if needed)
  6. Installed graphical wallet (optional)