Skip to main content

​
Perché il DNS discovery

Gli agenti con accesso a Internet possono risolvere il DNS prima di effettuare qualsiasi richiesta HTTP. Se pubblichi il tuo endpoint L402 come record DNS TXT, gli agenti lo scoprono automaticamente — anche prima di raggiungere la tua API.

​
Formato del record TXT

l402._payment.yourdomain.com  TXT  "v=l402 endpoint=https://api.yourdomain.com/data price=10sat docs=https://yourdomain.com/docs"
Campi:
  • v=l402 — identificatore del protocollo
  • endpoint= — il tuo URL protetto da L402
  • price= — prezzo in sats (opzionale, informativo)
  • docs= — link alla tua documentazione (opzionale)

​
Configurazione su Cloudflare

  1. Vai su Cloudflare Dashboard → DNS
  2. Aggiungi un nuovo record:
TypeNameContentTTL
TXTl402._paymentv=l402 endpoint=https://api.yourdomain.com/data price=10sat docs=https://yourdomain.com/docsAuto

​
Verifica con dig

dig TXT l402._payment.yourdomain.com

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

​
Come lo usano gli agenti

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

// L'agente risolve il DNS per trovare il tuo endpoint
const endpoint = await discoverL402Endpoint("yourdomain.com");
// Restituisce: "https://api.yourdomain.com/data"

const result = await client.fetch(endpoint);

​
Il record di l402-kit

L’esempio seguente utilizza un dominio fittizio (api.example.com) per illustrare il formato — sostituiscilo con il tuo endpoint reale. 
dig TXT l402._payment.l402kit.com
# v=l402 endpoint=https://api.example.com/api/demo price=1sat docs=https://docs.l402kit.com

​
Vantaggi

  • Zero overhead HTTP — scoperta prima di qualsiasi chiamata API
  • Nativo per gli agenti — il DNS è il modo in cui le macchine trovano i servizi, non gli esseri umani
  • Nessuna chiave API necessaria — scoperta completamente aperta
  • Memorizzabile nella cache — il TTL controlla la frequenza con cui gli agenti ri-risolvono
Consulta .well-known/agent.json per lo standard di scoperta HTTP complementare.