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
Duas formas de começar
Com sua própria carteira Solana ou com uma carteira no dispositivo: qual escolher e em que elas diferem.
Guia passo a passo
Carteira, SOL, conexão, depósito, jogo, jogo sem assinaturas, saque.
Carteira no dispositivo
Como o site cria uma carteira no seu navegador, onde a chave fica guardada e que riscos você corre.
Sem cadastro
Por que não são necessários e-mail, senha do site nem documentos.
Perguntas frequentes
Respostas curtas às perguntas mais comuns.
Erros e soluções
38 códigos de erro: o que aconteceu e o que fazer em cada caso.
Como o jogo funciona
Como funciona
O caminho da aposta: do que a rodada é composta, para onde vai cada parte da aposta, taxas.
Sorteio honesto
De onde vem o número da rodada e por que não é possível conhecê-lo nem manipulá-lo de antemão.
Conferir uma rodada
Conferência de qualquer rodada direto no navegador, pela assinatura da transação.
Todos os jogos
16 jogos em um único contrato; cada um tem sua própria tabela de prêmios.
Seus SOL e a proteção
Seus SOL no contrato
Onde fica o saldo do jogo, como funcionam o depósito e o saque, a trava sobre o valor depositado.
Proteção do jogador
A rodada é liquidada ou a aposta é devolvida por inteiro; o que acontece em caso de falhas.
Contrato
O endereço do programa, suas instruções e os direitos do administrador.
Estatísticas
Números públicos da conta comum do jogo na rede Solana.
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”.