Skip to main content

​
Warum DNS Discovery

Agenten mit Internetzugang können DNS auflösen, bevor sie eine HTTP-Anfrage stellen. Wenn du deinen L402-Endpunkt als DNS-TXT-Eintrag veröffentlichst, entdecken ihn Agenten automatisch — noch bevor sie deine API aufrufen.

​
TXT-Eintragsformat

l402._payment.yourdomain.com  TXT  "v=l402 endpoint=https://api.yourdomain.com/data price=10sat docs=https://yourdomain.com/docs"
Felder:
  • v=l402 — Protokollkennung
  • endpoint= — deine L402-geschützte URL
  • price= — Preis in sats (optional, informativ)
  • docs= — Link zu deiner Dokumentation (optional)

​
Einrichtung auf Cloudflare

  1. Gehe zu Cloudflare Dashboard → DNS
  2. Füge einen neuen Eintrag hinzu:
TypeNameContentTTL
TXTl402._paymentv=l402 endpoint=https://api.yourdomain.com/data price=10sat docs=https://yourdomain.com/docsAuto

​
Überprüfung mit dig

dig TXT l402._payment.yourdomain.com

# Erwartete Ausgabe:
# l402._payment.yourdomain.com. 300 IN TXT "v=l402 endpoint=https://api.yourdomain.com/data price=10sat docs=..."

​
Wie Agenten es verwenden

import { discoverL402Endpoint } from "l402-kit/agent";

// Agent löst DNS auf, um deinen Endpunkt zu finden
const endpoint = await discoverL402Endpoint("yourdomain.com");
// Gibt zurück: "https://api.yourdomain.com/data"

const result = await client.fetch(endpoint);

​
Eigener Eintrag von l402-kit

Das folgende Beispiel verwendet eine fiktive Domain (api.example.com), um das Format zu veranschaulichen — ersetze sie durch deinen tatsächlichen Endpunkt. 
dig TXT l402._payment.l402kit.com
# v=l402 endpoint=https://api.example.com/api/demo price=1sat docs=https://docs.l402kit.com

​
Vorteile

  • Kein HTTP-Overhead — Entdeckung vor jedem API-Aufruf
  • Agenten-nativ — DNS ist die Art und Weise, wie Maschinen Dienste finden, nicht Menschen
  • Kein API-Schlüssel erforderlich — vollständig offene Entdeckung
  • Cachebar — TTL steuert, wie oft Agenten erneut auflösen
Siehe .well-known/agent.json für den ergänzenden HTTP-Discovery-Standard.