ngx-l402 — an nginx module that puts a Lightning paywall (L402) in front of
any HTTP API.
Two directives:
l402 on;
l402_amount_msat_default 1000;
A request without payment gets a 402 with a macaroon + BOLT-11 invoice. Pay,
retry with the preimage, get your 200.
Non-custodial by design: sats settle straight to your own node or Lightning
address. No account, no intermediary, nothing routed through us.
Lightning backends: LND, CLN, Eclair, LNURL, NWC, BOLT12, LNC.
Cashu eCash works too — the client sends a token in the X-Cashu header
instead of paying an invoice. Proofs verify offline via NUT-12 DLEQ, so
there's no round-trip to the mint on the request path. Bearer, unlinkable,
and skipping the invoice round-trip makes it the fastest path of the lot.
It also publishes a capability manifest at /.well-known/l402-services, so
agents can discover your routes and prices and pay — no API key, no signup.
Live demo, 1 sat and learn more at: https://ngx-l402.org
Code (MIT): https://github.com/ngx-l402/ngx-l402
The repo is mirrored on Nostr via ngit (gitworkshop.dev) and release
binaries are on Blossom. GitHub flagged the org twice, so the project is
built to survive being deplatformed.
repo on ngit:- https://gitworkshop.dev/npub1qnw27f2jsqvn05wzpd56m7ykgmepk57p0yrzw8fzc7lfhjkmjmqqmd9r6h/relay.ngit.dev/ngx-l402
Release on blossom: https://nostr.download/03b6473139813e3c06361da15803a61e4c9f86111413a2467227825ed72b093d.gz
#bitcoin #lightning #l402
npub1qn…d9r6h
2026-07-23 10:03:34 UTC
Author Public Key
npub1qnw27f2jsqvn05wzpd56m7ykgmepk57p0yrzw8fzc7lfhjkmjmqqmd9r6hSeen on
wss://nos.lolPublished at
2026-07-23 10:03:34 UTCEvent JSON
{
"id": "78fa21bda254299d7e691500550f75d073bc412d8c20079b22667bd678032ace",
"pubkey": "04dcaf2552801937d1c20b69adf89646f21b53c17906271d22c7be9bcadb96c0",
"created_at": 1784801014,
"kind": 1,
"tags": [
[
"p",
"04dcaf2552801937d1c20b69adf89646f21b53c17906271d22c7be9bcadb96c0",
"",
"mention"
],
[
"t",
"bitcoin"
],
[
"t",
"lightning"
],
[
"t",
"l402"
],
[
"client",
"Primal Android"
]
],
"content": "ngx-l402 — an nginx module that puts a Lightning paywall (L402) in front of\nany HTTP API.\n\nTwo directives:\n\n l402 on;\n l402_amount_msat_default 1000;\n\nA request without payment gets a 402 with a macaroon + BOLT-11 invoice. Pay,\nretry with the preimage, get your 200. \n\nNon-custodial by design: sats settle straight to your own node or Lightning\naddress. No account, no intermediary, nothing routed through us.\n\nLightning backends: LND, CLN, Eclair, LNURL, NWC, BOLT12, LNC.\n\nCashu eCash works too — the client sends a token in the X-Cashu header\ninstead of paying an invoice. Proofs verify offline via NUT-12 DLEQ, so\nthere's no round-trip to the mint on the request path. Bearer, unlinkable,\nand skipping the invoice round-trip makes it the fastest path of the lot.\n\nIt also publishes a capability manifest at /.well-known/l402-services, so\nagents can discover your routes and prices and pay — no API key, no signup.\n\nLive demo, 1 sat and learn more at: https://ngx-l402.org\nCode (MIT): https://github.com/ngx-l402/ngx-l402\n\nThe repo is mirrored on Nostr via ngit (gitworkshop.dev) and release\nbinaries are on Blossom. GitHub flagged the org twice, so the project is\nbuilt to survive being deplatformed.\n\nrepo on ngit:- https://gitworkshop.dev/npub1qnw27f2jsqvn05wzpd56m7ykgmepk57p0yrzw8fzc7lfhjkmjmqqmd9r6h/relay.ngit.dev/ngx-l402\n\nRelease on blossom: https://nostr.download/03b6473139813e3c06361da15803a61e4c9f86111413a2467227825ed72b093d.gz\n\n#bitcoin #lightning #l402 \n\n",
"sig": "3ee3aac793f4aa0d579e8104c0dc7b0bb65af53fa2e78e6eee7e3d79922ecc1ebd3ccdafb598b7394f2e94fd85be06f8458680ad0e365e5fa8525d6654f7535a"
}