Testing & Examples

Upside includes a local game loader so you can embed a localhost game in the real parent shell before the game is approved for production discovery.

Local Iframe Testing

The test route is:

text
https://upside.win/test/games/{BASE64_URL}

{BASE64_URL} is your game URL encoded as base64.

bash
pnpm dev# game frontend available at http://localhost:3000

bash
node -e 'console.log(Buffer.from("http://localhost:3000").toString("base64"))'

text
https://upside.win/test/games/aHR0cDovL2xvY2FsaG9zdDozMDAw

Encoding Examples

Manual Bridge Test

Add temporary logging during local development.

ts
window.addEventListener("message", event => {  console.log("[upside message]", event.origin, event.data);});window.parent.postMessage({ type: "ready" }, "https://upside.win");

You should see a parent message containing balance, token, and locale. If you do not, verify that:

• The iframe route actually loaded your game URL.
• Your game sent ready after registering the listener.
• Your browser did not block localhost networking.
• Your message handler is checking https://upside.win, not your localhost origin.

Backend Smoke Test

Before wiring full gameplay, add a temporary authenticated route that calls checkAuth and getBalance.

ts
app.post("/api/upside-smoke-test", async c => {  const b3Jwt = c.req.header("Authorization")?.replace(/^Bearer\s+/i, "");  if (!b3Jwt) return c.json({ error: "Missing token" }, 401);  const auth = await upsideGameAction(c.env, b3Jwt, { trigger: "checkAuth" });  const balance = await upsideGameAction(c.env, b3Jwt, { trigger: "getBalance" });  return c.json({ auth, balance });});

Call it from your iframe with the token received from Upside:

ts
await fetch("/api/upside-smoke-test", {  method: "POST",  headers: { Authorization: `Bearer ${token}` },});

Complete Coin Flip Payloads

placeBet

json
{  "trigger": "placeBet",  "gameType": "coin-flip",  "sessionId": "coin-flip-2026-05-09T20-15-30Z-01",  "gameId": "round-01",  "betAmount": "1000000000000000000"}

processPayout Win

json
{  "trigger": "processPayout",  "gameType": "coin-flip",  "sessionId": "coin-flip-2026-05-09T20-15-30Z-01",  "payoutAmount": "2000000000000000000",  "result": "win",  "gameData": {    "prediction": "heads",    "result": "heads"  }}

processPayout Loss

json
{  "trigger": "processPayout",  "gameType": "coin-flip",  "sessionId": "coin-flip-2026-05-09T20-15-30Z-01",  "payoutAmount": "0",  "result": "loss",  "gameData": {    "prediction": "heads",    "result": "tails"  }}

Troubleshooting

Pre-Launch Review