Logo
PREDICTIONBATTLE
Beta
Back to Arena

Prediction Battle

Technical Whitepaper · v2.0

Contract: PredictionBattle v2.0 · Base Mainnet · March 2026

Abstract

Prediction Battle is a fully non-custodial, permissionless prediction market protocol deployed on Base (Coinbase's Layer 2 Ethereum network). The protocol enables any participant to create or bet on outcome markets framed as binary disputes between two subjects (e.g., Creator A vs Creator B), with settlement enforced entirely by the PredictionBattle v1.0 smart contract.

Resolution is achieved through an optimistic, bond-backed verification system in which economic penalties for dishonesty are hardcoded at the contract level. No central oracle, no trusted third party. All funds — bets, bonds, and fees — flow exclusively through on-chain logic. The protocol earns a fixed 21% fee on profits only, distributed among the treasury, market creator, referrer, and result reporter.

1. Problem Statement

1.1 Zero-stake social predictions: Social platforms are saturated with unverifiable predictions — crypto debates, influencer rivalries, political forecasts — but participants bear no financial consequence for being wrong. This results in low-quality discourse and no mechanism for price discovery around social outcomes.

1.2 Centralized custody risk: Existing prediction markets (Polymarket, Kalshi, Manifold) rely on centralized operators for fund custody, market creation, and resolution. This introduces counterparty risk, geographic censorship, and settlement opacity.

1.3 Oracle centralization: Most on-chain prediction protocols depend on external oracle providers (Chainlink, UMA, Pyth) that are expensive, slow to integrate, and unsuitable for qualitative or social media-based outcome data. Outcome verification for subjective social events remains an open problem.

1.4 High entry barrier: Complex token bridges, multi-step approvals, and illiquid prediction tokens discourage casual participation. A stablecoin-native (USDC) protocol on a cheap, fast L2 radically lowers this barrier.

2. Solution Overview

Prediction Battle addresses these problems through four architectural decisions:

Non-Custodial Contracts

All USDC is held exclusively in PredictionBattleV11.sol. No admin wallet, no intermediary. Users interact directly with the contract via ERC-20 approve + transferFrom.

Open-Ended Subject Markets

Markets are defined by two named sides (Side A vs Side B), not by a fixed oracle data feed. Any publicly verifiable social event qualifies: follower counts, engagement metrics, publishing frequency, platform metrics.

Optimistic Bond Resolution

Any user can report the outcome by staking a USDC bond. A 12-hour dispute window allows any other participant to challenge with a larger bond. Honest reporters earn a 1% reward; dishonest reporters lose their bond.

Base L2 Infrastructure

Deployed on Base, transactions settle in ~2 seconds at under $0.01 each, making micro-bets of $0.05 USDC economically viable.

3. Market Mechanics

3.1 Market Creation

Any wallet may create a market by depositing a minimum seed of 1 USDC and submitting a question (10–500 characters). The seed is held separately from the betting pools and is fully refundable to the creator after resolution. There is a 1-hour anti-spam cooldown per creator address.

3.2 Market Types

  • Time-Bound: Has an explicit deadline. Bets are accepted until the deadline passes, after which only outcome proposals are accepted.
  • Open-Ended (deadline = 0): No fixed expiry. Bets accepted until a proposer initiates resolution. The creator must wait 24h before self-proposing.

3.3 Betting

  • Participants choose Side A or Side B. Their USDC enters the liquidity pool for their chosen side.
  • Minimum bet: 0.05 USDC · Maximum: 100,000 USDC
  • Total market pool cap: 1,000,000 USDC
  • Multiple bets on the same side accumulate. The referrer address is locked on the first bet per user per market and cannot be overwritten.

3.4 Early Bird Bonus

Bets placed during the creator-defined bonus window receive 1.2× shares instead of the base 1.0×. Shares determine the proportional claim on the winning pool. This rewards participants who take on greater uncertainty by committing capital early.

3.5 Market States

OPENPROPOSEDDISPUTEDRESOLVED

4. Liquidity & Payout Model

Prediction Battle uses a Pari-Mutuel pool model. All bets on each side form two isolated pools. If your side wins, your proportional share of the opposite pool is distributed to you (after fees).

4.1 Share Calculation

// At bet time

shares = f(yourSidePool, opposingPool, betAmount, isEarlyBird)

// At claim time

yourSlice = (yourShares / totalWinningSideShares) × totalLosingPool

grossPayout = yourOriginalBet + yourSlice

netPayout = grossPayout - fees (applied to profit only)

4.2 Multiplier Dynamics

The effective multiplier is determined by the ratio of the opposing pool to your own pool at market close. A heavily unbalanced market (e.g., $200 on Side A vs $2,000 on Side B) produces a high multiplier (~10×) for Side A bettors and a low multiplier (~1.1×) for Side B bettors. This dynamic price discovery incentivizes contrarian capital to balance pools, improving market efficiency.

4.3 Special Outcomes

  • DRAW: All bettors receive 100% of their stake back. No fees collected.
  • CANCELLED: Admin voiding. Full stake refund to all participants.
  • One-sided pool: If the losing side has $0, winners reclaim their original stake only (no profit to distribute).

5. Fee Structure

All fees are calculated and deducted exclusively from the profit margin (the losing pool distribution). The original stake of every bettor is never subject to fees.

RecipientRateCondition
Protocol Treasury10%Always collected on resolved markets
Market Creator5%Paid to the wallet that created the market
Referrer5%Only if a referrer was recorded on first bet; stays in pool otherwise
Result Reporter1%Proposer who submitted correct outcome (or winning challenger)
Total21%On profit only; original stakes returned at 100%

Fees are pre-computed at market resolution (not at claim time), stored as separate balances, and withdrawable by each recipient independently. This design prevents any single actor from blocking fee collection.

6. Decentralized Resolution

Resolution is modeled as an Optimistic Oracle: assume honesty, penalize dishonesty economically.

1

Proposal

Any user submits the winning side plus evidence (URL ≤512 chars) and deposits a USDC bond (minimum 5 USDC, scales with pool size). Market transitions to PROPOSED state instantly.

2

Challenge Window (12 Hours)

For exactly 43,200 seconds, any other user may submit a counter-proposal by depositing a bond ≥ the original. The proposer cannot self-challenge. Market transitions to DISPUTED.

3

Finalization

If the 12h window closes without a dispute, any user calls finalize. The outcome is locked immutably. The proposer receives their bond back + 1% reporter reward.

4

Arbitration

If disputed, an admin evaluates both evidence sets and calls resolveDispute(winner). The honest party earns their bond + 80% of the liar's bond. 20% of the loser's bond is slashed to the treasury.

The 30-day Emergency Timeout ensures that no market can be permanently stuck. After 30 days without resolution, an admin may void the market and refund all participants.

7. Security Architecture

  • Non-Custodial: All funds are transferred directly to the smart contract via ERC-20 safeTransferFrom. No EOA or backend wallet holds user funds.
  • ReentrancyGuard: All state-changing functions implement Checks-Effects-Interactions (CEI) and use OpenZeppelin's ReentrancyGuard.
  • AccessControl (Role-based): Admin functions are protected by DEFAULT_ADMIN_ROLE. Operator functions by OPERATOR_ROLE. Role transfers require explicit setOperator() — direct grantRole on OPERATOR_ROLE is blocked.
  • Treasury Timelock: Changes to the treasury address require a 2-day timelock via a two-step propose/execute pattern, preventing immediate rug vectors.
  • Global Liability Tracking: All USDC locked (bets + bonds + seeds) is tracked in totalLockedAmount, enabling trustless solvency audits at any time.
  • Circuit Breakers: Configurable max bet (100k USDC) and max pool (1M USDC) caps prevent extreme concentration of funds in a single market.
  • MEV Protection: Open-ended markets have a per-user 5-minute cooldown between placing a bet and proposing an outcome on the same market, preventing same-block manipulation.
  • Pausable: Admin can halt all market activity in an emergency without disrupting existing claims.
  • Verified on Basescan: Contract source is publicly verified on Base Mainnet.

8. Punishment & Slashing

The slashing system is not a discretionary penalty. It is a hardcoded economic deterrent written into the contract's resolution logic. Slashing is irreversible once executed on-chain.

8.1 Bond Slashing (Dishonest Reporters)

When a dispute is resolved and a liar is identified:

  • The liar forfeits 100% of their submitted bond.
  • 80% of the forfeited bond is awarded to the honest counterparty as a bounty.
  • 20% is transferred directly to the protocol treasury.
  • The honest winner also inherits the 1% Reporter Reward from the market's profit pool.

8.2 Seed Confiscation (Fraudulent Market Creators)

If an admin determines a market was created fraudulently (fabricated subject, manipulated evidence, collusion):

  • The creator's seed deposit is permanently confiscated and transferred to the treasury.
  • The market resolves as CANCELLED — all bettors receive 100% stake refunds.
  • This is logged via the SeedConfiscated event (distinct from voluntary WithdrawSeed).

8.3 Incentive Alignment Summary

The economic game theory model ensures that at every decision point, the cost of lying exceeds the potential gain from lying. As pool sizes grow, bond requirements scale proportionally, making large-scale manipulation progressively more expensive.

9. Roadmap

✅ Foundation (Complete)

Core smart contract (v1.0), Base Sepolia testnet, frontend MVP, decentralized resolution logic, and referral system.

📱 Base & Farcaster Native App

Deep integration within the Base ecosystem and Farcaster clients for instant distribution and one-click connection.

⚡ Viral Social Hooks

Automated winner flex-cards and one-click sharing mechanics to drive organic growth across all platforms.

🌐 Omnichannel Integrations

Expanding prediction markets beyond Farcaster to include TikTok, YouTube, Instagram, and other major social networks.

🛡️ Decentralized Oracles

Integration with UMA or Kleros to fully decentralize the dispute resolution process, removing the dependency on a central Administrator.

📈 Orderbook & AMM Transition

Upgrading from the Pari-Mutuel model to an automated market maker or orderbook, enabling advanced position trading.

💳 Fiat Onramp Solution

Direct fiat-to-crypto payments allowing mainstream users to participate seamlessly without holding ETH.

🏆 Governance & Tokenization

Launch of the native token to initiate full protocol decentralization, where staked tokens will be the central element in result verification, dispute arbitration solutions, voting, and protocol governance.

Conclusion

Prediction Battle is a fully on-chain primitive for converting social disagreement into verifiable, economically-settled outcomes. By removing custody from operators and oracle trust from centralized providers, we build a system where the only way to win is to be right, and the only way to lose is to be wrong or to lie. Capital, reputation, and truth align by design.

Join the arena. Stake your claim. Prove you know what's next.