🏗️ Architecture
O Wave é um monorepo Turborepo + pnpm com 5 apps e 4 packages compartilhados. Todos os serviços se comunicam via REST sobre o apps/api.
Apps
apps/api — Backend (port 7000)
Backend principal em Express + TypeScript + SQLite (sql.js). Responsável por toda a lógica de negócio:
| Grupo de rotas | Descrição |
|---|---|
/casino/* | Rotas do jogador: auth, balance, deposit, withdraw, play, history, seed |
/casino/admin/* | Administração: games, agents, transactions, RTP, GGR, balances |
/casino/legacy/* | Proxy Pragmatic Play — modo Seamless |
/casino/vgames/* | 12 jogos HTML5 (Construct 3 / Spine 2D) |
/embed/* | White-label iframe — CRUD de operadores externos |
/public/* | Endpoints públicos: whitelabel config, recent bets, leaderboard |
apps/platform — Player UI (port 4001)
Casino Poseidoon — interface do jogador em React + Vite.
Stack: @solana/web3.js, wallet adapter, Zustand, styled-components, Framer Motion, Three.js.
apps/admin — Backoffice (port 7003)
Dashboard do operador em React + Vite + Radix UI + Recharts.
Funcionalidades: gestão de jogos, agentes, jogadores, relatórios de GGR, RTP, finanças, KYC.
apps/embed — White-label iframe
SPA React para embedding em qualquer site externo via <iframe>.
CORS aberto (any origin). Operadores provisionados via /embed/operators com admin key.
apps/website — Docs & Marketing (port 7003 dev)
Este site — Next.js 13 + Nextra, static export.
Diagrama de sistema
┌──────────────────────┐ ┌──────────────────────┐
│ 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 │
└─────────────────────────────────────────┘Packages
| Package | Função |
|---|---|
@wave/core | Tipos TypeScript, constantes Solana, utilitários de token |
@wave/react | WaveProvider, hooks (useAccount, useWalletAddress) |
@wave/ui | Componentes de jogo, Canvas, hooks (useGame, useFees, useTokenBalance, useWagerInput) |
@wave/design-system | Tokens CSS (cores, tipografia, espaçamento), temas dark/light |
Modelo de receita — GGR Waterfall
Cada aposta gera uma divisão de receita configurável por operador:
Aposta do jogador
└─ House Edge (%) → capturado do resultado do jogo
├─ Wave Fee (1%) → plataforma Wave
├─ Pool Fee (%) → provedores de liquidez
├─ Jackpot (%) → pool de jackpot compartilhado
├─ Bonus (%) → pool de bônus/afiliados
└─ Casino Net → receita líquida do operadorPricing: sem setup fee, sem taxa de licença. Você paga 1% por aposta processada.
Tech stack
| Camada | Tecnologia |
|---|---|
| Runtime | Node.js 18 + TypeScript |
| API | Express.js + Zod (validação) |
| Banco de dados | SQLite (sql.js in-memory/file) + MySQL legacy opcional |
| Blockchain | Solana — @solana/web3.js, Anchor framework |
| Frontend | React 18 + Vite (platform/admin) |
| Auth | SIWS — Sign-In-With-Solana (assinatura de wallet, sem senha) |
| State | Zustand, @preact/signals-react |
| Monorepo | Turborepo + pnpm workspaces |
| Jobs | node-cron para reconciliação periódica |
Autenticação
O Wave usa Sign-In-With-Solana (SIWS): o cliente assina uma mensagem com a private key da wallet, o backend valida a assinatura e retorna um Bearer token com validade de 30 minutos. Sem senha, sem OAuth, sem chave de API por usuário.
Ver Authentication para detalhes.
Catálogo de jogos
| Tipo | Jogos |
|---|---|
| Wave Originals (provably-fair) | Crash, Mines, Slots, Roulette, Flip, BlackJack, HiLo, Plinko, Wheel |
| Pragmatic Play | Seamless mode — acesso ao catálogo completo do provedor |
| PGSoft | Integração via API do provedor |
| vGames (HTML5) | 12 jogos Construct 3: Fortune Tiger, Fortune Ox, Fortune Mouse, e outros |