Jackpot System

The jackpot is the ultimate prize in Lotto Balls, awarded when a player matches all four numbers in the correct positions.

Jackpot Probability

Matching all 4 numbers has a probability of:

(1/10)^4 = 1 in 10,000 = 0.01%

This makes the jackpot a rare but achievable goal.

Dynamic Calculation

The jackpot amount is dynamically calculated based on the contract's USDC balance. This ensures:

• Jackpot grows as more players participate

• Pool remains sustainable

• Winners receive meaningful prizes

Formula

Pool = Contract USDC Balance
Buffer = Pool × 30%
Available = Pool - Buffer
Jackpot = Available × 35%

If Jackpot > Cap:
    Jackpot = Cap

Breakdown

Component	Percentage	Purpose
Buffer	30%	Reserve for operations and sustainability
Jackpot	35% of remaining	Maximum single win amount
Reserve	35% of remaining	Funds for smaller prizes

Example Calculation

If the contract holds 10,000 USDC:

Pool     = 10,000 USDC
Buffer   = 10,000 × 0.30 = 3,000 USDC
Available = 10,000 - 3,000 = 7,000 USDC
Jackpot  = 7,000 × 0.35 = 2,450 USDC

Jackpot would be 2,450 USDC (assuming it's under the cap)

Jackpot Cap

A maximum jackpot cap is set to:

• Prevent complete pool drainage

• Maintain sustainable prize pool

• Ensure long-term game viability

If the calculated jackpot exceeds the cap, the capped amount is awarded instead.

Cap Behavior

Calculated: 5,000 USDC
Cap: 3,000 USDC
Actual Jackpot: 3,000 USDC

The cap is configurable by the game administrator and can be adjusted based on pool growth and game economics.

Jackpot Growth

The jackpot naturally grows when:

1. More bets are placed: 80% of each USDC bet enters the pool

2. Small payouts occur: Most wins are 0-2 matches, preserving the pool

3. No jackpots hit: Rare 4-match wins mean the pool accumulates

Checking Current Jackpot

You can view the current jackpot:

On the App

The current jackpot is displayed prominently on the game interface.

On-Chain

Call the jackpot() function on the contract:

function jackpot() public view returns (uint256)

This returns the current jackpot amount in USDC (6 decimals).

After a Jackpot Win

When someone hits the jackpot:

1. The jackpot amount is transferred to the winner

2. The pool decreases by that amount

3. A new, smaller jackpot is calculated from the remaining pool

4. The jackpot rebuilds as new bets come in

No LTB Reward for Jackpot

Players who hit the jackpot receive only USDC, not LTB tokens. This is because:

• The jackpot is already the maximum prize

• LTB rewards are designed as consolation/participation incentives

• It simplifies the reward structure at the top tier