Caso de estudio
Ronin Rush
Juego crash multijugador en tiempo real, provably fair
p95 7 msen pruebas: carga con k6 y 1.000 jugadores concurrentes
Demo en vivo
Demo con dinero ficticio: fichas ficticias, sin dinero real ni premios. +18. Juega con responsabilidad.
Arranque en frío: la primera carga puede tardar hasta ~90 s mientras el servidor despierta.
Qué es y qué resuelve
Un crash multijugador en tiempo real: un ronin corre contra un oni en 2D mientras cada jugador decide cuándo retirarse. Lo difícil no es el dibujo, sino la confianza y el dinero: el resultado debe poder verificarse, el reloj es del servidor y cada ficha cuadra en un libro mayor de doble entrada.
Arquitectura
- Browser → nginx / Ingress (HTTPS / WS)
- nginx / Ingress → API #1 (leader)
- nginx / Ingress → API #2 (relay)
- API #1 (leader) → Redis
- API #2 (relay) → Redis
- API #1 (leader) → PostgreSQL
- API #1 (leader) → Kafka (outbox)
- API #1 (leader) → Platform Core
Dibujado a partir del diagrama de arquitectura del README del repositorio.
Tres decisiones técnicas
Reloj del servidor con un único líder
Una instancia de la API tiene un lock en Redis y lleva el bucle de rondas; las demás retransmiten. Las retiradas se valoran con la hora del servidor, así que un cliente lento o manipulado no puede retirarse después del crash.
Cadena de semillas SHA-256 + HMAC-SHA256
El punto de crash de cada ronda se calcula de antemano a partir de una semilla cuyo hash se muestra antes de apostar y se revela después, con un 1 % de ventaja de la casa. HMAC-SHA256 usa la semilla secreta como clave sobre los datos de la ronda, así el punto de crash queda fijado antes de abrir las apuestas y cualquiera puede recalcularlo cuando se revela la semilla. Una página pública de verificación hace justo eso.
Libro mayor de doble entrada y outbox a Kafka
Las apuestas pasan entre cuentas de usuario, escrow y casa en transacciones cuadradas; los eventos se escriben en la misma transacción y se envían a Kafka, así no se pierde ningún evento ni se publica uno de dinero que no se movió.
Pruebas, con cifras
- 1.000.000 de rondas simuladas que cuadran con la distribución teórica 0,99/x.
- 500 apuestas y retiradas simultáneas con los saldos cuadrados.
- k6 con 1.000 jugadores: p95 de 7 ms, medido con un cliente sonda.
- 8/8 pruebas de fallos contra Platform Core real: Core caído a mitad de ronda, respuestas perdidas, autoexclusión.
Verificado
- Integrado con Platform Core /api/v1: hold, intención de liquidación y settle.
- Repositorio público con CI en GitHub Actions.
Lo que no se afirma
- Operación con dinero real ni auditoría externa. Todas las fichas son ficticias.
- Las cifras salen de pruebas, no de tráfico en producción.