# 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](https://docs.lottoballs.io/getting-started/how-to-play) guide to learn everything you need to start playing Lotto Balls.


---

# Agent Instructions: 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.lottoballs.io/readme.md?ask=<question>
```

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.