Manual Reward Claiming Guide

Setup & maintenance
1

Manual Reward Claiming Guide

If your epoch rewards weren’t claimed automatically, you can claim them manually using one of two methods. Always check if you have unclaimed rewards first before attempting to claim.

Checking for Unclaimed Rewards

Replace <EPOCH_ID> with the epoch number (e.g., 135) and <ACCOUNT_ADDRESS> with your Gonka address (e.g., gonka1…123):

curl http://node2.gonka.ai:8000/chain-api/productscience/inference/inference/epoch_performance_summary/<EPOCH_ID>/<ACCOUNT_ADDRESS> | jq

Option 1: Recover Claim (Recommended)

This method uses your network node’s admin API and should be tried first.

Run this command from your network node, replacing <EPOCH_ID> with the reward’s epoch number:

curl -X POST http://localhost:9200/admin/v1/claim-reward/recover \
    -H "Content-Type: application/json" \
    -d '{"force_claim": true, "epoch_index": <EPOCH_ID>}'

Option 2: Manual Claim Transaction

If Option 1 fails, use this method to manually submit a claim transaction.

Step 1: Get the seed value for the epoch

Run this from your network node to retrieve the configuration:

curl http://localhost:9200/admin/v1/config

Look for "previous_seed" in the output - this is your <SEED> value.

Step 2: Submit the claim transaction

Replace the placeholders with your values:

  • <SEED>: The previous_seed from Step 1
  • <EPOCH_ID>: The epoch number for the reward
  • <local-key-name>: Your local keyring key name
./inferenced tx inference claim-rewards \
    <SEED> <EPOCH_ID> \
    --from <local-key-name> \
    --gas auto \
    --gas-adjustment 1.3 \
    --keyring-backend file \
    --chain-id gonka-mainnet \
    --node http://node2.gonka.ai:8000/chain-rpc/

Important Notes:

  • Rewards must be claimed within the next epoch or they’re lost
  • You can use any network node instead of node2 if it’s unavailable (node1, node3, or your own validator node)
1 Like