UltimaLotto SDK Documentation

Appearance

Changelog ​

Phase 6 — Integration Sandbox ​

  • Rate limiting — 60 req/min public, 120 req/min authenticated; X-RateLimit-* response headers
  • Webhook testing tool — POST /api/operator/test-webhook and POST /api/operator/test-webhook/all for integration verification
  • Webhook delivery logs — GET /api/operator/webhook-logs to inspect delivery status
  • Sandbox environment — Auto-scheduled rounds, test operators, full lifecycle simulation
  • Reference operator — Complete example implementation with manifest builder, webhooks, heartbeats
  • RPC retry logic — Exponential backoff (3 attempts) on all blockchain RPC calls
  • GitHub Actions CI — Automated TypeScript + Solidity test suite on every PR

Phase 5 — Production Infrastructure ​

  • JWT authentication — POST /api/auth/operator/login, refresh, logout
  • PostgreSQL storage — Swappable backend for production scale
  • Real RPC integration — Chain health monitoring, block hash retrieval, gas estimation
  • Admin dashboard — Round management, operator management, application review

Phase 4 — Revenue Engine ​

  • Operator application flow — POST /api/public/apply, GET /api/public/application-status/:id
  • Application approval — Admin approve/reject with API key issuance
  • 4-way on-chain split — 5% Ultima, 9% operators, 1% bonus, 85% winner
  • Commission claims — Proportional operator pool distribution

Phase 3 — Chain Expansion ​

  • Multi-chain support — Ethereum, Base, Arbitrum, Polygon, BNB Chain, Avalanche
  • Batch anchoring — Gas-optimized Merkle batch submission (80–97% savings)
  • Chain health monitoring — Auto-pause, fallback routing
  • Universal verification — UL1:{roundId}:{seed}:{manifest} compact format

Phase 2 — Operator Infrastructure ​

  • Operator registry — On-chain UltimaRegistry, bonds, attestation
  • Reputation scoring — Algorithmic 0–100 score from escrow, payout, exclusion, heartbeat
  • Webhook dispatcher — HMAC-SHA256 signed push notifications
  • Operator SDK — TypeScript client with retry, manifest builder, heartbeat monitor

Phase 1 — Core Protocol ​

  • Round lifecycle — DRAFT → OPEN → SEALING → ANCHORED → ESCROWED → WAITING → DRAWN → SETTLING → SETTLED → CLOSED
  • Manifest aggregation — Hierarchical Merkle tree, two-phase anchoring
  • Multi-chain randomness — Draw seed from 3 BTC + 3 ETH block hashes
  • Client-side verification — Full pipeline from public data
  • Operator escrow — Full-deposit model, settlement proof, challenge window, direct claims