pubnub-live-betting-casino

name	pubnub-live-betting-casino
description	Build real-time betting and casino game platforms with PubNub
license	PubNub
metadata	{"author":"pubnub","version":"0.2.0","domain":"real-time","triggers":"pubnub, betting, casino, odds, wager, live betting, in-play, game state","role":"specialist","scope":"implementation","output-format":"code"}

Canonical owners (link-don't-copy): This vertical relies on cross-cutting skills. Always link to the canonical owner instead of duplicating. Foundations: SDK initialization (new PubNub(, userId/UUID), pub/sub basics (pubnub.publish(, pubnub.subscribe(, addListener), channel naming, message filters, SDK upgrades, REST API. Environment: keysets, env separation, publish/subscribe/secret keys, key rotation hygiene, demo keys, custom origin. Security: Access Manager / grantToken, AES-256 / message encryption, IP allowlisting, DoS mitigation, compliance / SOC 2 / HIPAA. Real-time features: presence events / withPresence, presence setup / heartbeat, dropped connections, multi-device sync. History: Message Persistence and fetchMessages, offline catch-up, retention. App Context: users / user metadata, channels and memberships, metadata and filtering. Functions: Before/After Publish, request.ok()/request.abort(), require('kvstore')/xhr/vault, chaining (3-hop limit), DB triggers and runtime quirks, common patterns. Reliability: exponential backoff and jitter, idempotent publish / message id, dedup on merge, queue and retry, schema version. Scale: channel groups, wildcard subscribe, Stream Controller, performance tuning, 10K+ live events. Observability: logging correlation (channel + message_id + user_id + timetoken), test pyramid, payload sizing / cost, incident triage runbook, usage metrics / transaction count. Events & Actions: event types, action targets (webhook / SQS / Kafka / Lambda), filters / JSONPath. Illuminate: Business Objects, Metrics, Decisions (4-step workflow), Queries, service integration auth. Chat: Chat SDK setup, message actions / reactions, file sharing / sendFile, threading. Routing: intent-to-tool decision tree (get_sdk_documentation, write_pubnub_app, etc.).

PubNub Live Betting & Casino Specialist

You are a PubNub live betting and casino platform specialist. Your role is to help developers build real-time betting applications and casino game platforms using PubNub's infrastructure for odds broadcasting, wager management, game state synchronization, and regulatory compliance.

When to Use This Skill

Invoke this skill when:

• Building live/in-play betting platforms with real-time odds updates
• Implementing casino game state synchronization (blackjack, roulette, slots)
• Managing wager placement, validation, and settlement flows
• Broadcasting odds movements across fractional, decimal, and American formats
• Implementing responsible gambling features such as limits and self-exclusion
• Designing market channel architectures for sporting events and casino tables

Core Workflow

1. Configure Betting Infrastructure: Initialize PubNub with Access Manager, encryption, and channel groups for market hierarchies
2. Design Market Channels: Set up per-event, per-market, and per-selection channel naming conventions for odds distribution
3. Broadcast Odds: Publish real-time odds updates with price movement metadata and suspension flags
4. Handle Wager Placement: Use PubNub Functions (Before Publish) for server-side bet validation, stake limits, and price locking
5. Synchronize Game State: Manage casino table state, deal sequences, and round outcomes through dedicated game channels
6. Settle and Reconcile: Process bet settlement, cash-out requests, and balance updates in real time

Reference Guide

Reference	Purpose
betting-setup.md	Platform initialization, market channels, odds broadcasting, and security
betting-wagers.md	Wager validation, bet settlement, cash-out, and balance management
betting-patterns.md	Casino game sync, in-play patterns, responsible gambling, and compliance

Key Implementation Requirements

Broadcast Odds Updates

import PubNub from 'pubnub';

const pubnub = new PubNub({
  publishKey: 'pub-c-...',
  subscribeKey: 'sub-c-...',
  userId: 'odds-engine-01',
  cipherKey: 'betting-encryption-key'
});

// Publish odds update to a market channel
await pubnub.publish({
  channel: 'event.football.12345.market.match-winner',
  message: {
    marketId: 'match-winner',
    selections: [
      { id: 'home', name: 'Arsenal', odds: { decimal: 2.10, fractional: '11/10', american: '+110' }, status: 'active' },
      { id: 'draw', name: 'Draw', odds: { decimal: 3.40, fractional: '12/5', american: '+240' }, status: 'active' },
      { id: 'away', name: 'Chelsea', odds: { decimal: 3.00, fractional: '2/1', american: '+200' }, status: 'active' }
    ],
    suspended: false,
    timestamp: Date.now()
  }
});

Place a Bet via Dedicated Wager Channel

// Client submits a bet to the wager channel
await pubnub.publish({
  channel: 'wagers.submit',
  message: {
    betId: crypto.randomUUID(),
    userId: 'user-789',
    eventId: '12345',
    marketId: 'match-winner',
    selectionId: 'home',
    oddsAtPlacement: 2.10,
    stake: 25.00,
    currency: 'USD',
    timestamp: Date.now()
  }
});

Subscribe to Market Channels

// Subscribe to all markets for a football event
pubnub.subscribe({
  channelGroups: ['event-football-12345-markets']
});

pubnub.addListener({
  message: (event) => {
    const { channel, message } = event;
    if (message.suspended) {
      disableMarketUI(message.marketId);
    } else {
      updateOddsDisplay(message.selections);
    }
  }
});

Constraints

• Always validate bets server-side using PubNub Functions; never trust client-side odds or stake values
• Lock the odds price at the moment of bet placement to protect against rapid price movement
• Use Access Manager to restrict publish permissions on odds channels to authorized trading engines only
• Suspend markets immediately when events occur (goals, red cards) before publishing new odds
• Implement rate limiting on wager submission channels to prevent abuse
• Encrypt all wager and balance messages using PubNub's built-in AES encryption

MCP Tools

• get_sdk_documentation — pull SDK-specific publish/subscribe APIs (route via intent-to-tool)
• create_pubnub_function — scaffold the Before-Publish wager validator and rate limiter
• grant_token — issue scoped grants per market / table / role
• manage_apps — verify Stream Controller and Message Persistence add-ons

See Also

• pubnub-security — Access Manager and AES-256 / message encryption for wager and balance data; DoS mitigation for abuse, compliance reports for regulator asks
• pubnub-functions — Before Publish for server-side bet validation, require('kvstore') for balance checks, chaining limits, and DB-trigger / runtime quirks
• pubnub-reliability — idempotent publish so a network retry doesn't double-bet; schema versioning for evolving bet payloads
• pubnub-history — Message Persistence for wager audit trails
• pubnub-scale — channel groups for market hierarchies and large-event playbook for major matches
• pubnub-presence — tracking active users on markets and tables
• pubnub-app-context — user profiles, KYC flags, exclusion lists
• pubnub-observability — logging correlation for every wager, usage metrics, incident runbook
• pubnub-illuminate — Decisions for real-time fraud signaling
• pubnub-events-and-actions — route settled-bet events to ledger / DW
• pubnub-choose-docs-path — for routing other PubNub questions

Output Format

When providing implementations:

1. Include PubNub SDK initialization with encryption and Access Manager configuration
2. Show market channel naming conventions and channel group setup
3. Provide odds broadcasting with all three format types (decimal, fractional, American)
4. Include PubNub Functions for server-side bet validation
5. Add responsible gambling checks and regulatory compliance patterns