Skip to content

Unified Wallet

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

FeatureDescription
Single BalanceOne deposit serves Blockpad + Lotto
Multi-Token SupportSOL, USDC, PACHI, and partner tokens
Instant TransfersNo delays between games
On-chain PDAsSecure Program Derived Addresses
No Lock-upsWithdraw anytime, no cooldowns
Automatic PayoutsWinnings credited instantly
Points TrackingActivity tracked for referral tiers
Referral IntegrationRewards accumulated automatically

Why Unified Wallet?

BenefitTraditionalUnified Wallet
DepositsPer-game depositsSingle deposit for all
Switching gamesTransfer requiredInstant access
WithdrawalsMultiple transactionsOne withdrawal
TrackingFragmented historyUnified dashboard
SecurityMultiple attack surfacesSingle PDA account

How It Works

Flow Diagram

YOUR SOLANA WALLET(Phantom, Solflare, etc.)DEPOSITUNIFIED WALLETSOL Balance(lamports)Token Balance(SPL tokens)BlockpadGamePachinkoLotteryReferralRewardsWITHDRAWYOUR SOLANA WALLET

Account Structure

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

rust
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

ParameterValue
Minimum0.001 SOL
MaximumNo limit
Speed~1-2 seconds
FeeStandard 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

ParameterValue
Minimum0.001 SOL
MaximumYour full balance
SpeedInstant
Platform Fee10% (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:

ActionHow It Works
Play BlockpadBet directly from unified balance
Switch gamesNo transfer needed
Receive winningsAuto-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 FeatureDescription
No private keysPDAs are derived mathematically
Program-controlledOnly smart contract can move funds
AuditableAll transactions on-chain
Non-custodialYou 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

ParameterValue
Program IDs (Devnet)See Smart Contracts
Account TypePDA (Program Derived Address)
Seed["player", owner_pubkey]
Token StandardNative SOL + SPL Tokens
BlockchainSolana

Built on Solana