L402 — Lightning-Zahlungen
Was ist L402?
L402 (früher LSAT) nutzt Bitcoins Lightning Network für sofortige API-Zahlungen. Der Server stellt ein Macaroon (einen Bearer-Token) zusammen mit einer Lightning-Invoice aus — sobald der Agent die Invoice bezahlt, wird das Macaroon gültig.
So funktioniert es
- Der Agent sendet einen Request an einen kostenpflichtigen Endpoint
- Der Server antwortet mit HTTP 402 und
WWW-Authenticate: L402 macaroon="...", invoice="..." - Der Agent bezahlt die Lightning-Invoice
- Der Agent wiederholt den Request mit dem bezahlten Macaroon als Nachweis (
Authorization: L402 macaroon:preimage) - Der Server verifiziert das Macaroon und antwortet
Zentrale Konzepte
- Macaroon: Ein kryptografischer Bearer-Token, der gültig wird, sobald die zugehörige Invoice bezahlt ist
- Lightning-Invoice: Eine einmalige BOLT11-Zahlungsaufforderung im Lightning Network von Bitcoin
- Preimage: Der Zahlungsnachweis, der beim Settlement einer Lightning-Invoice offengelegt wird
- Sofortiges Settlement: Lightning-Zahlungen werden in Millisekunden bestätigt
- Bitcoin-nativ: Zahlungen erfolgen in Satoshis (1 sat = 0.00000001 BTC)
So fügst du L402 zu deinem Service hinzu
- Betreibe einen Lightning-Node (LND, CLN) oder nutze einen Lightning Service Provider
- Erzeuge für jeden kostenpflichtigen Request ein Paar aus Macaroon + Lightning-Invoice
- Gib 402 zurück mit
WWW-Authenticate: L402 macaroon="<base64>", invoice="<bolt11>" - Verifiziere beim erneuten Versuch das Macaroon und prüfe das Preimage der Invoice
Reifegrad der Spezifikation
Etabliert. Ursprünglich von Lightning Labs als LSAT entwickelt, dann in L402 umbenannt. Wird von mehreren Lightning-basierten APIs in Produktion genutzt.