burn_key
Burn one of your keys on a Solana round to increase the per-key dividend rate for your remaining keys and reduce competitors' share. Use when you hold many keys and the pot is still growing.
Instructions
Burn ONE key on a round to permanently boost your share on the remaining keys.
WHAT IT DOES: invokes the Anchor program's burn_key_token instruction.
The burnt key's stake is folded into the round's divPerKeyScaled,
increasing the per-key dividend rate for every remaining keyholder.
Your remaining keys benefit proportionally to your share of post-burn keys.
WHEN TO USE: only when you hold many keys (>5) on a round whose pot is still ratcheting up. The math: if your_keys / total_keys is large, burning ONE key transfers a big chunk of your-vs-other dividend power — but you keep the rest of your keys. if your_keys / total_keys is small, the burn mostly subsidises others.
IRREVERSIBLE: burnt keys are gone. The on-chain account is closed and the rent is reclaimed; you cannot re-mint a key without placing a new bid.
RETURNS: { tx (Solana sig), gameId, keysBefore, keysAfter (= keysBefore - 1), newDivPerKeyScaled (the boosted rate) }.
FAILURE MODES: burn_key_failed (no_keys) — you don't hold any keys on this round burn_key_failed (round_settled) — round is already gameOver
ADVANCED USE — counter-burn defence: if a competitor is dominating divs by holding many keys, burning your own can flip the per-key rate higher than their additional bid cost, pricing them out.
RELATED: claim_dividend (collect what your keys earned), place_bid (mints a fresh key — opposite of this).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gameId | Yes | Round you hold keys on and want to burn one of. | |
| api_key | No | Bearer api_key (or env). Must be the wallet that holds the keys. |