El contrato: cómo y por qué funciona

Un contrato inteligente es un programa que ejecutan los nodos de la red Solana, no el servidor del proyecto. Su código es el mismo para todos y cada acción es una transacción pública. El contrato de FAIRDRUM está escrito en Rust con la biblioteca Anchor; su código fuente es abierto.

La dirección del programa aparecerá aquí cuando el sitio esté conectado al contrato.

Una consecuencia importante: si el sitio fairdrum.to desaparece, los fondos de los jugadores seguirán en el contrato y podrán retirarse con cualquier programa capaz de enviar el comando de retiro con la firma de su billetera.

• El depósito. Una sola cuenta en SOL envuelto de la que solo dispone el propio programa. En ella está todo: los saldos de los jugadores, el banco de premios, los jackpots, la reserva y la parte del administrador que aún no se ha retirado.
• La cuenta común del juego. Un registro de cómo se reparte el importe del depósito: banco de premios, jackpot, minijackpot, superjackpot, reserva de fondos iniciales, parte del administrador, importes iniciales de los jackpots y contadores de rondas por juego.
• La cuenta del jugador. La crea el comando register, que el sitio envía junto con la primera recarga, y está vinculada a la dirección de la billetera: saldo de juego, hora de la última recarga, ronda sin terminar y parte del jackpot pendiente de pago.
• La cuenta de sesión (si está activado el «juego sin firmas»): una clave temporal, un plazo y un límite de apuestas.

La contabilidad está hecha de modo que la suma de todos los saldos y botes sea igual al importe del depósito. Una prueba comprueba esa igualdad después de cada una de decenas de miles de operaciones aleatorias.

1. Apuesta. El comando spin_commit descuenta la ronda de su saldo y, en la misma transacción, crea en el oráculo ORAO una solicitud de número aleatorio. La dirección de la solicitud se calcula a partir de su billetera y del número de ronda, por lo que no es posible colar una solicitud ajena.
2. Número. Varios nodos independientes de ORAO firman el número aleatorio y lo escriben en la red. Hasta ese momento nadie lo conoce: ni usted, ni el proyecto, ni un nodo por separado.
3. Liquidación. El comando spin_settle lee el número del registro del oráculo, comprueba que es la solicitud de su ronda y calcula el pago. El sitio lo envía por su cuenta; si la página está cerrada, lo hará el programa de guardia del proyecto o usted en su próxima visita.
4. Presentación. Cartas, minas, cohete, gemas: son una forma de mostrar un pago ya calculado. Las pulsaciones en el juego no influyen en él.

Por qué el resultado no se puede conocer de antemano ni falsear. El número final de la ronda es el número del oráculo mezclado con el hash del bloque en el que queda registrada la apuesta. En el momento de la apuesta ese hash aún no existe, y el número del oráculo llega después y de un tercero: nadie puede calcular el resultado de antemano, ni el jugador, ni el proyecto, ni el propio oráculo. El juego, los importes iniciales de los jackpots y el tope del premio se registran en el momento de la apuesta, y la fórmula de liquidación está en código abierto. Una liquidación tardía nunca es más ventajosa que una hecha a tiempo. Las reglas solo se pueden cambiar sustituyendo el código del programa, y eso lo ve todo el mundo (véase la sección sobre el administrador).

Una ronda son de 1 a 100 apuestas de 0,01 SOL (hasta 1000 en la rueda). El número del oráculo se despliega en un valor aleatorio independiente para cada apuesta, y para cada una el contrato responde por orden a estas preguntas:

1. ¿Superjackpot, jackpot, minijackpot? La probabilidad de cada bote es igual a la aportación de la apuesta a ese bote dividida entre su importe inicial. Un bote solo se sortea cuando contiene al menos el 25% de su importe inicial.
2. ¿Premio del juego? Cada juego tiene su propia probabilidad de premio y su propia tabla de seis niveles con pesos. Por ejemplo, en la rueda sale premio en el 10% de las apuestas. Las tablas de todos los juegos se muestran en sus páginas.
3. ¿«Girar otra vez»? Con una probabilidad del 11,6% la apuesta se repite gratis a cargo del banco de premios.
4. Si no, la apuesta queda sin premio. Se reparte igual que cualquier otra: banco de premios, jackpots y parte del administrador.

Las tablas de los juegos son distintas, pero el pago esperado es el mismo en todas (con una precisión de centésimas de punto porcentual; con un banco de premios de 40 SOL o más, cuando los premios no chocan con el tope): cerca del 77,5% de la apuesta en premios normales y, junto con las repeticiones «Girar otra vez», cerca del 88% de las apuestas pagadas. La igualdad la comprueba el compilador: si el valor esperado de algún juego resulta mayor que el de la rueda, o menor en más de medio punto porcentual, el programa no compila.

• Un premio no supera la cuarta parte del banco de premios. El contrato no puede prometer más de lo que tiene, y un gran premio no vacía el banco para los demás. Lo que no se paga se queda en el banco.
• Retiro 12 horas después de la última recarga. La regla es igual para todos y está escrita como constante: solo puede cambiarse con una nueva versión del programa.
• Los importes iniciales de los jackpots cambian con un retraso de 24 horas. Las probabilidades de la ronda se fijan en el momento de la apuesta, por lo que no pueden cambiarse «a la medida de una apuesta ya hecha».
• 20 minutos para la liquidación. Si el oráculo no ha respondido, la apuesta se devuelve íntegra al jugador: mientras no hay número, nadie conoce el resultado, así que no es posible librarse así de una pérdida. Si respondió pero la liquidación llegó tarde, se pagan los premios habituales y los jackpots no se sortean en esa ronda. Protección del depósito. Antes de cada pago y después de cada liquidación, el contrato comprueba que en el depósito no haya menos de lo que debe a los jugadores y a los botes; de lo contrario, la operación se rechaza. Guardián. Si el oráculo ha dejado de responder, la aceptación de nuevas apuestas se suspende automáticamente; las liquidaciones y el retiro siguen funcionando.
• El jackpot se paga por partes: al ganador le corresponde el 95% del bote, del cual el 20% de inmediato y un 8% por semana. La parte pendiente queda anotada en la cuenta del ganador.
• Una sola ronda sin terminar por jugador. Mientras la ronda no esté liquidada, no se acepta una nueva apuesta.

• Pruebas del contrato: parte del administrador del 10% en cada juego, retorno muy parecido de todos los juegos con un banco de 50 SOL, la regla de la cuarta parte del banco y el tope del premio en el momento de la apuesta, el bloqueo del retiro, el cambio diferido de los importes iniciales, y que una liquidación tardía no es más ventajosa que una hecha a tiempo.
• Prueba de conservación de los fondos: decenas de miles de operaciones aleatorias; tras cada una, el importe del depósito se coteja con la suma de los saldos y los botes.
• Simulaciones largas: dos millones de apuestas en cada juego; cuánto se pagó a los jugadores y cuánto recibió el administrador.
• Transacciones reales en un nodo local de Solana: recarga, retiro denegado antes de plazo, aportación a la reserva, cambio de los importes iniciales.
• Pruebas del sitio: el sitio calcula las probabilidades con las mismas fórmulas que el contrato y se coteja con muestras registradas por el contrato.

Lo que no se ha probado ni se ha hecho figura, sin adornos, en la página «Por qué FAIRDRUM». Cómo comprobar cualquier ronda por su cuenta, en la página «Comprobar una ronda».