SDK · private pilot

The SDK

Ask for sats. Hand out prizes. Never hold a key.

The SDK is how a world asks your pocket for sats. It can ask; it can’t take.

  • You see every request, and you decide.
  • The world only moves when your answer is final.
  • A world can pay you back, too — you accept it where you stand.
  • Built for WebXR worlds; works on any web page. Same pocket, same allowance, same rules.

The whole API

await pocket.connect();                                   // on your Connect button

const r = await pocket.requestPay({ paymentRequest: invoice, amountSats: 21 });
if (r.settled) game.grantRound();                      // only a settled payment moves the game

const p = await pocket.receive({ token: prize });
if (p.result === 'accepted') hud.cheer();              // the player took the prize

// the shape of the SDK — a preview, not yet published

Walk through it step by step → How it works

The contract

  • Final answers only: settled with a reference, or a typed refusal — never half-done.
  • The allowance is the player’s: you never set it or spend past it; you can see what’s left, never change it.
  • Keys, PIN, balance and history stay at wallet.satrium.org; your bundle carries no wallet code.
  • The same call on headset, phone and laptop; the panel adapts, your code doesn’t.
  • Your earnings land in a wallet you already own; Satrium holds nothing.
  • An XR session is never required: the same call works on your world’s flat pages.

When it says no

what happenedwhat your world should do
The player said nokeep playing; offer again later
More than they allowedsay so; they raise it in their pocket
Not connected yetshow Connect
Not enough in the pocketsay so; they top it up
The rail didn’t answernothing was sent; let them try again

Prizes work the same way: the player accepts or declines, and nothing moves until they do.

Already running in

  • private build

    Bit-Hunt

    The vault door costs 21 sats; the coin inside is a prize.

  • private build

    Sats Arena

    Rapid fire for 21 sats, for both players.

  • private build

    Ball Catch

    The Horror theme for 21 sats; a clean run pays you back.

  • private build

    The Atrium

    Satrium’s own hall; station 1 pays and pays back.

  • private build

    Bit-Hunt

    The vault door opens for 21 sats, and the coin inside is yours to keep.

  • private build

    Sats Arena

    Rapid fire for 21 sats, for you and your teammate.

  • private build

    Ball Catch

    Unlock the Horror theme for 21 sats; finish a clean run and it pays you back.

  • private build

    The Atrium

    Satrium’s own hall: station 1 takes 21 sats and hands a prize back.

Getting in

The SDK is in a private pilot. Send your world’s link, your engine (three.js, A-Frame, Babylon…), and what you’d charge for.

Request SDK access

The road to open

  1. 1proof ✓
  2. 2hands-on for invited builders
  3. 3public pocket after an external review
  4. 4free and open source: the pocket and the SDK (@satrium/*)

full status →

See how it works →