How to Play

Game Flow

1. Challenge an Opponent

In a group chat with the bot, use the /roll command:

/roll @opponent

You can challenge any activated player in the group. You can also challenge yourself with /roll @your_own_username for testing.

2. Select a Wager

The bot sends you a DM with the available wager options for that group. Pick a token (SOL, USDC, etc.) and an amount.

Each group's owner configures which tokens and amounts are available. Use /info in the group to see current wager options.

3. Pay the Wager

After selecting a wager, you'll receive a Solana Pay link (and QR code on desktop). Open it in your wallet app to send the exact amount.

• Mobile: Tap the payment link to open your wallet directly
• Desktop: Scan the QR code with your wallet's mobile app

The bot monitors the blockchain and confirms your payment automatically.

4. Opponent Accepts

Your opponent receives a DM with the challenge details — your name, the wager amount, the token, and what they can win. They can:

• Accept — pay the same wager amount
• Decline — you get a full refund

If the opponent doesn't respond within the timeout (default 15 minutes), the challenge expires and you're refunded.

5. Dice Roll

Once both players have paid, the dice roll happens in the group chat:

🎲 alice vs bob

💰 1.0 SOL pot

Rolling...

Both players roll a Telegram dice. The higher roll wins.

6. Winner Receives Payout

The winner's payout is sent automatically to their wallet — no action needed. The transaction includes a Solscan proof link.

Both players earn XP from the game, with the winner earning bonus XP.

Ties

If both players roll the same number, it's an automatic reroll. Ties can happen multiple times — the game keeps rerolling until someone wins. Each tie round awards bonus XP (20 XP per tie).

Rematch

After a game ends, the loser can instantly request a rematch with the same opponent and wager. Both players earn bonus XP (20 XP) for playing a rematch.

Limits

• You can have up to 5 outgoing challenges at once
• Only 1 pending challenge between the same two players at a time
• Wager selection times out after 10 minutes
• Challenger payment times out after 10 minutes
• Opponent payment times out after 15 minutes

Reminders are sent before each timeout.