Documentação

Documentação do FAIRDRUM

Aqui está reunido tudo sobre como o site funciona: por onde começar, como a rodada é calculada, onde ficam seus SOL e o que foi feito para tudo isso funcionar. Cada seção é uma página separada com os detalhes.

Para o jogador: por onde começar

Como o jogo funciona

Seus SOL e a proteção

Do que o projeto é composto

  • Contrato inteligente na rede Solana. Aceita as apostas, guarda os saldos do jogo e os potes, calcula o resultado da rodada e os pagamentos. O site não calcula os pagamentos e não pode alterá-los.
  • O site: páginas estáticas, sem servidor com banco de dados de jogadores. Ele lê o contrato e prepara as transações que a sua carteira assina.
  • O vigilante da plataforma: um programa em um servidor separado. Revela o segredo da rodada para que o contrato a liquide, credita as transferências dos endereços pessoais de depósito e cuida para que no cofre não haja menos do que as obrigações com os jogadores.

O que foi feito para o site chegar a este estado

Os números abaixo foram contados a partir do código-fonte e dos registros de verificações em 13/11/2026.

Contrato

Cerca de 2100 linhas em Rust, 27 instruções. 37 testes automáticos dos cálculos e da contabilidade.

Site

16 jogos, 37 páginas em 14 idiomas: 519 páginas prontas no total. Cerca de 10000 linhas de código e cerca de 1600 frases em cada idioma.

Revisões do código

7 revisões internas do código, com correção do que foi encontrado, e 83 testes automáticos do site. Ainda não houve auditoria externa independente.

Ensaios em uma cópia da rede

Em uma cópia local da rede Solana: 117 verificações de rodadas (falsificação do segredo, devolução da aposta, troca da raiz dos segredos) e 28 verificações do vigilante (inatividade, duas cópias, arquivo de segredos alheio).

Cada jogo ao vivo

Todos os 16 jogos foram jogados no navegador, no contrato real: depois de cada rodada, o saldo no site foi comparado com o saldo no contrato. Foram testadas as duas formas de entrar, o depósito a partir de uma corretora e o saque.

Cada página

Todas as páginas em todos os idiomas foram abertas no celular e no computador, 1008 aberturas: sem erros, espaços vazios nem rolagem horizontal.

Decisões que mudaram o projeto

  • Um sorteio honesto próprio em vez de um oráculo externo. Uma medição mostrou que o oráculo devolvia o mesmo número na rede de testes e na rede principal, ou seja, o número da rodada podia ser conhecido de antemão. O oráculo foi removido; agora o número da rodada é formado pelo segredo registrado antes da aposta e pelo hash do bloco da aposta.
  • Devolução da aposta em vez de uma rodada travada. Se a plataforma não liquidar a rodada no prazo, o contrato devolve a aposta por inteiro, e a devolução entra em um contador público.
  • Endereço pessoal de depósito. Cada jogador tem seu próprio endereço no contrato: é possível enviar SOL de uma corretora sem assinar na carteira.
  • Entrada sem carteira própria. O site cria uma carteira no navegador do jogador; a chave não é transmitida nem ao site nem à plataforma.
  • No servidor do site não há chaves. As chaves da plataforma ficam somente no servidor separado do contrato.

O que ainda não foi feito

Não foi realizada auditoria externa independente do contrato. O direito de atualizar o programa está, por enquanto, com uma única chave da plataforma, e não com um multisig. As traduções das páginas não foram revisadas por falantes nativos. Mais sobre as limitações nas páginas “Sorteio honesto” e “Proteção do jogador”.