Whitepaper — BOSSRUSH

Abstract

Memecoin launchpads all show the same thing: a price chart, a progress bar and a wall of numbers. It works for traders who already understand bonding curves. For everyone else it's noise.

BOSSRUSH shows the exact same on-chain mechanics as a boss fight. Every coin on pump.fun's bonding curve is a boss. Buying the coin hits it, selling heals it, and the HP bar is the SOL still needed before the coin graduates to a real exchange. Nothing about the underlying trade changes: you're buying a real coin, in your own wallet, through pump.fun's contract. Only the way it's presented changes, so that anyone who has ever played a game understands it in one sentence.

The problem

Bonding-curve launchpads made launching a coin cheap and instant. Understanding what's happening on one didn't get easier:

Progress is abstract. "Bonding curve 63%" means nothing to most people. "Boss HP 31 / 85 SOL" does.
Activity is invisible. A trade is a row in a table. Hundreds of people buying the same coin doesn't feel like anything.
Copycats look identical. Ten coins called the same name, with the same stolen image, are easy to mix up. Only the contract address tells them apart, and nobody reads contract addresses.

The boss fight model

Each concept on the site maps one-to-one to something real on-chain:

In the game	What it really is
Boss	A pump.fun coin that is still on its bonding curve
Boss HP	SOL still needed to buy out the curve (about 85 SOL at launch)
Hit	A buy: you send SOL and receive the coin
Heal	A sell: someone returns the coin and takes SOL out
Damage number	The SOL size of that buy or sell
Critical hit	A single buy of 2 SOL or more
Boss defeated	The curve is full and pump.fun migrates the coin to an exchange pool
New boss spawned	Someone created a new coin on pump.fun

Important: the game is a way of showing trades, not a different kind of trade. A hit is a normal pump.fun buy. If the coin's price falls, your coins lose value exactly as they would anywhere else.

How HP is calculated

Pump.fun's bonding curve is a constant-product curve over virtual reserves. Each coin's curve account stores four numbers we read directly:

vSol: virtual SOL reserves (starts at 30)
vTok: virtual token reserves (starts at 1,073,000,000)
realSol: SOL actually deposited by buyers so far
realTok: tokens still available to buy on the curve (starts at 793,100,000)

The curve is full when every real token has been bought. Because vSol × vTok stays constant, the SOL needed to buy the remaining realTok is:

k        = vSol × vTok
HP (SOL) = k / (vTok − realTok) − vSol
Max HP   = HP + realSol

For a fresh coin that gives 30 × 1,073,000,000 / 279,900,000 − 30 ≈ 85.0 SOL, which is why every boss starts with about 85 SOL of HP. Trading fees are left out, so the real SOL needed is slightly higher than HP shows.

Coins whose reserves don't match the standard SOL curve (for example coins paired with a different quote token) are left out of the arena, because their HP wouldn't be comparable.

Monster fingerprints

Every boss gets a 16×16 pixel monster. It's generated from the coin's contract address: the address is hashed into a seed, and the seed decides the body shape, horns, arms, eyes, mouth and colour. The same address always produces the same monster, on every page and every device.

This turns the one thing that can't be faked, the contract address, into something people actually look at. A copycat can steal a coin's name and image, but its monster will look completely different. You can check any address in the bestiary lookup.

Architecture

BOSSRUSH is a static website. It has no database and holds no funds. Everything it shows is read live from public sources:

pump.fun's public API lists live coins with their reserves, images and market caps. The site refreshes the most active coins every 5 seconds and the newest coins every 15 seconds.
PumpPortal's free data feed pushes every new coin and every graduation the moment it happens.
Optionally, a Solana RPC websocket watches the current boss's curve account directly, so HP moves on every single trade instead of every 5 seconds.

How a hit is made

You pick an amount, for example Hit 0.5 SOL.
Your browser asks PumpPortal's public trade API to build a pump.fun buy transaction for that coin, from your wallet address, with 15% slippage protection.
Phantom opens and shows exactly what will happen. You approve or cancel.
Phantom signs and sends it. Pump.fun's contract settles the trade on Solana and the coin lands in your wallet.
BOSSRUSH plays the hit and lists it under "Your fights" with a link to the transaction on Solscan.

Your private keys never leave Phantom. BOSSRUSH never receives your SOL or your coins at any point.

Fees

Fee	Who charges it	Amount
Trading fee	pump.fun	Set by pump.fun, applied by its contract
Transaction building	PumpPortal	0.5% of each trade
Network + priority fee	Solana	About 0.0005 SOL per hit
Platform fee	BOSSRUSH	0 SOL

Phantom always shows the full amount before you sign.

Trust and safety

Every number is real. Stats, HP, hits, spawns and defeats all come from live data. Nothing is simulated or inflated.
Non-custodial. Trades go from your wallet straight to pump.fun's contract.
Every hit needs your approval. Poking the monster is free; only the Hit buttons build trades, and each one asks Phantom first.
Contract address everywhere. Every boss shows its CA, a copy button and its monster fingerprint.

No vetting. Anyone can create a coin on pump.fun. BOSSRUSH doesn't review, endorse or rank coins by quality. A boss being on screen is not a recommendation.

Current limits

Anonymous crowd hits. Without a paid trade feed, the hit log can't say who hit. It shows "a slayer".
5-second updates by default. Per-trade updates need an RPC provider that accepts browser connections.
Coin creation happens on pump.fun. Pump.fun's image upload can't be called from other websites, so in-site launching waits for our own server.
Built on third parties. If pump.fun or PumpPortal change their APIs, parts of the site stop updating until we adapt.

What comes next

The roadmap has the detail. In short: a small server for in-site launching and named hit logs, then per-boss chat, then possibly our own Solana program so launches happen on BOSSRUSH directly. Our own program would need a full security audit before it handles anyone's money, and it isn't promised on any date.

Risks

Most memecoins lose most or all of their value, often within hours.
Prices can move sharply between clicking and confirming. Slippage protection limits this, but failed trades still cost network fees.
Smart-contract, wallet and third-party API risks exist outside our control.
Rules for crypto trading differ by country. You're responsible for following yours.

Read the full risk disclosure before you fight.

Glossary

Bonding curve: A formula that sets a coin's price from how much has already been bought. Every buy raises the price, every sell lowers it.
Graduation: When a coin's curve is full and its liquidity moves to an exchange pool. On BOSSRUSH: boss defeated.
CA: Contract address. The coin's unique ID on Solana. Names can be copied; this can't.
Slippage: How far the price may move before your trade lands. Above that, the trade fails instead of filling at a worse price.
Market cap: Current price × total supply. Useful for comparing coins, not a measure of money invested.
Phantom: The Solana wallet BOSSRUSH uses. It holds your keys and signs every trade.