Glossary

Broker, escrow, devshard, ngonka, epoch, and the other words used in the dashboard and the API.

On this page

Short definitions for the words on the dashboard, the API, and these docs. Money fields in the API are ngonka, not GNK.

Account words

TermMeaning
BrokerAn OpenBroker organization. One login, one ledger, one set of API keys.
Registered walletThe Gonka address you entered at signup. It identifies you. It is not the deposit destination.
Deposit addressThe generated address that credits your broker balance when it receives native GNK.
API keyAn obk- secret used on the inference API.
SessionThe browser login. Not valid as an inference bearer token.
ActiveAt least 100 GNK has been credited. Keys and inference are allowed.
Available balanceLedger minus reserved minus the minimum reserve. New requests spend this.

Chain words

TermMeaning
GNKThe Gonka token. Balances in the product UI are shown in GNK.
ngonkaThe integer denom. 1 GNK = 1,000,000,000 ngonka. API money fields are ngonka.
DevshardThe inference product on Gonka: an escrow lock plus a gateway that spends it on model hosts.
EscrowAn on-chain lock of GNK that pays for inference attempts. OpenBroker opens these with the allowlisted operator wallet and assigns them to your account.
EpochA Gonka chain period. Once an epoch starts, OpenBroker can post one escrow_epoch ledger line for the previous epoch. See Usage.
token_priceThe ngonka charged per token on an attempt. Live DevShard escrows use 10. See Pricing.
Governance priceThe older /v1/governance/pricing value of 1 ngonka per token. Not the live charge.

Request words

TermMeaning
Completion idid on a chat response, often starting with devshard-.
X-Request-IdResponse header for the gateway request, shaped like req-<time>-<id>.
cost_sourceHow cost_ngonka was chosen for that row.
Capacity error429 or a "no host / no escrow" message. Excluded from the status-page error rate.
Header timeoutThe client or the edge gave up before response headers arrived. HTTP 502.