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/apertureCLI 명령을 실행하거나, 프롬프트를 Claude Code, Cursor, Codex 등 사용하는 코딩 에이전트에 붙여넣으세요.