Skip to main content

​
DNS ディスカバリーを使う理由

インターネットアクセスを持つエージェントは、HTTP リクエストを行う前に DNS を解決できます。L402 エンドポイントを DNS TXT レコードとして公開すると、エージェントは自動的に検出できます — API にアクセスする前でも同様です。

​
TXT レコードの形式

l402._payment.yourdomain.com  TXT  "v=l402 endpoint=https://api.yourdomain.com/data price=10sat docs=https://yourdomain.com/docs"
フィールド:
  • v=l402 — プロトコル識別子
  • endpoint= — L402 で保護された URL
  • price= — sats 単位の価格（任意、参考情報）
  • docs= — ドキュメントへのリンク（任意）

​
Cloudflare でのセットアップ

  1. Cloudflare ダッシュボード → DNS に移動します
  2. 新しいレコードを追加します:
タイプ名前コンテンツTTL
TXTl402._paymentv=l402 endpoint=https://api.yourdomain.com/data price=10sat docs=https://yourdomain.com/docsAuto

​
dig で確認する

dig TXT l402._payment.yourdomain.com

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

​
エージェントの利用方法

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

// Agent resolves DNS to find your endpoint
const endpoint = await discoverL402Endpoint("yourdomain.com");
// Returns: "https://api.yourdomain.com/data"

const result = await client.fetch(endpoint);

​
l402-kit 自身のレコード

以下の例では、形式を説明するために架空のドメイン（api.example.com）を使用しています — 実際のエンドポイントに置き換えてください。 
dig TXT l402._payment.l402kit.com
# v=l402 endpoint=https://api.example.com/api/demo price=1sat docs=https://docs.l402kit.com

​
メリット

  • HTTP オーバーヘッドゼロ — API コールの前にディスカバリーが完了
  • エージェントネイティブ — DNS は人間ではなくマシンがサービスを見つける仕組み
  • API キー不要 — 完全にオープンなディスカバリー
  • キャッシュ可能 — TTL によってエージェントの再解決頻度を制御
補完的な HTTP ディスカバリー標準については .well-known/agent.json を参照してください。