Lumière PayCheck

Lumière PayCheck

在 Agent 付款前检查 x402 端点。

AI Agent 现在可以通过 x402 自主为 API 付款：端点以 402 Payment Required 响应并给出价格，Agent 使用 USDC 付款，然后获取数据。整个流程中没有任何信息能告诉 Agent 端点是否可用、价格是否合理，或收款钱包是否真实。

Lumière PayCheck 能解答这些问题。它会监控 x402 Bazaar 中列出的每个端点，为其评级，并向你的 Agent 给出明确结论：继续、谨慎或避免。

🌐 在线使用： https://lumierepaycheck.org · 🔌 MCP： https://lumierepaycheck.org/mcp?plans=1 · 📜 条款

此仓库是文档、示例和反馈的公共主页。监控服务本身由托管方运营且不公开源代码；评分公式公开如下。

---

功能

• 监控 x402 Bazaar 中的每个端点（上方徽章显示实时数量，随着新端点加入而增加），每 30 分钟检查一次：报价、收款钱包、正常运行时间、响应时间。

• 标记劫持风险，不会因正常轮换而惩罚。 每次收款钱包变更都会与卖家声明的钱包、卖家此前使用的钱包，以及旧钱包和新钱包之间的直接转账进行核对。已确认的轮换不会影响评级；无法解释的变更会被标记为 avoid，随后经人工审核标记为 caution。使用每个请求都对应新地址的卖家会被自动识别。了解工作原理。

• 为 Agent 制定支出规则。 付款前，Agent 可以询问“我可以向这个端点、使用这个金额、付款到这个钱包吗？”，并获得附带原因的允许或拒绝结果。

• 团队计划。 提供限定范围的 Agent 密钥、每日／每月支出限额、付款前可由钱包验证的签名收据、可重放的审计记录，以及针对异常情况的人工审核。详情。

• 为付款 Agent 提供身份与访问管理。 类似 Entra ID 和 Intune，适用于 AI Agent：

  功能	说明	计划
  PayCheck 之外的付款	注册 Agent 的钱包；它进行的每笔 x402 付款都会与 PayCheck 的决策进行比对；未经询问、在收到拒绝后仍进行的付款，或超过批准金额的付款都会触发提醒	所有计划
  SDK 强制执行	withPayCheck(client, { agentKey }) 不会为 PayCheck 已拒绝的付款签名；遇到故障时默认拒绝，并使用一次性收据	所有计划
  Agent 清单	状态（活跃、空闲、过期、即将过期、冻结）、上次活动时间、客户端、合规情况、风险；CSV	所有计划
  Agent 凭证	可选加入：Agent 可向卖家证明自己属于已验证的公司；卖家可免费使用 verifyAgentCredential() 验证	Business+
  访问审查、临时限额、策略模板、风险评分	使用带签名报告进行保留／修改／撤销审查，限时提高限额，共享规则集，并提供可解释的低／中／高风险评分	Business+
  SSO 和 SCIM	使用 Entra ID、Okta 或 Google Workspace 登录；自动配置人员账号	Enterprise
  API · 管理员指南

• 筛查支付促进方。 x402 支付促进方可在结算每笔付款前进行筛查：检查付款方和收款方是否受到 OFAC 制裁、payTo 是否为卖家已监控或声明的钱包，以及价格是否高于报价。每月免费检查 10,000 次。详情。

• 钱包风险。 在向任何钱包付款前，通过一次付费调用检查 OFAC 制裁、付款钱包历史记录和可能遭到劫持的信号。

• 警报。 监控端点；当端点发生故障、更换钱包或提高价格时，接收带签名的 webhook 警报。

• 付费交付检查： 通过小额真实付款，确认端点返回其宣传的内容。只有约两小时后的复测也失败，才会计为失败；端点因缺少输入而拒绝请求的情况永远不会计入。

• 已知答案测试：验证数值，而不只是结构。 正常运行时间和架构检查可能通过，但 API 返回的数字仍可能有误。对于答案可知的端点，验证器会付费发起一次能得到已知正确结果的调用，或与独立的实时数据源进行比较，并检查数值本身。卖家也可以添加自己的测试。工作原理。

• 来自链上数据的真实使用情况： 过去 30 天内，实际 x402 付款（在 Base 和 Solana 上使用 USDC）进入各端点付款钱包的数据：交易量、不同买家数、典型和最大付款额、趋势，以及买家集中度；仅统计由已认可的支付促进方提交的付款。

• 买家报告： 付款后，任何 Agent 都可以回答五个简短问题（通过收据或付款交易在链上验证；使用 npm 包时只需一行：reportOutcome({ url, response, answers })）。确认会让端点在我们的付费测试队列中优先级上升；严重问题会触发复测。只有我们自己的付费测试确认后，评分才会改变。

无需账户，也无需 API 密钥。免费检查免费；付费功能按调用次数付费，使用 x402，方式与 Agent 支付其他费用相同。

快速开始

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。

然后在 Agent 的指令中添加一条规则：

向任何 x402 端点付款前，调用 Lumière PayCheck 的 check_payment 工具，并提供端点 URL、金额以及其 402 报价中的 payTo 钱包。仅当 allow 为 true 时才付款。如果返回 allow: false，请告诉我原因，而不要付款。付款后，调用 report_outcome，并提供收据（或 URL 和付款 tx），以及关于你是否获得所付内容的简短回答。

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、webhook 和收据验证、带保护的付款方，以及套餐购买。

## API

路由	价格	功能
GET /v1/score?url=	免费	为一个端点评分并给出等级和判定结果
POST /v1/check-payment	免费	支出规则：允许或拒绝一笔特定付款，并说明原因
GET /v1/leaderboard?limit=	免费	评分最高的端点（无钱包异常）
GET /v1/stats	免费	目录规模和判定结果数量
GET /v1/operators?limit=	免费	按域名分组的卖家
GET /v1/usage?url=&days=	免费	一个端点的真实链上使用情况：交易量、买家数、趋势
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=	免费	单个端点的公开页面，包含其失败检查日志
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	一次调用为最多 100 个端点评分
POST /v1/watch	$0.10	为一个端点提供 30 天的签名 Webhook 警报
POST /v1/seller-test	端点价格	卖家：为价格高于 $0.05 的端点出资进行付费重新测试（详情）
GET /v1/plans	免费	套餐目录
POST /v1/plans/builder · /business	$9 · $49	使用 USDC（x402）购买、续订或升级套餐。银行卡：／subscribe
POST /v1/authorize	套餐	使用 Agent 密钥授权付款：允许／拒绝／审核 + 签名收据
POST /v1/facilitator/screen	Facilitator 套餐	为 x402 facilitator 提供结算前筛查（每月免费 10,000 次检查，此后每 1,000 次收费 $1.50）

免费路由允许每个客户端每分钟发送 60 次请求，使用在 x-paycheck-key 标头中发送的免费 API 密钥后，每分钟可发送 300 次请求。MCP 服务每分钟允许调用 300 次工具。付费路由使用 x402，以 USDC 在 Base 或 Solana 上结算（两者价格相同；在 Solana 上由 facilitator 支付费用）。查询我们未监控的端点会返回 404，绝不会收费。完整参考： docs/api.md。

供运行 Agent 的团队使用的方案

免费检查始终免费。付费方案为需要花钱的 Agent 增加授权：

	Builder	Business	Enterprise
价格	$9 / 月	$49 / 月	私下联系我们
受限 Agent 密钥（允许的卖家、每笔付款上限、过期时间、撤销、轮换）	3	25	自定义
每日和每月支出限额	✅	✅	✅
在工具边界执行的签名收据	✅	✅	✅
可重放的审计记录	30 天	1 年 + CSV	自定义
异常情况人工审核（新钱包、大额金额）	—	✅	✅

通过 lumierepaycheck.org/trial免费试用 Business 30 天：只需提供电子邮件，无需信用卡。继续使用，工作区和密钥会保留；不继续也没关系，Agent 仍可使用免费的允许/拒绝检查。

在网站上通过信用卡订阅：由 Stripe 按月收费，可随时取消，账户会自动设置。然后在 lumierepaycheck.org/account 管理所有内容（Agent 密钥、限额、审批、账单）。开发者也可以通过 x402 使用 USDC 付款（预付 30 天，不会自动续订）。

每次付款前，Agent 都会调用 POST /v1/authorize，并获得 allow、deny 或 review 结果及其原因。结果为 allow 时，Agent 会获得绑定到该笔具体付款的 Ed25519 签名收据；examples/guarded-pay.ts 展示了一个没有收据就拒绝签名的付款方。之后可以重放每一项决策，以证明其作出原因。

需要我们代为设置吗？ 设置服务（一次性收费 $750）会配置你的 Agent、限额和审批规则，让它们先运行 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 s 得满分，≥ 5 s 得零分（检查从同一个区域运行，因此不会因距离而扣分）。与我们一侧的停滞时间重叠的检查不计入
• **稳定性 25：**更改收款钱包和涨价都会导致分数下降（每次不同的涨价只计一次，最多扣 8 分）
• **交付 20：**付费测试付款中返回了宣传内容的比例。任何 2xx 都算成功；付款后出现 429、防火墙拦截或异步 202 均为中性；空结果列表算作诚实的“无结果”；仅当响应为错误状态、承诺有输出却为空、承诺返回 JSON 却未返回 JSON，或不含该条目任何字段时，才算失败（包装在 data/result 中的字段，或所列项目的列表，均符合要求）。未通过付费检查的端点会每天重新测试
• 尚未进行付费测试 → 按其他 80 分计分并重新按比例折算，会标明这一点，最高为 C：A 和 B 表示真实付费测试已交付
• **上限：**无说明地更改钱包 → F（24 小时后仍未确认 → 最高 70 分，即 C）；收款后未通过付费测试 → F；付款后报错但未收费，或条目自带的示例输入返回“未找到” → D；需要单独登录 → C；有交付但与自身条目描述的格式不同（字段嵌套在其他位置、显示单个项目却返回列表、大多数示例字段缺失）→ 最高 85 分（B），并附注告知 Agent 在哪里读取字段；轻微缺漏（可选字段、内容类型标签）仅添加说明。已确认的钱包轮换和每次请求使用的地址不计入
• 判定结果：proceed 表示真实付费测试已交付，且端点可靠。状态良好但尚未进行付费测试的端点为 caution（交付尚未确认），我们每 30 分钟进行一次免费检查以保持其状态最新
• **价值检查：**每次付费测试时，我们还会检查答案是否合理：内容是否与请求内容相关（符号、地址、URL）、“生成时间”是否足够新，以及主要代币的 USD 价格是否在公开现货价格的 10% 范围内。价值检查失败会发出警告并将等级上限设为 B，但绝不会标为“应避免”
• 由我们一侧导致的付款失败，绝不会计入卖家的不良记录
• **对卖家公平：**只计入真实问题。我们的监控器遭遇速率限制或防火墙拦截（Cloudflare、Vercel、AWS WAF、Akamai、DataDome、Imperva、Sucuri）时，检查标记为 blocked；端点在报价前拒绝的请求（400/405/415/422）标记为 mismatch；由我们自身网络导致的失败标记为 monitor_error。这些情况均不计入。网络错误和 502/503/504 会重试一次。对任何单个主机，我们最多同时发送 2 个请求，约每秒发送 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)

声明你的收款钱包，这样钱包轮换就不会被误认为是劫持，而劫持也能在首次检查时被发现：在 https://<your-host>/.well-known/paycheck.json 发布 {"payTo": ["0xYourWallet"]}（或在 _paycheck.<your-host> 发布 DNS TXT 记录：payto=0xYourWallet），然后使用你的端点 URL 调用 POST /v1/declaration。详情。

认为评级有误？请通过端点 URL 发起评级申诉。机器人会在一分钟内回复该端点的当前评分和故障日志，并自动排队安排一次付费复测。复测完成后，机器人会发布结果（复测前后的评级）；如果评级已修正，则会关闭议题。价格不超过 $0.05 的端点可免费复测；价格更高的端点，机器人会发布链接，供你按端点自身价格为测试注资。规则和限制：卖家指南。

Lumière Agents

来自 PayCheck 背后团队：为小型企业提供全托管的跟进服务。 agents.lumierepaycheck.org

大多数小型企业并不缺工作；它们缺的是后续跟进。Lumière Agents 会以企业主的名义和口吻进行追踪：

Agent	功能
发票催收	在到期日后第 1、7 和 14 天发送礼貌提醒；每位客户发送一份对账单，邮件来自企业自己的邮箱。能够理解回复（“已付款”“支票已经寄出”“我们周五付款”或争议），并将其他情况交由企业主处理。
报价跟进	在每份报价发出后的第 2、5 和 12 天进行友好跟进。收到任何回复后都会停止并直接转交企业主；修改后的报价会重新启动跟进。
未接来电短信回复	每位未接来电者都会在一分钟内收到一条来自企业自有号码的短信（上午 9 点至晚上 8 点），其中包含预约链接，并可转交企业主处理。
文件催收	通过上传链接收集分包商的保险凭证，根据企业主的清单进行核验，并在凭证到期前请求续期。
收据催收	每周一向持有公司卡的人员索要缺失的收据（手机拍照即可）并归档；记账员每月会收到一份副本。

安全保障

• 每封邮件在首次发送前都由你审批。 每个 Agent 都有一个“发送前审批”／“自动发送”开关，企业主可随时切换。
• 事实来自你的账簿，而非 AI。 金额、发票编号和日期都由代码填入；AI 只负责撰写措辞。如果草稿中出现编造的数字或施压内容，就会被替换为普通模板。
• 以礼貌为设计原则。 仅在营业时间内发送，避开美国节假日，对每位联系人设有每周发送上限；STOP 和取消订阅始终有效，且绝不会向要求停止的人发送内容。
• 你的账户仍归你所有。 可与 QuickBooks（只读）或任意电子表格配合使用；邮件来自你自己的地址，短信来自你自己的 Twilio 号码。每位客户的数据都在数据库中隔离，存储的文件均经过加密。

**定价：**一个 Agent 每月 $200，另加 $750 的设置费；每增加一个 Agent，每月加 $100，另加 $400 的设置费；全部五个 Agent 每月 $500，另加 $2,000 的设置费。可随时取消。指南 · 开始使用

Lumière Agents 是 Lumière LLC 提供的一款独立托管产品；其代码不在此仓库中。

独立性

Lumière PayCheck 是由 Lumière LLC（美国康涅狄格州）运营的独立项目。它与 Coinbase、x402 Foundation、Bazaar 或任何卖家均无关联。评分是自动评估结果，并非保证、背书或财务建议。

反馈

如有问题、功能请求或对评级有异议，请提出 issue，并选择相应表单。你正在构建使用 x402 付款的 Agent 吗？我很想了解它需要什么。

文档

有关评估和运行 Lumière PayCheck 的指南：概览、功能、定价、入门指南、管理员指南、集成指南和常见问题。PDF：企业版计划指南（包含所有内容）和 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 许可证涵盖代码，不涵盖名称或徽标：欢迎分叉，但请使用不同的名称。