Economy
Server-authoritative currency, stores, inventory, loot boxes, and energy — with one hardened grant path.
The economy is entirely server-authoritative: the client requests an action (buy, open, spend) and the server checks the price/balance/odds and applies the result. A client can never mint currency or grant an item.
The one grant path
Every reward — from a purchase, a loot box, an achievement, a daily claim — is delivered into the player's INBOX and granted exactly-once when they claim it. This is the single audited path that mutates a wallet or inventory, so a reward can't be double-granted by a retry.
const items = await tg.inbox.list();
for (const it of items) if (it.claimable) await tg.inbox.claim(it.id);Stores & idempotency
Buying is idempotent — pass a stable idem key so a network retry doesn't double-charge. Failures are typed: insufficient_funds, out_of_stock, store_limit_reached.
await tg.economy.buy('main_store', listingId, { idem: uuid });Loot boxes & energy
Loot boxes disclose their odds (tg.economy.loot.odds) and roll server-side with verifiable RNG. Energy meters (stamina, lives) regenerate over server time; spending fails with out_of_energy. Loot and IAP are age-gated where required — see the compliance guide.