O contrato: como e por que funciona

Um contrato inteligente é um programa executado pelos nós da rede Solana, e não no servidor do projeto. O código é o mesmo para todos, e cada ação é uma transação pública. O contrato do FAIRDRUM é escrito em Rust com a biblioteca Anchor; o código-fonte é aberto.

O endereço do programa aparecerá aqui quando o site estiver conectado ao contrato.

Uma consequência importante: se o site fairdrum.to desaparecer, os fundos dos jogadores continuarão no contrato e poderão ser sacados com qualquer programa capaz de enviar o comando de saque com a assinatura da sua carteira.

• O cofre. Uma única conta em SOL embrulhado (wrapped SOL), controlada apenas pelo próprio programa. Nela fica tudo: os saldos dos jogadores, o banco de prêmios, os jackpots, a reserva e a parte do administrador ainda não retirada.
• A conta geral do jogo. Um registro de como o valor do cofre está dividido: banco de prêmios, jackpot, minijackpot, superjackpot, reserva de aportes iniciais, parte do administrador, valores iniciais dos jackpots e contadores de rodadas por jogo.
• A conta do jogador. É criada pelo comando register, que o site envia junto com o primeiro depósito, e fica vinculada ao endereço da carteira: saldo do jogo, hora do último depósito, rodada não concluída e parte do jackpot ainda não paga.
• A conta de sessão (se o “jogo sem assinaturas” estiver ativado): uma chave temporária, um prazo e um limite de apostas.

A contabilidade é feita de modo que a soma de todos os saldos e potes seja igual ao valor no cofre. Um teste confere essa igualdade depois de cada uma de dezenas de milhares de operações aleatórias.

1. Aposta. O comando spin_commit debita a rodada do seu saldo e, na mesma transação, cria no oráculo ORAO uma solicitação de número aleatório. O endereço da solicitação é calculado a partir da sua carteira e do número da rodada, por isso não dá para encaixar a solicitação de outra pessoa.
2. Número. Vários nós independentes da ORAO assinam o número aleatório e o gravam na rede. Até essa gravação ninguém o conhece: nem você, nem o projeto, nem um nó isolado.
3. Liquidação. O comando spin_settle lê o número no registro do oráculo, confere que a solicitação é mesmo a da sua rodada e calcula o pagamento. O próprio site o envia; se a página estiver fechada, quem faz isso é o programa de plantão do projeto ou você, na próxima visita.
4. Exibição. Cartas, minas, foguete, pedras: são formas de mostrar um pagamento já calculado. Os toques no jogo não o alteram.

Por que o resultado não pode ser conhecido de antemão nem falsificado. O número final da rodada é o número do oráculo misturado com o hash do bloco em que a aposta foi registrada. No momento da aposta esse hash ainda não existe, e o número do oráculo chega depois e vem de um terceiro: ninguém consegue calcular o resultado de antemão — nem o jogador, nem o projeto, nem o próprio oráculo. O jogo, os valores iniciais dos jackpots e o teto do prêmio são registrados no momento da aposta, e a fórmula de cálculo está em código aberto. Uma liquidação atrasada nunca é mais vantajosa do que uma feita no prazo. As regras só podem ser alteradas trocando o código do programa, e isso fica visível para todos (veja a seção sobre o administrador).

Uma rodada é de 1 a 100 apostas de 0,01 SOL (até 1000 na roda). O número do oráculo é desdobrado em um valor aleatório independente para cada aposta, e para cada uma o contrato responde, em ordem, às perguntas:

1. Superjackpot, jackpot, minijackpot? A chance de cada pote é igual à contribuição da aposta para ele dividida pelo valor inicial do pote. Um pote só é sorteado quando tem pelo menos 25% do valor inicial.
2. Prêmio do jogo? Cada jogo tem sua própria chance de prêmio e sua própria tabela de seis níveis com pesos. Por exemplo, na roda sai prêmio em 10% das apostas. As tabelas de todos os jogos aparecem nas páginas deles.
3. “Girar de novo”? Com chance de 11,6%, a aposta é repetida de graça, por conta do banco de prêmios.
4. Caso contrário, a aposta fica sem prêmio. Ela é dividida como qualquer outra: banco de prêmios, jackpots e parte do administrador.

As tabelas dos jogos são diferentes, mas o pagamento esperado é o mesmo em todas (com precisão de centésimos de ponto percentual; com banco de prêmios a partir de 40 SOL, quando os prêmios não batem no teto): cerca de 77,5% da aposta em prêmios comuns e, somando as repetições “Girar de novo”, cerca de 88% das apostas pagas. Quem confere a igualdade é o compilador: se o valor esperado de algum jogo ficar acima do da roda, ou abaixo em mais de meio ponto percentual, o programa não compila.

• Um prêmio não passa de um quarto do banco de prêmios. O contrato não pode prometer mais do que tem, e um prêmio grande não esvazia o banco para os demais. O que deixa de ser pago fica no banco.
• Saque 12 horas após o último depósito. A regra é igual para todos e está escrita como constante: só pode ser mudada por uma nova versão do programa.
• Os valores iniciais dos jackpots mudam com atraso de 24 horas. As chances da rodada são fixadas no momento da aposta, por isso não dá para mudá-las “sob medida para uma aposta já feita”.
• 20 minutos para a liquidação. Se o oráculo não respondeu, a aposta é devolvida integralmente ao jogador: enquanto não há número, ninguém conhece o resultado, por isso não é possível escapar assim de uma perda. Se respondeu, mas a liquidação atrasou, os prêmios normais são pagos e os jackpots não são sorteados nessa rodada. Proteção do cofre. Antes de cada pagamento e depois de cada liquidação, o contrato verifica se o cofre tem pelo menos o que ele deve aos jogadores e aos potes; caso contrário, a operação é rejeitada. Guardião. Se o oráculo parar de responder, o recebimento de novas apostas é suspenso automaticamente; as liquidações e o saque continuam funcionando.
• O jackpot é pago em parcelas: o vencedor tem direito a 95% do pote, sendo 20% na hora e 8% por semana. A parte ainda não paga fica registrada na conta do vencedor.
• Uma rodada não concluída por jogador. Enquanto a rodada não for liquidada, uma nova aposta não é aceita.

• Testes do contrato: parte do administrador de 10% em cada jogo, retorno muito próximo em todos os jogos com banco de 50 SOL, a regra de um quarto do banco e o teto do prêmio no momento da aposta, a trava de saque, a mudança adiada dos valores iniciais e que uma liquidação atrasada não é mais vantajosa do que uma feita no prazo.
• Teste de conservação dos fundos: dezenas de milhares de operações aleatórias; depois de cada uma, o valor no cofre é conferido com a soma dos saldos e dos potes.
• Simulações longas: dois milhões de apostas em cada jogo; quanto foi pago aos jogadores e quanto o administrador recebeu.
• Transações reais em um nó local da Solana: depósito, saque recusado antes do prazo, aporte na reserva, mudança dos valores iniciais.
• Testes do site: o site calcula as chances com as mesmas fórmulas do contrato e se confere com amostras registradas pelo contrato.

O que não foi testado nem feito está listado, sem enfeites, na página “Por que FAIRDRUM”. Como conferir qualquer rodada por conta própria está na página “Conferir uma rodada”.