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运行 CLI 命令,或把这段提示词粘贴到 Claude Code、Cursor、Codex 或你在用的任意编程智能体里。