Agent SDK — Schnellstart

Lassen Sie Ihren KI-Agenten L402-geschützte APIs automatisch bezahlen. Blink oder Alby Wallet, Budgetkontrolle, MCP und LangChain bereit.

Was dies bewirkt

l402-kit enthält einen integrierten Client, der jedem KI-Agenten — oder jedem Skript — ermöglicht, L402-geschützte APIs aufzurufen, ohne die Zahlungsschleife selbst schreiben zu müssen.

Agent  →  GET /api/data
API    →  402 + BOLT11 invoice
Agent  →  pay invoice (Blink / Alby)
Agent  →  GET /api/data  Authorization: L402 macaroon:preimage
API    →  200 ✓

Alles dazwischen — Invoice-Parsing, Wallet-Aufruf, Wiederholung — wird automatisch verarbeitet.

---

Node.js / TypeScript

1. Installieren

npm install l402-kit

2. Wallet auswählen

Blink

Zugangsdaten unter dashboard.blink.sv → API Keys erhalten.

import { L402Client, BlinkWallet } from "l402-kit";

const client = new L402Client({
  wallet: new BlinkWallet(
    process.env.BLINK_API_KEY!,
    process.env.BLINK_WALLET_ID!,
  ),
  budgetSats: 1000, // max spend per session
});

const res = await client.fetch("https://api.example.com/premium");
const data = await res.json();
console.log(data);

Alby

Ihr Zugriffstoken unter getalby.com → Settings → Access Tokens erhalten.

import { L402Client, AlbyWallet } from "l402-kit";

const client = new L402Client({
  wallet: new AlbyWallet(process.env.ALBY_TOKEN!),
  budgetSats: 1000,
});

const res = await client.fetch("https://api.example.com/premium");
const data = await res.json();
console.log(data);

---

Python

1. Installieren

pip install l402kit

2. Die API aufrufen

Blink

import os
from l402kit import L402Client
from l402kit.wallets import BlinkWallet

client = L402Client(
    wallet=BlinkWallet(os.environ["BLINK_API_KEY"], os.environ["BLINK_WALLET_ID"]),
    budget_sats=1000,
    on_spend=lambda sats, url: print(f"Paid {sats} sats → {url}"),
)

r = client.get("https://api.example.com/premium")
print(r.json())

Alby

import os
from l402kit import L402Client
from l402kit.wallets import AlbyWallet

client = L402Client(
    wallet=AlbyWallet(os.environ["ALBY_TOKEN"]),
    budget_sats=1000,
)

r = client.get("https://api.example.com/premium")
print(r.json())

---

Was Schritt für Schritt passiert

1. client.fetch / client.get sendet die Anfrage ohne einen Auth-Header
2. Gibt die API 402 zurück, liest der Client die invoice und das macaroon aus dem Antwort-Body (oder dem WWW-Authenticate-Header)
3. Es wird das Budget geprüft — wirft BudgetExceededError, wenn der Preis das Limit überschreiten würde
4. Es wird wallet.payInvoice(bolt11) aufgerufen und auf das preimage gewartet
5. Die Anfrage wird erneut gesendet mit Authorization: L402 <macaroon>:<preimage>
6. Gibt die endgültige Response/httpx.Response an Ihren Code zurück

Kein 402? Die Antwort wird unverändert durchgeleitet.

---

Ausgabenbericht

// TypeScript
const report = client.spendingReport();
// { total: 42, remaining: 958, byDomain: { "api.example.com": 42 }, transactions: [...] }

# Python
report = client.spending_report()
print(f"Spent {report.total} sats, {report.remaining} remaining")

---

Nächste Schritte

Wallets

Blink, Alby — vollständige Einrichtung und Optionen

Budgetkontrolle

Domain-spezifische Limits, Callbacks, Berichte

MCP Server

Claude Desktop-Integration in 2 Minuten

LangChain

Plug-in-Werkzeug für LangChain-Agenten