skills.rest
PerceptLabs
PerceptLabsCOMMUNITY
Explore all skills by this author →
GitHub

lightning-address

Convert Lightning addresses into BOLT11 invoices via the LNURL-pay workflow.

Updated Dec 31, 2025
Search Tags:#invoice-generation#address-validation#lnurl-pay#wallet-integration#lightning-address#qr-code
One-click install
npx skills add https://github.com/PerceptLabs/mvmnt --skill lightning-address
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lightning-address
Source: https://github.com/PerceptLabs/mvmnt/tree/main/skills/lightning-address
Command: npx skills add https://github.com/PerceptLabs/mvmnt --skill lightning-address

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers integrating Lightning addresses often struggle to resolve an address to a live LNURL-pay endpoint and generate valid BOLT11 invoices. This Skill provides a complete pattern for validating addresses, resolving endpoints, enforcing min/max amounts, attaching optional comments, and retrieving invoices via the callback URL.

Core Features & Use Cases

  • Address validation: Ensure Lightning addresses follow the username@domain format before any network calls.
  • LNURL-pay resolution: Resolve to a pay metadata endpoint and read min/max bounds and callback URL.
  • Invoice generation: Request a BOLT11 invoice from the provider with the desired amount and optional comment.
  • UI integration: Support displaying the address in a wallet UI and generating QR codes for easy payments.
  • Use Case: Build a payment flow in a wallet app that reads an address, asks for an amount within provider limits, optionally includes a note, and presents a ready-to-pay invoice.

Quick Start

  • Validate the Lightning address with isValidLightningAddress(address).
  • Resolve the address to LNURL-pay metadata via resolveLightningAddress(address).
  • Ensure amount is within min/max bounds and optionally include a comment.
  • Call getInvoiceFromLightningAddress with the address, amountSats, and optional comment to obtain a BOLT11 invoice.

Frequently Asked Questions about lightning-address

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a Lightning address to a BOLT11 invoice?▼

To convert a Lightning address to a BOLT11 invoice, validate the address format, resolve it to an LNURL-pay endpoint to read min/max bounds, and retrieve the invoice via the callback URL with your desired amount.

What is the LNURL-pay workflow for wallet integration?▼

The LNURL-pay workflow involves resolving a Lightning address to a pay metadata endpoint, validating the requested amount against provider limits, and fetching a spendable BOLT11 invoice through a callback URL.

How do I validate a Lightning address before making network calls?▼

You validate a Lightning address by ensuring it strictly follows the username@domain format before attempting any network requests or endpoint resolution.

Can I include a comment when generating an invoice from a Lightning address?▼

Yes, you can include an optional comment when requesting a BOLT11 invoice if the resolved LNURL-pay metadata indicates that comments are allowed by the provider.

How do I enforce amount limits when requesting a Lightning invoice?▼

You enforce amount limits by reading the min and max bounds from the resolved LNURL-pay metadata and ensuring your requested amount in satoshis falls within those provider limits.

Does this Lightning address conversion process generate QR codes for UI integration?▼

Yes, the process supports wallet UI integration by providing the necessary address data and invoice results to generate QR codes for easy payments.

Related Skills

Explore More Software Engineering Skills→
MakePrismsMakePrisms
55

lnurl-test

Validate LNURL server endpoints for LUD-16, LUD-06, and LUD-21 flows.

Official
Intermediate
PerceptLabsPerceptLabs

lightning-invoice-decoder

Decode BOLT11 Lightning invoices to extract amounts in satoshis and validate format.

Community
Intermediate
lightninglabslightninglabs
57

taproot-assets-rpc

Authenticate and parse LND and Taproot Assets gRPC data in Go.

Official
Advanced
jholhewresjholhewres
3

payments

Facilitates payment processing via Stripe, PayPal, Lightning Network, Bitcoin, OpenNode, invoices, and charges.

Community
Advanced