Playground
The Playground source demonstrates passkey and policy flows in a browser. Its previous public relayer dependency is currently unavailable, so a hosted end-to-end transfer is not claimed on this page.
For a complete payment path that works today, run the Stellar x402 quickstart. It starts the facilitator, Bazaar, gateway, and dedicated Stellar Playground locally.
What's in the playground
| File | What it does |
|---|---|
src/main.ts | Browser flow for passkey registration, policy confirmation, and relayer submission when a relayer URL is configured. |
src/policies.ts | Example policy: per-tx max value with a label. Edit and re-run to see the transfer get rejected. |
src/trace-view.ts | Renders a signed-trace stub inline so you can see exactly what got recorded. |
README.md | Step-by-step walkthrough mirroring the Developer Quickstart. |
Five-minute path
- Click Open the playground ↗ above.
- When Stackblitz finishes booting, hit the Run button (or wait for autorun).
- In the preview pane, click 1. Register passkey - your browser prompts for FaceID/TouchID.
- Click 2. Confirm policy - confirms the per-transaction maximum the Playground will enforce.
- Relayer submission requires a separately configured, reachable relayer. Check service status before expecting an on-chain result.
When you're ready to leave the sandbox
- Wire it into your own project: Developer Quickstart
- Understand what just happened: Core Concepts
- Build an agent on top of it: Agent Payments guide
- Tune the policies: Spending Limits · Governance / Approvals
Current availability
The former public relayer and Developer Portal hostnames are reserved but not currently deployed. Do not use them as SDK defaults. Run a relayer you control, or use the self-hosted Stellar evaluator while the public services are being restored.