## Context Authoritative product spec for Arena v2. Parent epic: #238. Replace `docs/product/primitives.md` launchpad semantics with TimeArena rules. ## Relevant files - New: `docs/product/time-arena.md` - Update: `docs/glossary.md`, `docs/architecture/overview.md` - Retire references in: `YO-DOUB-Launch-UX-Flows.md`, `launchplan-timecurve.md` ## Acceptance criteria Document these timer rules: | Podium | Initial timer | Extension on buy | Hard-reset if remaining below | Reset to | |--------|---------------|------------------|-------------------------------|----------| | **Last Buy** (primary) | 24h | +120s | 13m | 15m | | **Streak** | 18h | +90s (+1.5m) | 8.5m | 10m | | **Time Booster** | 12h | +60s (+1m) | 4m | 5m | | **WarBow** | 48h | +300s (+5m) | 55m | 1h | - [ ] Each podium has **independent deadline + epoch counter**; epochs are **not synchronized** - [ ] **CHARM:** fixed **1000 DOUB / CHARM** (admin-settable); min/max CHARM band unchanged in spirit - [ ] **Buy economics:** 10% DOUB → each podium pool; 7.5% DOUB → each podium next-round seed; 30% → admin sell vault; **70% total to prizes** - [ ] **Play CRED:** non-transferable; 70 CRED = one free buy (min/max CHARM band applies); admin + optional grantor contract can mint - [ ] **CRED yield:** each buy mints **35 CRED** split pro-rata to current-epoch CHARM holders - [ ] **Last Buy epoch:** CHARM tracked per epoch; on Last Buy reset → claim pending CRED, zero epoch CHARM onchain - [ ] **XP:** linear 1–10 from min→max buy; L1=20 XP; +5 XP per level requirement until 100 XP/level cap, then flat 100 XP/level forever - [ ] **WarBow PvP:** steal/guard/revenge/flag; costs **1000 / 10000 / 1000 / 50000 DOUB**; WarBow scores reset when WarBow timer epoch ends; indexer retains historical epochs for admin finalize - [ ] **Referrals:** existing codes preserved; **5% CRED to referrer + 5% CRED to buyer** (not CHARM) ### Open decisions (resolve in this issue) 1. Revenge DOUB cost — default **1000** (same as steal) 2. Referral registration burn — keep **1 CL8Y** for existing-code continuity vs migrate to DOUB 3. CRED referral 5% basis — **5% of the 35 CRED mint** per side 4. Podium settlement trigger — permissionless `rollPodiumEpoch(cat)` vs auto on first post-expiry buy 5. Route naming — `/arena` primary with `/timecurve` redirect (optional) ## Verification checklist - [ ] Spec reviewed against Arena v2 requirements - [ ] Cross-links from glossary + agent-phases Phase 20 play track - [ ] No remaining sale-end / redeemCharms / linear CHARM price as v2 behavior