> 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! 🍀