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.

Abrir en otra pestaña ↗

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

Ronin Rush: arquitecturaHTTPS / WSoutboxBrowserNext.js 15 · PixiJSnginx / Ingress/ · /api · /socket.ioAPI #1 (leader)NestJS · round loopAPI #2 (relay)NestJSRedislease · live state · pub/subPostgreSQLledger · seeds · outboxKafkaronin.*.v1Platform Corehold · settle
  • 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

  1. 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.

  2. 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.

  3. 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.

Stack

  • NestJS 11
  • Socket.IO + Redis
  • Next.js 15
  • React 19
  • PixiJS
  • PostgreSQL
  • Kafka
  • Docker
  • Helm
  • GitHub Actions
  • Vitest
  • Playwright
  • k6