aperture
oleh roasbeef
Health & FitnessRingkasan
Install and run Aperture, the L402 Lightning reverse proxy from Lightning Labs.
Deskripsi
Apa yang Dilakukan Skill Ini
Aperture is a reverse proxy implementing the L402 protocol, which gates HTTP access to backend services behind Lightning Network micropayments. It handles the full challenge-response flow: issuing macaroons and invoices on first request, then validating payment proofs before proxying to your backend.
Aperture is the reference L402 implementation from Lightning Labs, so it handles the full macaroon-and-invoice challenge flow without requiring custom auth logic in each backend service.
Kapan Menggunakannya
- Protecting a REST API so callers pay per request in satoshis
- Hosting paid data endpoints that other agents fetch using lnget
- Testing L402 authentication flows against a local backend
- Setting per-path prices and rate limits on an existing HTTP service
- Running a payment-gated proxy on testnet before mainnet deployment
Contoh Alur Kerja
User asks: set up a paid endpoint at /api/data that charges 100 satoshis per request
- 1
Run install.sh to install the aperture binary via go install
- 2
Run setup.sh to generate ~/.aperture/aperture.yaml pointing to the local lnd node
- 3
Edit the config to add a service entry for /api/data with price: 100
- 4
Run start.sh to launch aperture as a background process
- 5
Test with lnget -k --no-pay to confirm the 402 challenge and invoice are returned
Aperture is running on localhost:8081, returning HTTP 402 with a Lightning invoice for any request to /api/data
Persyaratan
- Running LND node connected to the Lightning Network
- invoice.macaroon credential from LND
Instalasi
clawhub install roasbeef/apertureJalankan perintah CLI-nya, atau tempel prompt ke Claude Code, Cursor, Codex, atau coding agent apa pun yang Anda pakai.