Skip to content

Add lnurlmint v0.2.0 - #842

Open
bitkarrot wants to merge 7 commits into
lnbits:mainfrom
bitkarrot:add-lnurlmint-v0.1.2
Open

bitkarrot wants to merge 7 commits into
lnbits:mainfrom
bitkarrot:add-lnurlmint-v0.1.2

Conversation

@bitkarrot

@bitkarrot bitkarrot commented Aug 31, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Adds lnurlmint v0.2.0 to the vetted extensions registry — updated from the earlier v0.1.3 entry.

lnurlmint implements LUD-25 lnurlcash, letting each LNbits wallet run its own mint of Lightning-funded bearer notes. Notes circulate offline as lnurlw:// withdraw links and can be rotated, split, merged, or melted back into a BOLT-11 payment. A port of the standalone lnurl-mint app into the LNbits extension model.

v0.2.0 highlights (protocol sync with upstream v0.12.0)

  • Taproot protocol: notes are taproot output keys — cp1 keys, ck1 key-path spends, cw1 script-path spends, cs1 certificates (offline verification)
  • Username registration: signed cx1 registers <user>@<mint> lightning addresses that mint onto derived branches
  • NIP-05 (nostr.json) and NIP-57 zaps (description-hash-bound invoices, kind-9735 receipts)
  • Security: atomic note/pending-mint collision checks, settle-mint CAS race fix, verify-disclosure fix for legacy records, duplicate-melt rejection
  • Mint upgrades automatically — migration m004 rekeys existing notes to hex(Q); legacy preimage-keyed notes stay redeemable
  • No new required dependencies — optional lnurlcashkernel (Linux) adds arbitrary tapscript verification; ck1/bearer cw1 verify natively via coincurve

Manifest

Verification

  • python3 check.py lnurlmint passes (hash match, icon OK, min_lnbits_version match)
  • Archive excludes tests/, .planning/, .claude/ via .gitattributes export-ignore
  • Archive contains mandatory files: LICENSE, README.md, __init__.py, config.json, manifest.json
  • details_link points to the repo config.json
  • Extension test suite: 294 passing (13 kernel-only tests skipped without lnurlcashkernel)

Test plan

  • python3 check.py lnurlmint from a clean checkout of this PR

Register lnurlmint (LUD-25 lnurlcash) — mint Lightning-funded bearer
notes per-wallet. Notes circulate offline as lnurlw:// withdraw links
and can be rotated, split, merged, or melted back to a BOLT-11 payment.
The jmeter CI hardcoded lnbits/lnbits-extensions in the
LNBITS_EXTENSIONS_MANIFESTS raw URL, so fork PRs 404 because the
branch only exists in the fork, not upstream.

Use github.event.pull_request.head.repo.full_name (falls back to
github.repository for push events) and github.event.pull_request.head.ref
(falls back to github.ref_name) so the manifest is fetched from the
correct repo for fork PRs.
@bitkarrot

This comment was marked as resolved.

@bitkarrot bitkarrot changed the title Add lnurlmint v0.1.2 Add lnurlmint v0.1.3 Sep 2, 2026
@bitkarrot
bitkarrot enabled auto-merge (squash) September 5, 2026 01:52
@bitkarrot bitkarrot changed the title Add lnurlmint v0.1.3 Add lnurlmint v0.2.0 Sep 29, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant