A monster card battler on Solana — claim a roster, fight provably-fair 3v3 team battles, evolve your team, climb the leaderboard. The game ships first. The economy rides on top.
Play · X / Twitter · Telegram · Bot
PokeEvolve is a Solana-native monster card battler with a deterministic, server-authoritative battle engine. Every fight is a pure function of two rosters and a seed. Same inputs always produce the same fight, on every machine, forever. The server owns the seed and the roster, so outcomes can't be forged client-side.
Three things separate it from every other Web3 game launch in this cycle:
- Provably-fair battles — a real engine, not a black-box server roll
- Game-first sequencing — the game has shipped; the token rides on top
- Server-authoritative anti-cheat — clients can't fake wins, BP can't be farmed
| Property | Value |
|---|---|
| Roster catalogue | 47 monsters · 20 evolution lines · 5 rarity tiers |
| Type chart | 18 elemental types · super-effective ×1.5 · resisted ×0.75 |
| Battle format | 3v3 team · speed-ordered turns · first to 3 KOs wins |
| Modes | Async PvP · Friend (by code) · NPC bot |
| Auth | Sign-In With Solana (ed25519, ±60s replay window) |
| Anti-cheat | HMAC-signed single-use match tokens + server-side recomputation |
| Launch | $POKEVO fair-launch on PumpFun · 0% team alloc · 100% on the curve |
┌──────────────────────────────────────────────────────────────┐
│ │
│ Connect wallet ─► Claim 3 starters ─► Battle 3v3 │
│ │ │
│ ▼ │
│ Climb the leaderboard ◄─ +25 BP win / +5 BP loss │
│ ▲ │ │
│ │ ▼ │
│ Spend BP ◄──── Level Up (+1 each stat) or Evolve │
│ │
└──────────────────────────────────────────────────────────────┘
This umbrella repo houses three sub-projects. Each ships independently with its own tags.md for GitHub topics and a clean commit history.
| Folder | Purpose |
|---|---|
pokeevolve-core/ |
Monorepo, deterministic battle engine, PumpFun fair-launch scripts, C4 system design |
pokeevolve-docs/ |
Whitepaper, threat model, protocol-level documentation |
pokeevolve-api/ |
Open read-only API + TypeScript SDK for community tools |
Marketing collateral (kept in this umbrella repo, not pushed to a public sub-repo):
| Folder | Purpose |
|---|---|
Article/ |
Long-form articles (3 Medium · 3 X Articles) |
Caption/ |
29 launch captions (engagement hook · pre-launch · post-launch announcements) |
blueprint.md |
Source-of-truth project blueprint |
| Layer | Technology |
|---|---|
| Monorepo | Turborepo + pnpm workspaces |
| Game client | Next.js 14 App Router |
| Authoritative backend | Next.js Server Actions, Prisma, Postgres |
| Wallet auth | SIWS via tweetnacl ed25519, HMAC httpOnly session |
| Engine | TypeScript, xmur3 → mulberry32, 18-type chart |
| Audio | Procedural Web Audio (no asset files) |
| Launch venue | PumpFun bonding curve |
| Deploy | Docker + Traefik on VPS |
# Clone the umbrella repo
git clone https://github.com/<your-org>/pokeevolve.git
cd pokeevolve
# Install (root works as a pnpm workspace)
pnpm install
# Try the tokenomics sanity check
cd pokeevolve-core
pnpm tsx scripts/tokenomics_calc.ts
# Preview the PumpFun launch payload (dry-run, never broadcasts)
pnpm tsx scripts/pump_integrator.ts --preview-launch| Phase | Window | Deliverables |
|---|---|---|
| 1 — Launch-ready game | Shipped | 47 monsters, deterministic 3v3 engine, claim/level/evolve, async PvP, friend battles, NPC, SIWS auth, Pokédex, leaderboard |
| 2 — Economy & ranked | 1–2 months | $POKEVO fair launch on PumpFun, tier perks, ranked seasons, cosmetic frames, buy-back & burn |
| 3 — Depth | 3–5 months | More monsters/abilities, status effects, tournaments, guilds, on-chain seed commit, tradeable roster, spectate & replay |
| 4 — Ecosystem | 6–12 months | Open leaderboard/replay API, sponsored tournaments, mobile client, governance-driven balance |
| Property | Value |
|---|---|
| Total supply | 1,000,000,000 $POKEVO |
| Team allocation | 0% (no pre-mine, no insider alloc) |
| Distribution | 100% on the PumpFun bonding curve |
| Holder tiers | Rookie · Trainer (0.1%) · Ace (0.5%) · Champion (1%+) |
| Tier perks | BP boost · ranked access · cosmetic frames · governance |
| Buy-back & burn | 20% of treasury revenue routes into open-market $POKEVO buy + burn |
The game is free and fair for everyone. The token buys edge, access, and cosmetics. It does not buy power. Battle outcomes cannot be paid into.
The full tokenomics analysis lives in pokeevolve-docs/WHITEPAPER.md.
| Document | What's Inside |
|---|---|
pokeevolve-core/README.md |
Engine repo overview, quick start, tech stack |
pokeevolve-core/SYSTEM_DESIGN.md |
C4 container view, data model, deployment topology |
pokeevolve-core/CHANGELOG.md |
Release history from 0.1.0 onward |
pokeevolve-docs/WHITEPAPER.md |
Protocol whitepaper — design principles, tokenomics, governance |
pokeevolve-docs/THREAT_MODEL.md |
STRIDE analysis, Web3-game abuse patterns, incident runbooks |
pokeevolve-api/README.md |
Open API + SDK overview |
pokeevolve-api/API.md |
Full endpoint reference |
| Resource | URL |
|---|---|
| Live game | https://pokeevolve.fun |
| X / Twitter | https://x.com/pokeevolvefun |
| Telegram channel | https://t.me/pokeevolve |
| Telegram bot | https://t.me/pokeevolve_bot |
| Launch venue | https://pump.fun |
- $POKEVO is not live yet. Anyone selling you "early access," "presale," "allocation," or "whitelist" is a scammer.
- Every official announcement comes from the pinned post on
@pokeevolvefunor the pinned message int.me/pokeevolve. - The contract address (CA) will only be posted once and pinned at launch.
- If a stranger DMs you about a $POKEVO opportunity → block and report.
PRs welcome on the engine, the type chart, the move pool, and the Pokédex UI. Run pnpm test and pnpm typecheck before opening one. Game-balance proposals should land first in pokeevolve-docs/ as a draft, then propagate into the core repo as code.
MIT.