Documentación

Documentación de FAIRDRUM

Aquí está reunido todo sobre cómo funciona el sitio: por dónde empezar, cómo se calcula una ronda, dónde están sus SOL y qué se ha hecho para que todo esto funcione. Cada sección es una página aparte con los detalles.

Para el jugador: por dónde empezar

Cómo funciona el juego

Sus SOL y la protección

De qué consta el proyecto

  • Contrato inteligente en la red Solana. Acepta las apuestas, guarda los saldos de juego y los botes, y calcula el resultado de la ronda y los pagos. El sitio no calcula los pagos ni puede cambiarlos.
  • El sitio: páginas estáticas, sin un servidor con una base de datos de jugadores. Lee el contrato y prepara las transacciones que firma su billetera.
  • El vigilante de la plataforma: un programa en un servidor aparte. Revela el secreto de la ronda para que el contrato la liquide, abona las transferencias de las direcciones personales de recarga y vigila que en el depósito no haya menos que las obligaciones con los jugadores.

Qué se ha hecho para que el sitio llegue a este estado

Las cifras de abajo se han contado a partir del código fuente y de los registros de comprobaciones a fecha de 13/11/2026.

Contrato

Unas 2100 líneas en Rust, 27 instrucciones. 37 pruebas automáticas de los cálculos y de la contabilidad.

Sitio

16 juegos, 37 páginas en 14 idiomas: 519 páginas terminadas en total. Unas 10000 líneas de código y unas 1600 frases en cada idioma.

Revisiones del código

7 revisiones internas del código, con corrección de lo encontrado, y 83 pruebas automáticas del sitio. Todavía no ha habido una auditoría externa independiente.

Ensayos en una copia de la red

En una copia local de la red Solana: 117 comprobaciones de rondas (falsificación del secreto, devolución de la apuesta, cambio de la raíz de secretos) y 28 comprobaciones del vigilante (inactividad, dos copias, un archivo de secretos ajeno).

Cada juego en vivo

Los 16 juegos se han jugado en el navegador con el contrato real: después de cada ronda, el saldo del sitio se cotejó con el saldo del contrato. Se comprobaron las dos formas de entrar, la recarga desde un exchange y el retiro.

Cada página

Todas las páginas en todos los idiomas se abrieron en un teléfono y en un ordenador, 1008 aperturas: sin errores, huecos vacíos ni desplazamiento horizontal.

Decisiones que cambiaron el proyecto

  • Un sorteo justo propio en lugar de un oráculo externo. Una medición mostró que el oráculo devolvía el mismo número en la red de pruebas y en la red principal, es decir, el número de la ronda se podía conocer de antemano. El oráculo se ha eliminado; ahora el número de la ronda se compone del secreto registrado antes de la apuesta y del hash del bloque de la apuesta.
  • Devolución de la apuesta en lugar de una ronda atascada. Si la plataforma no liquida la ronda a tiempo, el contrato devuelve la apuesta íntegra y la devolución se suma a un contador público.
  • Dirección personal de recarga. Cada jugador tiene su propia dirección en el contrato: se pueden enviar SOL desde un exchange sin firmar en la billetera.
  • Entrada sin billetera propia. El sitio crea una billetera en el navegador del jugador; la clave no se transmite ni al sitio ni a la plataforma.
  • En el servidor del sitio no hay claves. Las claves de la plataforma están solo en el servidor aparte del contrato.

Qué falta por hacer

No se ha realizado una auditoría externa independiente del contrato. El derecho de actualizar el programa lo tiene por ahora una sola clave de la plataforma, no un multisig. Las traducciones de las páginas no han sido revisadas por hablantes nativos. Más sobre las limitaciones, en las páginas «Sorteo justo» y «Protección del jugador».