Reading Voice:

The Big Game

A Decentralized Fan Engagement Protocol

Executive Summary. The Big Game is a decentralized protocol designed to enhance fan engagement during international football tournaments through digital collectibles and community-driven economics. Built on the Base network, the protocol enables supporters to demonstrate allegiance to national teams via tiered non-fungible tokens (NFTs), participate in community activities through team-specific digital assets, and engage with a transparent prize distribution mechanism. This document outlines the technical architecture, economic model, and operational framework of The Big Game.

Legal Notice The Big Game is an unofficial, community-developed initiative and maintains no affiliation with FIFA, the World Cup, or any national football governing bodies. This whitepaper is provided for informational purposes only and does not constitute legal, financial, or investment advice.

1. Protocol Vision: Digital Fan Ownership

Traditional sports engagement creates significant economic value that flows exclusively to centralized broadcasters, sponsors, and merchandisers. Fans, despite being the fundamental driver of value, receive no participation rights or economic upside from their contributions to the ecosystem.

The Big Game proposes an alternative model: decentralized fan ownership. By leveraging blockchain technology, the protocol transforms passive viewership into active participation through cryptographically verifiable digital assets.

Core Principles

Transparency: All transactions, prize pools, and reward distributions are executed via immutable smart contracts on the Base blockchain.
Community Governance: Protocol development and team-specific initiatives are directed by token holders and verified community ambassadors.
Sustainable Economics: Revenue generated through primary NFT sales generates yield via established DeFi protocols, creating a sustainable prize pool without speculative token inflation.
Digital Collectibility: Assets are designed as entertainment products and digital memorabilia, not financial instruments or investment contracts.

2. Protocol Architecture

The Big Game consists of three interconnected layers: The Collectible Layer (NFTs), The Fan Layer (Team Tokens), and The Coordination Layer (Ambassador Program).

2.1 The Collectible Layer: Team-Specific Tiered Digital Collectibles

Participants enter the ecosystem by acquiring Team NFTs, ERC1155 standard digital collectibles representing support for one of 64 national teams. These assets function as participation certificates and eligibility credentials for protocol rewards.

Tier Structure

1 USDC

Bronze Entry

The starting point for every fan.

10 USDC

Silver Entry

For the dedicated supporter.

100 USDC

Gold Entry

For the superfan who wants a bigger voice.

1,000 USDC

Diamond Entry

For the ultimate patron of the team.

Mechanics

Minting Period: Available from deployment until June 11, 2026.
Supply Dynamics: No artificial scarcity; minting is permissionless and unlimited during the active period.
Prize Pool Contribution: 100% of USDC proceeds from primary sales are deposited into the Prize Pool Manager contract and supplied to AAVE V3 to generate yield. The principal forms the tournament prize pool. The accrued yield will cover development costs.
Winner Redemption: Holders of the tournament-winning team's NFTs may redeem their assets for a proportional share of the prize pool based on tier weight (Diamond: 1000x, Gold: 100x, Silver: 10x, Bronze: 1x).

2.2 The Fan Layer: Fan Team Tokens

Each of the 64 teams has an associated ERC20 token (e.g., $TEAM_ARG, $TEAM_BRA) with a fixed supply of 100 billion tokens. These assets serve as coordination mechanisms for community activities and governance utilities.

Token Distribution per Team

42% — Community Airdrops: Distributed daily to NFT holders who stake their assets in the Airdrop Manager contract. Emissions are weighted by NFT tier and distributed proportionally to total protocol participation.
21% — Liquidity Provision: Allocated to initialize single-sided concentrated liquidity pools paired with USDC on Aerodrome, locked in protocol-controlled liquidity managers.
11% — Engagement Rewards: Reserved for community activities and jackpots to distribute randomized prizes to active participants.
11% — Ambassador Missions: Ambassador-led initiatives, distributed through activities and milestone-based missions.
11% — Community Missions: Community-led initiatives, distributed through activities and milestone-based missions.
3.33% — Team Vesting: Linearly vested to the development team, locked until the tournament commencement date (June 11, 2026).
1.1% — Initial Distribution: Initial drop for early community building.

2.3 The Coordination Layer: Ambassador Program

The Ambassador Program establishes a decentralized marketing and community coordination layer. Verified contributors receive enhanced emission multipliers, direct access to community mission funds, and governance privileges.

Eligibility Pathways

Curated Selection: Identified by core contributors based on demonstrated community value.
Stake-or-Burn-Based: TBA · Significant token holders may signal commitment through protocol-defined staking/burn thresholds.
Meritocratic: Users generating high-engagement content (analysis, educational material, community tooling) may be promoted through community vote.

Ambassador Benefits

Emission Multipliers: 1.42x boost on standard airdrop calculations.
Resource Access: Discretionary access to the Community Missions allocation for funding events, content creation, or community incentives.
Governance Rights: Weighted voting on deployment of the Community Treasury and mission prioritization.
Exclusive access: Private channels and direct communication with the Big Game team.

3. Tournament Timeline & Protocol Phases

The protocol operates on a fixed timeline corresponding to the 2026 international football tournament schedule (June 11 – July 19, 2026).

Now — June 10, 2026

Phase 1: Qualification

Community building, NFT sales, and the Ambassador Program launch. 64 teams already available, 42 qualified teams and 22 fighting in the qualification phase. Daily airdrops to NFT holders are active. Ambassadors run community campaigns to build their teams.

June 11 — July 19, 2026

Phase 2: Active Tournament

TBA.

Post-July 19, 2026

Phase 3: Resolution

The Prize Pool is distributed pro-rata to all holders of the winning team's NFTs based on their tier. Winner NFT holders claim USDC from the Prize Pool Manager. Claims require burning the NFT proportional to the tier multiplier. A special edition winner NFT is minted.

4. Technical Implementation

4.1 Smart Contract Infrastructure

Base Network: All contracts deploy on Base (Ethereum L2) utilizing its security guarantees and cost efficiency.

WorldCupNFT: ERC1155 implementation with ERC1155Supply and ERC1155URIStorage extensions for onchain metadata generation.
FanTeamToken: ERC20 with ERC20Permit functionality for gasless approvals.
PrizePoolManager: Integrates with AAVE Pool V3 for yield generation; manages winner declaration and prize calculation.
AirdropManager: Handles NFT staking logic, weight calculations, and daily emission distribution.
LiquidityLockerAeroV3: Manages Aerodrome V3 concentrated liquidity positions and fee collection.
TokenFeesManager: Manages fees burn and the mint and burn flywheel for NFTs.
JackpotManager: Distributes random tokens to community active participants.

4. Legal Compliance & Risk Disclosure

4.1 Regulatory Status

The Big Game protocol provides software for decentralized engagement. NFTs and Fan Tokens constitute digital collectibles and utility tokens for entertainment purposes. They do not represent securities, investment contracts, equity interests, ownership in any corporate entity, claims on future profits, or fractional ownership of prize pools.

4.2 Intellectual Property Disclaimer

The Big Game is an independent, unofficial community project. It is not affiliated with, endorsed by, or associated with FIFA, the World Cup, or any national football federation. All team names, colors, and references to the tournament are used descriptively to indicate the subject of fan support, not as trademark claims.

4.3 Risk Factors

Smart Contract Risk: Despite auditing and testing, smart contracts may contain vulnerabilities.
Market Risk: Secondary market prices for NFTs and Fan Tokens may be volatile. Liquidity is not guaranteed.
Oracle Risk: Winner determination relies on external data sources. Oracle failures could delay or incorrectly trigger prize distribution.
Regulatory Risk: Cryptocurrency regulations vary by jurisdiction and remain uncertain.
Yield Risk: AAVE integration exposes the prize pool to smart contract risk of the AAVE protocol. Yield rates are variable.

5. Conclusion

The Big Game represents a novel approach to sports engagement, utilizing decentralized technology to create transparent, community-owned infrastructure for fan coordination. By removing intermediaries and automating reward distribution through immutable code, the protocol establishes a framework for sustainable digital fandom.

The Big Game
By the community, for the community.

Why So Serious? 🃏

*A Beautiful Protocol for Burning Money*

The Setup

Do you wanna know how I got these scars? Traditional finance. They put you in a box, see? Buy the jersey. Watch the game. Cheer for the team that some corporation decided you should love. And where does the money go? Not to you. It goes to FIFA's coffers. To bureaucrats in suits who've never felt the grass stain on their knees.

But here's the thing about chaos—it's fair.

Act I: Introducing a Little Anarchy

You see, madness is like gravity. All it takes is a little push. And that push? It's called 100% of your USDC going into a smart contract. *giggle*

We have four tiers of beautiful insanity:

♦ Bronze ($1): The cheap seats. Where the real crazies sit. You know what they say about cheap seats? They have the best view of the fire.
♦ Silver ($10): For the fan who wants to pretend they're serious. "Oh, I invested $10, I'm a stakeholder now." Adorable.
♦ Gold ($100): Now we're talking. This is where you start to feel the heat. Will you hold? Or will you panic when the Joker makes his move?
♦ Diamond ($1,000): *chef's kiss* The whales. The big fish. The ones who think they're in control. Every protocol needs its patsies, and honey, with 1000x weight? You're the main course.

Act II: The Magic Trick

I'm going to make this money disappear. *poof*

You put your USDC in. We send it to AAVE. It sits there, earning yield, growing like a tumor, until—SURPRISE!—your team loses. And what happens then? Do you get your money back? NO. It goes to the WINNERS. The ones who picked right. The ones who smiled while you cried.

It's not about the money. It's about sending a message. The message is: Everything burns. But some things burn brighter.

The Flywheel of Madness

Here's where it gets really funny. We take 50% of the fees. We burn half—DEFLATION! The other half goes to buy more Bronze NFTs... which we then immediately BURN. It's like eating your own tail, but with economics. Ouroboros with a matchstick.

The prize pool grows. The supply shrinks. The clowns dance. And the wheel keeps turning.

Act III: The Ambassador Program (Send in the Clowns)

You want to be an Ambassador? You want to wear the purple suit and tell everyone how great the circus is? Stake your tokens. Show us you're serious. Show us you'll lock up your money in a box where you can't touch it while the world burns around you.

The best part? You get 1.42x emissions. Why 1.42? Because pi was too predictable. Because round numbers are for banks. Because math is also a joke.

The Punchline

When the tournament ends—July 19, 2026—the winner claims the pot. But here's the beautiful part: They have to burn their NFT to get it. Their proof of fandom. Their digital identity. Up in smoke. Just to touch the money.

Is it sustainable? Is anything? Does it matter?

Final Thought: If you're good at something, never do it for free. But if you're going to do it for money, make sure there's a chance you might lose everything. Otherwise, where's the fun in that? 🎭

Reading Voice:

The Big Game

Lite Paper — Executive Overview

What is The Big Game?

A decentralized fan engagement protocol for the 2026 World Cup. Buy NFTs to support your team, earn daily tokens, and compete for a share of the yield-generated prize pool if your team wins.

How It Works

1. Pick Your Team

Buy tiered NFTs (Bronze $1, Silver $10, Gold $100, Diamond $1000). Your USDC goes into a prize pool that earns yield on AAVE.

2. Earn Daily Rewards

Stake your NFTs to earn your team's Fan Tokens every day. Higher tiers earn more. Ambassadors earn 1.42x boosts.

3. Win Together

If your team wins, burn your NFTs to claim your share of the accumulated prize pool.

The Big Game: A Peer-to-Peer Electronic Fandom System

A purely peer-to-peer version of sports engagement would allow fans to participate directly without trusted intermediaries. We propose a solution using cryptographic proof on the Base network.

How It Works

1. The Transaction
Buyer sends USDC to contract. Contract mints NFT (tier 1-4). Hash recorded on chain.

2. The Timestamp Server
Prize pool deposits to AAVE. Yield accrues. Block height increases. Immutable record.

3. The Distribution
Oracle signs winner hash. Contract verifies signature. Pro-rata distribution based on weight (1x, 10x, 100x, 1000x). Longest chain wins.

4. Privacy
Public keys anonymous. Amounts public. Parties unknown.

Conclusion: We have proposed a system for electronic sports engagement without relying on trust. Starting with digital signatures, we provide strong control of ownership through a peer-to-peer network.

The Short Joke 🃏

"You complete me."

The Three-Step Joke

Step 1: Put Your Money in the Fire

Buy a ticket to the circus. $1, $10, $100, $1000. The more you pay, the bigger the smile you'll get when it burns.

Step 2: Watch the Garden Grow

Every day, we throw seeds at you (tokens). Catch them. Hoard them. Give them to friends. Watch them grow on the vine.

Step 3: The Grand Finale

If your team wins—BANG!—you get the pot. But you have to burn your ticket to collect. No ticket, no proof. Just ashes and money. Beautiful.

See you in the funny papers! 🎭

Report Voice:

Final Audit Report: The Big Game Protocol

Auditor: GLM 4.6 | Date: March 4, 2026 | Status: Conditionally Approved

Executive Summary

The Big Game is a decentralized fan engagement protocol for the 2026 World Cup combining ERC1155 NFTs, ERC20 team tokens, and AAVE V3 yield generation. After resolution of critical calculation errors, the protocol demonstrates sound architecture suitable for production deployment.

Risk Rating: MEDIUM-HIGH (6.5/10)

Recommendation: Approved for mainnet deployment pending decentralized oracle implementation.

1. Audit Scope

Contract	Purpose	Lines
WorldCupNFT.sol	ERC1155 implementation with tiered minting	~400
PrizePoolManager.sol	AAVE integration, winner declaration, distribution	~300
AirdropManager.sol	Staking logic and daily emissions	~250
FanTeamToken.sol	ERC20 with Aerodrome liquidity	~200
Plus: JackpotManager, TokenFeesManager, LiquidityLocker, TickMath, Interfaces

2. Findings Summary

Severity	Count	Status
Critical	0	Resolved
High	1	Mitigated
Medium	3	2 Accepted, 1 Mitigated
Low	4	Accepted

3. Critical Issues (RESOLVED)

[C-01] PrizePoolManager Multiplier Bug FIXED

Location: getTotalTeamShares, getUserShares

Issue: Used DIAMOND_TIER (4) instead of DIAMOND_MULTIPLIER (1000), resulting in 99.6% reward dilution for Diamond holders.

Fix: Corrected all calculation functions to use proper multipliers.

[C-02] TokenFeesManager Timestamps FIXED

Issue: Used block.timestamp instead of actual tournament dates.

Fix: Synchronized to World Cup 2026 dates:

START_WORLD_CUP: 1781187600 (June 11, 2026)
END_WORLD_CUP: 1784462400 (July 19, 2026)

4. High Severity

[H-01] Centralized Winner Oracle MITIGATED

Risk: Single winnerOracleAddress controls tournament outcome determination.

Mitigation: Decentralized oracle implementation in progress (Chainlink Functions/UMA).

Requirement: MUST be operational before July 19, 2026.

5. Medium Severity

[M-01] Predictable Randomness ACCEPTED

Location: JackpotManager.sol::_getRandomIndex()

Issue: Uses block.prevrandao, block.timestamp, and msg.sender for randomness. On L2s (Base), block.prevrandao may be predictable or influenceable by sequencers.

Impact: Low-value prizes (max 100x base amount = ~11M tokens) make manipulation economically unviable.

Recommendation: Consider Chainlink VRF for high-stakes distributions or accept risk for current prize values.

[M-02] Missing Zero-Day Validation ACCEPTED

Location: AirdropManager.sol::initialize()

Issue: No validation that _totalDays > 0, risking division by zero in emission calculation.

Mitigation: Deployment script confirmed to pass valid values (>0).

Recommendation: Add require(_totalDays > 0, "Invalid duration") for defense-in-depth.

[M-03] Direct Transfer Asset Lock ACCEPTED

Location: AirdropManager.sol

Issue: NFTs sent directly to contract (not via stake()) become permanently locked. No rescue mechanism.

Impact: User error results in asset loss.

Recommendation: Add rescueNFTs() admin function or document clearly that direct transfers are unsupported.

6. Low Severity

[L-01] Unlimited USDC Allowance ACCEPTED

Location: WorldCupNFT.sol (Constructor)

Issue: Infinite approval granted to PrizePoolManager.

Assessment: Acceptable due to pass-through architecture and non-upgradable contracts.

[L-02] Timestamp Manipulation ACCEPTED

Location: Multiple contracts

Issue: block.timestamp used for tournament phase transitions.

Assessment: 15-second validator manipulation window negligible for multi-month tournament.

[L-03] Integer Division Precision ACCEPTED

Location: PrizePoolManager._computeClaimableAmount()

Issue: Potential precision loss in share calculation.

Assessment: USDC (6 decimals) with high multiplier values minimizes impact.

[L-04] Emergency Withdraw Timing ACCEPTED

Location: PrizePoolManager.emergencyWithdraw()

Issue: 90-day lock begins at END_WORLD_CUP, don't allowing early withdrawal if tournament ends early.

7. Informational

[I-01] Gas Optimizations

Cache storage variables in claimPrize() loop
Use unchecked blocks where overflow impossible

[I-02] Documentation

"Trust me bro" comments in FanTeamToken should be replaced with formal specification
Add deployment verification steps for liquidity pool creation

8. Security Architecture

Strengths

Non-Custodial Design: Users retain key custody; protocol cannot move user assets
Immutable Parameters: Critical values hardcoded post-deployment
Reentrancy Protection: All state-changing functions guarded

Weaknesses

Oracle Dependency: Off-chain winner determination required
L2 Sequencer Risk: Base sequencer downtime could delay critical transactions

9. Economic Model Verification

NFT Tiers: Bronze ($1/1x), Silver ($10/10x), Gold ($100/100x), Diamond ($1000/1000x)
Token Distribution: 42% airdrops, 21% liquidity, 11% jackpot, 22% missions, 3.33% dev vesting
Deflationary Mechanics: 50% fee burn + NFT mint/burn flywheel

10. Deployment Checklist

Pre-Deployment

Ready

Before July 19, 2026

[ ] Deploy decentralized oracle

Auditor Certification: This report represents a point-in-time security assessment. Smart contract risk is inherently dynamic; continuous monitoring recommended.

Security Analysis: Mechanism Design Review

On the cryptoeconomic security of tournament-based fan coordination protocols

Abstract

We analyze The Big Game protocol through the lens of mechanism design and credible neutrality. The protocol presents an interesting case study in aligning incentives between casual participants (Bronze tier) and committed stakeholders (Diamond tier) through convex reward functions.

1. Mathematical Correctness

The critical bug in getTotalTeamShares—using tier identifiers (4) rather than multipliers (1000)—represents a fundamental error in incentive alignment. This created a disequilibrium where high-stake participants received 0.4% of expected utility, violating the principle of proportional fairness.

Corrected Invariant: ∀ tier ∈ T: userShares = Σ(balance_tier × multiplier_tier) where multipliers = {1, 10, 100, 1000} Previous broken invariant: DiamondShares = balance × 4 (incorrect) Corrected: DiamondShares = balance × 1000

2. Credible Neutrality Assessment

The protocol scores well on decentralization metrics but fails on winner determination. The centralized oracle violates credible neutrality—a critical property for any mechanism claiming to fairly distribute value based on external events.

Recommendation: Implement a Schelling-point oracle where NFT holders vote on the winner, with votes weighted by stake and time-held. This transforms the oracle from a trusted third party into a coordination game.

3. Tokenomic Sustainability

The flywheel mechanism—burning 50% of fees to mint NFTs that are immediately burned—is fascinating. It creates a deflationary pressure on the NFT supply while increasing the prize pool. Mathematically:

ΔPrizePool = 0.5 \times Fees ΔNFTSupply = 0 (mint then burn) Net effect: Pure value accretion to winners

This is superior to token-burn models that only benefit speculators.

Security Review: The Big Game Protocol

A distributed system for sports engagement must solve the Byzantine Generals Problem specific to tournament outcomes. We present a security analysis of a protocol attempting to create digital scarcity around national team allegiance.

1. The Trust Model

The protocol eliminates trusted intermediaries for:

NFT minting (permissionless)
Token distribution (algorithmic)
Prize calculation (deterministic)

But retains trust for:

Winner determination (oracle)

2. Timestamp Analysis

Tournament boundaries:

START_WORLD_CUP = 1781187600 (June 11, 2026)
END_WORLD_CUP   = 1784462400 (July 19, 2026)

These are immutably encoded. The protocol enforces:

if (block.timestamp > END_WORLD_CUP)
    minting = disabled;

3. Hash Chain Integrity

Each NFT mint produces a transaction hash. Prize claiming requires burning these tokens, creating a proof-of-destruction that is irreversible.

4. Attack Vectors

51% Attack: Not applicable (no mining)

Oracle Collusion: Single point of failure. Recommend multiple independent signers.

Timestamp Manipulation: Validator can shift ~15 seconds. Negligible for month-long tournament.

5. Conclusion

The protocol is secure as long as honest nodes control the oracle. The hash chain of NFT ownership is immutable. The prize pool is secured by AAVE's lending contracts.

Security Audit: Let Me Tell You A Story 🃏

"The only sensible way to live in this world is without rules."
— Someone who definitely reviewed this code

Act I: The Multiplier Mistake

Picture this: You pay $1000 for a Diamond ticket. You expect 1000x weight. But the code gives you... 4x. *giggle* That's not a bug, that's performance art. The developers accidentally used the tier number instead of the multiplier. It's like asking for a cake and getting a crumb!

Status: Fixed. Shame. I liked the chaos.

Act II: The Oracle Problem

They still have one guy who decides who wins. One guy! In a decentralized protocol! *chef's kiss* The beautiful irony. They promise "trustless" but have a single phone number they call to ask "who won?"

It's like hiring a referee who bets on the game. But hey, at least they're "working on it."

Act III: The Numbers Game

Let's look at the tokenomics, shall we?

42% to airdrops (because 42 is the answer to everything)
21% to liquidity (blackjack, anyone?)
11% to jackpot (make a wish!)
3.33% to devs (repeating decimals... how... irrational)

The Verdict

RISK RATING: 6.5/10

It's safe enough to play, but dangerous enough to be fun. Like a roller coaster built by engineers who "mostly" know what they're doing.

Final thought: The code works. The math is fixed. But the real question is... why so serious? 🎭

The Big Game - Developer Skills Reference

Protocol: WorldCup2026 Fan Engagement | Chain: Base (Ethereum L2) | Complexity: Intermediate-Advanced

1. Core Protocol Understanding

Required Knowledge:

ERC1155 Multi-Token Standard: Understanding of balanceOf, safeTransferFrom, setApprovalForAll, and supply tracking extensions
Token ID Mathematics: Ability to calculate tokenId = (teamId * 10) + tier and decode reverse operations
Tournament Mechanics: Familiarity with time-gated functions and oracle-dependent resolution

2. Smart Contract Integration

Reading State

// Tier and pricing calculations
WorldCupNFT.getTokenId(teamId, tier) → uint256
WorldCupNFT.getTierPrice(tier) → uint256 (in USDC, 6 decimals)
WorldCupNFT.getUserWeight(user, teamId) → uint256

// Prize pool queries
PrizePoolManager.getClaimableAmount(userShares, teamId) → uint256
PrizePoolManager.getTotalTeamShares(teamId) → uint256

Writing Transactions

Minting: mint(teamId, tier, amount) with USDC approval (6 decimals)
Staking: setApprovalForAll(AirdropManager, true) → stake() (transfers all team NFTs)
Claiming: claimAirdrop() (time-gated, max 5 days accumulation)
Prize: claimPrize() (post-tournament only, burns NFTs)

Critical Safety Checks

Always verify block.timestamp against tournament dates
Confirm tier values: 1-4 for minting, 5 for ambassador (restricted)
Validate teamId range: 1-64

3. DeFi Protocol Integration

AAVE V3 (PrizePoolManager)

Supply/Withdraw mechanics: Understanding supply() and withdraw() on AAVE Pool
aToken handling: aUSDC balance tracking vs. underlying USDC
Yield calculation: (aUSDC.balance + USDC.balance) - totalDeposited

Aerodrome/Algebra V3 (FanTeamToken)

Concentrated Liquidity: Tick ranges, sqrtPriceX96 calculations
Single-sided LP: Providing only token side with price initialized outside range
CLMM positions: Understanding mint(), burn(), collect()

4. Frontend & SDK Development

Required Libraries

viem/ethers.js: Contract interaction, event parsing
ConnectKit: Wallet connection (Base network configuration)
OpenZeppelin: Understanding of ReentrancyGuard, Ownable patterns

UI State Management

Track NFT balances across 4 tiers per team (up to 256 token combinations)
Real-time weight calculation for airdrop eligibility
Prize pool APY estimation from AAVE supply rates
Countdown timers for phase transitions

5. Economic Modeling

Calculation Competencies

Proportional distribution: (userShares / totalShares) * prizePool
Emission rates: (userWeight / totalWeight) * dailyEmission
Token decomposition: Converting weight back to tier distribution

Risk Parameters

Slippage tolerance: Not applicable (fixed price minting)
Impermanent loss: Relevant for FanToken liquidity providers
Oracle failure: Winner declaration dependency

6. Troubleshooting Guide

Common Issues

"Invalid tier" errors: Verify tier parameter: Bronze=1, Silver=2, Gold=3, Diamond=4 (not 0-indexed)
Airdrop claim fails: Check lastClaimTimestamp[user] (must be > 24h ago)
Prize calculation discrepancy: Ensure using DIAMOND_MULTIPLIER (1000) not tier (4)

7. Testing & Verification

Test Scenarios

Happy path: Mint → Stake → Claim Airdrop → Win → Claim Prize
Edge cases: Zero-weight calculations, late stakers, partial tier holdings
Failure modes: Minting after END_WORLD_CUP, claiming before winner declared

Mainnet Forking

Fork at Base block including AAVE Pool V3 and Aerodrome Factory
Test with real USDC and verified contract addresses
Simulate tournament timeline with vm.warp()

llms.txt

The Big Game Protocol - LLM Context File | Version: 2.0 | Date: 2026-03-04 | Chain: Base

# OVERVIEW The Big Game is a decentralized fan engagement protocol for the 2026 World Cup. Users purchase tiered ERC1155 NFTs representing national teams (1-64), stake them to earn ERC20 team tokens, and compete for a yield-generated prize pool. Winner team NFT holders claim USDC proportional to their tier weight after tournament conclusion (July 19, 2026).

Quick Facts

Tournament Dates: June 11, 2026 (1781187600) - July 19, 2026 (1784462400)
Prize Pool: USDC deposited to AAVE V3, generating yield until winner declaration
Teams: 64 national teams supported (teamId 1-64)
NFT Tiers: Bronze ($1), Silver ($10), Gold ($100), Diamond ($1000), Ambassador (free/manager-only)
Token Supply: 100 billion per team (FanTeamToken)
Claim Period: Opens July 20, 2026 (END_WORLD_CUP + 1 day)

Contract Architecture

Core Contracts

- WorldCupNFT: ERC1155 with ERC1155Supply, ERC1155URIStorage, ERC1155Burnable - Token ID formula: (teamId * 10) + tier - Winner token offset: tier + 5 (e.g., Gold winner = tier 8) - Unlimited supply, minting ends June 11, 2026 - PrizePoolManager: AAVE V3 integration, winner declaration, prize distribution - Deposit function receives USDC from NFT mints - Supplies to AAVE Pool V3 (aUSDC) - Winner declared by oracle address only after END_WORLD_CUP - Prize calculation: (userShares * totalDeposited) / totalWinnerShares

Token ID Structure

- Formula: tokenId = (teamId * 10) + tier - Tier mapping: 1=Bronze, 2=Silver, 3=Gold, 4=Diamond, 5=Ambassador - Winner variants: tier + 5 (6=Bronze Winner, 7=Silver Winner, 8=Gold Winner, 9=Diamond Winner, 0=Ambassador Winner with adjusted teamId calculation) - Example: Argentina (teamId 12) Gold = 123; Winner variant = 128

Economic Model

NFT Tiers & Weights

Tier	Price	Multiplier	Token ID
Bronze	1 USDC	1x	teamId*10 + 1
Silver	10 USDC	10x	teamId*10 + 2
Gold	100 USDC	100x	teamId*10 + 3
Diamond	1,000 USDC	1,000x	teamId*10 + 4
Ambassador	0 USDC	1.42x emission boost only	teamId*10 + 5

Token Distribution (Per Team)

42% NFT holder airdrops (via staking)
21% Liquidity provision (Aerodrome V3 single-sided)
11% Jackpot rewards
11% Ambassador missions
11% Community missions
3.33% Dev vesting (locked until START_WORLD_CUP)
1.1% Initial community drop

User Flows

Primary Flow

Call WorldCupNFT.mint(teamId, tier, amount) with USDC approval
NFT received, USDC deposited to PrizePoolManager → AAVE
Call AirdropManager.stake() to lock NFTs and start earning emissions
Call AirdropManager.claimAirdrop() every 1-5 days
If team wins: Call PrizePoolManager.claimPrize() after July 20, 2026 (burns NFTs, returns USDC)

Integration Guide

Reading NFT Data

- Get user holdings: WorldCupNFT.getUserTeamHoldings(user, teamId) → (bronze, silver, gold, diamond) - Calculate weight: WorldCupNFT.getUserWeight(user, teamId) → weighted score (Bronze*1 + Silver*10 + Gold*100 + Diamond*1000) - Check ambassador: WorldCupNFT.isAmbassador(teamId, user) → bool

Calculating Rewards

- Pending airdrop: AirdropManager.getClaimableAirdrop(user) → (weight, claimableAmount) - Prize share: PrizePoolManager.getClaimableAmount(userShares, teamId) → USDC amount - Total shares: PrizePoolManager.getTotalTeamShares(teamId) → total weighted supply

Important Notes for AI Interpretation

Token IDs are not sequential per team; they follow (teamId * 10) + tier formula
Ambassador NFTs (tier 5) do not count toward prize pool weights but boost airdrop emissions
Prize pool is denominated in USDC, not team tokens
"The Big Game" refers to the protocol, not a specific contract
World Cup 2026 dates are hardcoded; contract immutable post-deployment
Winner declaration is separate from prize claiming; 1-day delay between winner declaration and claim opening

Audit Status: Critical Issues: 0 (multiplier bug fixed, timestamps corrected) | High Issues: 1 (centralized oracle, mitigation in progress) | Status: Conditionally approved for deployment