# STAKEWAR

> Web3 pixel capture game on Base Sepolia testnet. Players claim cells on a 10×10 grid using USDC, capture each other's cells for 125% of locked value, and compete for epoch prize pools. Domain: stakewar.com

STAKEWAR is currently in its testnet phase on Base Sepolia and uses testnet USDC, not real money. A Base mainnet launch (real USDC) is planned but has no fixed date — it ships only after testnet proves the system works at scale (target: hundreds of test users, several weeks without critical bugs, and a completed smart-contract audit). Quality over speed.

## How the game works

- 10×10 grid (100 cells); each cell is a pixel of on-chain territory with an owner, a locked USDC stake, an optional image (IPFS), and an optional link.
- Claim an empty cell: lock at least 1 USDC. A 4% protocol fee is taken; the remaining 96% stays locked as your stake.
- Capture an owned cell: pay 125% of its current locked value. The payment splits 80% to the previous owner (they recover their full stake — 80% of 125% = 100%) / 16% to the epoch prize pool / 4% to the protocol treasury. The previous owner's 80% is credited to their pending winnings (pull payment), claimable anytime from their profile — not pushed automatically.
- You never lose principal on a capture; you only spend the 25% premium when you attack someone else's cell.
- Epochs last 3 days. When an epoch ends, if the prize pool holds at least 50 USDC, the top 5 holders by cell count split it 40/25/20/10/5%. Ranking is by cell COUNT, not USD locked.
- If the pool is below 50 USDC, the epoch auto-extends another 3 days (no tiny payouts).
- Settlement is permissionless: anyone can trigger it after the epoch ends and earns a 1% caller bounty for paying gas.
- Treasure drops: every claim and capture has a 2.5% chance (7.5% during a STREAK) to award one of 6 bonus types — USDC ($1–$20), SHIELD (capture immunity 1–12h), CROWN (permanent badge), ECHO (image ghosts onto a random cell 24h), FREEZE (4 neighbours immune 1h), STREAK (next 3 claims roll at 7.5%). Randomness comes from Chainlink VRF v2.5. Treasures are protocol-funded — free, no risk to the player.
- Images: when you claim or capture a cell you can upload an image (stored on IPFS via Pinata, 512×512 PNG, passed through OpenAI moderation). It is shown until someone captures the cell; ownership history stays on-chain forever.

## Technology

- Smart contract: TheGrid.sol (Solidity ^0.8.20, OpenZeppelin) on Base Sepolia.
- Frontend: Next.js 16 (App Router), React 19, TypeScript, Tailwind v4.
- Web3: wagmi v2, viem v2, RainbowKit v2.
- Image storage: Pinata IPFS. Randomness: Chainlink VRF v2.5.
- Deploy: Vercel (frontend), Base Sepolia (contract); Base mainnet planned.

## Contract addresses (Base Sepolia testnet)

- TheGrid (V3, live): 0x1CE38cb0dcE4cE2B68f8986611dDC0FD2AD0F5d8
- USDC (Circle native testnet): 0x036CbD53842c5426634e7929541eC2318f3dCF7e
- Chain ID: 84532
- Always verify the current address shown in the site footer before interacting.

## Key pages

- [Home](https://stakewar.com): the live 10×10 grid, stats bar, live activity, leaderboard, recent activity.
- [How It Works](https://stakewar.com/how-it-works): full game mechanics — claiming, the capture mechanic, epochs, treasures.
- [Get Started](https://stakewar.com/get-started): step-by-step onboarding (wallet, Base Sepolia network, faucets).
- [FAQ](https://stakewar.com/faq): common questions answered.
- [Leaderboard](https://stakewar.com/leaderboard): top holders ranked by cells, locked value, captures, spend, and badges.
- [Stats](https://stakewar.com/stats): global game statistics — volume, players, daily claims, treasure pool, achievement distribution.
- [Bug Bounty](https://stakewar.com/bug-bounty): security scope, severity/reward table, responsible disclosure.
- [Terms](https://stakewar.com/terms): terms of service.
- [Privacy](https://stakewar.com/privacy): privacy policy.
- [DMCA](https://stakewar.com/dmca): copyright takedown policy.

## Achievements (29 total)

Players earn off-chain badges computed deterministically from the grid's public on-chain event history (Claimed / Captured / TreasureWon) plus the live grid state — zero gas, nothing extra to sign. Categories:

- Origin: Patient Zero, Genesis, Founding (entry order).
- Combat: Raider, Warmonger, Hunter, Giant Killer, Sniper.
- Defense: Survivor, Veteran, Defender, Untouchable.
- Collection: Collector, Whale, Tycoon.
- Pattern: Square Architect, Crusader, Corner Lord, Diagonal.
- Economic: High Roller, Bankroll, Big Spender.
- Treasure: Crown, Lucky, Echo Master, Iceberg.
- Meta: Completionist, Pentathlon.
- Social: Joined Via Referral.

## Security

A bug-bounty program is available. Report vulnerabilities to stakewar@proton.me. Rewards are badges plus post-mainnet USDC credits (no testnet payouts during the testnet phase), with 90-day responsible disclosure. See [/bug-bounty](https://stakewar.com/bug-bounty).

## License & disclaimer

This is a testnet application. Testnet USDC has no monetary value — do not transfer real funds to testnet addresses. The project currently operates pseudonymously without a legal entity. Use at your own risk. See [/terms](https://stakewar.com/terms) for full terms.

## Links

- [X / Twitter](https://x.com/StakeWarGame)
- [GitHub](https://github.com/seomarlboro/stakewar)