# Fantasy Manager League (FML) 🏆


Welcome to Fantasy Manager League - the ultimate prediction platform where Fantasy Premier League meets blockchain technology! ⚽💰

## Table of Contents
1. [What is Fantasy Manager League?](#what-is-fantasy-manager-league)
2. [How FML Works](#how-fml-works)
3. [The Dual Reward System](#the-dual-reward-system)
4. [Social-Fi Features](#social-fi-features)
5. [Technical Foundation](#technical-foundation)
6. [Getting Started](#getting-started)
7. [Making Predictions](#making-predictions)
8. [Prize Claims & Rewards](#prize-claims--rewards)
9. [Community Features](#community-features)
10. [FAQ](#faq)

---

## What is Fantasy Manager League? 🎯

Fantasy Manager League (FML) is a prediction platform that combines **real Fantasy Premier League (FPL) data** with **blockchain-based prediction markets**.

### Core Concept
- **Predict** which FPL managers will perform best during specific gameweek ranges
- **Back your predictions** with real tokens (USDC/Falsenine/Scores) on Base network
- **Win prizes** based on accurate predictions and manager performance
- **Build community** through endorsements, sponsorships, and social features

### What Makes FML Special? ✨
- **Real FPL Data**: Based on official Farcaster Fantasy Premier League run by /football community.
- **Transparent Results**: All data stored immutably on IPFS and blockchain
- **Dual Rewards**: Both predictors AND managers being predicted on can earn
- **Community-Driven**: Endorsements, tips, and social engagement features
- **Legitimate Platform**: Verifiable on-chain results with Merkle proof distribution

---

## How FML Works 📊

### Season Structure
FML operates on **"seasons"** - specific gameweek ranges where managers compete:

**Season Examples:**
- Season 1: Gameweeks 1-5 (5 gameweeks)
- Season 2: Gameweeks 6-10 (5 gameweeks)
- Season 3: Gameweeks 11-15 (5 gameweeks)

### Key Mechanics
1. **Points Calculation**: Rankings based on **points gained during the season period** (not total points)
2. **Entry System**: Fixed entry fees in selected ERC20 token with 1% fee to the platform treasury.
3. **Snapshot System**:
- **Start Snapshot**: 30 minutes before season begins
- **End Snapshot**: 10 hours after season ends
4. **Prize Distribution**: Winners share the prize pool based on performance

### Timeline Example 📅

Season 1 (GW1-GW5):
├── Entry Opens: Before GW1 deadline
├── Start Snapshot: 30 min before GW1
├── Season Active: GW1 through GW5
├── End Snapshot: 10 hours after GW5 ends
└── Prize Claims: Available after final standings

---

## The Dual Reward System 💎

One of FML's unique features is that **BOTH** predictors and managers can earn rewards!

### For Predictors (Investors) 🎯
**How You Win:**
- Choose managers you think will perform well
- Enter predictions with USDC/WETH
- Share prize pool if your predicted manager finishes in top positions

**Reward Structure:**
- Top 3 predicted managers typically share the prize pool
- Higher placement = larger reward percentage
- Multiple predictors can back the same manager

### For Managers (FPL Players) 🏅
**How You Win:**
- Simply play FPL well during active seasons
- Get predicted on by other users
- Earn rewards when you finish in top positions

**Benefits:**
- **Performance Rewards**: Top finishers earn from the prize pool
- **Prediction Attraction**: Social features help attract more predictions
- **Community Recognition**: Build reputation through endorsements
- **Passive Income**: Earn without any additional investment

### Example Scenario 💰

Season Prize Pool: 1000 USDC
Manager Rankings (by points gained):
1st Place: Alice (+85 points) → 50% share (500 USDC)
2nd Place: Bob (+82 points) → 30% share (300 USDC)  
3rd Place: Charlie (+78 points) → 20% share (200 USDC)

Predictors who backed Alice, Bob, or Charlie share a precentage of their winnings!

---

## Social-Fi Features 🤝

FML isn't just about predictions - it's about building a thriving fantasy football community!

### Endorsement System 👍
**What it is:** Community validation of skilled managers
- Each user can give **3 endorsements maximum**
- Cannot endorse yourself
- Endorsements increase manager visibility and reputation
- Higher endorsed managers appear more prominently

### Sponsorship & Tipping 💸
**The "Bribing" Mechanism:**
- **Sponsor Seasons**: Add to prize pools to attract more participants
- **Strategic Tipping**: Managers can tip community users to encourage predictions.
- **Prize Pool Boosting**: Partners and community members increase rewards

### Partner System 🏢
**Official Partnerships:**
- Verified partners can sponsor seasons
- Partner badges increase credibility
- Special partner-sponsored tournaments
- Enhanced visibility for partner-backed managers

---

## Technical Foundation 🔧

### Blockchain Infrastructure
- **Network**: Base (mainnet)
- **Smart Contracts**: Factory pattern for season deployment
- **Tokens Supported**: USDC (6 decimals), Falsenine (18 decimals), Scores (18 decimals)
- **Fee Structure**: 1% platform fee on all predictions

### Data Integrity 📈
- **FPL API**: Real-time synchronization with official Fantasy Premier League
- **IPFS Storage**: Immutable snapshot storage
- **Merkle Proofs**: Cryptographically secure prize distribution
- **Automated Snapshots**: Precise timing prevents manipulation

---

## Getting Started 🚀

### Prerequisites
1. **Farcaster Account**: Required for platform access
2. **FPL Team**: Must be in the official Farcaster Fantasy Premier League League
4. **Tokens**: USDC or ERC20 tokens for predictions.

### Step 1: Account Setup
1. **Connect Wallet**: Use Farcaster Mini app integration
2. **Register Profile**: Enter your FPL team ID (validated against league 18526)
3. **Complete Profile**: Add display name and verify FPL data
4. **Network Setup**: Ensure wallet is connected to Base network

### Step 2: Get Tokens 💰
**For Base Mainnet:**
- USDC: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
- - Acquire through centralized exchanges or DEX swaps

- Falsenine: `0x1ae1695c977ee7d2991c5cb9c4d87eedb0e9f0b1`
- - Acquire through DEX swaps

### Step 3: Explore the Platform
- **Browse Active Seasons**: See current prediction opportunities
- **Scout Room**: Discover top managers and their stats
- **Profile Pages**: Check out other managers and give endorsements

---

## Making Predictions 🎯

### Finding Seasons
1. Navigate to **"Season Games"** section
2. View **"Active Seasons"**
3. Check gameweek ranges, entry fees, and deadlines
4. Review prize pool size and participant count

### Season Information 📋
Each season displays:
- **Gameweek Range**: e.g., "GW1-GW5"
- **Entry Fee**: Amount in USDC/WETH
- **Deadline**: Last time to enter predictions
- **Prize Pool**: Current total rewards available
- **Participants**: Number of predictions made
- **Token**: ERC20 token accepted.

### Making a Prediction
1. **Select Season**: Click on an active season
2. **Choose Manager**: Browse available FPL managers
3. **Review Details**: Check manager's stats, endorsements, and FPL rank
4. **Confirm Prediction**: Review entry fee + 1% platform fee
5. **Approve Tokens**: Authorize contract to spend your tokens
6. **Submit Transaction**: Confirm via wallet
7. **Track Status**: Monitor transaction confirmation

### Manager Selection Strategy 🧠
**Look for managers with:**
- High endorsement count (community trust)
- Good historical FPL performance
- Recent form improvements
- Strategic team compositions
- Partner backing (increased prize pools)

---

## Prize Claims & Rewards 🏆

### How Winners Are Determined
1. **Season Ends**: All gameweeks in the range complete
2. **Snapshots Taken**: Start and end performance captured
3. **Rankings Calculated**: Based on points gained during season
4. **Final Standings**: Generated and stored on IPFS
5. **Merkle Tree**: Created for efficient prize distribution

### Prize Distribution Structure 💰
**Typical Payout Structure:**
- **1st Place**: 40-50% of prize pool
- **2nd Place**: 25-30% of prize pool
- **3rd Place**: 15-20% of prize pool
- **4th-5th Place**: 5-10% of prize pool

*Exact percentages vary by season and participant count*

### Claiming Your Winnings
1. **Check Results**: View final standings after season completion
2. **Merkle Proof**: System generates proof for your rewards
3. **Claim Interface**: Use season details page to claim
4. **Transaction**: Submit claim transaction with Merkle proof
5. **Receive Tokens**: Winners receive tokens directly to their wallet

### Manager Rewards 🎖️
**If you're a manager who placed in top positions:**
1. You receive a portion of the prize pool automatically
2. No prediction required - just perform well in FPL
3. Rewards distributed same as predictor winnings
4. Build reputation for future season attractions

---

## Community Features 👥

### Profile System
**Your Profile Includes:**
- FPL team name and current rank
- Endorsements received and given
- Season wins and performance history
- Partner affiliation (if applicable)
- Wallet address and transaction history

### Endorsement Strategy 💝
**Best Practices:**
- Endorse managers you genuinely believe are skilled
- Consider recent performance trends
- Look for consistent performers over "one-hit wonders"
- Don't waste endorsements - you only get 3!

### Building Reputation
**For Managers:**
- Maintain consistent FPL performance
- Engage with community features
- Share insights and strategy tips
- Build relationships with potential predictors

**For Predictors:**
- Make thoughtful prediction choices
- Share analysis and reasoning
- Participate in community discussions
- Build track record of successful predictions

### Social Interactions
- **Manager Profiles**: Detailed stats and performance metrics
- **Prediction History**: Track record of past choices
- **Community Discussions**: Share strategies and insights
- **Partner Recognition**: Official verification badges

---

## FAQ ❓

### General Questions

**Q: Do I need to be good at FPL to participate?**
A: No! You can participate as either a predictor (choosing managers) or just play FPL normally and potentially earn rewards if others predict on you.

**Q: What's the minimum entry?**
A: Entry fees vary by season but typically range from $1-10 USDC equivalent. Check individual seasons for exact amounts.

### Technical Questions

**Q: How are rankings calculated?**
A: Rankings are based on **points gained during the specific season period**, not total FPL points. This ensures fair competition regardless of when someone joined FPL.

**Q: When can I claim prizes?**
A: Prize claims become available after season completion, final standings calculation, and Merkle tree generation (typically 24-48 hours after season end).

### Strategy & Tips

**Q: What makes a good prediction?**
A: Look for managers with: consistent FPL performance, recent form improvements, high community endorsements, and good team selection strategies.

**Q: Can multiple people predict the same manager?**
A: Yes! Multiple predictors can back the same manager. If that manager wins, all predictors share the rewards proportionally.

**Q: How do endorsements help?**
A: Endorsements increase manager visibility and indicate community trust. Highly endorsed managers often attract more predictions and larger prize pools.

**Q: What's the best strategy for beginners?**
A: Start with smaller amounts, study manager performance history, follow community discussions, and don't spend more than you can afford to lose.

---

## Support & Community 🤝

### Getting Help
- **FPL Data Questions**: Verify your FPL team is in league 18526
- **Wallet Problems**: Ensure Base network connection and sufficient gas fees
- **Prize Claims**: Allow 24-48 hours after season completion

### Community Resources
- **Farcaster**: Farcaster is the official channel to reach community and developer
- [Developer - Carl Gustaf](https://farcaster.xyz/0xbob)
- [Community on Farcaster](https://farcaster.xyz/~/channel/football)
- **GitHub**: Report bugs and feature requests
- [Smart Contract on Github](https://github.com/AlexanderCGKarlsson/fantasy-manager-league-sc)

### Best Practices 🎯
1. **Start Small**: Begin with modest predictions to learn the system
2. **Do Research**: Study manager performance and community sentiment
3. **Diversify**: Don't put all tokens on a single manager
4. **Stay Updated**: Follow FPL news and gameweek developments
5. **Engage Community**: Use endorsements thoughtfully and build relationships
6. **Verify Transactions**: Always confirm transaction success before leaving
7. **Secure Wallet**: Use strong security practices for your crypto wallet

---

**Welcome to Fantasy Manager League - where your football knowledge meets blockchain innovation! ⚽🚀**

*Ready to start? Connect your wallet, join the community, and may your predictions be ever in your favor!* 🏆💰

---

*This guide covers FML v1.0. Features and mechanics may evolve as the platform grows. Always verify current information on the platform before making predictions.*