Build Lightning payment UX in Workshop #8

Closed
opened 2026-03-18 22:01:01 +00:00 by hermes · 1 comment
Collaborator

Context

When a visitor wants to talk to Timmy, they need to pay via Lightning. The payment
flow should be seamless and integrated into the 3D experience.

Requirements

Session Mode (Primary UX — Mode 2)

  1. Visitor clicks "Enter the Workshop" or similar CTA
  2. UI shows session creation: deposit amount selector (100-10000 sats)
  3. Lightning invoice QR code displayed (overlaid on 3D scene)
  4. WebSocket listens for payment confirmation
  5. On payment: QR dissolves, session activates, chat opens
  6. Balance displayed as HUD element
  7. Low balance warning + top-up flow

Per-Job Mode (Fallback — Mode 1)

  1. User submits question
  2. Eval invoice (10 sats) displayed
  3. After payment: eval runs, work invoice displayed
  4. After payment: result streams in

QR Code

  • Generate client-side (qrcode.js or similar)
  • Also show BOLT11 string (copy-to-clipboard)
  • "Open in wallet" deep link for mobile

Acceptance Criteria

  • Session creation flow works end-to-end with stub mode
  • QR code renders correctly and is scannable
  • BOLT11 copy-to-clipboard works
  • WebSocket receives payment confirmation
  • Balance HUD updates in real-time
  • Top-up flow works
  • Graceful handling of expired invoices

References

  • Parent epic: #{epic_num}
## Context When a visitor wants to talk to Timmy, they need to pay via Lightning. The payment flow should be seamless and integrated into the 3D experience. ## Requirements ### Session Mode (Primary UX — Mode 2) 1. Visitor clicks "Enter the Workshop" or similar CTA 2. UI shows session creation: deposit amount selector (100-10000 sats) 3. Lightning invoice QR code displayed (overlaid on 3D scene) 4. WebSocket listens for payment confirmation 5. On payment: QR dissolves, session activates, chat opens 6. Balance displayed as HUD element 7. Low balance warning + top-up flow ### Per-Job Mode (Fallback — Mode 1) 1. User submits question 2. Eval invoice (10 sats) displayed 3. After payment: eval runs, work invoice displayed 4. After payment: result streams in ### QR Code - Generate client-side (qrcode.js or similar) - Also show BOLT11 string (copy-to-clipboard) - "Open in wallet" deep link for mobile ## Acceptance Criteria - [ ] Session creation flow works end-to-end with stub mode - [ ] QR code renders correctly and is scannable - [ ] BOLT11 copy-to-clipboard works - [ ] WebSocket receives payment confirmation - [ ] Balance HUD updates in real-time - [ ] Top-up flow works - [ ] Graceful handling of expired invoices ## References - Parent epic: #{epic_num}
hermes added the frontendintegration labels 2026-03-18 22:01:01 +00:00
Owner

Resolved — Lightning payment UX built (payment.js panel, session panel)

✅ **Resolved** — Lightning payment UX built (payment.js panel, session panel)
This repo is archived. You cannot comment on issues.