Lumière PayCheck

Lumière PayCheck

エージェントが x402 エンドポイントに支払う前にチェックします。

AI エージェントは x402 を使って、API の料金を自動で支払うようになりました。エンドポイントが価格とともに 402 Payment Required を返し、エージェントが USDC で支払うと、データを取得できます。この一連の流れでは、エンドポイントが動作するか、価格が適正か、支払い先のウォレットが本物かどうかは、エージェントには分かりません。

Lumière PayCheck は、これらの疑問に答えます。x402 Bazaar に掲載されたすべてのエンドポイントを監視して評価し、エージェントに 続行、注意、回避 の明確な判定を提示します。

🌐 公開サイト： https://lumierepaycheck.org · 🔌 MCP： https://lumierepaycheck.org/mcp?plans=1 · 📜 利用規約

このリポジトリは、ドキュメント、サンプル、フィードバックを公開する場所です。監視サービス自体はホストされており、ソースは非公開です。スコアリングの計算式は公開されています（以下を参照）。

---

機能

• x402 Bazaar 内のすべてのエンドポイントを監視します（上のバッジに表示される件数はリアルタイムの値で、新しいエンドポイントが掲載されると増加します）。30 分ごとに、価格の見積もり、支払い先ウォレット、稼働時間、応答時間を確認します。

• 通常のウォレット変更にペナルティを与えることなく、乗っ取りのリスクを検知します。支払い先ウォレットの変更はすべて、販売者自身が申告したウォレット、以前に使われたウォレット、変更前と変更後のウォレット間の直接送金と照合します。正当な変更は評価に影響しません。説明のつかない変更は、まず avoid と判定され、その後、人による確認を経て caution と判定されます。リクエストごとに新しいアドレスを使う販売者は、自動的に識別されます。仕組み。

• エージェント向けの支出ルール。 支払う前に、エージェントは「このエンドポイントに、この金額を、このウォレットへ支払ってもよいですか？」と確認し、理由とともに許可または拒否の判定を受け取ります。

• チーム向けのプラン。 スコープを指定したエージェントキー、日次・月次の支出上限、支払い前にウォレットで検証できる署名付きレシート、再生可能な監査証跡、異常に対する人による確認を利用できます。詳細。

• 支払いを行うエージェントの ID とアクセス管理。 Entra ID や Intune のように、AI エージェントに対応します。

  機能	内容	プラン
  PayCheck 外での支払い	エージェントのウォレットを登録します。エージェントが行うすべての x402 支払いを PayCheck の判定と照合し、確認を行わない支払い、拒否された後の支払い、承認額を超える支払いを通知します	すべて
  SDK による強制	withPayCheck(client, { agentKey }) は、PayCheck が拒否した支払いに署名せず、フェイルクローズで動作し、1 回限りのレシートを使用します	すべて
  エージェントの一覧	ステータス（active、idle、stale、expiring、frozen）、最終確認日時、クライアント、コンプライアンス、リスクを確認できます。CSV にも対応します	すべて
  エージェントの認証情報	オプトイン：エージェントは、認証済み企業に所属していることを販売者に証明できます。販売者は verifyAgentCredential() を使って無料で検証できます	Business+
  アクセスレビュー、一時的な上限、ポリシーテンプレート、リスクスコア	署名付きレポートによる維持・変更・取り消しのレビュー、期限付きの上限引き上げ、共有ルールセット、説明可能な Low／Medium／High のリスク評価を利用できます	Business+
  SSO と SCIM	Entra ID、Okta、Google Workspace でサインインできます。ユーザーは自動的にプロビジョニングされます	Enterprise
  API · 管理者向けガイド

• ファシリテーターのスクリーニング。 x402 ファシリテーターは、各支払いの決済前にスクリーニングできます。支払人と受取人の OFAC 制裁対象チェック、payTo が販売者の監視対象または申告済みウォレットではないかの確認、価格が見積もりを上回っていないかの確認を行います。月10,000回まで無料です。詳細。

• ウォレットのリスク。 どのウォレットに支払う場合も、1回の有料コールで OFAC 制裁対象のスクリーニング、支払い先ウォレットの履歴、乗っ取りの可能性を示すシグナルを確認します。

• アラート。 エンドポイントを監視し、停止、ウォレットの変更、価格の引き上げがあった場合に、署名付きウェブフックアラートを受け取れます。

• 有料配信チェック： エンドポイントが宣伝どおりの内容を返すことを確認する、小額の実際の支払いです。約2時間後の再テストでも失敗した場合に限り、失敗としてカウントします。また、入力不足を理由にエンドポイントが拒否したリクエストは、決してカウントしません。

• 既知の正解を使ったテスト：形だけではなく、値を検証します。 稼働状況やスキーマのチェックに合格していても、API が誤った数値を返すことがあります。正解がわかっているエンドポイントでは、検証者が正しい結果のわかっているコールに対して支払うか、独立したライブソースと比較し、値そのものを確認します。販売者は独自のテストを追加できます。仕組み。

• オンチェーンデータに基づく実際の利用状況： 30日間に各エンドポイントの支払い先ウォレットへ送られた実際の x402 支払い（Base および Solana 上の USDC）について、取引量、購入者数、通常および最大の支払額、傾向、購入者の集中度を確認できます。認定済みファシリテーターが送信した支払いのみをカウントします。

• 購入者レポート： 支払い後、すべてのエージェントが5つの簡単な質問に回答できます（レシート、またはオンチェーンで検証された支払いトランザクションを使用します。npm パッケージなら1行で記述できます：reportOutcome({ url, response, answers })）。確認が入るとエンドポイントの有料テストの順番が繰り上がり、重大な問題があれば再テストが行われます。評価が変わるのは、独自の有料テストで確認できた場合のみです。

アカウントも API キーも不要です。無料チェックは無料です。有料機能は、エージェントがほかのすべての支払いに使うのと同じ方法で、x402 によりコールごとに支払います。

クイックスタート

1. Claude、Cursor、または任意の MCP クライアントから

リモート MCP サーバーを追加します：

https://lumierepaycheck.org/mcp?plans=1

• Claude： Settings → Connectors → Add custom connector → URL を貼り付けます。
• Cursor など（mcp.json）：

  { "mcpServers": { "lumiere-paycheck": { "url": "https://lumierepaycheck.org/mcp?plans=1" } } }
  

ツール：check_payment、check_endpoint、report_outcome、top_endpoints、catalog_stats、get_full_report。

ローカルの stdio サーバーを使いたい場合は、packages/mcp-server で同じツールをマシン上で実行できます（node server.js、またはリポジトリの Dockerfile）。

2. x402 fetch クライアントにそのまま導入（npm）

npm i x402-paycheck @x402/fetch

import { x402Client, wrapFetchWithPayment } from "@x402/fetch";
import { withPayCheck } from "x402-paycheck";

const fetchWithPay = wrapFetchWithPayment(fetch, withPayCheck(new x402Client().register(/* your scheme */)));

すべての支払いは署名される前に PayCheck によってチェックされます。「いいえ」と判定された場合は、その理由とともに支払いを中止します。詳細：packages/x402-paycheck。

次に、エージェントの指示にルールを1つ追加します：

x402 エンドポイントに支払う前に、エンドポイントの URL、金額、402 の見積もりに含まれる payTo ウォレットを指定して、Lumière PayCheck の check_payment ツールを呼び出してください。allow が true の場合にのみ支払ってください。allow: false が返された場合は、支払わずに理由を伝えてください。支払い後は、レシート（または URL と支払い tx）と、支払った内容を受け取れたかどうかについての簡単な回答を指定して、report_outcome を呼び出してください。

3. コードから

// Before paying any x402 endpoint, ask Lumière PayCheck.
const res = await fetch("https://lumierepaycheck.org/v1/check-payment", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ url: target, amount: quote.amount, payTo: quote.payTo }),
});
const decision = await res.json();
if (!decision.allow) throw new Error(`Not paying ${target}: ${decision.reasons.join("; ")}`);
// ...then pay with your x402 client as usual

詳しくは examples/ をご覧ください。TypeScript、Python、curl、ウェブフックとレシートの検証、安全対策付きの支払い処理、プランの購入例があります。

## API

ルート	価格	機能
GET /v1/score?url=	無料	1 つのエンドポイントのスコア、評価、判定
POST /v1/check-payment	無料	支払いルール：理由とともに特定の支払いを許可／拒否
GET /v1/leaderboard?limit=	無料	評価上位のエンドポイント（ウォレットに関するインシデントなし）
GET /v1/stats	無料	カタログ件数と判定数
GET /v1/operators?limit=	無料	ドメイン別にまとめた販売者
GET /v1/usage?url=&days=	無料	1 つのエンドポイントの実際のオンチェーン利用状況：取引量、購入者数、推移
GET /v1/failures?url=	無料	過去 7 日間のすべてのチェック失敗：時刻、結果、HTTP ステータス、カウント対象かどうか
GET /v1/wallet-changes?url=	無料	過去 7 日間の支払いウォレットの変更と、レビュー結果（申告、販売者の履歴、オンチェーンの関連付け）
POST /v1/declaration	無料	販売者向け：申告した支払いウォレットを今すぐ読み取ってもらえます
POST /v1/report	無料	購入者向け：支払い後の報告（レシートまたは支払いトランザクション付き）
POST /v1/dispute · GET /v1/dispute?url=	無料	販売者向け：評価に異議を申し立てる、または異議申し立ての状況を確認する
GET /e?url=	無料	1 つのエンドポイントの公開ページ（チェック失敗のログを含む）
GET /badge?url=	無料	埋め込み可能な SVG バッジ
GET /v1/monitor	無料	モニターの健全性：ブロックしたホストを含む、直近のサイクルで確認された内容
GET /v1/status	無料	サービスのリアルタイム状況と過去 90 日間の稼働率
GET /v1/report?url=	$0.005	詳細レポート：スコアの内訳、現在の見積もり、ウォレットと価格の履歴
GET /v1/wallet-risk?address=	$0.01	ウォレットへの支払い前のリスク確認：OFAC 制裁、支払いウォレットの履歴、乗っ取りの可能性
POST /v1/score/batch	$0.01	1 回の呼び出しで最大 100 件のエンドポイントを評価
POST /v1/watch	$0.10	1 つのエンドポイントについて、署名付き Webhook アラートを 30 日間提供
POST /v1/seller-test	エンドポイントの価格	販売者向け：価格が $0.05 を超えるエンドポイントの有料再テストに資金を提供します（詳細）
GET /v1/plans	無料	プランカタログ
POST /v1/plans/builder · /business	$9 · $49	USDC（x402）でプランを購入、更新、アップグレードします。カード払い：/subscribe
POST /v1/authorize	プラン	エージェントキーで支払いを承認：許可／拒否／レビュー＋署名付きレシート
POST /v1/facilitator/screen	ファシリテータープラン	x402 ファシリテーター向けの決済前スクリーニング（月 10,000 件まで無料。その後は 1,000 件あたり $1.50）

無料ルートでは、クライアントごとに毎分 60 件、x-paycheck-key ヘッダーで無料 API キーを送信すると毎分 300 件までリクエストできます。MCP サーバーでは、毎分 300 回までツールを呼び出せます。有料ルートでは、Base または Solana 上の USDC を使用する x402 を利用します（どちらも同じ価格です。Solana ではファシリテーターが手数料を支払います）。監視対象外のエンドポイントへの照会は 404 を返し、料金は一切発生しません。完全なリファレンス： docs/api.md。

エージェントを運用するチーム向けのプラン

無料チェックは引き続き無料です。プランでは、支払いを行うエージェント向けの認可を追加できます。

	Builder	Business	Enterprise
価格	月額 $9	月額 $49	個別にお問い合わせください
エージェント用のスコープ付きキー（許可する販売者、支払いごとの上限、有効期限、失効、ローテーション）	3	25	カスタム
日次・月次の支出上限	✅	✅	✅
ツール境界での適用に使う署名付きレシート	✅	✅	✅
再生可能な監査証跡	30 日間	1 年間 + CSV	カスタム
異常（新しいウォレット、高額取引）の人による確認	—	✅	✅

こちらでBusiness を 30 日間無料でお試しいただけます。必要なのはメールアドレスだけで、カードは不要です。継続すると、ワークスペースとキーはそのまま引き継がれます。継続しない場合も、エージェントは無料の許可／拒否チェックを引き続き利用できます。

こちらでウェブサイトからカードで申し込めます。Stripe による月払いで、いつでも解約でき、アカウントは自動的に設定されます。その後、こちらでエージェントキー、上限、承認、請求などすべてを管理できます。開発者は x402 経由で USDC による支払いも可能です（30 日分の前払い、自動更新なし）。

エージェントは支払いのたびに POST /v1/authorize を呼び出し、理由とともに allow、deny、review のいずれかを受け取ります。allow の場合、その支払いに紐付けられた Ed25519 署名付きレシートが返されます。examples/guarded-pay.tsには、レシートがなければ署名を拒否する支払者の例があります。各判断は後から再生して、その理由を証明できます。

設定をお任せになりたいですか？ セットアップサービス（一回限りの料金 $750）では、エージェント、上限、承認ルールを設定し、予期せず何かがブロックされないよう、7 日間の監視のみの期間にエージェントを稼働させたうえで、チーム向けガイドとともに引き渡します。オプションの月次レビューは月額 $250 です。

完全なガイド： docs/subscriptions.md · 申し込み： lumierepaycheck.org/subscribe · USDC で支払う： examples/subscribe.ts

判定

判定	意味
proceed	スコア ≥ 75、ウォレット関連の問題なし、配信失敗なし
caution	スコア 40～74、または誰も確認できない出金ウォレットの変更が 24 時間続いた
avoid	スコア < 40、説明のない出金ウォレットの変更（最初の 24 時間、元に戻された場合、または申告済みウォレットでない場合）、または有料配信の失敗
free	支払いを求めずにデータを提供する
insufficient_data	これまでのチェックが 3 回未満

スコアの算出方法

決定論的で公開されています。誰も評価を上げるために支払うことはできません。

各評価の意味： A 支払い済みで、問題なく確実に配信された · B 支払い済みで配信されたが、注意点がある（掲載内容と異なる形に調整された、値に関する警告、稼働率 80～95％） · C 動作する可能性は高いが未確認（有料テスト未実施、個別のサインインが必要、稼働率 50～80％、未確認のウォレット変更） · D 掲載どおりには動作しないが、金銭的な損失は発生しない（支払い後のエラーだが請求なし、または掲載例の入力値に対して「見つかりません」と返される） · F 金銭がかかる、または安全でない（料金を受け取ったのに失敗、出金ウォレットの問題、稼働率 50％未満）。A/B = proceed、C/D = caution、F = avoid。

• 稼働率 40： 7 日間にエンドポイントが有効な支払い見積もりを返した頻度です。稼働率が評価の上限を決めます。 A 評価には稼働率 95％以上と有料テストの合格が必要です。95％未満の場合、最高評価は B、80％未満では C、50％未満では F（利用を避けてください）となります。これらの基準は、チェック時間が 6 時間に達した時点で適用されます
• レイテンシ 15： 中央値が 1 秒以下で満点、5 秒以上で 0 点です（チェックは 1 つのリージョンから実行されるため、距離による減点はありません）。当方の障害と重なったチェックは対象外です
• 安定性 25： 支払い先ウォレットの変更や価格の値上げがあると減点されます（異なる値上げはそれぞれ 1 回として数え、最大 8 点減点）
• 提供品質 20： 有料テストでの支払いのうち、宣伝どおりの結果が返された割合です。2xx はすべて成功として扱います。支払い後の 429、ファイアウォールによるブロック、非同期の 202 は中立です。結果リストが空の場合は、正直な「結果なし」として扱います。レスポンスが失敗となるのは、エラーステータスの場合、出力が返されるとされているのに空の場合、JSON が返されるとされているのに JSON でない場合、または掲載項目のフィールドが 1 つも含まれていない場合に限ります（フィールドが data／result の中にある場合や、掲載された項目のリストの場合も含みます）。有料チェックに失敗したエンドポイントは毎日再テストされます
• まだ有料テストを受けていない場合 → 残り 80 点で採点し、比例換算してその旨を表示します。最高評価は C です。A と B は、実際の有料テストで結果が返されたことを意味します
• 評価上限： 説明のないウォレット変更 → F（24 時間経過後も確認できない場合 → 最高 70 点、C）。支払いを受け取ったのに有料テストに失敗 → F。支払い後のエラーで請求なしの場合、または掲載者自身の入力例が「見つかりません」の場合 → D。独自のサインインが必要 → C。結果は返すものの掲載内容と構造が異なる場合（フィールドが別の場所にネストされている、掲載例では単一項目なのにリストが返される、例にあるフィールドの大半が欠落しているなど）→ 最高 85 点（B）。エージェントがフィールドの場所を確認できるよう注記を付けます。軽微な不足（任意フィールドやコンテンツタイプのラベルなど）は注記のみとします。確認済みのローテーションやリクエストごとのアドレスは対象外です
• 判定： proceed は、実際の有料テストで結果が返され、エンドポイントの信頼性が確認されたことを意味します。健全でもまだ有料テストを受けていないエンドポイントは、提供品質が未確認のため caution とします。30 分ごとの無料チェックで最新の状態を保ちます
• 値のチェック： 有料テストのたびに、回答が妥当かどうかも確認します。依頼内容（シンボル、アドレス、URL など）に関する回答か、「生成日時」が新しいか、主要トークンの USD 価格が公開されている現物価格の 10％以内かを確認します。値のチェックに失敗した場合は警告となり、評価の上限は B です。利用を避ける判定にはなりません
• 当方に起因する支払いの失敗は、販売者の評価には影響しません
• 販売者に公平： 実際の問題のみが評価対象です。当方のモニターがレート制限やファイアウォール（Cloudflare、Vercel、AWS WAF、Akamai、DataDome、Imperva、Sucuri）によってブロックされたチェックは blocked とします。見積もりを返す前にエンドポイントが拒否したリクエスト（400/405/415/422）は mismatch、当方のネットワークに起因する失敗は monitor_error とします。まだ読み取りできない支払いネットワークの見積もり（例：nano:mainnet）は unsupported_network とします。これらはどれも評価に影響しません。ネットワークエラーと 502/503/504 は 1 回再試行します。同一ホストへのリクエストは同時に最大 2 件、約 1 秒に 1 件までとし、速度を落とすよう求めるホストへのチェックは一時停止します
• 透明性： 失敗したチェックはすべて、エンドポイントの公開ページと /v1/failures にタイムスタンプ付きで掲載されます。許可リストに登録する場合は、当方のユーザーエージェント lumiere-paycheck-prober/1.0 (+https://lumierepaycheck.org) を使用してください

価格設定

## 販売者向け

監視対象の各エンドポイントには公開ページがあり、バッジは自動で更新されます。

[![Lumière PayCheck](https://lumierepaycheck.org/badge?url=YOUR_ENDPOINT_URL_ENCODED)](https://lumierepaycheck.org/e?url=YOUR_ENDPOINT_URL_ENCODED)

支払い先ウォレットを登録してください。 これにより、ウォレットの変更が乗っ取りと誤認されるのを防ぎ、乗っ取りを最初のチェックで検出できます。{"payTo": ["0xYourWallet"]} を https://<your-host>/.well-known/paycheck.json で公開するか、_paycheck.<your-host> に DNS TXT レコード（payto=0xYourWallet）を設定し、エンドポイント URL を指定して POST /v1/declaration を実行してください。詳細。

評価が間違っていると思いますか？エンドポイント URL を添えて評価への異議申し立てを送信してください。ボットは1分以内にエンドポイントの現在のスコアと失敗ログを返信し、有料の再テストを自動的にキューに登録します。再テストの実行後、ボットは結果（変更前後の評価）を投稿し、評価が修正されていれば Issue をクローズします。無料の再テストは、価格が $0.05 以下のエンドポイントが対象です。それより高額なエンドポイントについては、ボットがエンドポイント独自の価格でテストに資金を提供するためのリンクを投稿します。ルールと制限：販売者ガイド。

Lumière Agents

PayCheck を手がけたチームが、小規模事業者向けにフォローアップを代行します。 agents.lumierepaycheck.org

ほとんどの小規模事業者に不足しているのは仕事ではなく、フォローアップです。Lumière Agents は、事業主の名前と口調で相手に催促します。

エージェント	内容
請求書催促エージェント	支払期日の1日後、7日後、14日後に丁寧なリマインダーを送信します。顧客ごとに明細書を1通作成し、事業者自身のメールアドレスから送信します。「支払いました」「小切手を郵送しました」「金曜日に支払います」といった返信や異議申し立てを理解し、それ以外は事業主に引き継ぎます。
見積もりフォローアップ	見積もりごとに2日後、5日後、12日後に気軽な確認メッセージを送ります。返信があれば送信を停止して事業主に直接引き継ぎます。見積もりを改訂すると、フォローアップを再開します。
不在着信へのテキスト返信	不在着信があると、すべての発信者に1分以内（午前9時～午後8時）に事業者自身の電話番号からテキストを送信します。予約リンクを添え、事業主への引き継ぎも行います。
書類催促エージェント	アップロードリンクを使って下請業者から保険証明書を集め、事業主のチェックリストと照合し、有効期限が切れる前に更新を依頼します。
領収書催促エージェント	毎週月曜日、会社のカードを保管している人に領収書の提出を依頼します（スマートフォンで撮影した写真で構いません）。領収書をファイリングし、記帳担当者には毎月コピーを送ります。

安全性を保つ仕組み

• 最初はすべてのメールを承認できます。 各エージェントには「送信前に承認」／「自動送信」の切り替えがあり、事業主はいつでも変更できます。
• 情報源は AI ではなく、帳簿です。 金額、請求書番号、日付はコードで挿入します。AI が作成するのは文面のみで、作り上げた数字や圧力をかける表現を含む下書きは、通常のテンプレートに置き換えられます。
• 丁寧さを設計に組み込んでいます。 営業時間内のみ送信し、米国の祝日は送信しません。連絡先ごとに週あたりの送信回数を制限し、STOP と配信停止は常に機能します。停止を求めた相手には何も送信しません。
• アカウントはお客様のものです。 QuickBooks（読み取り専用）または任意のスプレッドシートで動作します。メールはお客様自身のアドレスから、テキストはお客様自身の Twilio 番号から送信します。クライアントごとにデータベース内でデータを分離し、保存ファイルを暗号化します。

料金： エージェント1つは月額 $200 ＋初期設定費用 $750、追加エージェント1つごとに月額 $100 ＋初期設定費用 $400、5つすべてなら月額 $500 ＋初期設定費用 $2,000 です。いつでも解約できます。ガイド · 利用開始

Lumière Agents は Lumière LLC が提供する、別個のホスト型製品です。そのコードはこのリポジトリには含まれていません。

独立性

Lumière PayCheck は、Lumière LLC（米国コネチカット州）が運営する独立したプロジェクトです。Coinbase、x402 Foundation、Bazaar、またはいずれの販売者とも提携していません。スコアは自動評価によるものであり、保証、推奨、または財務上の助言ではありません。

フィードバック

ご質問、機能のご要望、評価への異議申し立ては、issue を開き、該当するフォームを選択してください。x402 で支払いを行うエージェントを開発していますか？必要な機能について、ぜひお聞かせください。

ドキュメント

Lumière PayCheck の評価と実行に関するガイド：概要、機能、料金、はじめに、管理者ガイド、統合ガイド、FAQ。PDF：Enterprise プランガイド（すべての内容を網羅）と4 ページの概要。

セキュリティとプライバシー

収集する個人情報と、その情報を取り扱う第三者：PRIVACY.md（lumierepaycheck.org/privacy にも掲載）。リアルタイムの利用状況：lumierepaycheck.org/stats。サービスの稼働状況と稼働率：lumierepaycheck.org/status。

現在の制限事項も含め、キー、支払い、データがどのように保護されるかについて：SECURITY.md（lumierepaycheck.org/security にも掲載）。脆弱性は、GitHub のセキュリティアドバイザリまたは [email protected] から非公開で報告してください。

ライセンス

このリポジトリ内のドキュメント、サンプルコード、パッケージはMIT ライセンスで提供されています。Lumière PayCheck のホステッドサービスとそのソースコードはこのリポジトリには含まれておらず、このライセンスの対象ではありません。

「Lumière PayCheck」、「Lumière」、および Lumière PayCheck のロゴは Lumière LLC の商標です。MIT ライセンスの対象はコードであり、名称やロゴではありません。フォークは歓迎しますが、異なる名称を付けてください。