> 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! 💰🎉 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.b-lucky.gg/claiming-prizes.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.