Boltar — LNbits extension

A paid tarot reading experience powered by Lightning and WASM.
Pay sats, draw cards, and receive a deterministic Bitcoin-flavored fortune.

Boltar is a WASM extension for LNbits. It creates incoming Lightning invoices, watches payment settlement, then generates a tarot reading from the paid invoice hash.

---

Quick Links

• Overview
• Features
• Usage
• Spread Types
• Sharing Readings
• WASM Build
• Permissions
• Terms
• Powered by LNbits

Overview

Boltar gives creators and communities a playful pay-per-reading flow:

• Visitors open a public page
• Choose a spread
• Pay a Lightning invoice
• Instantly receive a tarot reading

Every draw is deterministic and based on payment data, so the same paid reading key always resolves to the same spread output. Card data and artwork are served from the extension itself. WebLLM interpretations are enabled by default and run in the visitor's browser when supported; if module or model loading is blocked or unavailable, Boltar sends the deterministic reading.

Features

• Paid tarot draws — Lightning invoice required per reading
• Three spreads — one card, three cards, or Celtic cross
• Configurable prices — admin-set sats pricing for each spread
• Optional reversed cards — toggle reversed meaning on/off
• Public share links — every paid reading gets a shareable URL
• WASM-native logic — invoice + draw flow runs via the LNbits WASM host
• Local card artwork — full 78-card deck bundled with the extension
• Browser AI first — WebLLM interpretations are attempted in capable browsers and fall back to deterministic text

Usage

1. Enable the boltar extension in LNbits.
2. Open Boltar from your extensions menu.
3. In Settings, choose the wallet to receive reading payments.
4. Set sats prices for:
   • One card
   • Three cards
   • Celtic cross
5. Optionally toggle Allow reversed cards.
6. Optionally disable Try browser WebLLM interpretations.
7. Click Save.
8. Click Open public reader and share that URL.

On the public page:

1. Visitor chooses a spread.
2. Boltar creates a Lightning invoice.
3. After payment confirmation, Boltar generates and stores the reading.
4. Visitor can open or share the final reading page.

Spread Types

• One Card — quick signal for the moment
• Three Cards — past, present, future
• Celtic Cross — ten-card deep reading

Sharing Readings

• Admins can open recent readings from the extension dashboard.
• Public readers can share reading pages by URL.
• Reading pages include built-in actions for copy/share/export image in the UI.

WASM Build

Build the extension WebAssembly module from the Rust source:

cd lnbits/extensions/boltar
make build-wasm

This compiles wasm/rust-example and updates:

• wasm/module.wasm

Permissions

Boltar requests narrow permissions for invoice and reading flow:

• ext.db.read_write — store settings and reading data
• api.POST:/api/v1/payments (payments_out: false) — create incoming invoices only
• ext.payments.watch — detect when reading invoices are paid

WebLLM

WebLLM is enabled by default. Boltar attempts to load the pinned @mlc-ai/web-llm browser module and model artifacts in supported browsers, then falls back to deterministic text on any loading or generation error. This never changes the paid reading payload, share URL, or deterministic card text. Deployments that require fully same-origin AI assets should vendor the WebLLM runtime and model files or disable this option.

Card Artwork Credits

Tarot card images are adapted from Luciella Elisabeth Scarlett's Rider Waite Smith Tarot Cards (CC0), via geraldfingburke/plateau-tarot-api (Unlicense). Card details in that source were prepared by Josh Petty at BrainJar Games.

Terms

Boltar is for entertainment only. Tarot readings are generated deterministically from payment data and should not be treated as financial, legal, medical, or life advice.

---

Powered by LNbits

LNbits empowers developers and communities with modular, open-source tools for building Bitcoin-based systems.