What You Can Build
- Games that verify player activity and settle rewards in USDC
- Payment flows that combine verification, routing, and programmable payment links
- Cross-chain USDC movement through sw4p across supported chains
- Interactive stream surfaces, overlays, and live participation modules
- Bots, agents, and automations that react to REST and live SSE events
Choose Your Starting Point
Build a game
Use GameHarness and VAP to integrate verified gameplay, scoring, and reward accrual.Build payment flows
Use AGG, Hyperlink, and sw4p to route and move value.Build bots and automations
Use the REST API and SSE stream to react to live system events.Build on-chain
Use the Solana / Anchor program layer for rewards, escrow, and lottery logic.API Overview
Most integrations start the same way: authenticate with SIWS, keep the session cookie, use REST for actions, and SSE for live state. Base URL:https://api.rndrntwrk.com
Authentication: SIWS (Sign In With Solana):
POST /auth/nonce— request a sign-in nonce- Sign the nonce with a Solana wallet
POST /auth/verify— submit signed message, receive session cookie- Include the session cookie on all subsequent requests
| Group | What It Covers |
|---|---|
| Authentication | Nonce, verify, logout, social linking |
| Arcade and Gaming | Score submission, game state, per-game leaderboards, stats |
| Battles | Create, join, and track PvP matches |
| Lottery | Create rounds, buy tickets, finalize draws, audit trails |
| Leaderboards | Global, per-game, quest, and referral rankings |
| Rewards | Claim USDC, Merkle proofs, epoch management, projected earnings |
| Referrals | Generate links, bind codes, track performance |
| Profile and Tasks | User profile, daily tasks, payment history |
| Events and SSE | Real-time event stream, burn events |
| Quests | List quests, track progress, check multipliers |
| Social | Twitter webhook, social sharing data |
| Clips | Upload and list gameplay clips |
| Eligibility and Config | Token-gate checks, normalization config, game registry |
Integrate a Game
GameHarness is the fastest path for integrating a game into RNDRNTWRK. Your game is responsible for:- Gameplay logic
- Event emission
- Score-producing actions
- Session lifecycle
- VAP connection
- Hashing and signing flow
- Verifier submission
- Reward accrual hooks based on normalization settings
SCORE_UPDATE, ENEMY_KILL, etc.) and the harness aggregates them into a Merkle root. The session key signs the root and the signed payload is sent to the VAP Verifier.
Score normalization maps all games to a 0 to 10,000 scale. Normalization config is managed at the protocol level. See Arcade Overview for the current normalization rules and scoring model.
Verification, Routing, and Settlement
Four components handle verification, routing, and settlement across the network. Each has a distinct role.VAP — Verifiable Attention Protocol
VAP verifies participation.- Ed25519 challenge-response sessions
- WebSocket heartbeat at 5-second intervals
- Session lifecycle: connect, challenge, sign, verify, accumulate
AGG — Payment Aggregator
AGG routes and settles supported payment flows inside the protocol.- Solana-native settlement via Jupiter (live)
- HTTP 402 (Payment Required) standard support
Status: Solana-native settlement is live. Cross-chain routing via CCTP V2 is in development. See AGG.
Hyperlink — Smart Payment Links
Hyperlink creates programmable payment surfaces.- Generate payment links programmatically
- Embedded wallets, analytics, and social attribution
- See Hyperlink
sw4p — Cross-Chain USDC Movement
sw4p is the dedicated cross-chain USDC movement surface. Use sw4p when your application needs USDC to move between supported chains without wrapped assets or liquidity-pool dependencies.- Burn — USDC is burned on the source chain
- Attest — Circle’s attestation service verifies the burn
- Mint — Native USDC is minted on the destination chain
- TypeScript:
@sw4p/bridge(npm) - Rust:
sw4p-bridge(crates.io) - Full docs: sw4p Documentation Site
Real-Time Events (SSE)
Use SSE when your application needs live state without polling. Subscribe toGET /events for a persistent SSE connection. Authentication follows the same SIWS session model as the REST API.
Event categories:
| Category | Examples |
|---|---|
| Gameplay | new_entry, score updates, game state changes |
| Chat | chat_message, moderation events |
| Round state | Round transitions, winner announcements |
| Rewards | Claim events, epoch transitions |
| System | Burn events, system notifications |
text/event-stream with typed JSON payloads.
Reconnection should be handled client-side. Events are delivered in order within each category.
Protocol Programs and Settlement Logic (Solana / Anchor)
The protocol includes Anchor-based Solana programs that handle on-chain settlement and reward distribution.- Rewards program:
commit_epoch→fund_vault→claim_rewardpipeline - 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
Start integrating against the live endpoints.
Protocol Overview
Understand how verification, routing, and settlement fit together.
sw4p
Build cross-chain USDC movement into your application.
Architecture
See how the system is wired across client, service, agent, and chain layers.
See also: Security & Fairness · API Usage & Proxying · Arcade Overview