nostrstack-lightning

Integrate LNbits payment flows into nostrstack with regtest and smoke tests.

Updated Dec 31, 2025
One-click install
npx skills add https://github.com/joelklabo/markdowntown-cli --skill nostrstack-lightning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nostrstack-lightning
Source: https://github.com/joelklabo/markdowntown-cli/tree/main/codex/skills/nostrstack-lightning
Command: npx skills add https://github.com/joelklabo/markdowntown-cli --skill nostrstack-lightning

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Integrates LNbits-backed Lightning payment flows into the nostrstack codebase to make payment, zap, and webhook behavior testable and observable across regtest, staging, and production environments.

Core Features & Use Cases

  • Regtest and E2E testing: Guidance for enabling regtest payments and running LNbits smoke and end-to-end pay-to-act tests to validate settlement and zap flows.
  • Staging and production ops: Notes for configuring LNbits, Postgres, and containerized deployments while preserving observability and secret handling.
  • Developer workflows: Practical checks to ensure webhook flow and payment state transitions remain intact when editing provider code or API payment logic.

Quick Start

Review references/regtest-flows.md and references/testing.md, enable the regtest flags in API and gallery, set LNBITS_URL and LNBITS_ADMIN_KEY, and run the LNbits smoke test to verify end-to-end payment settlement.

Frequently Asked Questions about nostrstack-lightning

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

FAQPage Schema
How do I test Lightning payment flows using LNbits and regtest?

To test Lightning payment flows using LNbits and regtest, enable regtest flags in your API and gallery, set LNBITS_URL and LNBITS_ADMIN_KEY, and run the LNbits admin-key smoke test to verify end-to-end payment settlement.

What's the best way to preserve webhook state transitions when editing LNbits payment logic?

To preserve webhook state transitions when editing LNbits provider code or API payment logic, follow the regtest and environment documentation and run practical developer checks to ensure webhook flows and payment state transitions remain intact.

How do I configure LNbits for staging and production deployments?

Configure LNbits for staging and production by setting up Postgres and containerized deployments while preserving observability and secret handling to maintain secure LNbits Lightning workflows.

Why do my regtest payments fail to settle in nostrstack?

Regtest payments fail to settle when regtest flags are misaligned between API and gallery components. Align the flags in both, set LNBITS_URL and LNBITS_ADMIN_KEY, and run the LNbits smoke test to validate settlement.

Can I validate zaps and payment observability across different environments?

You can validate zaps and payment observability across regtest, staging, and production by integrating LNbits-backed Lightning payment flows into your codebase and running end-to-end pay-to-act tests.

Do I need an admin key to run LNbits smoke tests?

Yes, you need to set LNBITS_ADMIN_KEY alongside LNBITS_URL to run LNbits admin-key smoke tests for end-to-end verification of payment settlement and zap flows.