Agent SDK — Démarrage rapide

Permettez à votre agent IA de payer automatiquement les API protégées par L402. Compatible avec les portefeuilles Blink ou Alby, contrôle du budget, prêt pour MCP et LangChain.

Ce que cela fait

l402-kit embarque un client intégré qui permet à n’importe quel agent IA — ou n’importe quel script — d’appeler des API protégées par L402 sans avoir à écrire vous-même la boucle de paiement.

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

Tout ce qui se passe entre les deux — analyse de la facture, appel au portefeuille, nouvelle tentative — est géré automatiquement.

---

Node.js / TypeScript

1. Installation

npm install l402-kit

2. Choisir un portefeuille

Blink

Obtenez vos identifiants sur dashboard.blink.sv → Clés API.

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

Obtenez votre jeton d’accès sur getalby.com → Paramètres → Jetons d’accès.

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. Installation

pip install l402kit

2. Appeler l’API

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())

---

Ce qui se passe étape par étape

1. client.fetch / client.get envoie la requête sans en-tête d’authentification
2. Si l’API renvoie 402, le client lit l’invoice et le macaroon depuis le corps de la réponse (ou l’en-tête WWW-Authenticate)
3. Il vérifie votre budget — lève une erreur BudgetExceededError si le prix dépasse la limite
4. Il appelle wallet.payInvoice(bolt11) et attend le preimage
5. Il relance la requête avec Authorization: L402 <macaroon>:<preimage>
6. Renvoie la Response/httpx.Response finale à votre code

Pas de 402 ? La réponse est transmise telle quelle.

---

Rapport de dépenses

// 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")

---

Prochaines étapes

Portefeuilles

Blink, Alby — configuration complète et options

Contrôle du budget

Limites par domaine, callbacks, rapports

Serveur MCP

Intégration Claude Desktop en 2 minutes

LangChain

Outil clé en main pour les agents LangChain