Memepull Arena

MemePull ARENA is a Web3 GameFi platform that turns meme coin tribalism into structured, trustless competition. It features two core products:

1. PvP Battle (Battle of the Tribes) — Winner-takes-all liquidity competitions between two meme token communities. Users pick a side, deposit tokens, and the community with the best price performance (measured via TWAP) wins 90% of the combined pool.

2. Prediction Markets — Template-based Yes/No prediction markets for verifiable on-chain milestones (e.g., "Will $PEPE hit $1B market cap by March 2026?"). Markets are resolved automatically by Chainlink CRE using real-time price data.

The platform solves three key problems in the meme coin space:

• Sybil attacks: World ID integration enforces identity tiers (Ghost/Device/Human) with deposit caps and differentiated fees.
• Price manipulation: 30-minute TWAP windows prevent flash-loan and last-second price manipulation during settlement.
• Token safety: Chainlink CRE workflows automatically audit every market proposal — checking DEX liquidity thresholds and running token contract validation before approval.

All market lifecycle operations (auditing, settlement, liquidity monitoring, resolution) are fully automated through Chainlink CRE workflows with no manual intervention required.

MemePull ARENA is built as a modular architecture with three layers:

Smart Contracts (Solidity + Foundry):

• BattleArena: Manages PvP battle lifecycle (propose → approve → deposit → settle)
• PredictionMarket: Handles Yes/No market lifecycle with template-based resolution
• MulticallRouter: Atomic swap + deposit in a single transaction
• WorldIDVerifier: On-chain World ID proof verification with 3 identity tiers
• All contracts implement IReceiver (ERC-165 interface 0x805f2132) for Chainlink CRE report delivery via onReport()

Chainlink CRE Orchestrator (Go + WASI):

• Market Auditor Workflow (Cron 30s): Catches new proposals, validates token liquidity via DexScreener API, runs token safety checks, then calls approveBattle() or voidBattle()
• Battle Settlement Workflow (Cron 5min): Fetches final TWAP prices and settles expired battles with on-chain reward distribution (90% winners / 4% WLD victory bonus / 4% WLD safety net / 0.5% creator / 1.5% protocol)
• Liquidity Monitor Workflow (Cron 1h): Monitors active battles for >50% liquidity drops, triggers emergencyHalt() with full refund
• Market Resolution Workflow (Cron 15min): Resolves prediction markets at deadline using oracle price data

Frontend (Next.js 16 + React 19):

• Retro arcade-themed UI built with Tailwind CSS + shadcn/ui
• Wallet integration via wagmi/viem
• World ID verification via MiniKit SDK
• Real-time battle tracking with live price charts

Network: World Chain Sepolia (testnet) — chosen for native World ID support.