Battlefield docs

Battlefield turns a live Pump.fun token's order flow into a 3D war. Every real buy reinforces the Bulls, every real sell reinforces the Bears; army sizes, the firefight, and the frontline all follow real on-chain activity streamed over Yellowstone gRPC. Nothing on the map is simulated.

On top of the visualization runs a round game: pick a side, sign a position, and if your side wins the round you get paid in SOL from the token's creator fees.

Gameplay

Every battle token runs three concurrent round clocks. A round opens at the token's current USD price and closes when the clock runs out:

Winner rule. Close above open: Bulls win. Close below open: Bears win. A move inside ±0.030% is a draw, so noise never decides a round. On a Pump.fun bonding curve the price is a pure function of net SOL flow, which means the side that actually moved more SOL through the curve wins. Spam trades cannot fake it.

Positions. To stake a round you hold the market's token, choose Bulls or Bears while the round is in its lobby, enter a position size up to your balance, and sign a message. No tokens move. Your position weight at settlement is the smaller of what you signed and what you still hold, so dumping mid-round shrinks your claim.

Prize pool economics

Battle tokens route 100% of their Pump.fun creator fees to the game's keeper wallet through an immutable on-chain fee split. From there the flow is mechanical:

1. Every lamport of new creator fees is counted once and split across the three concurrent rounds: 50% / 30% / 20%.
2. When a round settles, the winning side splits its pool pro rata to effective position sizes.
3. If a round ends in a draw or nobody backed the winning side, its whole pool, including rounding dust, rolls over into the next round of the same length. Nothing is skimmed and nothing burns quietly.

The more a token trades, the bigger its pools get, which gives traders a reason to come back, which makes the token trade more. That loop is the product.

Payouts and trust

A keeper service settles rounds. After each round it collects accrued creator fees from the Pump.fun vault and pays winners with plain SOL transfers, batched into transactions. Every position shows its payout status and the transaction signature once paid, so every payout can be verified on-chain.

What you trust and what you do not: the fee route is immutable and on-chain, position math is deterministic, and payouts are visible transactions from the keeper wallet. The keeper key custody and the settlement code are operated by the project. This is an experimental product; size your positions accordingly.

Launchpad

The Launchpad tab creates a real Pump.fun token whose fees fund the prize pool from block one. Metadata goes to IPFS first, then the first transaction creates the bonding curve and the second locks the fee split. The optional initial buy is a separate transaction. Cost is network fees, roughly 0.02 SOL, and Battlefield takes no commission. If you approve the create but reject the fee route, finish the route later on the Link token tab.

Linking a token

An existing Pump.fun token becomes a battle market through the Link token tab: paste the mint, check it, connect the creator wallet, and sign one transaction. Only the token's fee-sharing authority can sign, the split is 100%, and it cannot be undone. From that moment the token's creator fees fund its battle pools.

FAQ

What do I risk? You must hold the market's token to have position weight, so you carry its price risk for the round. The signature itself is free and non-custodial.

When do I get paid? Right after the round settles. The keeper collects fees and sends SOL in the same settlement pass; your position shows the transaction signature.

Can the creator take the fees back? No. The split is immutable on-chain. That is exactly what makes a market verifiably playable.

What happens on a draw? The pool rolls into the next round of the same length. Draw positions score points but no SOL.

Is this financial advice? No. Experimental software, real money, act accordingly.