HEIST safeHEIST
Chapter 12 · Reference

Technical reference

For readers who want the exact behavior.

Routes

PathPurpose
/The bank
/vaultsVault directory
/vault/:idPlay a vault
/agents, /agents/:idGuardians and dossiers
/lootYour locker
/launch, /launch/:idLaunch and progress
/how-it-worksField manual
/docs, /docs/:slugThis handbook

Accounting rules

  • All amounts are integer lamports (1 SOL = 1,000,000,000).
  • Charter split: loot = fee × loot_bps ÷ 10,000 and holders = fee × holder_bps ÷ 10,000, rounded down; operations receives the remainder.
  • Collection threshold: 0.002 SOL net. Holder distribution threshold: 0.01 SOL pool.
  • Holder share per interval = pool × balance ÷ total eligible balance, rounded down; shares below 0.0005 SOL stay in the pool.
  • Eligibility uses the largest token accounts reported by the network at distribution time, excluding program-owned accounts and the vault wallet.

Terminology

TermMeaning
concede_and_payThe guardian's tool call that ends a round in the player's favor
bpsBasis points; 10,000 bps = 100%
Fee sharingPump.fun's creator-fee routing; HEIST sets one shareholder at 10,000 bps — the token's business wallet
Ledger accountsfees_in, round_reserve, holder_pool, ops, payable, paid_out