Jackpot Lottery System

Date: 2025-01-12 Audience: Token holders & creators Reading Time: 10 minutes

---

What Is the Jackpot Lottery?

The Jackpot Lottery is an automated, provably fair system that randomly selects one token holder to win accumulated rewards. It's like a raffle where simply holding tokens automatically enters you—no tickets to buy, no extra steps.

How It Works

1. Transfer fees accumulate → 20% goes to Jackpot Treasury
2. Every 24 hours → Random holder selected
3. Winner receives → Entire jackpot balance
4. Process repeats → New jackpot starts accumulating

Key Features:

• ✅ Provably fair random selection
• ✅ No action needed to enter (just hold tokens)
• ✅ Fully automated (runs on-chain)
• ✅ Transparent and auditable
• ✅ Winner announced publicly

---

For Token Holders

Am I Eligible?

Requirements to Win:

1. Hold Minimum Value: $5 USD worth of tokens (default)

   • Dynamic based on real-time price
   • Example: If price = $0.0001, need 50,000 tokens

2. Below Whale Threshold: < 2% of total supply (default)

   • Prevents large holders from dominating
   • Example: 1M supply → must hold < 20,000 tokens

3. Not Excluded: Wallet not in exclusion list

   • Treasury wallets excluded automatically
   • Pool reserves excluded
   • Custom excluded wallets (if set by creator)

Check Your Eligibility:

Visit: app.mintcraft.co/jackpot/[TOKEN_MINT]
Connect wallet
See: "You are eligible" or reason why not

How to Enter

Good News: You're already entered!

Just by holding eligible tokens, you're automatically in the lottery. No registration, no tickets to buy, no claiming needed.

To Increase Chances:

• Hold more tokens (more holdings = more entries)
• Stay below whale threshold
• Keep holdings above minimum value

Your Odds:

Your chance = Your tokens / Total eligible tokens

Example:
You hold: 100,000 tokens
Total eligible: 10,000,000 tokens
Your odds: 1% (1 in 100)

When Are Drawings?

Default Schedule: Every 24 hours (86,400 seconds)

Drawing Time:

• Based on time since last drawing
• Could be any time of day
• Check dashboard for next drawing countdown

Frequency Options (set by creator):

• Daily (86,400 sec): Most common, smaller prizes
• Weekly (604,800 sec): Larger accumulated prizes
• Custom: Creator can set any interval

How Winners Are Selected

Provably Fair Randomness:

1. On-Chain Random Number: Uses Solana's on-chain randomness
2. Weighted Selection: More tokens = more chances
3. Transparent Process: All transactions public
4. Verifiable: Anyone can verify fairness

NOT Used:

• ❌ Creator can't pick winners
• ❌ No off-chain manipulation possible
• ❌ No insider advantage

If You Win

Automatic Payout:

1. Winner selected on-chain
2. Jackpot balance transferred automatically
3. Transaction visible on Explorer
4. Wallet balance updates immediately

Winner Announced:

• Transaction hash published
• Creator may announce in community channels
• Check token's Twitter/Discord
• View on Explorer: Jackpot Treasury → Winner wallet

What You Get:

Entire jackpot balance at time of drawing

Example:
Jackpot accumulated: 500,000 tokens
You win: All 500,000 tokens

Taxes:

• Winnings may be taxable income (consult advisor)
• Save transaction hash for records
• Report fair market value at time of win

Historical Winners

View Past Winners:

1. Go to token's dashboard
2. Click "Jackpot History"
3. See all past winners and amounts
4. Verify on Explorer

Example History:

Drawing #15 (Jan 12): Wallet 7xUW... won 450,000 tokens
Drawing #14 (Jan 11): Wallet 9HeG... won 380,000 tokens
Drawing #13 (Jan 10): Wallet ABqJ... won 520,000 tokens

---

For Token Creators

Configuring Jackpot

During Token Creation:

Enable Jackpot: Toggle ON

Drawing Frequency:

• Daily (recommended for engagement)
• Weekly (for larger prizes)
• Custom (advanced)

Min Holding Requirement:

• Default: $5 USD worth
• Range: $1 - $100
• Filters spam wallets

Anti-Whale Percent:

• Default: 2% of supply
• Range: 1% - 20%
• Prevents large holder dominance

Jackpot Economics

Fee Allocation:

Transfer fee: 2.5% (example)
To jackpot: 20% of fees = 0.5% of every transfer

Daily volume: 10M tokens
Daily jackpot accumulation: 50,000 tokens

Prize Sizing:

Daily drawing:
- Smaller individual prizes
- More frequent winners
- Higher engagement

Weekly drawing:
- 7× larger prizes
- Fewer winners
- Bigger community excitement

Example Accumulation:

Volume: 10M tokens/day
Jackpot share: 50,000 tokens/day

Daily: 50,000 token prizes
Weekly: 350,000 token prizes
Monthly: 1,500,000 token prizes

Managing Jackpot

Monitoring:

• Current jackpot balance
• Time until next drawing
• Number of eligible holders
• Last winner and amount

Manual Triggers (use sparingly):

• Force drawing early
• Emergency pause (critical bugs only)
• Resume after pause

Best Practices:

• Let it run automatically
• Announce winners in community
• Share transaction hashes
• Celebrate winners publicly
• Build excitement for next drawing

Excluded Wallets

Automatically Excluded:

• Jackpot Treasury PDA (can't win itself)
• Reflection Treasury PDA
• Auto-LP Treasury PDA
• Burn Treasury PDA
• Pool reserve accounts
• Platform wallet

Custom Exclusions:

• Team wallets (optional)
• Treasury/reserve wallets
• Any address you specify

Why Exclude?:

• Fairness (prevent self-wins)
• Professional appearance
• Community trust

---

Jackpot Strategies

For Holders: Maximizing Chances

Hold More (Within Limits):

Holder A: 50,000 tokens (0.5%) → Eligible ✅
Holder B: 100,000 tokens (1%) → Eligible ✅, 2× odds
Holder C: 150,000 tokens (1.5%) → Eligible ✅, 3× odds
Holder D: 250,000 tokens (2.5%) → Excluded ❌ (whale)

Sweet Spot:

• Just below whale threshold
• Example: If whale = 2%, hold 1.9%
• Maximum eligible holdings = maximum odds

Long-Term Holding:

• More drawings = more chances
• Compounding reflections increase holdings
• Increased holdings = better odds

Community Participation:

• Active communities often have bonus drawings
• Special events may have extra prizes
• Engagement can lead to airdrops

For Creators: Engagement Tactics

Weekly Hype Building:

Monday: Announce jackpot size
Wednesday: Reminder (24h left)
Friday: Live drawing announcement
Saturday: Winner celebration

Social Media:

• Tweet jackpot milestones
• Share winner stories
• Create countdown graphics
• Build FOMO for next drawing

Special Events:

• Holiday mega-jackpots (pause to accumulate)
• Community milestone bonuses
• Partnership prize additions

Transparency:

• Always share transaction hashes
• Verify on-chain
• Show accumulation charts
• Prove fairness

---

Advanced Features

Multi-Period Accumulation

Concept: Skip drawings to build larger prize

Example:

Normal: 50k tokens/day = 50k prize daily
Accumulated 7 days: 50k × 7 = 350k mega-prize

How To (creator):

1. Pause drawings temporarily
2. Let jackpot accumulate
3. Announce mega-drawing
4. Resume and execute

Use Cases:

• Special milestones (1M holders, 1 year anniversary)
• Marketing pushes
• Community events

Prize Boosts

Add Extra Tokens:

• Creator can send tokens to Jackpot Treasury
• Immediate prize boost
• Great for marketing

Example:

Current jackpot: 100,000 tokens
Creator adds: 500,000 tokens
New prize: 600,000 tokens (6× boost!)

Announce:

• "This week's jackpot boosted to 600k!"
• Creates excitement
• Drives trading volume
• Attracts new holders

Jackpot Notifications

For Holders:

• Set up wallet notifications
• Track jackpot balance
• Get alerts for drawings
• Celebrate winners

For Creators:

• Discord/Telegram bots
• Twitter auto-announcements
• Email notifications (coming soon)

---

Verifying Fairness

On-Chain Verification

Check Random Selection:

1. Find jackpot drawing transaction
2. View instruction logs
3. See random number generation
4. Verify winner selection logic

Example Explorer View:

Program: Hbcw8A9k... (MintCraft)
Instruction: execute_jackpot_drawing
Random Seed: [on-chain randomness]
Selected Index: 427
Winner: 7xUWueakxvL2... (index 427 in eligible list)
Amount: 450,000 tokens

What To Check:

• ✅ Uses Solana on-chain randomness
• ✅ Winner was actually eligible
• ✅ Correct token amount transferred
• ✅ Time lock respected (24h passed)

Trust But Verify

Questions to Ask:

1. Is random selection truly on-chain?
2. Can creator manipulate outcome?
3. Are exclusions reasonable?
4. Has jackpot treasury been drained improperly?

MintCraft Guarantees:

• ✅ 100% on-chain randomness
• ✅ Creator cannot pick winners
• ✅ Treasury is program-controlled (not creator wallet)
• ✅ All transactions public and auditable

---

Troubleshooting

I'm Not Eligible - Why?

Check:

1. Balance too low:

   • Need $5 USD worth (default)
   • Check current price × your balance
   • Buy more tokens if below threshold

2. Whale (too many tokens):

   • Holding > 2% of supply (default)
   • Split across wallets (not recommended for reflections)
   • Sell some to get below threshold

3. Wallet excluded:

   • Check if you're on exclusion list
   • Team wallets often excluded
   • Contact creator if believe it's an error

4. Token account issue:

   • Make sure you have an ATA
   • Tokens must be in your wallet (not staked elsewhere)

Drawing Hasn't Happened

Check:

1. Time lock not passed:

   • 24 hours must pass since last drawing
   • Check dashboard for countdown
   • Be patient!

2. No eligible holders:

   • All holders may be whales
   • All may be below minimum
   • Need at least 1 eligible holder

3. Jackpot treasury empty:

   • No fees accumulated yet
   • Need trading volume to accumulate
   • Creator may need to boost

4. Keeper bot issue:

   • Automated system may have hiccup
   • Creator can trigger manually
   • Check status page

Won But Didn't Receive

This is very rare - jackpot payout is automatic and atomic.

If it happens:

1. Check transaction succeeded (not failed)
2. Verify you're the actual winner
3. Check your token account balance
4. Contact creator with transaction hash
5. Provide wallet address for verification

---

Economics & ROI

Expected Value

Formula:

EV = (Your Holdings / Total Eligible) × Average Prize

Example:
Your holdings: 100,000 tokens (1% of eligible)
Average prize: 50,000 tokens
Your EV per drawing: 500 tokens
Annual EV: 500 × 365 = 182,500 tokens

Compared to Reflections:

• Reflections: Guaranteed small amounts
• Jackpot: Lottery (most get 0, one gets all)
• Combined: Best of both worlds

Break-Even Analysis

Question: How long until I "should" win?

Answer:

Expected drawings until win = 1 / (Your % of eligible supply)

Example:
You hold 1% of eligible supply
Expected win: Every 100 drawings (100 days if daily)

Reality:

• Randomness means high variance
• Could win on first drawing
• Could take 200+ drawings
• It's gambling (fun, not guaranteed income)

---

Best Practices

For Holders

Do:

• ✅ Hold within eligible range
• ✅ Be patient (randomness takes time)
• ✅ Celebrate winners publicly
• ✅ Verify fairness on-chain

Don't:

• ❌ Expect to win quickly
• ❌ Buy more than you can afford for lottery
• ❌ Complain about randomness
• ❌ Accuse creators without evidence

For Creators

Do:

• ✅ Announce winners publicly
• ✅ Share transaction hashes
• ✅ Build hype for drawings
• ✅ Keep jackpot funded (trading volume helps)
• ✅ Consider periodic boosts

Don't:

• ❌ Manually trigger too often (kills trust)
• ❌ Add yourself to excluded list then complain
• ❌ Drain jackpot treasury (ruins trust)
• ❌ Make promises about winning

---

Next Steps

For Holders:

• Check your eligibility
• Monitor jackpot balance
• Join community for announcements
• Good luck! 🍀

For Creators:

• Configure during token creation
• Plan announcement strategy
• Monitor and celebrate winners
• Consider boosts for special events

Learn More:

• Reflections (04) → Another way to earn
• Token Creation (02) → Configure jackpot
• Managing Tokens (03) → Monitor jackpot
• Security (07) → Verify fairness

---

Last Updated: 2025-01-12 Previous: Reflections Explained (04) Next: Liquidity Management (06)