> For the complete documentation index, see [llms.txt](https://docs.lottoballs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lottoballs.io/readme.md).

# Introduction

Welcome to **Lotto Balls**, an on-chain lottery game where players pick four numbers and win prizes based on how many they match.

## What is Lotto Balls?

Lotto Balls is a decentralized lottery game built on blockchain technology. Players select four numbers between 0 and 9, place a bet using either USDC or LTB tokens, and the smart contract generates four random numbers using Chainlink VRF (Verifiable Random Function). Prizes are awarded based on how many numbers match in the correct positions.

## Key Features

### Dual Payment Options

* **USDC**: Pay with stablecoins and earn both USDC prizes and LTB token rewards
* **LTB**: Pay with LTB tokens at a dynamic cost based on the contract's token balance

### Provably Fair

All random numbers are generated using Chainlink VRF, ensuring that results are verifiably random and cannot be manipulated by anyone—including the game operators.

### Dynamic Tokenomics

The LTB token operates on a unique "seesaw" model where costs and rewards scale dynamically based on the contract's token balance, creating sustainable game economics.

### Instant Payouts

Winners receive their prizes automatically through the smart contract—no manual claims required.

## How It Works

1. **Connect** your wallet to the Lotto Balls app
2. **Choose** four numbers from 0 to 9
3. **Select** your payment method (USDC or LTB)
4. **Place** your bet
5. **Wait** for the random numbers to be drawn
6. **Collect** your winnings automatically

## Prize Structure

| Matches | USDC Prize | LTB Reward (USDC plays only) |
| ------- | ---------- | ---------------------------- |
| 0       | -          | Yes                          |
| 1       | Small      | Yes                          |
| 2       | Medium     | Yes                          |
| 3       | Large      | Yes                          |
| 4       | Jackpot    | -                            |

## Getting Started

Ready to play? Head to the [How to Play](/getting-started/how-to-play.md) guide to learn everything you need to start playing Lotto Balls.