Saltar a contenido

slots-api

Propósito

API server-authoritative del producto de slots. Resuelve patrones, ganancias, saldo y verificación provably fair. El frontend solo muestra el resultado.

Stack

  • Laravel 13 · PHP 8.3+
  • Orion · Sanctum
  • PostgreSQL, esquema api
  • Laravel Octane + FrankenPHP
  • Pest

Repositorio

VortexPlayDev/slots-api

Arquitectura

  • clients, credentials y users para multi-cliente y multi-moneda.
  • game_configs y client_game_configs para configuración dinámica.
  • Configuración estática del juego en código.
  • Provably fair commit-reveal: POST /commit, POST /spin, GET /spin/{id}/verify.
  • Cálculo de RTP teórico y simulador.

Desarrollo local

composer setup
composer octane:start

Puerto por defecto: 8000.

Comandos:

php artisan game:rtp zeus-treasures --currency=USD
php artisan game:coins 0.25 100 --currency=USD
php artisan game:paytable 500 --currency=USD
php artisan game:verify {roundId}
vendor/bin/pest

Deploy

  • Octane + FrankenPHP.
  • Imagen base: dunglas/frankenphp:1-php8.4-alpine.
  • La base de datos es compartida con slots-admin, esquema api.
  • Revisar docs/api-contract.md.

Documentación relacionada