> 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/introduction.md).

# Introduction

**The fairest lottery on BNB Chain. Play, invest, or stake - there's a way for you to win.**

***

## What is B-Lucky?

B-Lucky is a fully decentralized lottery protocol built on Binance Smart Chain (BSC). Unlike traditional lotteries, B-Lucky operates entirely on-chain with complete transparency, provably fair random number generation, and instant prize claims - no waiting, no middlemen, no excuses.

Every ticket purchased, every number drawn, and every prize claimed is recorded permanently on the blockchain for anyone to verify.

***

## How B-Lucky Works

### The Simple Version

{% stepper %}
{% step %}

### Buy Tickets Bundles

Choose your lucky numbers and purchase tickets with BNB or WBNB.
{% endstep %}

{% step %}

### Wait for the Draw

Winning numbers are drawn using Chainlink VRF (provably random).
{% endstep %}

{% step %}

### Check Results

See if you've won instantly on-chain.
{% endstep %}

{% step %}

### Validate your ticket

Lock your prize by validating your winning tickets 
{% endstep %}

{% step %}

### Claim Prizes

Withdraw your BNB prize to your wallet
{% endstep %}

{% step %}

### Profit!

:)
{% endstep %}
{% endstepper %}

### The Complete Picture

B-Lucky runs in **rounds**. Each round follows this lifecycle:

```
Ticket Sales → Draw Request → Winning Numbers Drawn → Winners Submit → Winners Claim → Next Round
```

* **Ticket buying is open** during the entire round until the draw is requested
* **Every ticket purchased** funds the next round's prize pool
* **Multiple prize tiers** mean more chances to win
* **Unclaimed prizes** roll over to future rounds
* **Complete transparency** - all transactions are on-chain

***

## Three Ways to Participate

### 🎫 Play the Lottery

The classic approach - buy tickets, pick your numbers, and win big prizes.

**Perfect for:** Anyone who wants a chance to win life-changing money

**Key benefits:**

* Massive jackpots that grow every round
* Instant on-chain claims
* Multiple prize tiers
* Every ticket helps grow the ecosystem

***

### 🏦 Invest in House Funding

Deposit BNB into the House Funding pool and earn passive yield from every game played.

**Perfect for:** Long-term believers who want steady, passive income

**Key benefits:**

* Earn revenue share from every ticket sold
* The more people play, the more you earn
* Permanent position = lifetime earnings
* Full transparency, no hidden fees

{% hint style="warning" %}
**Important:** House Funding is a **permanent investment**. Once deposited, your BNB cannot be withdrawn. However, you will earn a share of lottery revenues **forever**.
{% endhint %}

***

### 💎 Stake $LUCKY Tokens

Own and stake the $LUCKY token to earn direct revenue from the protocol.

**Perfect for:** Token holders who want to earn protocol revenue

**Key benefits:**

* Stake to earn BNB directly from lottery revenue
* Earn real yield from protocol revenue
* Flexible staking and unstaking
* Early holders get maximum long-term benefits

***

## Why B-Lucky is Different

### ✅ Provably Fair

Winning numbers are generated using **Chainlink VRF** - the industry standard for verifiable randomness. No one can manipulate the results. Not even us.

### ✅ Instant Claims

Winners claim prizes directly from the smart contract. No delays, no approvals, no excuses.

### ✅ Multiple Ways to Win

* 🎰 Play the lottery for big jackpots
* 💰 Invest in House Funding for passive income
* 🪙 Stake $LUCKY for protocol revenue
* 🎁 Earn airdrop points with every ticket bundle

### ✅ Complete Transparency

Every transaction is on-chain. View ticket bundle sales, prize pools, winners, and revenue in real-time.

### ✅ Growing Jackpots

When no one wins the jackpot, it rolls over to the next round - creating massive prize pools.

### ✅ Fair Game Settings

Game settings (number ranges, ticket prices, prize tiers) **cannot be changed during an active round**. What you see when you buy is what you get when you play.

***

## Quick Start Guide

### For Players

{% stepper %}
{% step %}

### Connect your wallet

{% endstep %}

{% step %}

### Buy a single ticket or a bundle

{% endstep %}

{% step %}

### Wait for the draw

{% endstep %}

{% step %}

### Claim prizes

{% endstep %}
{% endstepper %}

***

### For Investors (House Funding)

{% stepper %}
{% step %}

### Connect your wallet

{% endstep %}

{% step %}

### Deposit BNB into the House Funding

{% endstep %}

{% step %}

### Earn passive yield

{% endstep %}

{% step %}

### Track earnings

{% endstep %}
{% endstepper %}

***

### For Token Holders

{% stepper %}
{% step %}

### Acquire $LUCKY

{% endstep %}

{% step %}

### Stake tokens

{% endstep %}

{% step %}

### Earn revenue share

{% endstep %}

{% step %}

### Claim rewards

{% endstep %}
{% endstepper %}

***

## Exclusive Airdrop Program

Every ticket you purchase earns you **airdrop points**. The more you play, the more points you accumulate.

**Upcoming Airdrop:** Points will be converted to $LUCKY tokens based on your share of total points.

***

## Built on BNB Chain

B-Lucky operates on **Binance Smart Chain (BSC)**, offering:

* ⚡ Fast transactions
* 💰 Low gas fees
* 🌐 Wide accessibility
* 🔗 BNB native integration

All funds are held in **WBNB (Wrapped BNB)** for maximum security and efficiency.

***

**Welcome to B-Lucky - where transparency meets opportunity. Let's get lucky! 🍀**