dubs-server 1.0.0

package/scripts/setup-complete-database.sql

@@ -0,0 +1,992 @@
+-- ============================================
+-- 🎮 DUBS SERVER - COMPLETE DATABASE SCHEMA
+-- ============================================
+-- This script creates ALL tables needed for the DUBS server
+-- Safe to run multiple times (uses IF NOT EXISTS)
+-- Run with: psql -d dubs_db -f scripts/setup-complete-database.sql
+
+-- ============================================
+-- 1. AUTHENTICATION & USERS
+-- ============================================
+
+-- Users table (main user profiles)
+CREATE TABLE IF NOT EXISTS users (
+  id SERIAL PRIMARY KEY,
+  wallet_address VARCHAR(44) UNIQUE NOT NULL,
+  email VARCHAR(255),
+  username VARCHAR(50) NOT NULL,
+  avatar TEXT,
+  referral_code VARCHAR(50),
+  my_referral_code VARCHAR(50),
+  signature TEXT,
+  onboarding_complete BOOLEAN DEFAULT false,
+  telegram_user_id BIGINT UNIQUE,
+  telegram_username VARCHAR(255),
+  telegram_first_name VARCHAR(255),
+  telegram_last_name VARCHAR(255),
+  telegram_photo_url TEXT,
+  telegram_connected_at TIMESTAMP,
+  preferred_currency VARCHAR(3) DEFAULT 'USD',
+  created_at TIMESTAMP DEFAULT NOW(),
+  updated_at TIMESTAMP DEFAULT NOW()
+);
+
+-- Auth nonces (for signature verification)
+CREATE TABLE IF NOT EXISTS auth_nonces (
+  wallet_address VARCHAR(44) PRIMARY KEY,
+  nonce VARCHAR(64) NOT NULL,
+  expires_at TIMESTAMP NOT NULL,
+  used BOOLEAN DEFAULT false,
+  created_at TIMESTAMP DEFAULT NOW()
+);
+
+-- User sessions (JWT token management)
+CREATE TABLE IF NOT EXISTS user_sessions (
+  id SERIAL PRIMARY KEY,
+  wallet_address VARCHAR(100) NOT NULL,
+  user_id INTEGER,
+  token_hash VARCHAR(64) NOT NULL,
+  expires_at TIMESTAMP NOT NULL,
+  created_at TIMESTAMP DEFAULT NOW(),
+  last_activity TIMESTAMP DEFAULT NOW()
+);
+
+-- User badges (achievements)
+CREATE TABLE IF NOT EXISTS user_badges (
+  id SERIAL PRIMARY KEY,
+  user_id INTEGER NOT NULL,
+  badge_type VARCHAR(50) NOT NULL,
+  badge_name VARCHAR(100) NOT NULL,
+  badge_description TEXT,
+  badge_icon TEXT,
+  referral_count INTEGER,
+  earned_at TIMESTAMP DEFAULT NOW(),
+  created_at TIMESTAMP DEFAULT NOW(),
+  UNIQUE(user_id, badge_type)
+);
+
+-- Telegram notification preferences
+CREATE TABLE IF NOT EXISTS telegram_notification_preferences (
+  user_id INTEGER PRIMARY KEY REFERENCES users(id) ON DELETE CASCADE,
+  notify_reply BOOLEAN DEFAULT true,
+  notify_reaction BOOLEAN DEFAULT true,
+  notify_friend_request BOOLEAN DEFAULT true,
+  notify_friend_request_accepted BOOLEAN DEFAULT true,
+  notify_friend_request_declined BOOLEAN DEFAULT true,
+  notify_referral BOOLEAN DEFAULT true,
+  notify_mention BOOLEAN DEFAULT true,
+  notify_friend_message BOOLEAN DEFAULT true,
+  notify_game_joined BOOLEAN DEFAULT true,
+  notify_game_invite BOOLEAN DEFAULT true,
+  created_at TIMESTAMP DEFAULT NOW(),
+  updated_at TIMESTAMP DEFAULT NOW()
+);
+
+-- Push notification subscriptions (for PWA/seeker mode)
+CREATE TABLE IF NOT EXISTS push_subscriptions (
+  id SERIAL PRIMARY KEY,
+  user_id INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  endpoint TEXT NOT NULL,
+  p256dh TEXT NOT NULL,
+  auth TEXT NOT NULL,
+  device_type VARCHAR(50) DEFAULT 'android_pwa',
+  created_at TIMESTAMP DEFAULT NOW(),
+  updated_at TIMESTAMP DEFAULT NOW(),
+  UNIQUE(user_id, endpoint)
+);
+
+-- Push notification preferences (mirrors telegram_notification_preferences)
+CREATE TABLE IF NOT EXISTS push_notification_preferences (
+  user_id INTEGER PRIMARY KEY REFERENCES users(id) ON DELETE CASCADE,
+  notify_reply BOOLEAN DEFAULT true,
+  notify_reaction BOOLEAN DEFAULT true,
+  notify_friend_request BOOLEAN DEFAULT true,
+  notify_friend_request_accepted BOOLEAN DEFAULT true,
+  notify_friend_request_declined BOOLEAN DEFAULT true,
+  notify_referral BOOLEAN DEFAULT true,
+  notify_mention BOOLEAN DEFAULT true,
+  notify_friend_message BOOLEAN DEFAULT true,
+  notify_game_joined BOOLEAN DEFAULT true,
+  notify_game_invite BOOLEAN DEFAULT true,
+  created_at TIMESTAMP DEFAULT NOW(),
+  updated_at TIMESTAMP DEFAULT NOW()
+);
+
+-- ============================================
+-- 2. CHAT SYSTEM
+-- ============================================
+
+-- Chat messages (main chat table)
+CREATE TABLE IF NOT EXISTS chat_messages (
+  id SERIAL PRIMARY KEY,
+  user_id INTEGER,
+  wallet_address VARCHAR(100) NOT NULL,
+  username VARCHAR(100),
+  avatar TEXT,
+  message TEXT NOT NULL,
+  reply_to_id INTEGER,
+  is_winner_announcement BOOLEAN DEFAULT FALSE,
+  win_amount NUMERIC(20, 9),
+  round_id INTEGER,
+  game_invite_metadata JSONB,
+  edited BOOLEAN DEFAULT FALSE,
+  edited_at TIMESTAMP,
+  deleted BOOLEAN DEFAULT FALSE,
+  deleted_at TIMESTAMP,
+  timestamp TIMESTAMP DEFAULT NOW(),
+  created_at TIMESTAMP DEFAULT NOW()
+);
+
+-- Chat reactions (emojis on messages)
+CREATE TABLE IF NOT EXISTS chat_reactions (
+  id SERIAL PRIMARY KEY,
+  message_id INTEGER,
+  user_id INTEGER,
+  wallet_address VARCHAR(100) NOT NULL,
+  reaction VARCHAR(20) NOT NULL,
+  created_at TIMESTAMP DEFAULT NOW(),
+  UNIQUE(message_id, user_id, reaction)
+);
+
+-- User relationships (friends/blocks)
+CREATE TABLE IF NOT EXISTS user_relationships (
+  id SERIAL PRIMARY KEY,
+  user_id INTEGER,
+  target_user_id INTEGER,
+  relationship_type VARCHAR(20) NOT NULL CHECK (relationship_type IN ('friend', 'block')),
+  created_at TIMESTAMP DEFAULT NOW(),
+  UNIQUE(user_id, target_user_id)
+);
+
+-- Chat notifications
+CREATE TABLE IF NOT EXISTS chat_notifications (
+  id SERIAL PRIMARY KEY,
+  user_id INTEGER,
+  message_id INTEGER,
+  sender_user_id INTEGER,
+  notification_type VARCHAR(30) NOT NULL CHECK (notification_type IN ('reply', 'mention', 'friend_message', 'reaction', 'friend_request', 'friend_request_accepted', 'friend_request_declined', 'referral', 'game_joined', 'game_invite', 'game_starting_soon', 'game_starting_now', 'game_won', 'game_lost', 'payment_received', 'payment_sent', 'dm', 'dm_message', 'whats_new')),
+  notification_data JSONB,
+  read BOOLEAN DEFAULT FALSE,
+  created_at TIMESTAMP DEFAULT NOW()
+);
+
+-- Message mentions (@mention system)
+CREATE TABLE IF NOT EXISTS message_mentions (
+  id SERIAL PRIMARY KEY,
+  message_id INTEGER NOT NULL REFERENCES chat_messages(id) ON DELETE CASCADE,
+  mentioned_user_id INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  created_at TIMESTAMP DEFAULT NOW(),
+  UNIQUE(message_id, mentioned_user_id)
+);
+
+-- Chat payments (SOL payment tracking)
+CREATE TABLE IF NOT EXISTS chat_payments (
+  id SERIAL PRIMARY KEY,
+  message_id INTEGER REFERENCES chat_messages(id) ON DELETE CASCADE,
+  sender_user_id INTEGER REFERENCES users(id) ON DELETE CASCADE,
+  sender_wallet VARCHAR(100) NOT NULL,
+  recipient_user_id INTEGER REFERENCES users(id) ON DELETE CASCADE,
+  recipient_wallet VARCHAR(100) NOT NULL,
+  amount_sol NUMERIC(20, 9) NOT NULL,
+  transaction_signature VARCHAR(200) NOT NULL UNIQUE,
+  status VARCHAR(20) NOT NULL CHECK (status IN ('pending', 'confirmed', 'failed')),
+  error_message TEXT,
+  created_at TIMESTAMP DEFAULT NOW(),
+  updated_at TIMESTAMP DEFAULT NOW()
+);
+
+-- ============================================
+-- 3. GAMES SYSTEM (Sports Betting)
+-- ============================================
+
+-- Games table (shared game data)
+CREATE TABLE IF NOT EXISTS games (
+  id SERIAL PRIMARY KEY,
+  game_id VARCHAR(255) UNIQUE NOT NULL,
+  game_address VARCHAR(255) NOT NULL,
+  title VARCHAR(500),
+  image_url TEXT,
+  matchup_image_url TEXT,  -- Pre-generated S3 matchup image URL
+  game_type VARCHAR(50),
+  buy_in NUMERIC(20, 9),
+  max_players INTEGER DEFAULT 0,
+  game_mode INTEGER,
+  created_by VARCHAR(255) NOT NULL,
+  sports_event JSONB,
+  home_team_players TEXT[] DEFAULT '{}',
+  away_team_players TEXT[] DEFAULT '{}',
+  draw_team_players TEXT[] DEFAULT '{}',  -- For EPL/soccer draw betting
+  lock_timestamp BIGINT,
+  is_locked BOOLEAN DEFAULT false,
+  is_resolved BOOLEAN DEFAULT false,
+  automatic_status VARCHAR(50),
+  lock_notification_sent_10min BOOLEAN DEFAULT false,
+  lock_notification_sent_now BOOLEAN DEFAULT false,
+  -- Connect4 specific columns
+  game_status VARCHAR(50),              -- waiting, playing, completed, cancelled
+  connect4_board JSONB,                 -- 6x7 2D array board state
+  connect4_current_turn VARCHAR(10),    -- home or away
+  connect4_winner VARCHAR(10),          -- home, away, draw, or NULL
+  connect4_winning_cells JSONB,         -- Array of {row, col} winning cells
+  claim_signature TEXT,                 -- On-chain claim transaction signature
+  completed_at TIMESTAMP,               -- When game ended
+  invited_player VARCHAR(255),          -- Wallet for private game invites
+  created_at TIMESTAMP DEFAULT NOW(),
+  updated_at TIMESTAMP DEFAULT NOW()
+);
+
+-- User game refs table (user-specific game data)
+CREATE TABLE IF NOT EXISTS user_game_refs (
+  id SERIAL PRIMARY KEY,
+  wallet_address VARCHAR(255) NOT NULL,
+  game_id VARCHAR(255) NOT NULL,
+  role VARCHAR(50),
+  joined_at TIMESTAMP,
+  team_choice VARCHAR(10),
+  my_signature VARCHAR(255),
+  my_explorer_url TEXT,
+  status VARCHAR(50),
+  wallet_type VARCHAR(50),
+  claimed_at TIMESTAMP,
+  claim_signature TEXT,
+  claim_explorer_url TEXT,
+  amount_claimed NUMERIC(20, 9),
+  created_at TIMESTAMP DEFAULT NOW(),
+  updated_at TIMESTAMP DEFAULT NOW(),
+  UNIQUE(wallet_address, game_id)
+);
+
+-- Audit logs table
+CREATE TABLE IF NOT EXISTS audit_logs (
+  id SERIAL PRIMARY KEY,
+  log_type VARCHAR(100),
+  method VARCHAR(100),
+  user_id VARCHAR(255),
+  metadata JSONB,
+  created_at TIMESTAMP DEFAULT NOW()
+);
+
+-- ============================================
+-- 4. SOCIAL FEATURES
+-- ============================================
+
+-- Friends table
+CREATE TABLE IF NOT EXISTS friends (
+  id SERIAL PRIMARY KEY,
+  user_wallet VARCHAR(100) NOT NULL,
+  friend_wallet VARCHAR(100) NOT NULL,
+  status VARCHAR(20) DEFAULT 'pending',
+  created_at TIMESTAMP DEFAULT NOW(),
+  updated_at TIMESTAMP DEFAULT NOW(),
+  UNIQUE(user_wallet, friend_wallet)
+);
+
+-- Friend requests
+CREATE TABLE IF NOT EXISTS friend_requests (
+  id SERIAL PRIMARY KEY,
+  from_user_id INTEGER REFERENCES users(id) ON DELETE CASCADE,
+  to_user_id INTEGER REFERENCES users(id) ON DELETE CASCADE,
+  status VARCHAR(20) NOT NULL CHECK (status IN ('pending', 'accepted', 'rejected')) DEFAULT 'pending',
+  created_at TIMESTAMP DEFAULT NOW(),
+  updated_at TIMESTAMP DEFAULT NOW()
+);
+
+-- Add unique constraint for friend_requests if it doesn't exist
+DO $$ 
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM pg_constraint 
+    WHERE conname = 'friend_requests_from_user_id_to_user_id_key'
+  ) THEN
+    ALTER TABLE friend_requests 
+    ADD CONSTRAINT friend_requests_from_user_id_to_user_id_key 
+    UNIQUE (from_user_id, to_user_id);
+  END IF;
+END $$;
+
+-- Groups (group chats)
+CREATE TABLE IF NOT EXISTS groups (
+  id SERIAL PRIMARY KEY,
+  name VARCHAR(100) NOT NULL,
+  description TEXT,
+  creator_id INTEGER REFERENCES users(id) ON DELETE CASCADE,
+  created_at TIMESTAMP DEFAULT NOW()
+);
+
+-- Group members
+CREATE TABLE IF NOT EXISTS group_members (
+  id SERIAL PRIMARY KEY,
+  group_id INTEGER REFERENCES groups(id) ON DELETE CASCADE,
+  user_id INTEGER REFERENCES users(id) ON DELETE CASCADE,
+  role VARCHAR(20) DEFAULT 'member',
+  joined_at TIMESTAMP DEFAULT NOW()
+);
+
+-- Add unique constraint for group_members if it doesn't exist
+DO $$ 
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM pg_constraint 
+    WHERE conname = 'group_members_group_id_user_id_key'
+  ) THEN
+    ALTER TABLE group_members 
+    ADD CONSTRAINT group_members_group_id_user_id_key 
+    UNIQUE (group_id, user_id);
+  END IF;
+END $$;
+
+-- ============================================
+-- 5. PLAYER STATS & TRACKING
+-- ============================================
+
+-- Player stats (overall performance)
+CREATE TABLE IF NOT EXISTS player_stats (
+  wallet_address VARCHAR(100) PRIMARY KEY,
+  total_wagered NUMERIC(20, 9) DEFAULT 0,
+  total_won NUMERIC(20, 9) DEFAULT 0,
+  net_pnl NUMERIC(20, 9) DEFAULT 0,
+  rounds_played INTEGER DEFAULT 0,
+  rounds_won INTEGER DEFAULT 0,
+  biggest_win NUMERIC(20, 9) DEFAULT 0,
+  biggest_win_round INTEGER,
+  last_played TIMESTAMP,
+  created_at TIMESTAMP DEFAULT NOW()
+);
+
+-- Player history (individual transactions)
+CREATE TABLE IF NOT EXISTS player_history (
+  id SERIAL PRIMARY KEY,
+  wallet_address VARCHAR(100) NOT NULL,
+  round_id INTEGER NOT NULL,
+  action VARCHAR(20) NOT NULL,
+  amount NUMERIC(20, 9) NOT NULL,
+  cumulative_pnl NUMERIC(20, 9) NOT NULL,
+  timestamp TIMESTAMP DEFAULT NOW()
+);
+
+-- ============================================
+-- 6. JACKPOT SYSTEM
+-- ============================================
+
+-- Jackpot rounds history
+CREATE TABLE IF NOT EXISTS jackpot_rounds (
+  id SERIAL PRIMARY KEY,
+  round_id VARCHAR(50) UNIQUE NOT NULL,
+  winner VARCHAR(100) NOT NULL,
+  win_amount VARCHAR(50) NOT NULL,
+  total_pot VARCHAR(50) NOT NULL,
+  entry_count INTEGER NOT NULL,
+  locked_at TIMESTAMP,
+  resolved_at TIMESTAMP,
+  created_at TIMESTAMP DEFAULT NOW()
+);
+
+-- Keeper actions (keeper bot logs)
+CREATE TABLE IF NOT EXISTS keeper_actions (
+  id SERIAL PRIMARY KEY,
+  round_id INTEGER,
+  action_type VARCHAR(50) NOT NULL,
+  status VARCHAR(20) NOT NULL,
+  details TEXT,
+  error_message TEXT,
+  created_at TIMESTAMP DEFAULT NOW()
+);
+
+-- Keeper health (monitoring)
+CREATE TABLE IF NOT EXISTS keeper_health (
+  id SERIAL PRIMARY KEY,
+  round_id INTEGER,
+  check_type VARCHAR(50) NOT NULL,
+  status VARCHAR(20) NOT NULL,
+  message TEXT,
+  created_at TIMESTAMP DEFAULT NOW()
+);
+
+-- Keeper rounds (keeper state machine)
+CREATE TABLE IF NOT EXISTS keeper_rounds (
+  id SERIAL PRIMARY KEY,
+  round_id INTEGER UNIQUE NOT NULL,
+  state VARCHAR(50) NOT NULL,
+  entries_count INTEGER DEFAULT 0,
+  total_pot NUMERIC(20, 9) DEFAULT 0,
+  locked_at TIMESTAMP,
+  resolved_at TIMESTAMP,
+  winner VARCHAR(100),
+  last_action TIMESTAMP DEFAULT NOW(),
+  created_at TIMESTAMP DEFAULT NOW()
+);
+
+-- ============================================
+-- 7. REFERRAL EARNINGS SYSTEM
+-- ============================================
+-- Commission goes to the GAME CREATOR's referrer ONLY!
+-- The person who referred the GAME CREATOR earns 1% of the ENTIRE POT.
+-- Fee Structure: 4% Operator + 1% Referrer + 1% Oracle = 6% Total
+-- If game creator has no referrer, operator keeps full 5%.
+
+-- Main earnings table - tracks each individual earning event
+CREATE TABLE IF NOT EXISTS referral_earnings (
+  id SERIAL PRIMARY KEY,
+  
+  -- Relationship: Referrer (who earns) and Referee (who played)
+  referrer_user_id INTEGER REFERENCES users(id) ON DELETE SET NULL,
+  referrer_wallet VARCHAR(44) NOT NULL,
+  referee_user_id INTEGER REFERENCES users(id) ON DELETE SET NULL,
+  referee_wallet VARCHAR(44) NOT NULL,
+  
+  -- Game details
+  game_id VARCHAR(255) NOT NULL,
+  game_type VARCHAR(50) NOT NULL, -- 'sports', 'billiards', 'jackpot'
+  
+  -- Financial details (all in lamports)
+  pot_size BIGINT NOT NULL,            -- Total pot of the game
+  referee_buy_in BIGINT NOT NULL,      -- Amount referee wagered
+  referee_won BOOLEAN NOT NULL,        -- Did referee win?
+  referee_payout BIGINT DEFAULT 0,     -- Amount referee won (0 if lost)
+  
+  -- Commission details
+  commission_rate DECIMAL(6,4) NOT NULL DEFAULT 0.0100, -- 1% = 0.0100
+  commission_amount BIGINT NOT NULL,   -- Actual commission in lamports
+  
+  -- Status and payout tracking
+  status VARCHAR(20) DEFAULT 'pending' CHECK (status IN ('pending', 'paid', 'cancelled')),
+  notes TEXT,
+  created_at TIMESTAMP DEFAULT NOW(),
+  paid_at TIMESTAMP,
+  payout_tx_signature VARCHAR(128),
+  payout_batch_id INTEGER,
+  notes TEXT, -- Optional notes (e.g., "Paid on-chain during game resolution")
+  
+  -- Prevent duplicate entries for same referee in same game
+  UNIQUE(referee_wallet, game_id)
+);
+
+-- Payout batches table - tracks batch payouts to referrers
+CREATE TABLE IF NOT EXISTS referral_payout_batches (
+  id SERIAL PRIMARY KEY,
+  
+  -- Batch details
+  total_amount BIGINT NOT NULL,        -- Total lamports in this batch
+  num_referrers INTEGER NOT NULL,      -- Number of unique referrers paid
+  num_earnings INTEGER NOT NULL,       -- Number of individual earning records
+  
+  -- Transaction details
+  tx_signature VARCHAR(128),
+  status VARCHAR(20) DEFAULT 'pending' CHECK (status IN ('pending', 'processing', 'completed', 'failed')),
+  
+  -- Timing
+  created_at TIMESTAMP DEFAULT NOW(),
+  processed_at TIMESTAMP,
+  completed_at TIMESTAMP,
+  
+  -- Error tracking
+  error_message TEXT,
+  retry_count INTEGER DEFAULT 0
+);
+
+-- Referral earnings indexes
+CREATE INDEX IF NOT EXISTS idx_referral_earnings_referrer ON referral_earnings(referrer_user_id, status);
+CREATE INDEX IF NOT EXISTS idx_referral_earnings_referrer_wallet ON referral_earnings(referrer_wallet);
+CREATE INDEX IF NOT EXISTS idx_referral_earnings_referee ON referral_earnings(referee_user_id);
+CREATE INDEX IF NOT EXISTS idx_referral_earnings_game ON referral_earnings(game_id);
+CREATE INDEX IF NOT EXISTS idx_referral_earnings_status ON referral_earnings(status);
+CREATE INDEX IF NOT EXISTS idx_referral_earnings_created ON referral_earnings(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_referral_earnings_pending ON referral_earnings(referrer_wallet) WHERE status = 'pending';
+CREATE INDEX IF NOT EXISTS idx_payout_batches_status ON referral_payout_batches(status);
+
+-- Aggregated summary view for quick dashboard stats
+CREATE OR REPLACE VIEW referral_earnings_summary AS
+SELECT 
+  u.id as user_id,
+  u.wallet_address,
+  u.username,
+  u.my_referral_code,
+  COALESCE(COUNT(re.id), 0) as total_referral_games,
+  COALESCE(SUM(re.commission_amount), 0) as total_earned_lamports,
+  COALESCE(SUM(CASE WHEN re.status = 'pending' THEN re.commission_amount ELSE 0 END), 0) as pending_lamports,
+  COALESCE(SUM(CASE WHEN re.status = 'paid' THEN re.commission_amount ELSE 0 END), 0) as paid_lamports,
+  MAX(re.created_at) as last_earning_at
+FROM users u
+LEFT JOIN referral_earnings re ON u.wallet_address = re.referrer_wallet
+WHERE u.my_referral_code IS NOT NULL
+GROUP BY u.id, u.wallet_address, u.username, u.my_referral_code;
+
+-- ============================================
+-- 8. WHAT'S NEW SYSTEM (Feature Announcements)
+-- ============================================
+
+-- What's New posts (admin announcements with GIFs)
+CREATE TABLE IF NOT EXISTS whats_new_posts (
+  id SERIAL PRIMARY KEY,
+  
+  -- Post content
+  title VARCHAR(200) NOT NULL,
+  content TEXT NOT NULL,               -- Markdown-style content
+  gif_url TEXT,                        -- Optional GIF URL to showcase feature
+  
+  -- Categorization
+  category VARCHAR(50) DEFAULT 'feature', -- feature, improvement, bugfix, announcement
+  
+  -- Versioning
+  version VARCHAR(20),                 -- Optional app version (e.g., "1.2.0")
+  
+  -- Targeting (future use - could target specific user segments)
+  target_all BOOLEAN DEFAULT TRUE,
+  
+  -- Status
+  is_published BOOLEAN DEFAULT TRUE,
+  is_pinned BOOLEAN DEFAULT FALSE,     -- Pinned posts show at top
+  
+  -- Audit
+  created_by VARCHAR(64) NOT NULL,     -- Admin wallet address
+  created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+  updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+);
+
+-- User What's New reads (tracking which users have seen which posts)
+CREATE TABLE IF NOT EXISTS user_whats_new_reads (
+  id SERIAL PRIMARY KEY,
+  user_id INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  post_id INTEGER NOT NULL REFERENCES whats_new_posts(id) ON DELETE CASCADE,
+  read_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+  
+  -- Prevent duplicates
+  UNIQUE(user_id, post_id)
+);
+
+-- What's New indexes
+CREATE INDEX IF NOT EXISTS idx_whats_new_posts_published 
+  ON whats_new_posts(is_published, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_whats_new_posts_pinned 
+  ON whats_new_posts(is_pinned, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_user_whats_new_reads_user 
+  ON user_whats_new_reads(user_id);
+CREATE INDEX IF NOT EXISTS idx_user_whats_new_reads_post 
+  ON user_whats_new_reads(post_id);
+
+-- Function to update updated_at timestamp for whats_new_posts
+CREATE OR REPLACE FUNCTION update_whats_new_updated_at()
+RETURNS TRIGGER AS $$
+BEGIN
+  NEW.updated_at = NOW();
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+-- Trigger to auto-update updated_at
+DROP TRIGGER IF EXISTS whats_new_posts_updated_at ON whats_new_posts;
+CREATE TRIGGER whats_new_posts_updated_at
+  BEFORE UPDATE ON whats_new_posts
+  FOR EACH ROW
+  EXECUTE FUNCTION update_whats_new_updated_at();
+
+-- ============================================
+-- 9. DEVELOPER API PLATFORM
+-- ============================================
+
+-- Developer accounts (linked to Solana wallet)
+CREATE TABLE IF NOT EXISTS developer_accounts (
+  id SERIAL PRIMARY KEY,
+  wallet_address VARCHAR(44) UNIQUE NOT NULL,
+  display_name VARCHAR(100),
+  email VARCHAR(255),
+  commission_wallet VARCHAR(44) NOT NULL,
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Developer apps (each gets API keys)
+CREATE TABLE IF NOT EXISTS developer_apps (
+  id SERIAL PRIMARY KEY,
+  developer_id INTEGER REFERENCES developer_accounts(id),
+  app_name VARCHAR(100) NOT NULL,
+  description TEXT,
+  website_url VARCHAR(500),
+  environment VARCHAR(10) DEFAULT 'sandbox',
+  status VARCHAR(20) DEFAULT 'active',
+  network_mode VARCHAR(10) DEFAULT 'open' CHECK (network_mode IN ('open', 'private')),
+  ui_config JSONB DEFAULT '{}',
+  resolution_secret VARCHAR(64),
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- API keys (sandbox + production per app)
+CREATE TABLE IF NOT EXISTS developer_api_keys (
+  id SERIAL PRIMARY KEY,
+  app_id INTEGER REFERENCES developer_apps(id),
+  key_prefix VARCHAR(20) NOT NULL,
+  key_hash VARCHAR(64) NOT NULL,
+  key_hint VARCHAR(8) NOT NULL,
+  environment VARCHAR(10) NOT NULL,
+  is_active BOOLEAN DEFAULT TRUE,
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  last_used_at TIMESTAMPTZ
+);
+
+-- Track which games came from which developer app
+CREATE TABLE IF NOT EXISTS developer_game_attributions (
+  id SERIAL PRIMARY KEY,
+  game_id VARCHAR(100) NOT NULL,
+  app_id INTEGER REFERENCES developer_apps(id),
+  developer_id INTEGER REFERENCES developer_accounts(id),
+  commission_wallet VARCHAR(44) NOT NULL,
+  created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- API usage logs for rate limiting and analytics
+CREATE TABLE IF NOT EXISTS developer_api_logs (
+  id SERIAL PRIMARY KEY,
+  app_id INTEGER REFERENCES developer_apps(id),
+  endpoint VARCHAR(200) NOT NULL,
+  method VARCHAR(10) NOT NULL,
+  status_code INTEGER,
+  response_time_ms INTEGER,
+  created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Developer webhooks (outbound notifications)
+CREATE TABLE IF NOT EXISTS developer_webhooks (
+  id SERIAL PRIMARY KEY,
+  app_id INTEGER NOT NULL REFERENCES developer_apps(id) ON DELETE CASCADE,
+  url VARCHAR(500) NOT NULL,
+  secret VARCHAR(64) NOT NULL,
+  events TEXT[] NOT NULL DEFAULT '{}',
+  is_active BOOLEAN DEFAULT TRUE,
+  description VARCHAR(200),
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Developer webhook delivery logs
+CREATE TABLE IF NOT EXISTS developer_webhook_logs (
+  id SERIAL PRIMARY KEY,
+  webhook_id INTEGER NOT NULL REFERENCES developer_webhooks(id) ON DELETE CASCADE,
+  event VARCHAR(50) NOT NULL,
+  payload JSONB NOT NULL,
+  status_code INTEGER,
+  response_body TEXT,
+  attempts INTEGER DEFAULT 1,
+  success BOOLEAN DEFAULT FALSE,
+  error TEXT,
+  created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Developer app users (tracks which users authenticated through which app)
+CREATE TABLE IF NOT EXISTS developer_app_users (
+  developer_app_id INTEGER NOT NULL REFERENCES developer_apps(id) ON DELETE CASCADE,
+  user_id INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  first_seen_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  last_seen_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  PRIMARY KEY (developer_app_id, user_id)
+);
+
+-- Developer platform indexes
+CREATE INDEX IF NOT EXISTS idx_developer_accounts_wallet ON developer_accounts(wallet_address);
+CREATE INDEX IF NOT EXISTS idx_api_keys_hash ON developer_api_keys(key_hash);
+CREATE INDEX IF NOT EXISTS idx_game_attributions_game ON developer_game_attributions(game_id);
+CREATE INDEX IF NOT EXISTS idx_game_attributions_app ON developer_game_attributions(app_id);
+CREATE INDEX IF NOT EXISTS idx_api_logs_app ON developer_api_logs(app_id, created_at);
+CREATE INDEX IF NOT EXISTS idx_webhooks_app ON developer_webhooks(app_id);
+CREATE INDEX IF NOT EXISTS idx_webhook_logs_webhook ON developer_webhook_logs(webhook_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_developer_app_users_app ON developer_app_users(developer_app_id);
+CREATE INDEX IF NOT EXISTS idx_developer_app_users_user ON developer_app_users(user_id);
+CREATE INDEX IF NOT EXISTS idx_developer_app_users_last_seen ON developer_app_users(developer_app_id, last_seen_at DESC);
+
+-- ============================================
+-- 10. MIGRATIONS (Add missing columns to existing tables)
+-- ============================================
+
+-- Add buy_in column to user_game_refs if it doesn't exist
+DO $$ 
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns 
+    WHERE table_name = 'user_game_refs' AND column_name = 'buy_in'
+  ) THEN
+    ALTER TABLE user_game_refs ADD COLUMN buy_in NUMERIC(20, 9);
+  END IF;
+
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns 
+    WHERE table_name = 'user_game_refs' AND column_name = 'won_game'
+  ) THEN
+    ALTER TABLE user_game_refs ADD COLUMN won_game BOOLEAN DEFAULT false;
+  END IF;
+END $$;
+
+-- Add check constraint for preferred_currency if it doesn't exist
+DO $$ 
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.table_constraints 
+    WHERE constraint_name = 'check_preferred_currency'
+  ) THEN
+    ALTER TABLE users
+    ADD CONSTRAINT check_preferred_currency 
+    CHECK (preferred_currency IN ('USD', 'EUR', 'CAD', 'GBP', 'JPY', 'AUD', 'CHF', 'CNY', 'SEK', 'NZD'));
+  END IF;
+END $$;
+
+-- Add comment for preferred_currency column
+COMMENT ON COLUMN users.preferred_currency IS 'User preferred display currency (3-letter code)';
+
+-- Add notification tracking columns to games table if they don't exist
+DO $$ 
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns 
+    WHERE table_name = 'games' AND column_name = 'lock_notification_sent_10min'
+  ) THEN
+    ALTER TABLE games ADD COLUMN lock_notification_sent_10min BOOLEAN DEFAULT false;
+  END IF;
+
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns 
+    WHERE table_name = 'games' AND column_name = 'lock_notification_sent_now'
+  ) THEN
+    ALTER TABLE games ADD COLUMN lock_notification_sent_now BOOLEAN DEFAULT false;
+  END IF;
+
+  -- Add matchup_image_url column for pre-generated S3 matchup images
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_name = 'games' AND column_name = 'matchup_image_url'
+  ) THEN
+    ALTER TABLE games ADD COLUMN matchup_image_url TEXT;
+  END IF;
+
+  -- Add draw_team_players column for EPL/soccer draw betting
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_name = 'games' AND column_name = 'draw_team_players'
+  ) THEN
+    ALTER TABLE games ADD COLUMN draw_team_players TEXT[] DEFAULT '{}';
+  END IF;
+
+  -- Add Connect4 specific columns
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_name = 'games' AND column_name = 'game_status'
+  ) THEN
+    ALTER TABLE games ADD COLUMN game_status VARCHAR(50);
+  END IF;
+
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_name = 'games' AND column_name = 'connect4_board'
+  ) THEN
+    ALTER TABLE games ADD COLUMN connect4_board JSONB;
+  END IF;
+
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_name = 'games' AND column_name = 'connect4_current_turn'
+  ) THEN
+    ALTER TABLE games ADD COLUMN connect4_current_turn VARCHAR(10);
+  END IF;
+
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_name = 'games' AND column_name = 'connect4_winner'
+  ) THEN
+    ALTER TABLE games ADD COLUMN connect4_winner VARCHAR(10);
+  END IF;
+
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_name = 'games' AND column_name = 'connect4_winning_cells'
+  ) THEN
+    ALTER TABLE games ADD COLUMN connect4_winning_cells JSONB;
+  END IF;
+
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_name = 'games' AND column_name = 'claim_signature'
+  ) THEN
+    ALTER TABLE games ADD COLUMN claim_signature TEXT;
+  END IF;
+
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_name = 'games' AND column_name = 'completed_at'
+  ) THEN
+    ALTER TABLE games ADD COLUMN completed_at TIMESTAMP;
+  END IF;
+
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_name = 'games' AND column_name = 'invited_player'
+  ) THEN
+    ALTER TABLE games ADD COLUMN invited_player VARCHAR(255);
+  END IF;
+END $$;
+
+-- Add indexes for Connect4 columns
+CREATE INDEX IF NOT EXISTS idx_games_game_status ON games(game_status);
+CREATE INDEX IF NOT EXISTS idx_games_type_status ON games(game_type, game_status);
+CREATE INDEX IF NOT EXISTS idx_games_invited_player ON games(invited_player) WHERE invited_player IS NOT NULL;
+
+-- ============================================
+-- 11. FOREIGN KEY CONSTRAINTS
+-- ============================================
+
+-- Add foreign keys if they don't exist
+DO $$ 
+BEGIN 
+  -- Chat messages reply_to_id
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.table_constraints 
+    WHERE constraint_name = 'chat_messages_reply_to_id_fkey'
+  ) THEN
+    ALTER TABLE chat_messages 
+    ADD CONSTRAINT chat_messages_reply_to_id_fkey 
+    FOREIGN KEY (reply_to_id) REFERENCES chat_messages(id) ON DELETE SET NULL;
+  END IF;
+
+  -- Chat reactions message_id
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.table_constraints 
+    WHERE constraint_name = 'chat_reactions_message_id_fkey'
+  ) THEN
+    ALTER TABLE chat_reactions 
+    ADD CONSTRAINT chat_reactions_message_id_fkey 
+    FOREIGN KEY (message_id) REFERENCES chat_messages(id) ON DELETE CASCADE;
+  END IF;
+
+  -- Chat notifications message_id
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.table_constraints 
+    WHERE constraint_name = 'chat_notifications_message_id_fkey'
+  ) THEN
+    ALTER TABLE chat_notifications 
+    ADD CONSTRAINT chat_notifications_message_id_fkey 
+    FOREIGN KEY (message_id) REFERENCES chat_messages(id) ON DELETE CASCADE;
+  END IF;
+END $$;
+
+-- ============================================
+-- 12. INDEXES FOR PERFORMANCE
+-- ============================================
+
+-- Users indexes
+CREATE INDEX IF NOT EXISTS idx_users_wallet ON users(wallet_address);
+CREATE INDEX IF NOT EXISTS idx_users_username ON users(username);
+CREATE INDEX IF NOT EXISTS idx_users_referral_code ON users(referral_code);
+CREATE INDEX IF NOT EXISTS idx_users_telegram_user_id ON users(telegram_user_id) WHERE telegram_user_id IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_users_preferred_currency ON users(preferred_currency);
+
+-- Push subscriptions indexes
+CREATE INDEX IF NOT EXISTS idx_push_subscriptions_user_id ON push_subscriptions(user_id);
+
+-- Auth indexes
+CREATE INDEX IF NOT EXISTS idx_nonces_expires ON auth_nonces(expires_at);
+CREATE INDEX IF NOT EXISTS idx_user_sessions_wallet ON user_sessions(wallet_address);
+CREATE INDEX IF NOT EXISTS idx_user_sessions_token_hash ON user_sessions(token_hash);
+CREATE INDEX IF NOT EXISTS idx_user_sessions_expires ON user_sessions(expires_at);
+
+-- User badges indexes
+CREATE INDEX IF NOT EXISTS idx_user_badges_user_id ON user_badges(user_id);
+CREATE INDEX IF NOT EXISTS idx_user_badges_type ON user_badges(badge_type);
+CREATE INDEX IF NOT EXISTS idx_user_badges_earned ON user_badges(earned_at DESC);
+
+-- Chat indexes
+CREATE INDEX IF NOT EXISTS idx_chat_timestamp ON chat_messages(timestamp DESC);
+CREATE INDEX IF NOT EXISTS idx_chat_wallet ON chat_messages(wallet_address);
+CREATE INDEX IF NOT EXISTS idx_chat_user_id ON chat_messages(user_id);
+CREATE INDEX IF NOT EXISTS idx_chat_reply_to ON chat_messages(reply_to_id);
+CREATE INDEX IF NOT EXISTS idx_chat_winner ON chat_messages(is_winner_announcement);
+CREATE INDEX IF NOT EXISTS idx_chat_game_invite ON chat_messages((game_invite_metadata->>'gameId')) WHERE game_invite_metadata IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_reactions_message ON chat_reactions(message_id);
+CREATE INDEX IF NOT EXISTS idx_relationships_user ON user_relationships(user_id);
+CREATE INDEX IF NOT EXISTS idx_relationships_type ON user_relationships(relationship_type);
+CREATE INDEX IF NOT EXISTS idx_notifications_user ON chat_notifications(user_id);
+CREATE INDEX IF NOT EXISTS idx_message_mentions_user ON message_mentions(mentioned_user_id);
+CREATE INDEX IF NOT EXISTS idx_message_mentions_message ON message_mentions(message_id);
+CREATE INDEX IF NOT EXISTS idx_payments_message ON chat_payments(message_id);
+CREATE INDEX IF NOT EXISTS idx_payments_sender ON chat_payments(sender_user_id);
+CREATE INDEX IF NOT EXISTS idx_payments_recipient ON chat_payments(recipient_user_id);
+CREATE INDEX IF NOT EXISTS idx_payments_signature ON chat_payments(transaction_signature);
+
+-- Games indexes
+CREATE INDEX IF NOT EXISTS idx_games_game_id ON games(game_id);
+CREATE INDEX IF NOT EXISTS idx_games_creator ON games(created_by);
+CREATE INDEX IF NOT EXISTS idx_games_status ON games(automatic_status);
+CREATE INDEX IF NOT EXISTS idx_user_game_refs_wallet ON user_game_refs(wallet_address);
+CREATE INDEX IF NOT EXISTS idx_user_game_refs_game ON user_game_refs(game_id);
+CREATE INDEX IF NOT EXISTS idx_audit_logs_user ON audit_logs(user_id);
+CREATE INDEX IF NOT EXISTS idx_audit_logs_type ON audit_logs(log_type);
+
+-- Social indexes
+CREATE INDEX IF NOT EXISTS idx_friends_user ON friends(user_wallet);
+CREATE INDEX IF NOT EXISTS idx_friends_status ON friends(status);
+CREATE INDEX IF NOT EXISTS idx_friend_requests_from ON friend_requests(from_user_id);
+CREATE INDEX IF NOT EXISTS idx_friend_requests_to ON friend_requests(to_user_id);
+CREATE INDEX IF NOT EXISTS idx_friend_requests_status ON friend_requests(status);
+CREATE INDEX IF NOT EXISTS idx_group_members_group ON group_members(group_id);
+CREATE INDEX IF NOT EXISTS idx_group_members_user ON group_members(user_id);
+
+-- Player stats indexes
+CREATE INDEX IF NOT EXISTS idx_player_stats_pnl ON player_stats(net_pnl DESC);
+CREATE INDEX IF NOT EXISTS idx_player_stats_wagered ON player_stats(total_wagered DESC);
+CREATE INDEX IF NOT EXISTS idx_player_history_wallet ON player_history(wallet_address, timestamp DESC);
+CREATE INDEX IF NOT EXISTS idx_player_history_round ON player_history(round_id);
+
+-- Keeper indexes
+CREATE INDEX IF NOT EXISTS idx_keeper_actions_round ON keeper_actions(round_id);
+CREATE INDEX IF NOT EXISTS idx_keeper_health_round ON keeper_health(round_id);
+CREATE INDEX IF NOT EXISTS idx_keeper_rounds_state ON keeper_rounds(state);
+
+-- ============================================
+-- 13. VIEWS FOR MONITORING
+-- ============================================
+
+-- Stuck rounds view (for keeper monitoring)
+CREATE OR REPLACE VIEW stuck_rounds AS
+SELECT 
+  round_id,
+  state,
+  entries_count,
+  last_action,
+  (NOW() - last_action) as time_stuck
+FROM keeper_rounds
+WHERE state IN ('open', 'locked')
+  AND (NOW() - last_action) > INTERVAL '10 minutes'
+ORDER BY last_action ASC;
+
+-- Keeper health summary
+CREATE OR REPLACE VIEW keeper_health_summary AS
+SELECT 
+  DATE(created_at) as date,
+  check_type,
+  status,
+  COUNT(*) as count
+FROM keeper_health
+WHERE created_at > NOW() - INTERVAL '7 days'
+GROUP BY DATE(created_at), check_type, status
+ORDER BY date DESC, check_type;
+
+-- ============================================
+-- 14. SUMMARY
+-- ============================================
+
+-- Show all tables
+\echo '✅ Database schema setup complete!'
+\echo ''
+\echo 'Tables created:'
+SELECT table_name 
+FROM information_schema.tables 
+WHERE table_schema = 'public' 
+  AND table_type = 'BASE TABLE'
+ORDER BY table_name;
+
+\echo ''
+\echo 'Views created:'
+SELECT table_name 
+FROM information_schema.views 
+WHERE table_schema = 'public'
+ORDER BY table_name;
+
+\echo ''
+\echo '🎉 All done! Your database is ready for the DUBS server.'
+