Como o provably fair funciona no Mines

Veja como jogar Mines na Cloudbet, e como verificar se o posicionamento das minas em cada rodada é provably fair.

Como jogar Mines

Toda rodada de Mines na Cloudbet usa a mesma base provably fair — seed do servidor, seed do cliente, nonce e SHA3-256/SHAKE256 — detalhada na nossa página central sobre Como Funciona o Provably Fair. Esta página cobre o que é específico do Mines: como essa sequência de números aleatórios se transforma na grade de minas contra a qual você joga.

Transformando números aleatórios em uma grade de minas

Você escolhe o número de minas a serem posicionadas no início do jogo — chamamos esse número de N. A grade 5×5 do Mines pode ser "achatada" em uma única fileira de 25 posições, cada uma com seu próprio índice, começando em 1:

Diagrama mostrando como a grade de equidade comprovável do Mines da Cloudbet — 5×5 casas rotuladas de A a Y — é achatada em uma única linha de 25 posições numeradas para a geração justa de números.

Nós amostramos um número da sequência aleatória (gerada da mesma forma descrita na página do Provably Fair) para determinar a posição da primeira mina:

Exemplo prático do algoritmo de equidade comprovável do Mines da Cloudbet: um número aleatório seleciona a posição da primeira mina entre as 25 casas.

Se mais minas precisarem ser posicionadas, extraímos outro número aleatório e repetimos o processo — mas agora restam apenas 24 espaços disponíveis para escolher:

Exemplo prático mostrando como o algoritmo de equidade comprovável do Mines seleciona a próxima mina entre as 24 posições restantes após a primeira mina ser removida do conjunto.

Isso se repete até que todas as minas sejam posicionadas. A grade completa é então reconstruída e mantida em segredo até o fim da rodada:

A grade final de equidade comprovável do Mines, reconstruída a partir da linha achatada assim que todas as posições das minas são colocadas de forma aleatória e verificável.

Detalhes técnicos: selecionando cada posição de mina

Antes de cada escolha, sabemos P — o número de posições livres de minas que ainda restam para escolher. P começa em 25 e diminui em 1 a cada mina posicionada.

Um número aleatório de 4 bytes (32 bits) é extraído da saída do SHAKE256 para cada mina, variando de 0 a 4.294.967.295. Para escolher de forma justa entre as P posições, aplicamos a amostragem por rejeição (veja o conceito geral explicado em Como Funciona o Provably Fair), e então calculamos o resultado módulo P para obter um índice de posicionamento:

// Pseudo Code
const placementIndex = randomNumber % P;

Fluxograma do cálculo de equidade comprovável do Mines da Cloudbet: bytes aleatórios e rejection sampling determinam o índice da posição de cada mina.

Se ainda restarem minas para posicionar, a posição escolhida é removida da lista, P diminui em 1, e o processo se repete.

Jogabilidade

A grade final preenchida com minas é construída e ocultada no servidor antes que você faça qualquer jogada — ela não pode ser alterada ou adulterada sem detecção depois, graças ao Compromisso já compartilhado com você. Cada quadrado que você escolhe é simplesmente verificado contra essa grade oculta.

Código para verificação independente

Este programa é fiel à implementação do Mines na Cloudbet. Insira sua Seed do Servidor, Seed do Cliente, Nonce e número de minas, instale a única dependência e execute-o você mesmo para reconstruir o resultado do seu jogo.

Observação: para revelar a Seed do Servidor de um jogo concluído na Cloudbet, você precisa já ter iniciado uma nova rodada (o que rotaciona para um novo par de seeds).

Dependências:

npm install js-sha3

O código:

// If you are running this yourself, then you can input your own data here
// You can then compare:
// 1) Cloudbet's provided Commitment to the Commitment outputted here. This proves that the Server Seed was not altered during gameplay.
// 2) Cloudbet's provided game outcome to the game outcome outputted here. This proves that your game's outcome was determined solely by the pre-game seeds and was not altered afterwards.
let myServerSeed      = 'your_server_seed'; // ✍️YOUR_INPUT✍️: Enter your (unhashed) Server Seed here
let myClientSeed      = 'your_client_seed'; // ✍️YOUR_INPUT✍️: Enter your Client Seed here
let myNonce           = 1;                  // ✍️YOUR_INPUT✍️: Enter your Nonce here
let myNumberOfMines   = 3;                  // ✍️YOUR_INPUT✍️: Enter your number of mines here
const usingCustomData = false;              // Change this to true if you are using your own data

// Load libraries
const crypto = require('crypto');
const { sha3_256, shake256 } = require('js-sha3');

// Step 1: Generate a Server Seed and Commitment
// And generate a Client Seed - either by player input or by the player's browser
function generateServerSeed() {
  let seed = crypto.randomBytes(32).toString('hex');
  if (usingCustomData) { seed = myServerSeed; }
  const commitment = sha3_256(seed);
  return { 'serverSeed': seed, 'commitment': commitment };
}
function getClientSeed() {
  let seed = crypto.randomBytes(32).toString('hex');
  if (usingCustomData) { seed = myClientSeed; }
  return seed;
}

// Step 2: Create a Round Signature with SHA3 using a Server Seed, Client Seed, and Nonce
function createRoundSignature(serverSeed, clientSeed, nonce) {
  return sha3_256(`${serverSeed}:${clientSeed}:${nonce}`);
}

// Step 3: Create a SHAKE256 stream generator from a Round Signature.
// To simplify this example program, this function doesn't create a stream, but instead a sequence of custom length.
function* createRandomNumberSequence(numbersToGenerate, roundSignature) {
  const numOfBytes = 4 * numbersToGenerate;           // 4 bytes (32 bits) per random number we generate
  const byteStream = shake256.create(8 * numOfBytes); // shaker256 takes bits as input
  byteStream.update(roundSignature);                  // Use the Round Signature to seed the generator
  const buf = Buffer.from(byteStream.digest());       // The Buffer class lets us package every 4 bytes into one 32-bit integer
  for (let i = 0; i < numbersToGenerate; i++) {
    yield buf.readUInt32BE(i * 4);                    // Read buf in 4-byte steps
  }
  throw new Error("No more numbers in the random number sequence! Fix: make 'numbersToGenerate' larger.");
}

// Step 4: Generate the mine locations
function pickUniquePositions(mineCount, totalTiles, rng) {
  const available = Array.from({ length: totalTiles }, (_, i) => i);
  let result = [];

  for (let i = 0; i < mineCount; ++i) {
    const index = sample(available.length, rng);

    result.push(available[index]);
    available.splice(index, 1);         // Remove chosen position from list of available positions
  }
  result.sort((a, b) => a - b);         // Sort the mine positions from smallest to largest
  result = result.map(num => num + 1);  // Increment positions by one so that they start with 1, 2, 3, ...
  return result;
}
// Rejection sampling for fair results
function sample(P, rng) {
  const maxAcceptable = Math.floor(0x100000000 / P) * P;

  // Rejection sampling
  let rand;
  do {
    rand = rng.next().value;
  } while (rand >= maxAcceptable);
  // Modulo operation
  const sampled_number = rand % P;

  return sampled_number;
}

// Example usage
(function main() {
  const gridSize = 25;
  let mineCount = 3;
  let nonce = 1;
  if (usingCustomData) { mineCount = myNumberOfMines; nonce = myNonce; }

  const { serverSeed, commitment } = generateServerSeed();
  const clientSeed = getClientSeed();

  const roundSignature = createRoundSignature(serverSeed, clientSeed, nonce);
  const numbersToGenerate = 24 * 2; // There are max. 24 mines, however due to rejection sampling we may need more random numbers
  const rng = createRandomNumberSequence(numbersToGenerate, roundSignature);

  const minePositions = pickUniquePositions(mineCount, gridSize, rng);

  console.log('📝 Commitment (shown before the game):', commitment);
  console.log('🔒 Server Seed (revealed after the game):', serverSeed);
  console.log('🎲 Client Seed:', clientSeed);
  console.log('🔢 Nonce:', nonce);
  console.log('🔁 Round Signature (can be verified after the game):', roundSignature);
  console.log('💣 Mine Positions (1 = top-left square, 5 = top-right square, 25 = bottom-right square):', minePositions);
})();

Experimente agora: teste sua sorte no Mines

Quer ver ao vivo? Jogue uma rodada de Cloudbet Mines — depois verifique seus resultados com a calculadora provably fair. Leva apenas alguns segundos. Não é necessário nenhum conhecimento técnico.

Você vai poder ver o processo em ação, inspecionar suas seeds e observar como a ferramenta reconstrói seu resultado do zero.

Mais explicações dos jogos provably fair:

  1. Provably fair Pump
  2. Provably fair Plinko
  3. Provably fair Dice
  4. Provably fair Dice: Golden Ticket
  5. Provably fair Limbo
  6. Provably fair Roulette
  7. Provably fair Keno