Unified Wallet

The Unified Wallet is the central balance system that powers all of Pachinko. Deposit once, play any game, receive winnings instantly, and withdraw anytime, all from a single on-chain account secured by Solana's Program Derived Addresses.

Overview

The Unified Wallet is a shared balance system that connects all games, referral rewards, and points tracking on the Pachinko platform. Instead of managing separate balances for each game or token, you deposit once and your funds are available everywhere instantly.

Core Features

Feature	Description
Single Balance	One deposit serves Blockpad + Lotto
Multi-Token Support	SOL, USDC, PACHI, and partner tokens
Instant Transfers	No delays between games
On-chain PDAs	Secure Program Derived Addresses
No Lock-ups	Withdraw anytime, no cooldowns
Automatic Payouts	Winnings credited instantly
Points Tracking	Activity tracked for referral tiers
Referral Integration	Rewards accumulated automatically

Why Unified Wallet?

Benefit	Traditional	Unified Wallet
Deposits	Per-game deposits	Single deposit for all
Switching games	Transfer required	Instant access
Withdrawals	Multiple transactions	One withdrawal
Tracking	Fragmented history	Unified dashboard
Security	Multiple attack surfaces	Single PDA account

How It Works

Flow Diagram

Account Structure

Your Unified Player Account stores all your data on-chain:

UnifiedPlayerAccount {
    owner: Pubkey,              // Your wallet address
    balance: u64,               // SOL balance (in lamports)
    token_balance: u64,         // SPL token balance
    total_deposited: u64,       // Lifetime deposits
    total_withdrawn: u64,       // Lifetime withdrawals
    blockpad_stats: BlockpadStats,
    lottery_stats: LotteryStats,
    referral_stats: ReferralStats,
    referrer: Option<Pubkey>,   // Who referred you
    bump: u8,                   // PDA bump seed
}

Deposit

How to Deposit

1. Connect wallet to Pachinko
2. Click "Deposit" button
3. Enter SOL amount
4. Approve transaction in wallet
5. Balance updates instantly

Deposit Details

Parameter	Value
Minimum	0.001 SOL
Maximum	No limit
Speed	~1-2 seconds
Fee	Standard Solana tx fee (~0.000005 SOL)

Withdraw

How to Withdraw

1. Navigate to Wallet section
2. Click "Withdraw"
3. Enter amount
4. Approve transaction
5. Funds sent to your wallet

Withdrawal Details

Parameter	Value
Minimum	0.001 SOL
Maximum	Your full balance
Speed	Instant
Platform Fee	10% (Blockpad, from pool)

The 10% platform fee is taken from each Blockpad round's pool, not from withdrawals.

Cross-Game Features

Seamless Switching

Your unified balance lets you:

Action	How It Works
Play Blockpad	Bet directly from unified balance
Switch games	No transfer needed
Receive winnings	Auto-credited to unified balance

Balance Updates

• Pachinko wins → Instant credit
• Games wins → Instant credit
• Referral rewards → Auto-accumulated
• Deposits → Instant availability

Statistics Tracking

Your account tracks comprehensive stats:

Blockpad Stats

- Total bets placed
- Total won
- Total lost
- Win rate
- Biggest win

Lotto Stats

- Balls purchased
- Rounds played
- Prizes won
- Total winnings

Referral Stats

- Referrals count
- Rewards earned
- Active referrals

Security

PDA-Based Security

Your funds are held in Program Derived Addresses (PDAs):

Security Feature	Description
No private keys	PDAs are derived mathematically
Program-controlled	Only smart contract can move funds
Auditable	All transactions on-chain
Non-custodial	You control your wallet

Access Control

• Only you can withdraw your balance
• Only authorized programs can credit winnings
• All transactions require your signature

FAQ

For common questions about the Unified Wallet, see the FAQ → Unified Wallet section.

Technical Details

Parameter	Value
Program IDs (Devnet)	See Smart Contracts
Account Type	PDA (Program Derived Address)
Seed	["player", owner_pubkey]
Token Standard	Native SOL + SPL Tokens
Blockchain	Solana

Related Pages

• Getting Started - Setup guide
• Blockpad - Tile betting game
• Lotto - Lottery game
• Referral Program - Earn rewards