# PUMP.RPG Litepaper

*Casual GambleFi on the pump.fun social layer.*

**$PUMPRPG contract address (CA):** `61nBtbHTfxCJikoUQJUizYv2tKSHg2KJ3r9YsdLxpump`
[Buy on DexScreener ↗](https://dexscreener.com/solana/2izawyjfmkd9a5xxgsa5xjd4dpdvjanbhw666equpaaz)

---

## TL;DR

**Bet SOL on nonstop arena fights, or roll a hero of your own and earn when it wins.** Pump.fun accounts can roll a hero whose strength is driven by your real trading (PnL, volume, win rate, streak, following), then take a 5% cut of bets every time it wins. No grinding, no clicking: fights run on their own around the clock. A perpetual arena to casually gamble on, powered by real pump.fun traders. And when you want hands-on: **jump into the Live Arena and control your hero in real time — or deploy an AI agent to fight it for you.**

---

## The Thesis

pump.fun isn't just a launchpad anymore — it's a **social layer**. Every wallet has a story: what it holds, what it's traded, its PnL, its followers, whether it's connected to X. That data is public, on-chain, and composable.

Our thesis is that this data is a **game engine waiting to happen**. Anyone's trading footprint can power experiences in other apps. PUMP.RPG is the first to turn it into a **betting arena**, where your on-chain reputation becomes a fighter's strength and the crowd wagers on who walks out.

Because eligibility is gated to wallets with an official pump.fun account (verified via the pump.fun API), **every player is a real participant in the ecosystem**. The game doesn't just sit next to pump.fun — it pulls people deeper into it.

---

## How It Works

**Two ways in.** Bet on the fights with any Solana wallet, or roll a hero of your own and let it fight for you.

**To bet,** just deposit SOL, back a fighter before the round locks, and split the pool if it wins. No pump.fun account needed (full details in The Arena Economy).

**To field a hero,** the loop is passive by design:

1. **Connect** a Solana wallet that has a **pump.fun account** (link an existing wallet at pump.fun, or export the pump.fun app's built-in wallet), then sign in with Solana. No password.
2. **Roll** a hero. It's minted to your account with a permanent mint number.
3. **Auto-deploy.** Your hero is queued straight into the arena.
4. **Win.** Fights resolve automatically. Your rewards, and your 5% cut of every betting pool your hero wins, accrue to your in-app balance, ready to withdraw to your wallet anytime.

There's no "train vs. fight" decision, no stamina to manage, no actions to take. Once your hero is rolled, it's in the arena — battles run on their own, around the clock, until one champion remains, then the next begins.

### Rerolls

Don't like your hero? **Reroll it.** You get **one free reroll per day** (resets at UTC midnight). Want another? Reroll again for **0.1 SOL**. A reroll swaps your class and stats for a fresh random roll while keeping your mint number.

---

## Eligibility

To roll a hero, your wallet must have an account on the official pump.fun app. We verify this in real time against the pump.fun API. If pump.fun is briefly unreachable, we never wrongly reject a previously-verified wallet — we simply ask you to retry rather than lock you out.

This keeps the arena full of genuine ecosystem participants, and gives people one more reason to be part of pump.fun.

---

## The Heroes

Every hero is rolled from a **class**, each with its own stats and a **signature "Q" ability** that fires automatically in combat.

### Classes & abilities

| Class | Signature ability | What it does |
|---|---|---|
| **Knight** | **Charge** | Dashes to a target and lands a punishing two-hit slash on impact. |
| **Knight Templar** | **Charge** | A holy cavalry charge — closes the gap and strikes twice. |
| **Swordsman** | **Charge** | Blinks the gap and lands a quick two-hit combo. |
| **Lancer** | **Impale** | Skewers straight through the enemy line on a long-reach dash. |
| **Werebear** | **Pounce** | Leaps across the arena into a heavy two-hit crush — a long-range engage. |
| **Werewolf** | **Blink Strike** | Vanishes and reappears on its prey for a savage hit. |
| **Elite Orc** | **Whirlwind** | A channeled spinning AoE that grinds down everyone caught in the storm. |
| **Armored Axeman** | **Whirlwind** | The same devastating spin, wrapped in heavy armor. |
| **Armored Orc** | **Slam** | A brutal ground slam that hurls nearby foes back. |
| **Orc Rider** | **Slam** | Barrels in and slams down, scattering the pack. |
| **Archer** | **Roll** | A defensive dash that looses an arrow from the new position — kite, reposition, punish. |
| **Soldier** | **Aimed Shot** | Repositions with a roll, then looses a precise shot. |
| **Wizard** | **Arcane Spike** | Calls down a burst of arcane force on a distant target. |
| **Priest** | **Mend** | Channels holy light to mend its own wounds mid-fight. |

**Your free reroll draws from the five founding classes** (Knight, Elite Orc, Armored Axeman, Werebear, Archer). The full **14-class roster** reaches the arena through the **Genesis collection** (below) — hold a card and it takes the field for you. More heroes, classes, and abilities keep coming.

### Stats

Each hero carries five stats:

- **HP** — how much punishment it can take.
- **ATK** — how hard it hits.
- **DEF** — how much incoming damage it shrugs off.
- **SPD** — how fast it moves and how quickly it swings.
- **LUCK** — its shot at dodging hits and landing critical strikes.

For the MVP, every hero rolls at a balanced baseline so matchups stay fair and bettable, with outcomes driven by class, ability, and profile bonuses (below). We deliberately avoid permanent leveling and power creep, which would stale the odds. Depth comes instead from **runes and loadouts** (below), not XP grinds.

### Your starter hero & the Genesis collection

Your **free-rolled hero is soulbound** — it lives with your account, keeps its permanent mint number, and isn't sold. It's your always-available starter, drawn from the five founding classes.

On top of that sits the **Genesis collection**: **1,000** unique, hand-rolled hero cards minted on Solana (Metaplex Core), spanning the full **14-class** roster in **Rare, Epic, and Legendary** tiers. Genesis heroes are real, tradeable NFTs.

Owning one **auto-fields it as your arena fighter** — no action required. The best card in your wallet takes the field in place of your starter, carrying your Trader's Edge buffs and your AI strategy with it; sell it and you fall back to your soulbound starter. Mint on the site (**0.1 SOL** or **60k $PUMPRPG**) or grab one on the secondary market.

---

## Your pump.fun Profile Powers Your Hero

The baseline hero is rolled from an empty account. From there, **your on-chain reputation makes your hero stronger** — the more real you are in the ecosystem, the tougher your fighter. Two bonuses are live today, applied to **every stat**:

- **Merchant's Fortune** — scales with your **pump.fun portfolio value** (up to +10 to all stats). A bigger bag, a bigger buff, with heavy diminishing returns so whales don't run away.
- **Renown** — scales with your **pump.fun follower count** (any follower earns at least +1, up to +5 to all stats).

Bonuses are sampled from your live pump.fun profile and refreshed periodically, so they track your real standing over time. The profile page shows exactly what each buff contributes and what it takes to reach the next tier.

**More signals are coming** — PnL, specific token holdings, X connection, and more — each translating participation in pump.fun into power in the arena.

---

## The Arena

The arena is a **free-for-all: eight heroes enter, one walks out.**

No teams, no turns. All eight fighters spawn together and go to war simultaneously, driven entirely by the combat AI as they chase, kite, dodge, and unload abilities. When a hero falls, it drops a health potion where it died, so the bold get rewarded for diving in. Attrition does the rest — the field thins until one hero is left standing. That's your champion. Then the arena resets and the next battle begins.

Melee bruisers, ranged archers, and channeled-AoE heavies all share the same floor. Matchups are messy and emergent — which is exactly the point.

Fights run back-to-back, around the clock, and heroes enter through a **fair queue**: every rolled hero is deployed into the arena at the same frequency. Nobody can buy more fights or better placement. How often you show up is equal for everyone, so whether you win comes down to your class, stats, ability, and Trader's Edge, not how much you spend.

---

## The Arena Economy

Every fight is a **live betting market.** Anyone with a Solana wallet can wager on who walks out, and the heroes in the ring earn from the action they draw. You do not need a pump.fun account to bet; you only need one to field a hero of your own.

**Betting is pari-mutuel:** you bet against other players, not the house. All the SOL wagered on a match flows into one shared pool, and the odds shift live as bets land. The more that piles onto the *other* fighters, the bigger your payout if yours wins.

How a round plays out:

1. **Deposit SOL** once into your balance. Withdraw anytime, with no fee to hold it.
2. **Back a fighter** before the round locks at match start (0.1 SOL minimum). Spread bets across as many fighters as you like.
3. **If your fighter wins, you split the entire pool** with everyone else who backed it, in proportion to your stake.

**Every pool splits three ways.** A flat 10% is raked off the top, and the winners always take the other 90%:

- **90% to the winning backers,** paid pro-rata to their stake.
- **5% to the winning hero's owner.** Field a fighter and you earn a cut of every pool it wins, even if you never place a bet yourself. A strong hero becomes yield.
- **5% to buyback-and-burn** of $PUMPRPG (see Tokenomics).

**No bets, no rake.** Fair-play rules keep the market honest: if nobody backed the actual winner, the highest-placed fighter that *was* backed pays out instead, and if only one fighter drew any bets all round, everyone is refunded and no rake is taken.

This is the loop that ties the ecosystem together. **Traders** field stronger heroes (see Trader's Edge). **Bettors** bring the volume and the fun. **Hero owners** earn from that volume. And the **treasury** turns a slice of every pool into permanent $PUMPRPG deflation. The more the arena is played, the more the token burns.

---

## The Live Arena — Play It Yourself

The auto-battler runs itself and you bet on it. The **Live Arena** flips that: **you take the controls.** Drop into a real-time, free-for-all brawl and pilot your own hero — move, attack, and time your ability — against other live players and AI in the same deterministic arena. It's **just for fun: no betting, no stakes,** so anyone can jump in.

You fight as **your hero** — your fielded Genesis NFT (or your soulbound starter), carrying its stats and your **Trader's Edge** buffs, exactly as it fights in the betting arena. Watching is free and needs no wallet; **entering is a deliberate opt-in.** Join the fight and you queue for the next match, control your fighter live, and climb a dedicated **Live Arena leaderboard** (wins and win rate) with its own live trollbox. Every match with a human in it is recorded, so the board is real.

**And you don't have to play it yourself — you can deploy an agent.**

This is where PUMP.RPG becomes an **arena for AI agents.** Point an autonomous agent at your hero and it fights for you over a live connection, reading the game state — positions, health, abilities, projectiles — and issuing commands. There are **two levels of control:**

- **Real-time** — your agent runs a control loop (target selection, kiting, dodging, ability timing). A ready-to-run reference bot ships with a fully documented contract; the agent's job is to make the policy *smarter.*
- **Declarative** — set a **strategy** once (the same spec the auto-battler uses: targeting, focus-fire, conditional rules) and your hero fights hands-free. Write your strategy once, and it fights everywhere.

Agent-controlled fighters are marked **🤖** so spectators know a bot is in the ring. Fielding is **gated by on-chain ownership** — an agent plays your hero only with a scoped, revocable token tied to the wallet that owns the NFT, so the leaderboard stays honest and no funds are ever at risk.

The result is a live, always-on arena where **humans and their agents fight side by side,** every fighter backed by a real hero and a real wallet.

---

## Raid Bosses

Where the arena is PvP, **Raid Bosses** is **co-op PvE**: a **party of 5 Genesis heroes** takes on a shared raid boss. The first is **Ansum, The Black Knight** — a brutal encounter most parties won't survive.

**Do heroes die? No.** "Death" only happens *inside* a raid — a fallen hero is simply out for that one fight. Your Genesis NFT is **permanent**: never lost, burned, or downgraded. It rejoins the rotation for the next raid. Raids risk nothing but bragging rights.

**Every Genesis hero is auto-enrolled** — no sign-up. Parties of 5 rotate through the entire collection, so every hero gets its shot at the boss. Raids run **continuously, 24/7**; open the **Raids** tab to watch live.

The fight is hard on purpose. Ansum hits like a truck, **summons a demon horde** mid-battle, and **leaps across the arena** with a slam AoE. Clearing him takes a strong, well-composed party — and a little luck. The leaderboard ranks by **clears**, and even wipes are measured by **how close** the party got (the boss's remaining HP).

- **Build your team.** Group your heroes into **Raid Teams** in your Profile so they always deploy together; everyone else is auto-matchmade across the pool.
- **Trader's Edge applies here too.** The same live trading buffs that power your arena fighter carry into raids.
- **Rewatch every raid.** Each fight your heroes join is saved — replay it from **Profile → Raid History** with a live damage meter, per-hero DPS, and your hero highlighted.

**Competitions & prizes:** clears earn prizes during announced raid competitions. Each clear inside the competition window is **one raffle ticket**; winners are drawn weighted by tickets, with the seed committed up front and combined with a Solana blockhash at close so anyone can verify the draw. Prizes go to each winning hero's holder at draw time. The current competition is shown on the Raids tab.

---

## Provably Fair & Replayable

Every fight is resolved by a **deterministic simulation seeded from a single value.** Same seed in, same fight out — every swing, dodge, crit, and potion pickup reproduces exactly.

That means matches are **provably replayable**: anyone can re-run a seed and verify the outcome frame for frame. It also means we can **stream fights live** while the exact same simulation runs client-side from the same seed. Every match is recorded with its **full finishing order** (champion, runner-up, and beyond), and any past fight can be **replayed and shared** with a link. No black box — the arena is auditable by design.

---

## Rewards

Today, the core payout for owning a hero is the **5% cut of every betting pool your fighter wins** (see The Arena Economy). It accrues to your in-app balance automatically, ready to withdraw anytime — no claiming, no gas games. A strong, well-traded hero becomes a passive income stream, not just bragging rights.

Beyond that, we'll **explore additional reward mechanisms** as the ecosystem grows:

- **Partner-funded arenas** — other projects sponsoring prize pools in their own tokens, plugging into PUMP.RPG as a distribution and engagement channel.
- **Treasury-backed rewards** — allocations set aside to sustain and boost the game.
- **Placement payouts** — rewards for runners-up, not just the champion.

---

## $PUMPRPG Tokenomics

**$PUMPRPG launches as a pump.fun coin** — fair and native to the ecosystem it's built on.

**Utility**

- **Governance.** Holders steer the roadmap: which modes ship next, how boosts are weighted, and where the project goes.
- **Token sinks (planned).** We plan to introduce $PUMPRPG sinks such as hero upgrades and runes & loadouts, so sustained demand comes from players investing in their fighters. These aren't live yet — they arrive as the game builds out.

**Burns & deflation**

$PUMPRPG is designed to be **deflationary**, with multiple outlets that permanently remove tokens from supply:

- **Betting rake → buyback & burn.** The **5% buyback cut** taken from every betting pool is used to buy back $PUMPRPG on the open market and burn it. Betting volume converts directly into deflation, so the busier the arena, the faster supply shrinks.
- **Reroll revenue → buyback & burn.** The **SOL spent on paid rerolls** is used to buy back $PUMPRPG on the open market and burn it. Every extra reroll tightens supply.
- **Token sinks → burn (planned).** As $PUMPRPG sinks like hero upgrades and runes go live, the tokens spent on them are burned directly.
- **More burn outlets** roll out as the game expands — the more people play, the more the token deflates.

The principle is simple: **usage burns supply.**

---

## Roadmap

PUMP.RPG's first version is a lean, honest MVP — but our ambition isn't. We are committed to building a **fully gamified, on-chain trading experience**, and we believe the single biggest opportunity in crypto right now is **building on top of a social layer**. pump.fun's tech — public profiles, on-chain identity, real trading data, a native launchpad — is *perfect* for exactly that. Every hero rolled is a new reason to open the pump.fun app; our north star is to **proliferate usage of pump.fun itself.**

Directions we're building toward:

- **A full GambleFi ecosystem** — the arena is just the first game. We want to build a whole suite of fun, casual ways to gamble and earn on the pump.fun social layer: new products, new game modes, new bet types, all sharing the same wallet and token.
- **More heroes, classes, and abilities** — a deeper, more varied arena roster.
- **Runes & loadouts** — unlockable, equippable modifiers you pick before a fight. Depth without XP grinds or permanent power creep, powered by $PUMPRPG sinks.
- **Deeper pump.fun integration** — more profile metrics (PnL, holdings, X, specific-token bonuses) feeding directly into gameplay.
- **New game modes** — tournaments, seasons, and formats beyond the eight-man free-for-all.
- **Placement rewards** — payouts for runners-up, not just the champion.
- **Genesis NFTs (live)** — the 1,000-card Genesis collection is minted and auto-fields into the arena; next is deeper card utility (loadouts, swaps) and secondary-market features.
- **Live Arena & AI agents (live)** — the real-time, player-controlled arena is here, along with an open agent contract so anyone can point an AI agent at their hero. Next: agent-vs-agent formats, richer leaderboards, and deeper strategy tooling.

The MVP earns the right to build all of it.

---

## The Pitch, One More Time

pump.fun made trading social. PUMP.RPG makes it a game you can bet on. Connect your wallet and back a fighter, or roll a hero of your own and let it fight — passively, provably, and for real rewards. Trade, bet, and earn, all on the pump.fun social layer.

*Enter the arena.*

---

*Nothing here is financial advice. PUMP.RPG is experimental software; mechanics and tokenomics are subject to change as the game evolves.*
