x402receipts

Name: x402receipts
Author: x402receipts.com

本地服务

x402receipts.com金融数据14 周前更新

代码仓库访问官网

关于 x402receipts

x402receipts 记录 Agent 的 x402 购买，并与链上付款对账，提供可验证的收据和月度报告，供需要追踪自主支出的团队使用。

主要功能

01将付费调用记录为收据
02匹配 Base 和 Solana 付款
03标记未匹配付款
04发布可验证的收据证明
05导出 CSV 和签名 JSON 报表

适用场景

01审计 Agent 钱包的购买记录
02调查未匹配的 USDC 付款
03准备月度供应商支出报告

MCP 相关

MCP 服务提供记录收据、验证收据和查询服务信息的工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "com-x402receipts": {
      "command": "npx",
      "args": [
        "-y",
        "x402receipts-mcp"
      ],
      "env": {
        "X402RECEIPTS_EVM_PRIVATE_KEY": "<X402RECEIPTS_EVM_PRIVATE_KEY>",
        "X402RECEIPTS_SOLANA_PRIVATE_KEY": "<X402RECEIPTS_SOLANA_PRIVATE_KEY>"
      }
    }
  }
}

启动命令npx -y x402receipts-mcp

需要配置的环境变量

X402RECEIPTS_EVM_PRIVATE_KEY密钥Optional. 0x… key holding USDC on Base; pays USD 1 per wallet per calendar month; later uploads that month are free.

X402RECEIPTS_SOLANA_PRIVATE_KEY密钥Optional. ed25519 key (hex or base58) holding USDC on Solana.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmx402receipts-mcp1.0.0stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

x402receipts

为自主支出提供会计基础设施。 Agent 的每笔 x402 采购都会成为一张收据，并与链上交易进行对账；缺失或无法匹配的付款会被标记，财务人员可查看月度报表，任何人都能验证相关凭证。

网站：https://x402receipts.com · 应用：https://app.x402receipts.com · 实时报表：https://app.x402receipts.com/demo
Agent 文档：https://app.x402receipts.com/llms.txt · OpenAPI：https://app.x402receipts.com/openapi.json
价格：每个记录采购的 Agent 钱包每天 USD 0.01，由 Agent 使用自己的钱包通过 x402 以 USDC（Base、Solana）支付。没有采购的日子不收费，因此一个月的费用永远不会超过 USD 0.31。收据数量不限。无需 API 密钥。

使用方法

在代码中——在 Agent 已经用于付款的 fetch 外包一层封装（npm i x402receipts-sdk）：

import { wrapFetchWithPayment } from "@x402/fetch";
import { withRegister } from "x402receipts-sdk";

const register = withRegister(fetch, { endpoint: "https://app.x402receipts.com", payWith: () => pay });
const pay = wrapFetchWithPayment(register, wallet);

作为 MCP 服务（npx -y x402receipts-mcp）：record_receipts、verify_receipt、service_info。参见 packages/mcp。

通过 HTTP：POST https://app.x402receipts.com/api/v1/receipts——返回包含 x402 挑战的 402 响应；任何 x402 客户端都可以支付。

使用 AI 编码工具：将集成提示词粘贴到 Claude Code 或 Cursor 中。

该格式是开放标准

记录、指纹、其上的仅追加日志、锚定记录和验证算法均以 ARR-1 — Agent 收据记录 的形式发布，并以公共领域（CC0）许可发布。JSON Schema 位于 spec/arr-1/。你可以自行实现，也可以据此检查我们的实现。

ARR-1 基于现有标准构建，而非取而代之：该树采用 Certificate Transparency 使用的 RFC 9162 配置文件，检查点以 HCS-27 消息发布，账户使用 CAIP-2/CAIP-10 命名，Agent 使用 HCS-14 标识符命名。

本仓库内容

路径	内容
`spec/arr-1/`	ARR-1 规范及其 JSON Schema（CC0）
`sdk/`	`x402receipts-sdk` npm 包（单文件，无依赖）
`packages/mcp/`	`x402receipts-mcp` MCP 服务
`examples/`	原生 Node、Vercel AI SDK、LangChain、OpenAI Agents
`integrations/agentkit/`	Coinbase AgentKit 操作提供程序
`integrations/x402-ecosystem/`	x402.org 生态系统条目

工作原理

记录 — SDK 记录每次已付款的调用：资源、金额、交易对手、交易引用、请求/响应指纹、交付状态，以及卖家签发的签名收据（若有）（x402 offer-receipt）。
对账 — 读取 Base 和 Solana 上已连接的钱包；将每笔 USDC 转出付款与收据匹配。无法匹配的项目会作为异常列出，而不是用平均值掩盖。
证明 — 每晚，账户的完整收据日志会被哈希处理，生成一棵 RFC 9162 Merkle 树，并将其根写入 Hedera Consensus Service，同时关联前一天的根。每张收据都有一个公开验证页面，可在浏览器中重新执行计算。
报告 — 所有者使用钱包登录：按供应商查看支出、查看登记簿，以及导出 CSV 和带签名的 JSON。

指南：https://x402receipts.com/guide.html · 状态：https://app.x402receipts.com/status · 联系方式：[email protected]

MIT 许可。

支持 Markdown

登录后评论