DocumentationπŸ”Œ Integration Guide🌐 Overview

Wave Casino API β€” Overview

Wave Casino API Γ© um backend Solana-native que permite lanΓ§ar um casino completo. Ele fornece:

  • Jogos originais β€” provably-fair on-chain (Slots, Crash, Mines, Roulette, Flip, BlackJack e mais)
  • Pragmatic Play & PGSoft β€” integraΓ§Γ£o com provedores terceiros via modo Seamless
  • Auth por wallet β€” Sign-In-With-Solana; sem senhas ou OAuth
  • Sistema de agentes β€” hierarquia multi-tier (Wave Creator β†’ Platform Creator β†’ Integrator)
  • Embed white-label β€” iframe configurΓ‘vel para operadores externos sem desenvolvimento prΓ³prio
  • Admin panel β€” backoffice completo em /admin para gerenciar jogos, agentes, jogadores, RTP e finanΓ§as

Arquitetura

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚    apps/platform     β”‚  β”‚     apps/embed        β”‚
β”‚    (port 4001)       β”‚  β”‚    (iframe SPA)       β”‚
β”‚    Player casino UI  β”‚  β”‚    Operator embed     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
           β”‚  REST + SIWS            β”‚  REST
           β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
      β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
      β”‚          apps/api  (port 7000)          β”‚
      β”‚  /casino/*        player routes         β”‚
      β”‚  /casino/admin/*  admin routes          β”‚
      β”‚  /casino/legacy/* Pragmatic Play proxy  β”‚
      β”‚  /casino/vgames/* HTML5 games           β”‚
      β”‚  /embed/*         operator CRUD         β”‚
      β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                      β”‚
      β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
      β”‚       apps/admin  (port 7003)           β”‚
      β”‚       Operator backoffice               β”‚
      β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Base URL

https://your-domain.com/casino

Todas as rotas do jogador ficam sob /casino. Rotas administrativas ficam sob /casino/admin.

AutenticaΓ§Γ£o

O Wave usa Sign-In-With-Solana (SIWS). Veja Authentication.

Modelo de receita

O Wave cobra 1% por aposta processada β€” sem setup fee, sem taxa de licenΓ§a. O restante do house edge Γ© distribuΓ­do conforme a configuraΓ§Γ£o do operador (pool fee, jackpot, bΓ΄nus, net). Veja Architecture para o GGR waterfall completo.

PrΓ³ximos passos