> For the complete documentation index, see [llms.txt](https://docs.b-lucky.gg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.b-lucky.gg/claiming-prizes.md). # Claiming Prizes Your complete guide to submitting winning tickets and claiming prizes. *** ## The Two-Step Process B-Lucky uses a unique two-step process to ensure fair prize distribution and prevent gaming the system. ### Why Two Steps? Step 1: Submit Your Winning Ticket * Lock in your position in the prize tier Step 2: Claim Your Prize * Collect your calculated prize * Receive BNB directly to your wallet * Complete the winning process Why this design? * ✅ Fair prize calculation (all winners known before distribution) * ✅ Gives everyone equal opportunity * ✅ Transparent winner count *** ## Step 1: Submitting Your Winning Ticket After winning numbers are drawn, winners must submit their tickets within a specific time window. ### When to Submit Different deadlines for different prizes: Partial Win Tickets: * Submission window: Shorter (e.g., 6-12 hours after draw) * Must submit quickly * Timer starts when numbers are drawn Jackpot Tickets: * Submission window: Longer (e.g., 24-48 hours after draw) * Extended time for big prizes * More time to verify and submit Check the dApp for exact deadlines — they're clearly displayed! ### ### How to Submit your winning ticket(s) {% stepper %} {% step %} ### Find your ticket Open the "Winning Tickets" tab in the dApp to see all your winning tickets {% endstep %} {% step %} ### Start the claim On the ticket, press the claim prize button {% endstep %} {% step %} ### Confirm the transaction Approve and confirm the submission transaction in your wallet. {% endstep %} {% step %} ### Wait for blockchain confirmation Transaction confirmed on-chain — your ticket is now submitted. {% endstep %} {% endstepper %} Success! Your winning ticket is now submitted. ### What Happens When You Submit On-chain effects: * ✅ Your ticket is marked as submitted * Position locked for prize claiming * ✅ Eligible combinations count updates * Protocol tracks how many winners in each tier * Used to calculate prize splits *** ## Submission Windows Understanding timing is critical! ### The Timeline ``` Draw Completed ↓ [Partial Win Submission Window Opens] ← 6-12 hours ↓ [Partial Win Submission Window Closes] ↓ [Jackpot Submission Window Still Open] ← Additional time ↓ [Jackpot Submission Window Closes] ↓ [Claim Period Begins] ``` ### Why Different Windows? Partial wins first: * Smaller prizes, less verification needed * Faster processing * Tiers without winners get put back in the prize pot faster Jackpot later: * More time to verify big wins * Extra caution warranted for life changing prizes ### Missing the Submission Window ⚠️ Critical Warning: If you miss the submission deadline: * ❌ You cannot submit anymore * ❌ You cannot claim the prize * ❌ Your winning ticket is forfeited * 💔 Prize becomes unclaimed and gets reallocated **This is serious! Set reminders, enable notifications, check regularly.** *** ## Between Submission and Claiming After you submit, there's a waiting period before you can claim. ### What's Happening During This Time {% stepper %} {% step %} ### Collect submissions Protocol collects all submissions from winners. {% endstep %} {% step %} ### Count winners Protocol counts total winners per tier. {% endstep %} {% step %} ### Calculate prize splits Prize splits are calculated accurately using the counts. {% endstep %} {% step %} ### Prepare claim period Protocol prepares the state for the claim period. {% endstep %} {% endstepper %} Why wait? * Ensures all winners have submitted * Allows accurate prize calculation * Fair distribution among all winners * Prevents manipulation ### How Long is the Wait? Check the dApp for the exact claim period start time! *** ## Step 2: Claiming Your Prize Once the claim period opens, you can collect your prize! ### When to Claim Claim Window Opens: * After submission period fully ends * All winners counted * Prizes calculated * dApp shows "Claim Now" button Claim Window Closes: * Partial wins: Days to weeks later * Jackpot: Weeks to months later * Exact deadlines in dApp **⏰ Don't wait too long! Claim before the deadline.** ### How to Claim {% stepper %} {% step %} ### Press "Claim Prize" on the winning ticket Go to the "Winning tickets" section in the dApp. {% endstep %} {% step %} ### Review prize amount dApp shows the prize amount you'll receive. {% endstep %} {% step %} ### Confirm the transaction Approve and confirm the claim transaction in your wallet. {% endstep %} {% step %} ### Prize sent to your wallet Net prize is transferred to your wallet — success! {% endstep %} {% endstepper %} Prize arrives in your wallet within seconds once the transaction is confirmed. ### What Happens When You Claim On-chain effects: * ✅ Prize calculated: ``` Your Prize = (Tier Prize Pool) ÷ (Winners in Tier) × (Your Winning Tickets in Tier) ``` * ✅ Fee deducted: ``` Fee Amount = Prize × Fee Percentage Net Prize = Prize - Fee ``` * ✅ Prize sent: * Net prize transferred to your wallet * Fee sent to protocol revenue * All transparent on blockchain * ✅ Your submitted entry deleted: * Entry marked as claimed * Cannot claim again * Prevents double-claiming *** ## Claiming Multiple Prizes If you used Power Play and won in multiple tiers, it works the same. ### Multiple Tier Claims Example scenario: * You won in Tier 3 (5 tickets) * You won in Tier 5 (10 tickets) * You won in Tier 7 (3 tickets) Stay organized: * Claim systematically (highest to lowest) * Check off each claim as you complete it * Don't miss any tiers! *** ## What If You Miss the Claim Deadline? ⚠️ Missing the claim deadline means: * Your prize is forfeited: * ❌ You submitted but didn't claim * ❌ Prize becomes "unclaimed" * ❌ Funds are reallocated to future rounds * 💔 You receive nothing **This is final — no appeals, no exceptions.** How to avoid this: * ✅ Submit AND claim promptly * ✅ Set multiple reminders * ✅ Check dApp regularly * ✅ Enable notifications * ✅ Don't procrastinate! *** ## Prize Reallocation **Unclaimed prizes don't disappear** — they are added to the prize pool after expiry to benefit future players. *** ## Delegation: Claiming for Others You can claim prizes on behalf of other players (with permission). ### What is Delegation? Delegation allows: * Player A gives permission to Player B * Player B can submit/claim for Player A * Uses cryptographic signatures (EIP-712) * Secure and verifiable ### Use Cases When to use delegation: * Playing on behalf of family/friends * Managing multiple accounts * Services that buy tickets for users * Convenience and automation ### How Delegation Works {% stepper %} {% step %} ### Player A (ticket owner) signs Player A signs a delegation message and gives the signature to Player B, specifying which address receives prizes. {% endstep %} {% step %} ### Player B (delegated) submits or claims Player B calls submit/claim functions including Player A's signature. The transaction succeeds if the signature is valid. {% endstep %} {% step %} ### Security controls Signatures can be revoked; version numbers prevent replay attacks; only works for specified draws. {% endstep %} {% endstepper %} ### Revoking Delegation {% stepper %} {% step %} ### Increment delegation version Call `incrementDelegationVersion()` to invalidate all previous signatures. {% endstep %} {% step %} ### Require new signatures All previous signatures become invalid and new signatures are required. {% endstep %} {% step %} ### Maintain control Player A retains control by issuing new signatures as needed. {% endstep %} {% endstepper %} *** ## Troubleshooting Common Issues
"Transaction Failed" When Submitting Possible causes: * ❌ Wrong Draw ID * ❌ Wrong purchased index * ❌ Numbers don't match winning combination * ❌ Submission window closed * ❌ Already submitted this ticket Solutions: * Double-check all information * Verify Draw ID in dApp * Confirm winning numbers * Check deadline status
"Transaction Failed" When Claiming Possible causes: * ❌ Wrong submitted index (not purchased!) * ❌ Already claimed this prize * ❌ Claim window not open yet * ❌ Claim window closed * ❌ Wrong numbers entered Solutions: * Use submitted index, not purchased * Check claim window status * Verify you haven't claimed already * Confirm all details are correct
Lost Track of Tickets How to recover: 1. Check wallet history on BSCScan 2. Find `EntryPurchased` events 3. Note Draw IDs and indexes 4. Use dApp's recovery tools (if available) Prevention: * Screenshot ticket details immediately * Save confirmation emails/notifications * Keep organized records * Use the dApp's ticket tracker
*** ## Best Practices for Claiming ### Do's ✅ * ✅ Submit immediately after winning numbers drawn * Don't wait for deadline * Avoid last-minute rush * ✅ Claim promptly when window opens * Prize arrives instantly * ✅ Set multiple reminders * Phone alarms, calendar events, dApp notifications *** ## Claim Success Checklist After claiming, verify everything worked: Immediate Checks * [ ] Transaction confirmed on blockchain * [ ] BNB received in your wallet * [ ] Correct amount (after fees) * [ ] No error messages * [ ] dApp shows "Claimed" status Record Keeping * [ ] Screenshot of claim transaction * [ ] Note transaction hash * [ ] Record net prize amount * [ ] Save for tax purposes (if applicable) * [ ] Celebrate! 🎉 *** ## Tax Considerations Important: Lottery winnings may be taxable in your jurisdiction. What You Should Know * Winnings might be considered income * May need to report on tax returns * Varies by country/region * Consult a tax professional Keep records: * All winning tickets * Claim transaction hashes * Prize amounts received * Dates and timestamps B-Lucky doesn't: * Withhold taxes * File tax forms for you * Provide tax advice Your responsibility: * Understand local laws * Report winnings if required * Pay applicable taxes * Seek professional advice *** ## Example: Complete Claiming Journey ### The Setup A game with 5 main numbers and no bonus number You bought: * A ticket with 7 main numbers * 21 tickets combinations covered Winning draw: * Your numbers matched! * Won in Tier 3 * Won in Tier 6 ### Submission Phase Right after the numbers are drawn, you can 1. See winning numbers announced 2. Check your tickets — you won! 🎉 3. Go to "Submit Entry" Submit the winning ticket: * All winning tiers are submitted at once ### Claim Phase Right after the submission phase, the Claim period opens. Claim your ticket * Tier 3 winning numbers * Prize: 5 BNB * Fee (5%): 0.25 BNB * Receive: 4.75 BNB * Tier 6 winning numbers * Prize: 2 BNB * Fee (5%): 0.1 BNB * Receive: 1.9 BNB * Total winnings: 6.65 BNB! 🎊 *** ## Quick Reference: Submission vs Claim | Aspect | Submission | Claim | | ------------ | ---------------------- | ----------------------- | | When | Immediately after draw | After submission window | | Purpose | Declare your win | Collect your prize | | Window | Shorter (hours) | Longer (days/weeks) | | What Happens | Locked in tier | Prize sent to wallet | | Fee | - | Prize fee deducted | | Can Skip? | NO - forfeit prize | NO - forfeit prize | *** Remember: Submit quickly, claim promptly, and enjoy your winnings! 💰🎉