TrustRoll Documentation

TrustRoll is a decentralized gaming platform built on the Binance Smart Chain (BSC) that offers provably fair chance-based games. Unlike traditional online casinos, TrustRoll operates entirely on a public smart contract, ensuring complete transparency and trustless gameplay.

Key Platform Features

Available Games

TrustRoll offers multiple games of chance:

All games operate on the same core smart contract with identical fairness guarantees and a progressive jackpot system that gives every qualifying bet a chance to win big.

Getting Started

Prerequisites

• BSC-Compatible Wallet: Install MetaMask, Trust Wallet, or use the platform's social login option.
• BNB Tokens: You need BNB (Binance Coin) to place bets and pay network transaction fees.

Connecting to TrustRoll

1. Click the "Go to App" button in the top-right corner or visit trustroll.win directly
2. Click "Connect Wallet" and approve the connection request in your wallet
3. Ensure you have sufficient BNB in your wallet

Placing Your First Bet

1. Select a Game: Choose from the various games offered on the platform
2. Set Your Bet Amount: Enter how much BNB you wish to wager (minimum 0.01 BNB)
3. Choose Your Prediction: Select the outcome(s) you want to bet on
4. Confirm the Transaction: Click "Play Now" and approve the transaction in your wallet
5. Wait for Results: The outcome will be determined by the smart contract and displayed within seconds
6. Receive Winnings: If you win, payouts are sent automatically to your wallet

Game Mechanics

Coin Flip

• How to Play: Bet on either Heads or Tails
• Odds: 50% chance of winning
• Payout: 1.98× your bet (after 1% house edge)
• Example: Bet 1 BNB on Heads → Win = 1.98 BNB (including your bet)

Dice (Single Die)

• How to Play: Bet on one or more numbers on a six-sided die
• Odds: Depends on how many sides you bet on (1/6 to 5/6)
• Payout: Varies based on number of sides covered
  • One number (16.7% chance): ~5.94× bet
  • Two numbers (33.3% chance): ~2.97× bet
  • Three numbers (50% chance): ~1.98× bet
• Example: Bet 0.5 BNB on number 5 → Win = 2.97 BNB if die shows 5

Two Dice

• How to Play: Bet on specific combinations of two dice (36 possible outcomes)
• Odds: 1/36 (2.78%) for a specific pair to 50% for broader bets
• Payout: Up to 35.64× for a specific pair (e.g., double sixes)
• Example: Bet 0.1 BNB on double sixes → Win = 3.52 BNB if both dice show 6

TrustRoll Game (0-97)

• How to Play: Choose your own win probability by setting a "roll under" threshold (0-97)
• Odds: Fully customizable (1% to 97% chance of winning)
• Payout: Inverse to your win probability (lower chance = higher payout)
  • 50% chance: ~1.98× bet
  • 10% chance: ~9.9× bet
  • 1% chance: ~99× bet
• Example: Bet 1 BNB with a 25% win chance → Win = 3.96 BNB if the number is 0-24

Roulette

• How to Play: Bet on one or more numbers from 0 to 36
• Odds: 1/37 (2.7%) for a single number to 48.6% for half the wheel
• Payout: Up to 36.59× for a single number bet
• Example: Bet 0.1 BNB on number 7 → Win = 3.63 BNB if the wheel lands on 7

Provable Fairness Explained

TrustRoll ensures fairness using a secure and transparent commit-reveal system integrated directly into the blockchain. This mechanism prevents manipulation by players, the platform, or miners.

How the Commit-Reveal Mechanism Works

1. Commit Phase:
   • When you place a bet, the platform generates a secret random number (the "reveal").
   • Instead of revealing this number immediately, the platform sends only a cryptographic hash of the number (the "commit") to the blockchain.
   • Your bet, along with this commit, is permanently recorded.
2. Block Hash Randomness:
   • Your bet is included in a blockchain block, generating a unique and unpredictable block hash.
   • This block hash provides an additional layer of randomness that nobody can predict or manipulate.
3. Reveal Phase:
   • After your bet is recorded on-chain, the platform publicly reveals the original secret random number.
   • The smart contract automatically:
     • Checks that this revealed number matches the original "commit."
     • Combines the reveal number with the block hash to produce the final, unbiased random outcome.
     • Determines the bet outcome based on your selected game conditions.
     • Sends winnings directly and immediately to your wallet.

Why This Is Secure and Fair

• Players: Cannot predict or influence the outcome.
• Platform: Cannot alter the secret number after the bet has been recorded, preventing any manipulation.
• Miners: Cannot control the block hash randomness to affect results.

Verification – Real-World Example

Jackpot System & House Edge

House Edge

• Rate: 1% on all bets
• Minimum Fee: 0.0003 BNB (for very small bets)
• How It Works: For every bet, 1% of the wager goes to the platform as revenue
• Effect on Payouts: True odds are reduced by 1% (e.g., a fair 2× payout becomes 1.98×)

Jackpot System

• Eligibility: Any bet of 0.1 BNB or more
• Fee: 0.001 BNB per eligible bet goes to the jackpot pool
• Winning Chance: 0.1% (1 in 1000) per eligible bet
• Prize: The entire accumulated jackpot pool
• Mechanism: The smart contract performs a second random draw after determining the main game outcome

The jackpot adds an exciting bonus opportunity to standard gameplay. Every qualifying bet has a small chance to win big, regardless of whether you win or lose the main game.

Technical Details

Smart Contract Architecture

TrustRoll's core functionality is implemented in a single Solidity smart contract deployed on the Binance Smart Chain. Key components include:

// Validate input data ranges
         uint amount = msg.value;
         require(modulo > 1 && modulo <= MAX_MODULO, "Modulo should be within range.");
         require(amount >= MIN_BET && amount <= MAX_AMOUNT, "Amount should be within range.");
         require(betMask > 0 && betMask < MAX_BET_MASK, "Mask should be within range.");

// The RNG - combine "reveal" and blockhash
         bytes32 entropy = keccak256(abi.encodePacked(reveal, entropyBlockHash));
         uint dice = uint(entropy) % modulo;
         if (modulo <= MAX_MASK_MODULO) {
             if ((2 ** dice) & bet.mask != 0) {
                 diceWin = diceWinAmount;
             }
         }

// Funds tracking
         uint128 public jackpotSize;
         uint128 public lockedInBets;
         lockedInBets += uint128(possibleWinAmount);
         jackpotSize += uint128(jackpotFee);
         require(jackpotSize + lockedInBets <= address(this).balance, "Cannot afford to lose this bet.");

// Roll for a jackpot (if eligible)
         if (amount >= MIN_JACKPOT_BET) {
             uint jackpotRng = (uint(entropy) / modulo) % JACKPOT_MODULO;
             if (jackpotRng == 0) {
                 jackpotWin = jackpotSize;
                 jackpotSize = 0;
             }
         }
         if (jackpotWin > 0) {
             emit JackpotPayment(gambler, jackpotWin);
         }

// Only the croupier can settle bets
function settleBet(uint reveal, bytes32 blockHash) external onlyCroupier {
    uint commit = uint(keccak256(abi.encodePacked(reveal)));
    
    // Verify the bet exists and hasn't expired
    Bet storage bet = bets[commit];
    uint placeBlockNumber = bet.placeBlockNumber;
    require(block.number > placeBlockNumber, "settleBet in the same block as placeBet, or before.");
    require(block.number <= placeBlockNumber + BET_EXPIRATION_BLOCKS, "Blockhash can't be queried by EVM.");
    
    // Verify the block hash matches
    require(blockhash(placeBlockNumber) == blockHash);
    
    // Process the bet outcome and payment
    settleBetCommon(bet, reveal, blockHash);
}

Key Technical Constants

The contract defines these key constants that determine game mechanics, house edge, and limits:

uint constant HOUSE_EDGE_PERCENT = 1;
            uint constant HOUSE_EDGE_MINIMUM_AMOUNT = 0.0003 ether;
            uint constant MIN_JACKPOT_BET = 0.1 ether;
            uint constant JACKPOT_MODULO = 1000;
            uint constant JACKPOT_FEE = 0.001 ether;
            uint constant MIN_BET = 0.01 ether;
            uint constant MAX_AMOUNT = 300000 ether;
            uint constant MAX_MODULO = 100;
            uint constant MAX_MASK_MODULO = 40;
            uint constant BET_EXPIRATION_BLOCKS = 250;

Bet Structure

Each bet is stored on-chain with the following data structure:

struct Bet {
                uint amount;
                uint8 modulo;
                uint8 rollUnder;
                uint40 placeBlockNumber;
                uint40 mask;
                address gambler;
            }

Bet Settlement Process

Safety Mechanisms

// Check that bet has already expired
            require(block.number > bet.placeBlockNumber + BET_EXPIRATION_BLOCKS, "Blockhash can't be queried by EVM.");
            // Process refund
            bet.amount = 0;
            sendFunds(bet.gambler, amount, amount);

// Change max bet reward
            function setMaxProfit(uint _maxProfit) public onlyOwner {
                require(_maxProfit < MAX_AMOUNT, "maxProfit should be a sane number.");
                maxProfit = _maxProfit;
            }
            // During bet placement
            require(possibleWinAmount <= amount + maxProfit, "maxProfit limit violation.");

// Lock funds for potential payout
            lockedInBets += uint128(possibleWinAmount);
            jackpotSize += uint128(jackpotFee);
            // Check contract has enough funds
            require(jackpotSize + lockedInBets <= address(this).balance, "Cannot afford to lose this bet.");

// Check that commit signature is valid
            bytes32 signatureHash = keccak256(abi.encodePacked(uint40(commitLastBlock), commit));
            require(secretSigner == ecrecover(signatureHash, 27, r, s), "ECDSA signature is not valid.");

Security & Transparency

Platform Security

• Open Source Contract: The smart contract is verified and publicly viewable on BscScan
• Automatic Payouts: All winnings are paid directly by the smart contract without human intervention
• Transparent Bankroll: The contract's BNB balance is public information
• Provable Fairness: All random outcomes can be independently verified
• No Custodial Risk: Your funds always remain fully under your control in your own wallet

User Security Best Practices

• Wallet Safety: Never share your private keys or seed phrase
• Official Links: Always access TrustRoll through the official website
• Transaction Verification: Check bet amounts and contract addresses before confirming
• Responsible Gaming: Set personal limits and don't chase losses
• Scam Awareness: The platform will never ask for funds outside of normal betting

Troubleshooting & FAQs

Find answers to the most commonly asked questions about TrustRoll below.

Glossary