Lotto

Lotto is Pachinko's lottery game, a multi-token, multi-winner lottery system where players purchase balls for a chance to win from the prize pool. With 4-hour rounds, up to 5 winners per draw, and support for multiple tokens including partner collaborations, Lotto offers a different pace of gameplay compared to Blockpad's rapid-fire rounds.

Game Overview

Lotto operates as a ball-based lottery where players purchase balls (tickets) during each round. When the 4-hour round ends, ORAO VRF generates cryptographically secure randomness, and a Fisher-Yates shuffle algorithm selects up to 5 winning balls. Winners share the prize pool based on their placement (1st through 5th), with a unique carryover mechanism that grows prize pools over time.

Core Specifications

Specification	Value
Round Duration	4 hours (configurable)
Ball Price	0.01 SOL (default, varies by machine)
Maximum Balls	No limit (balance-constrained)
Winners Per Round	Up to 5 unique wallets
Prize Pool	90% of ball sales
Platform Fee	10% (structure varies by lottery type)
Carryover	5% of each prize → next round
One Prize Per Wallet	Maximum one win per address per round
Randomness	ORAO VRF + Fisher-Yates shuffle

Why Lotto?

Feature	Benefit
Multi-winner	Up to 5 prizes per round increases chances
Multi-token	Play with SOL, USDC, PACHI, or partner tokens
Longer rounds	4 hours to accumulate, strategic buying
Carryover	Prize pools grow over time
Partner lotteries	Community-driven token lotteries
Truly fair and verifiable	VRF + on-chain verification

How to Play

Step 1: Choose a Machine

Lotto supports multiple lottery machines, each accepting a different token. Choose the machine that matches your preferred cryptocurrency:

Home Lottery Machines (Hosted by Pachinko)

Machine	Token	Default Ball Price	Fee Structure
SOL Machine	Native SOL	0.01 SOL	10% to Treasury
USDC Machine	USD Coin	0.01 USDC	10% to Treasury
PACHI Machine	PACHI Token	Configurable	10% to Treasury

Partner Lottery Machines (Co-hosted)

Machine	Token	Ball Price	Fee Structure
Partner Machine	Partner Token	Configurable	5% Pachinko + 5% Partner

Step 2: Fund Your Wallet

Deposit the appropriate token into your Unified Wallet:

Step 3: Buy Lottery Balls

Purchase balls from your chosen machine:

Action	Description
Select machine	Choose token type
Enter quantity	Number of balls to buy
Review cost	Quantity × ball price
Confirm purchase	Balls added to round pool

Each ball you purchase:

• Receives a unique ball ID (sequential)
• Acts as a lottery ticket for the current round
• Contributes to the prize pool
• Earns you points toward referral tiers

Ball Purchase Example:
─────────────────────
Machine: SOL
Ball Price: 0.01 SOL
Quantity: 50 balls
Total Cost: 0.5 SOL
Your Ball IDs: #4201 - #4250

Step 4: Wait for Round End

The round runs for 4 hours (configurable). During this time:

• More players buy balls
• Prize pool grows
• Carryover from previous round is included

Step 5: Winner Selection

When the timer expires:

Step 6: Collect Winnings

Winnings are automatically credited to your Unified Wallet in the same token used for the lottery.

Prize Distribution

Pool Breakdown

Prize Tiers

Place	Share of Prize Pool	Example (10 SOL pool)
1st	50%	4.5 SOL
2nd	25%	2.25 SOL
3rd	15%	1.35 SOL
4th	7.5%	0.675 SOL
5th	2.5%	0.225 SOL

If fewer than 5 unique players participate, fewer prizes are awarded.

Platform Fee Structure

Lotto operates two lottery types with different fee structures, each taking 10% Platform Fee from ball sales.

Lottery Types

Type	Tokens	Hosted By
Home Lottery	SOL, USDC, PACHI	Pachinko
Partner Lottery	Partner Tokens	Pachinko + Partner

Home Lottery Fee Structure

Home Lotteries (SOL, USDC, PACHI) are hosted entirely by Pachinko.

Platform Fee (10% of pool)
└── 100% → Treasury
    ├── Referral Rewards: 0.1% - 1% (based on tier)
    └── Platform Revenue: ~9% minimum

Allocation	Percentage	Recipient
Treasury	10%	Pachinko

Referral Distribution (Home Lottery)

Referrer Tier	Commission	Treasury Remainder
No Referrer	0%	10% to Treasury
Tier 1	0.1%	9.9% to Treasury
Tier 2	0.25%	9.75% to Treasury
Tier 3	0.69%	9.31% to Treasury
Tier 4	1.0%	9.0% to Treasury

Partner Lottery Fee Structure

Partner Lotteries are hosted in collaboration with token projects. Fees are split between Pachinko and the partner.

Platform Fee (10% of pool)
├── 5% → Pachinko Treasury
│   ├── Referral Rewards: 0.1% - 1% (based on tier)
│   └── Platform Revenue: ~4% minimum
│
└── 5% → Partner Treasury

Allocation	Percentage	Recipient
Pachinko Treasury	5%	Pachinko
Partner Treasury	5%	Partner Project

Referral Distribution (Partner Lottery)

Referrer Tier	Commission	Treasury Remainder
No Referrer	0%	5% to Pachinko
Tier 1	0.1%	4.9% to Pachinko
Tier 2	0.25%	4.75% to Pachinko
Tier 3	0.69%	4.31% to Pachinko
Tier 4	1.0%	4.0% to Pachinko

Partner receives their 5% regardless of referral tier.

Token-Specific Rewards

Referral rewards are paid in the same token used for the lottery:

Lottery	Token	Referral Reward Token
SOL Lottery	SOL	SOL
USDC Lottery	USDC	USDC
PACHI Lottery	PACHI	PACHI
Partner Lottery	Partner Token	Partner Token

Carryover Mechanism

5% of each winner's gross prize is held back and added to the next round's prize pool.

How It Works

Round 1 Prize Pool: 10 SOL
1st Place Gross:    5 SOL
Carryover (5%):     0.25 SOL → Next Round
1st Place Net:      4.75 SOL

Round 2 Starts:     0.25 SOL carryover added
New Ball Sales:     8 SOL
Round 2 Pool:       8.25 SOL

Prize pools grow over time as carryover accumulates.

Multi-Machine Architecture

Lotto supports multiple machines running simultaneously with different tokens and fee structures.

Home Lottery Machines

Machine	Token	Ball Price	Fee Structure
SOL Machine	Native SOL	0.01 SOL	10% to Treasury
USDC Machine	Stablecoin	0.01 USDC	10% to Treasury
PACHI Machine	PACHI Token	Configurable	10% to Treasury

Partner Lottery Machines

Machine	Token	Ball Price	Fee Structure
Partner Machine	Partner Token	Configurable	5% Pachinko + 5% Partner

Machine Benefits

Feature	Benefit
Token variety	Play with your preferred crypto
Independent pools	Separate prize pools per machine
Simultaneous play	Enter multiple machines at once
Partner integrations	Community-driven lottery pools

Truly Fair and Verifiable

ORAO VRF + Fisher-Yates Shuffle

Step	What Happens
1	Round ends → Request VRF from ORAO
2	ORAO returns 32-byte random seed
3	Seed initializes random state
4	Fisher-Yates shuffle on ball pool
5	Select up to 5 winning balls
6	Ensure one prize per address
7	Calculate prizes using percentages

Winner Selection Algorithm

1. Get VRF seed from ORAO (32 bytes)
2. Initialize random state with seed
3. Fisher-Yates shuffle all balls
4. Select up to 5 winning balls
5. Deduplicate by wallet address
6. Distribute prizes by placement

Verification

Anyone can verify:

• VRF request transaction on Solana
• Random seed published on-chain
• Shuffle algorithm is deterministic
• Results match seed output

Dynamic Pricing

Ball prices increase over time using a bonding curve mechanism. Early buyers pay the base price, while late buyers pay a premium.

Price Schedule

Time Elapsed	Price Multiplier	Example (0.01 SOL base)
0 - 30 min	1.0x	0.01 SOL
30 min - 1h	1.5x	0.015 SOL
1h - 1.5h	2.0x	0.02 SOL
1.5h - 2h	2.5x	0.025 SOL
2h - 3h	3.0x	0.03 SOL
3h - 4h	4.0x	0.04 SOL
4h - 5h	5.0x	0.05 SOL
5h - 6h	6.0x	0.06 SOL
6h - 7h	7.0x	0.07 SOL
7h - 7.5h	8.0x	0.08 SOL
7.5h+	9.0x	0.09 SOL

Price schedule is configurable per machine.

Ball Marketplace

The Ball Marketplace allows players to trade lottery balls with each other. This creates an opportunity for early buyers to profit by selling to late joiners.

How It Works

Marketplace Actions

Action	Description	Fee
List Ball	Put your ball up for sale at your chosen price	Free
Delist Ball	Remove listing, keep your ball	Free
Buy from Market	Purchase listed ball from another player	10% treasury fee

Why Use the Marketplace?

For Sellers:

• Buy balls early at 1x price
• List them later when price has increased to 5x-9x
• Profit from the price difference (minus 10% fee)

For Buyers:

• Find balls at potentially better prices than current bonding curve
• More options closer to round end
• Same winning odds as any other ball

Marketplace Fee Structure

Component	Percentage	Recipient
Seller Receives	90%	Ball seller
Treasury Fee	10%	Pachinko Treasury

The 10% marketplace fee goes directly to the treasury, supporting platform operations and referral rewards.

Trading Example

SCENARIO: 4-hour round, ball price at 5x

Early Buyer (Hour 0):
├── Buys ball at 1x = 0.01 SOL
├── Lists for sale at 0.045 SOL
│
Marketplace Sale:
├── Buyer pays: 0.045 SOL
├── 10% fee: 0.0045 SOL → Treasury
├── Seller receives: 0.0405 SOL
│
Result:
├── Seller profit: 0.0405 - 0.01 = 0.0305 SOL (305% return)
└── Buyer saves: 0.05 - 0.045 = 0.005 SOL vs direct purchase

Important Notes

Rule	Detail
Same round only	Can only trade balls from the current active round
Listing cutoff	Cannot list balls in the last 10% of round time
Ownership transfer	Ball ownership updates on-chain immediately
Prize eligibility	Buyer is eligible for prizes if ball wins

Frequently Asked Questions

For common questions about Lotto, see the FAQ → Lotto section.

Technical Specifications

Parameter	Value
Blockchain	Solana
Program IDs (Devnet)	See Smart Contracts
Round Duration	4 hours (configurable)
Winners	Up to 5 per round
Prize Pool	90% of ball sales
Platform Fee	10% (Home: 100% Treasury, Partner: 50/50 split)
Carryover	5% of each prize
VRF Provider	ORAO Network
Selection Algorithm	Fisher-Yates shuffle

Pro Tips

Tip	Why It Works
Buy early	Get base price before multipliers
Diversify machines	Spread across token pools
More balls = better odds	Simple probability
Watch carryover	High carryover = bigger prizes
Check player count	Fewer players = better odds

Related Pages

• Getting Started - New player setup
• Unified Wallet - Balance management
• Blockpad - Tile betting game
• Truly Fair and Verifiable - VRF verification