Core LNURL
LNURL Server for Core Lightning
A lightweight Go application that enables Lightning Network invoice generation through Core Lightning's REST API using the LNURL-Pay protocol.
What is Core LNURL?
Core LNURL is a self-custodial LNURL server designed to work with Core Lightning (CLN) nodes. It provides a simple HTTP endpoint that generates Lightning invoices dynamically, making it easy to accept Lightning payments without giving up control of your funds.
Unlike custodial services, Core LNURL runs on your own infrastructure, communicating directly with your Core Lightning node via its REST API. This means you maintain full sovereignty over your Bitcoin while providing a clean LNURL interface for payments.
⚡ Built for Self-Sovereignty
Core LNURL is open source and self-hosted. No third-party dependencies, no custodial risks—just you and your Lightning node.
Lightning Integration
- ✓ Dynamic invoice generation
- ✓ Direct CLN REST API integration
- ✓ LNURL-Pay protocol compatible
- ✓ Works with any LNURL wallet
- ✓ Unique invoices per request
- ✓ Configurable payment amounts
Security & Setup
- ✓ Runes-based authentication
- ✓ Restricted command permissions
- ✓ Configurable ports and URLs
- ✓ Simple YAML configuration
- ✓ Pre-built binaries available
- ✓ Minimal attack surface
🔧 How It Works
Setup Your Node
Run a Core Lightning node with REST API enabled. Create a rune (restricted auth token) that allows only invoice generation.
Configure & Deploy
Edit the YAML config with your node URL, rune, and server port. Run the pre-built binary or build from source.
Accept Payments
Share your LNURL endpoint. Wallets scan it, request an invoice, and you receive payments directly to your node.
📡 API Endpoint
GET /lnurl/pay
Accepts username and amount parameters, returns a Lightning payment request.
https://your-server.com/lnurl/pay?username=satoshi&amount=1000The server communicates with your Core Lightning node's REST API to generate fresh invoices on each request.
⚙️ Requirements
Infrastructure
- • Bitcoin full node (Bitcoin Core, etc.)
- • Core Lightning node with open channels
- • CLN REST server enabled
- • Server or VPS to host the LNURL server
Configuration
- • Rune with invoice generation permissions
- • YAML config file with node details
- • Domain or IP for public access
- • Optional: Reverse proxy for HTTPS
Get Started with Core LNURL
Core LNURL is open source and built for Lightning node operators who value self-custody. Pre-built binaries available for Linux, macOS, and Windows.
License: MIT • Language: Go • Status: Production Ready