Skip to main content

​
What You Can Build

  • Games that earn players real USDC through verified engagement
  • Payment flows using the 555x402 suite (VAP + AGG + Hyperlink)
  • Cross-chain USDC transfers via sw4p (Solana, Base, Polygon)
  • Stream overlays and interactive experiences via CTRL Panel
  • Bots and integrations via the REST API and SSE event stream

​
API Overview

Base URL: https://api.rndrntwrk.com Authentication: SIWS (Sign In With Solana):
  1. POST /auth/nonce — request a sign-in nonce
  2. Sign the nonce with a Solana wallet
  3. POST /auth/verify — submit signed message, receive session cookie
  4. Include the session cookie on all subsequent requests
Format: JSON REST for requests/responses. SSE for real-time events. Endpoint domains:
DomainDescription
AuthenticationNonce, verify, logout, social linking
Arcade & GamingScore submission, game state, per-game leaderboards, stats
BattlesCreate, join, and track PvP matches
LotteryCreate rounds, buy tickets, finalize draws, audit trails
LeaderboardsGlobal, per-game, quest, and referral rankings
RewardsClaim USDC, Merkle proofs, epoch management, projected earnings
ReferralsGenerate links, bind codes, track performance
Profile & TasksUser profile, daily tasks, payment history
Events & SSEReal-time event stream, burn events
QuestsList quests, track progress, check multipliers
SocialTwitter webhook, social sharing data
ClipsUpload and list gameplay clips
Eligibility & ConfigToken-gate checks, normalization config, game registry
Full reference: API Reference

​
Integrate a Game

Add a game to the 555 Arcade using the Game Harness:
  1. Wrap your game in the <GameHarness> React component
  2. The harness manages the VAP lifecycle: connect → play → hash → sign → transmit
  3. Your game engine emits events (SCORE_UPDATE, ENEMY_KILL, etc.); the harness aggregates them into a Merkle root
  4. The user’s session key signs the root; the signed payload is sent to the VAP Verifier
  5. Points accrue automatically per the normalization config (all games normalize to a 0–10,000 scale)
<GameHarness appId="your-game-id" onSessionStart={handleStart}>
  <YourGameComponent />
</GameHarness>
Score normalization, beta mode scaling, daily bonuses, and leaderboard integration are handled by the protocol — your game only needs to emit score events.

​
Use the Payment Stack (555x402)

​
VAP — Verifiable Attention Protocol

Cryptographic proof of engagement via Ed25519 challenge-response sessions:
  • WebSocket heartbeat at 5-second intervals
  • Session lifecycle: connect → challenge → sign → verify → accumulate
  • Proof of Engagement records are anchored on-chain
Status: VAP v1 is live. VAP v2 (cNFT minting, on-chain Proof of Engagement tokens) is in design. See VAP and VAP v2.

​
AGG — Payment Aggregator

Routes payments across chains with Solana finality:
  • Solana-native settlement via Jupiter (live)
  • HTTP 402 (Payment Required) standard support
  • Cross-chain routing via CCTP V2 (planned)
Status: Partially Implemented — Solana-native settlement is live. Cross-chain routing via CCTP V2 is in development. See AGG.
Payment links with embedded wallets, analytics, and social attribution:
  • Generate payment links programmatically
  • Track conversions and attribution
  • See Hyperlink

​
Cross-Chain with sw4p

sw4p bridges USDC across Solana, Base, and Polygon using Circle CCTP V2:
  1. Burn — USDC is burned on the source chain
  2. Attest — Circle’s attestation service verifies the burn
  3. Mint — Native USDC is minted on the destination chain
No wrapped tokens. No liquidity pools. 5 independent security audits. Gasless via Kora. SDKs:

​
Real-Time Events (SSE)

Subscribe to GET /events for a persistent SSE connection:
  • Event types: new_entry, chat_message, round state transitions, winner announcements, burn events, system notifications
  • Format: text/event-stream with typed JSON payloads
  • Use SSE instead of polling for all real-time updates

​
On-Chain Programs (Solana/Anchor)

The protocol includes Anchor-based Solana programs:
  • Rewards program: commit_epoch → fund_vault → claim_reward pipeline
  • Merkle-tree distribution for provable USDC payouts
  • PDA-based escrow for tournament prizes and lottery pools
  • On-chain randomness via Switchboard VRF for lottery draws

​
Go Deeper

API Reference

Complete endpoint reference with auth, params, and response formats.

Protocol Overview

VAP, AGG, and Hyperlink protocol specification.

sw4p

Cross-chain USDC bridge reference and SDK docs.

Architecture

System architecture and component map.
See also: Security & Fairness · API Usage & Proxying · Arcade Overview