DICE PVP Documentation

Last Updated: December 2024

Welcome to the comprehensive documentation for DICE PVP, a decentralized player-versus-player dice gambling game built on Solana blockchain and operated through Telegram.

Overview

DICE PVP revolutionizes online gambling by combining the convenience of Telegram bots with the transparency and speed of Solana blockchain. Our platform offers truly fair, peer-to-peer dice battles with instant payouts and minimal fees.

Key Features

  • 🎲 Telegram Server-Side RNG: Using Telegram's native dice API for provably fair rolls
  • 📊 Public Games Log: Full transparency with verifiable on-chain game history
  • ⚡ Fast TX, Low Fees: Sub-second Solana transactions with minimal costs
  • 🎁 5-Level Referral System: Earn passive income from your network
  • 🔒 Secure Escrow: Smart contract-based fund management
  • 🌍 Global Access: Available worldwide via Telegram
  • 🏆 No House Edge: Pure PvP gambling
  • 💰 Token Benefits: Fee reductions with $DICEPVP tokens (Coming Soon)
  • 🎯 Tournaments: Competitive events and prize pools (Coming Soon)

Getting Started

First Steps

  1. Access the Bot

    Open Telegram and search for @solana_glicinebot or click this direct link

  2. Start the Bot

    Send /start command to initialize your account

  3. Choose Language

    Select your preferred language from: English, Spanish, Russian, or Chinese

  4. Set Up Wallet

    Import existing Solana wallet or generate a new one

Wallet Setup

Import Existing Wallet

⚠️ Security Notice: Never share your private key with anyone. The bot encrypts and stores it securely.
  1. Click "💼 Manage Wallet" in the main menu
  2. Select "Import Wallet"
  3. Enter your Solana private key (base58 format)
  4. Confirm the import
Example private key format:
5JuGe7z3XrK4nR8g3sVkHBb4Dt6qPZcLm5hRYjH4Nz8x...

Generate New Wallet

✅ Recommended for new users without existing Solana wallets
  1. Click "💼 Manage Wallet" in the main menu
  2. Select "Generate New Wallet"
  3. IMPORTANT: Save the displayed private key immediately
  4. Confirm you've saved the key
  5. Fund your wallet with SOL to start playing

Funding Your Wallet

To start playing, you need SOL in your wallet:

Method Speed Min Amount Instructions
Direct Transfer Instant 0.01 SOL Send SOL to your wallet address from any Solana wallet
Exchange Withdrawal 5-30 min Varies Withdraw SOL from exchanges like Binance, Coinbase, FTX
Cross-chain Bridge 10-60 min Varies Bridge from other chains using Wormhole or AllBridge

Game Mechanics

Dice Rules

DICE PVP uses Telegram's native dice feature, ensuring complete fairness:

Dice Values

The dice shows values from 1 to 6:

  • Odd numbers: 1, 3, 5
  • Even numbers: 2, 4, 6

Win Conditions

Players choose Even or Odd before the game:

  • If dice shows your choice, you win
  • Winner receives nearly 2x their bet

Betting System

Bet Limits

  • Minimum bet: 0.01 SOL
  • Maximum bet: No limit (depends on opponents)
  • Increment: 0.01 SOL

Bet Matching

Both players must bet the exact same amount. The total pot equals 2x the bet amount.

Odds & Payouts

Probability Calculation

P(Even) = 3/6 = 50%
P(Odd) = 3/6 = 50%

Expected Value (before fees):
EV = 0.5 × 2 + 0.5 × 0 = 1.0 (break-even)

After platform fee:
Winner receives their bet back plus opponent's bet minus small platform fee

Escrow System

Our smart contract-based escrow ensures secure and fair gameplay:

1

Lobby Creation

Creator's bet is locked in escrow

→
2

Opponent Joins

Opponent's bet is added to escrow

→
3

Dice Roll

Telegram dice determines winner

→
4

Payout

Winner receives payout instantly

Gameplay Guide

Creating a Lobby

1. Access Lobby Creation

From main menu, click "🎲 Create Lobby"

Create Lobby Button

2. Set Your Bet

Choose bet amount (minimum 0.01 SOL)

Common bet amounts:
• 0.01 SOL (minimum)
• 0.05 SOL (casual)
• 0.1 SOL (standard)
• 0.5 SOL (high stakes)
• 1+ SOL (whale territory)

3. Choose Even or Odd

Select your prediction for the dice outcome

💡 Tip: Both choices have exactly 50% probability

4. Share or Wait

Share lobby code with friends or wait for random opponent

  • Lobby code: 6-character unique identifier
  • Can be cancelled anytime before opponent joins

Joining a Lobby

Browse Open Lobbies

  1. Click "🎮 Join Lobby"
  2. View list of available lobbies
  3. Check bet amounts and choices
  4. Click to join matching lobby

Use Lobby Code

  1. Get code from friend
  2. Click "Enter Code"
  3. Type 6-character code
  4. Confirm and join

Join from Channel

  1. Check Lobbies topic in @dicepvpsol
  2. Find posted lobbies
  3. Click inline button
  4. Redirected to bot to join

Game Flow

1

Lobby Full

Both players have joined and funds are in escrow

2

Countdown

3-second countdown begins

3

Dice Roll

Bot sends dice emoji, Telegram animates and shows result

4

Result

Winner announced, payout processed instantly

Cancellation & Refunds

When You Can Cancel

  • ✅ Before an opponent joins your lobby
  • ❌ After opponent joins
  • ❌ During the game

Refund Process

Refunds are automatic and instant:

  1. Click "Cancel Lobby" button
  2. Confirm cancellation
  3. Funds returned minus network fee (~0.00005 SOL)
  4. Transaction confirmed on blockchain

Strategy & Tips

Probability Analysis

Statistical Facts

50% Win Probability
~2x Payout Multiplier
Low House Edge (Fee)
0.98x Net Win Amount

Long-term Expectations

After 100 games with 0.1 SOL bets:
Expected wins: ~50 games
Expected losses: ~50 games

Total wagered: 10 SOL
Expected return: 9.9 SOL
Platform fees: Minimal
Network fees: ~0.005 SOL

Net expected: -0.105 SOL

Bankroll Management

Recommended Guidelines

  • Conservative (1-2% rule):

    Never bet more than 1-2% of total bankroll per game

    Example: With 1 SOL bankroll, max bet 0.01-0.02 SOL

  • Standard (5% rule):

    Maximum 5% of bankroll per game

    Example: With 1 SOL bankroll, max bet 0.05 SOL

  • Aggressive (10% rule):

    Up to 10% for experienced players

    Example: With 1 SOL bankroll, max bet 0.1 SOL

Loss Limits

Set daily/weekly loss limits:

  • Daily: Maximum 10-20% of bankroll
  • Weekly: Maximum 30-40% of bankroll
  • Use bot's auto-limit features (coming soon)

Advanced Strategies

1. Session Management

The 3-Win Rule

After 3 consecutive wins, take a break or reduce bet size by 50%

Rationale: Prevents overconfidence and preserves profits

Stop-Loss Strategy

Set a maximum loss for each session (e.g., 3 losses or 0.3 SOL)

Rationale: Prevents tilt and emotional betting

2. Betting Patterns

⚠️ Avoid These Systems

These strategies are mathematically proven to fail long-term:

  • Martingale: Doubling bet after loss - leads to catastrophic losses
  • D'Alembert: Progressive betting - doesn't change odds
  • Fibonacci: Sequence betting - same issues as Martingale

3. Psychological Tips

  • Never chase losses
  • Don't bet when emotional
  • Take regular breaks
  • Celebrate small wins
  • View it as entertainment, not income
  • Set time limits for sessions

Blockchain Integration

Solana Network

Why Solana?

Speed

400ms block times

65,000 TPS capacity

Cost

~$0.00025 per transaction

Predictable fees

Finality

Instant finality

No waiting for confirmations

Transactions

Transaction Types

Type Description Gas Fee Processing Time
Create Lobby Lock funds in escrow ~0.00005 SOL < 1 second
Join Lobby Add funds to escrow ~0.00005 SOL < 1 second
Payout Distribute winnings ~0.00005 SOL < 1 second
Refund Cancel and return funds ~0.00005 SOL < 1 second
Withdrawal Send to external wallet ~0.00005 SOL < 1 second

Transaction Monitoring

All transactions can be verified on Solana blockchain:

  1. Copy transaction hash from bot message
  2. Visit Solscan.io or Solana Explorer
  3. Paste hash in search box
  4. View complete transaction details

How It Works

Our smart contracts automatically handle all game operations securely and transparently. When you create or join a game, your funds are safely held until the game completes, then instantly distributed to the winner.

Security

Your Security

  • You control your wallet:

    Only you have access to your private keys

  • Encrypted storage:

    Your wallet information is securely encrypted

  • Transparent transactions:

    All transactions are verifiable on the blockchain

  • Automatic refunds:

    If a game doesn't complete, funds are automatically returned

Security Best Practices

  • Never share your private key
  • Keep backup of your wallet seed
  • Use unique wallet for gambling
  • Regularly withdraw winnings
  • Verify transaction hashes

Referral System

Earn Passive Income: DICE PVP features a powerful 5-level referral system that rewards you for building a network of players.

How Referrals Work

1. Get Your Referral Code

Every player automatically receives a unique referral code and link when they start using the bot.

  • Access via Settings → Referrals & Earnings
  • Your personal referral link: t.me/BOT_USERNAME?start=ref_YOURCODE
  • Share on social media, forums, or directly with friends

2. Players Join Using Your Link

When someone clicks your referral link and starts playing:

  • They become your Level 1 referral
  • You earn commissions from their game activity
  • Their referrals become your Level 2, and so on

3. Earn Commissions Automatically

Every time your referrals play games, you earn a percentage of the platform fees:

  • Commissions credited in real-time
  • No manual claiming required
  • Earnings from up to 5 generations

Commission Structure

5-Level Commission Breakdown

Earn from every game your referrals play based on the total pot value:

Level Relationship Commission Rate Example (0.1 SOL game)
Level 1 Direct referrals 0.2% of pot 0.0004 SOL
Level 2 Referrals of your referrals 0.1% of pot 0.0002 SOL
Level 3 3rd generation 0.05% of pot 0.0001 SOL
Level 4 4th generation 0.025% of pot 0.00005 SOL
Level 5 5th generation 0.01% of pot 0.00002 SOL

Earning Potential Example

Network Size: 10 direct referrals (Level 1)
Each refers 5 players (50 Level 2)
Each refers 3 players (150 Level 3)
Each refers 2 players (300 Level 4)
Each refers 1 player (300 Level 5)

If each player plays 10 games/day @ 0.1 SOL:
Level 1: 10 × 10 × 0.0004 = 0.04 SOL/day
Level 2: 50 × 10 × 0.0002 = 0.1 SOL/day
Level 3: 150 × 10 × 0.0001 = 0.15 SOL/day
Level 4: 300 × 10 × 0.00005 = 0.15 SOL/day
Level 5: 300 × 10 × 0.00002 = 0.06 SOL/day

Total: ~0.5 SOL/day (~15 SOL/month)

Earning & Tracking

View Your Statistics

Access detailed referral analytics in Settings → Referrals & Earnings:

Overall Stats

  • Total referrals across all levels
  • Active players count
  • Lifetime earnings
  • Available to redeem
  • Total redeemed

Per-Level Breakdown

  • Users at each level
  • Games played per level
  • Earnings from each level
  • Commission percentage

Commission Distribution

Commissions are distributed automatically when games complete:

  1. Game finishes and winner is determined
  2. Platform fee is collected from the pot
  3. Referral commissions calculated for all 5 levels
  4. Earnings credited to each referrer's balance
  5. Updated stats visible immediately

Redeeming Earnings

Minimum Redemption

0.1 SOL - minimum balance required to redeem commissions to your game wallet

How to Redeem

  1. Check Balance

    Go to Settings → Referrals & Earnings to view available balance

  2. Click Redeem

    Press the Redeem button if you have ≥ 0.1 SOL available

  3. Confirm

    Review the amount and confirm the redemption

  4. Receive Funds

    Commissions are instantly added to your game balance

After Redemption

  • Funds available immediately for gameplay
  • Can be withdrawn to external wallet anytime
  • New commissions continue accumulating
  • Track history in referral stats

Best Practices

  • Share Consistently:

    Post your referral link regularly on social media and gaming communities

  • Explain Benefits:

    Help new players understand the game to keep them active

  • Build Community:

    Create groups or channels for your referrals to encourage retention

  • Track Performance:

    Monitor which referral sources bring the most active players

  • Redeem Strategically:

    Let commissions accumulate or redeem regularly for gameplay

Bot Commands Reference

Available Commands

/start

Start the bot and show main menu

/play

Challenge other players - create or join games

/stats

View your personal gaming statistics

/leaderboard

See the top players rankings

/help

Get help and information about the bot

/language

Change your interface language

Most features are accessible through the interactive menu buttons rather than commands. After using /start, you can:

  • 🎲 Play: Create or join dice games
  • 📊 Stats: View your statistics
  • 🏆 Leaderboard: See top players
  • 💼 Wallet: Manage your wallet and funds
  • 🌍 Language: Change language settings
  • ❓ Help: Get assistance

Wallet Management

Wallet functions are accessed through the menu system after pressing the Wallet button:

  • View Balance: Check your current SOL balance
  • Deposit: Get your wallet address for deposits
  • Withdraw: Send SOL to external wallets
  • Import/Export: Manage wallet keys

⚠️ Always use the menu buttons for wallet operations to ensure security and proper transaction handling.

Troubleshooting

Common Issues

🔴 Transaction Failed

Symptoms: Error message when creating/joining lobby

Common Causes:

  • Insufficient balance (including gas fees)
  • Network congestion
  • Wallet not properly imported

Solutions:

  1. Check balance with /balance
  2. Ensure you have extra 0.001 SOL for fees
  3. Re-import wallet if necessary
  4. Try again in a few seconds

🔴 Cannot Join Lobby

Symptoms: Error when trying to join a lobby

Common Causes:

  • Lobby already full
  • Trying to join own lobby
  • Selected same choice as creator
  • Insufficient balance

Solutions:

  1. Refresh lobby list
  2. Choose opposite choice (Even/Odd)
  3. Check your balance matches bet amount + fees
  4. Try a different lobby

🔴 Withdrawal Issues

Symptoms: Cannot withdraw funds

Common Causes:

  • Below minimum withdrawal (0.01 SOL)
  • Invalid recipient address
  • Insufficient balance for fees

Solutions:

  1. Ensure withdrawal amount ≥ 0.01 SOL
  2. Verify recipient address format
  3. Keep 0.001 SOL for network fees
  4. Use /withdraw command correctly

🔴 Bot Not Responding

Symptoms: Bot doesn't reply to commands

Common Causes:

  • Bot maintenance
  • Telegram server issues
  • Rate limiting

Solutions:

  1. Wait a few minutes and try again
  2. Check @dicepvpsol group for announcements
  3. Restart chat with /start
  4. Clear Telegram cache

Error Codes

Code Message Description Solution
E001 Insufficient Balance Not enough SOL for bet + fees Deposit more SOL
E002 Lobby Not Found Invalid lobby code or lobby not found Check code or browse open lobbies
E003 Lobby Full Someone else joined first Find another lobby
E004 Invalid Choice Same choice as creator Choose opposite (Even/Odd)
E005 Transaction Failed Blockchain transaction error Retry or contact support
E006 Wallet Error Wallet not configured Import or generate wallet
E007 Rate Limited Too many requests Wait 60 seconds
E008 Maintenance Mode Bot temporarily offline Check announcements channel

Getting Support

Support Channels

📢 Announcements

Updates and news

@dicepvpsol

🎮 Community

Chat with other players

Community (dicepvpsol)

Before Contacting Support

  1. Check this documentation
  2. Review error message carefully
  3. Try basic troubleshooting steps
  4. Check announcements for known issues
  5. Prepare transaction hash if applicable

Frequently Asked Questions

Is DICE PVP legal in my country?

DICE PVP operates as a skill-based game platform. However, online gambling laws vary by jurisdiction. Users are responsible for ensuring compliance with their local laws. We recommend checking your local regulations before playing.

How do I know the dice rolls are fair?

We use Telegram's native dice feature, which is cryptographically random and cannot be manipulated by the bot, players, or even Telegram staff. Each roll is independently verified and transparent to all players.

What happens if I disconnect during a game?

The game continues automatically. Once both players have joined and the dice is rolled, the outcome is determined by the blockchain smart contract. You'll receive your winnings (if you won) even if offline.

Can I play with friends?

Yes! Create a lobby and share the 6-character code with your friend. They can join using the code to play directly against you.

What's the minimum/maximum bet?

Minimum bet is 0.01 SOL. There's no maximum limit - you can bet as much as you want, as long as you find an opponent willing to match your bet.

How fast are payouts?

Instant! Solana blockchain processes transactions in under 1 second. As soon as the dice result is determined, the winner receives their payout automatically.

What are the fees?

Platform fee: Small percentage from winnings. Network fee: ~0.00005 SOL per transaction (negligible).

Can I cancel a game after my opponent joins?

No, once an opponent joins your lobby, the game must proceed to completion. You can only cancel while waiting for an opponent.

Is there a house edge?

No! DICE PVP is pure player vs player. We only charge a small platform fee from the winner's payout. The odds are exactly 50/50 for both players.

Can I use multiple accounts?

While not prohibited, we don't recommend it. Each Telegram account can have one bot account. Using multiple accounts to play against yourself is discouraged.

How do I report bugs or issues?

Contact our community in @dicepvpsol with details about the issue, including any error messages and transaction hashes if applicable.

Are there any bonuses or promotions?

We occasionally run promotions and tournaments. Follow @dicepvpsol for announcements about special events, bonuses, and competitions.

Glossary

Bankroll
Total amount of SOL available for gambling
Base58
Encoding format used for Solana private keys and addresses
Escrow
Smart contract that holds both players' bets until game completion
Even
Dice outcomes of 2, 4, or 6
Gas Fee
Small amount of SOL paid for blockchain transactions (~0.00005 SOL)
Lobby
Game room where players meet to compete
Lobby Code
6-character unique identifier for joining specific games
Odd
Dice outcomes of 1, 3, or 5
Platform Fee
Small commission taken from winner's payout
Private Key
Secret key that controls your Solana wallet (never share!)
Public Key
Your Solana wallet address for receiving funds
PvP
Player versus Player - no house involvement
Refund
Return of bet when game is cancelled
SOL
Native cryptocurrency of Solana blockchain
Smart Contract
Automated blockchain program that manages game logic
TPS
Transactions Per Second - Solana can handle 65,000
Wallet
Digital storage for your SOL and other tokens
Whale
Player who makes large bets (typically 1+ SOL)