> 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/getting-started.md). # Getting started **Everything you need to start playing, investing, or staking on B-Lucky.** *** ## What You'll Need Before you can participate in B-Lucky, make sure you have: {% stepper %} {% step %} ### A Web3 Wallet You'll need a wallet that supports Binance Smart Chain (BSC). Popular options include: * **MetaMask** or Rabby (Recommended) - download [MetaMask](https://metamask.io/) or [Rabby](https://rabby.io/) * **Trust Wallet** - Mobile-friendly option * **Binance Chain Wallet** - Native BSC support * **WalletConnect** - Connect various mobile wallets {% endstep %} {% step %} ### BNB in Your Wallet B-Lucky operates with **BNB** (Binance Coin), the native currency of Binance Smart Chain. How to get BNB: * Purchase on centralized exchanges (Binance, Coinbase, etc.) * Use on-ramps (MoonPay, Transak, etc.) * Bridge from other chains * Receive from another wallet How much BNB do you need? * **For playing:** Ticket prices vary based on game settings (typically starting from a few cents worth of BNB) * **For gas fees:** Keep \~$1-2 worth of BNB for transaction fees * **For House Funding:** Any amount (but remember it's permanent) * **For staking:** You'll need $LUCKY tokens (acquired separately) {% endstep %} {% step %} ### Binance Smart Chain Network Make sure your wallet is connected to the **Binance Smart Chain (BSC)** network. Network Details: * **Network Name:** Binance Smart Chain * **RPC URL:** `https://bsc-dataseed.binance.org/` * **Chain ID:** 56 * **Currency Symbol:** BNB * **Block Explorer:** Most wallets have BSC pre-configured, but you may need to switch to it manually. {% endstep %} {% endstepper %} *** ## Understanding Rounds B-Lucky operates in sequential **rounds**. Each round is identified by a unique **Draw ID** behind the scenes. ### What is a Round? A round is a complete lottery cycle: ``` Round Start → Ticket Sales → Draw Request → Numbers Drawn → Winners Submit & Claim → Round End ``` ### What is a Draw ID? The **Draw ID** is simply a number that identifies each round: * Draw ID 0 = First round * Draw ID 1 = Second round * Draw ID 2 = Third round * And so on... **Why does this matter?** * When you buy a ticket or a bundle of tickets, it's valid for a **specific Round thus Draw ID** ### Current Round Information The dApp always displays: * **Prize Pool** - Total amount to be won this round * **Time Until Draw** - When tickets sales close and the draw happens * **Ticket Price** - Cost per ticket for the current round *** ## Entry Prices & Fees ### How Pricing Works When you buy a ticket or a bundle of tickets, you pay: 1. **Ticket Price** - The base cost that funds the prize pool 2. **Small Fee** - A percentage that goes to protocol revenue Example: * Ticket Price: 0.01 BNB * Fee: 10% (0.001 BNB) * Total Cost: 0.011 BNB per ticket The ticket price funds the **next round's prize pool**, while fees are distributed to: * House Funding depositors * $LUCKY token stakers * Protocol development ### Multiple Tickets = a Bundle = Automatic Calculation If you select extra numbers (creating multiple tickets in one grid), the cost is automatically calculated: * 1 ticket = 1x price * 3 tickets = 3x price * 10 tickets = 10x price The dApp shows you the exact total of your entire bundle before you confirm. ### Gas Fees In addition to the ticket price, you'll pay **gas fees** to the BSC network (not to B-Lucky): * Typical gas fee: \~$0.10 - $0.50 USD equivalent * Gas fees fluctuate based on network congestion * Gas fees are higher when bundles with multiple tickets are bought * Your wallet shows gas fees before confirming transactions *** ## Your First Lottery Entry {% stepper %} {% step %} ### Connect Your Wallet * Visit the B-Lucky dApp * Click "Connect Wallet" * Select your wallet type * Approve the connection {% endstep %} {% step %} ### Review Current Round Info Check the dashboard for: * Prize pool size * Ticket price * Time remaining {% endstep %} {% step %} ### Fill Your Grid * Choose your **main numbers** (e.g., pick 5 numbers from 1-50) * Choose your **bonus numbers** (e.g., pick 2 numbers from 1-12) * The exact requirements depend on current game settings Pro Tip: You can select more main numbers than required to create multiple tickets automatically (Power Play feature) {% endstep %} {% step %} ### Review Your Purchase The dApp shows: * Your selected numbers * Number of tickets and bundle created * Total cost (tickets + fees) * Estimated gas fee {% endstep %} {% step %} ### Confirm Transaction * Click "Buy" * Your wallet opens for confirmation * Review the transaction details * Confirm in your wallet {% endstep %} {% step %} ### Wait for Confirmation * Transaction is submitted to BSC * Wait for blockchain confirmation (usually 3-5 seconds) * Success! Your ticket is recorded on-chain {% endstep %} {% step %} ### View your Tickets and Bundles All purchased tickets and bundles can be found in the ticket section of the dApp {% endstep %} {% endstepper %} *** ## Tracking Your Ticket and Bundles ### In the dApp The B-Lucky dApp provides a **"Tickets"** section where you can: * See all your active (bundle of) tickets * View past round tickets * Track winning numbers *** ## Understanding Game Settings Each round operates with specific **game settings** that determine: ### Number Selection Requirements * **Main numbers:** How many to pick and from what range (e.g., pick 5 from 1-50) * **Bonus numbers:** How many to pick and from what range (e.g., pick 2 from 1-12) ### Pricing * **Ticket price:** Cost per single ticket * **Fee percentage:** Protocol fee on each ticket ### Timing * **Round duration:** How long before the draw can be requested * **Submission windows:** Time limits for submitting winning tickets * **Claim windows:** Time limits for claiming prizes ### Prize Distribution * **Prize tiers:** Different winning combinations and their payouts * **Jackpot allocation:** Percentage of pool for jackpot vs partial wins *** ## Important: Settings Can't Change Mid-Round 🔒 Fairness Guarantee When you buy a ticket for a specific Round / Draw ID: * The game settings are **locked for that entire round** * Number ranges cannot change * Ticket prices cannot change * Prize tiers cannot change Why this matters: You can play with complete confidence knowing the rules won't change after you've bought your ticket. What you see is what you get. When can settings change? * Settings may change for **future rounds** (new Draw IDs) * The dApp always shows you the settings for the current round * If settings will change next round, you'll see a notification *** ## What Happens Next? {% stepper %} {% step %} ### Wait for the Draw * The round continues until the minimum duration has passed * Anyone can request the draw (they get a small reward for doing so) * Chainlink VRF generates the winning numbers * Results are posted on-chain immediately {% endstep %} {% step %} ### Check Results * Winning numbers are displayed in the dApp * Check if any of your numbers match * The dApp may automatically notify you if you win {% endstep %} {% step %} ### Submit Your Winning Ticket (If You Win) * Winners must **submit** their winning ticket first * This locks in your position for prize claiming * There are specific time windows for submission {% endstep %} {% step %} ### Claim Your Prize * After the submission period ends, the claim period begins * Navigate to the claim section * Submit your claim transaction * Prize is sent directly to your wallet instantly {% endstep %} {% endstepper %} *** ## Quick Reference Checklist Before buying your first ticket: * [ ] Wallet connected to BNB Chain * [ ] Sufficient BNB balance (tickets + gas) * [ ] Game settings reviewed * [ ] Numbers selected * [ ] Total cost understood * [ ] Ready to save ticket details after purchase *** You're ready to play! Good luck! 🍀 --- # 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/getting-started.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.