aperture
بواسطة roasbeef
Health & Fitnessموجز
Install and run Aperture, the L402 Lightning reverse proxy from Lightning Labs.
الوصف
ما الذي تفعله هذه المهارة
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.
متى تستخدمها
- 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
مثال على سير العمل
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
المتطلبات
- Running LND node connected to the Lightning Network
- invoice.macaroon credential from LND
التثبيت
clawhub install roasbeef/apertureشغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.