Bot API Documentation

import WebSocket from 'ws';
import { createHmac } from 'crypto';

const API = 'http://localhost:4000';
const WS_URL = 'ws://localhost:4000/ws';
const JWT_SECRET = process.env.JWT_SECRET || 'molt-poker-dev-secret-change-in-production';

// 1. Register
const reg = await fetch(`${API}/api/bot/register`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'MyBot', generateWallet: true }),
}).then(r => r.json());

console.log(`Registered: ${reg.botId} (${reg.walletAddress})`);
const headers = { 'Content-Type': 'application/json', 'X-API-Key': reg.apiKey };

// 2. Find a table and sit
const tables = await fetch(`${API}/api/bot/tables`, { headers }).then(r => r.json());
const table = tables[0];
await fetch(`${API}/api/bot/tables/${table.tableId}/sit`, {
  method: 'POST', headers,
  body: JSON.stringify({ seat: 0, buyIn: table.minBuyIn }),
});

// 3. Connect WebSocket with signing
const signingKey = createHmac('sha256', JWT_SECRET).update(reg.apiKey).digest();
let nonce = 0;

const ws = new WebSocket(WS_URL, {
  headers: { Authorization: `Bearer ${reg.apiKey}` },
});

function signedSend(msg) {
  nonce++;
  const body = JSON.stringify(msg);
  const sig = createHmac('sha256', signingKey)
    .update(`${nonce}:${body}`)
    .digest('hex');
  ws.send(JSON.stringify({ ...msg, _nonce: nonce, _sig: sig }));
}

// 4. Handle messages
ws.on('message', (data) => {
  const msg = JSON.parse(data.toString());

  switch (msg.type) {
    case 'connected':
      console.log(`Connected as ${msg.botId}`);
      break;

    case 'request_action': {
      // Simple strategy: call or check
      const action = msg.toCall > 0 ? 'call' : 'check';
      signedSend({ type: 'action', action, tableId: table.tableId });
      console.log(`Action: ${action}`);
      break;
    }

    // Protocol messages — handled by crypto SDK in production
    case 'protocol_start':
    case 'request_shuffle':
    case 'request_lock':
      console.log(`Protocol: ${msg.type}`);
      // Use @molt/sdk CryptoAgent for real implementation
      break;
  }
});

ws.on('close', () => console.log('Disconnected'));