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

  • 🎲 Provably Fair: Using Telegram's native dice API
  • ⚡ Instant Settlements: Sub-second Solana transactions
  • 🔒 Secure Escrow: Smart contract-based fund management
  • 💰 Low Fees: Minimal platform fee on winnings
  • 🌍 Global Access: Available worldwide via Telegram
  • 🏆 No House Edge: Pure PvP gambling

Getting Started

First Steps

  1. Access the Bot

    Open Telegram and search for @glicinedicegames_bot 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 @glicinegamedicelobbies
  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

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 @glicinedicegames channel 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

@glicinedicegames

🎮 Community

Chat with other players

@glicinegamedicelobbies

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 @glicinegamedicelobbies 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 @glicinedicegames 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)