x402-data-gateway

SameDayDesk x402 和 MPP 数据网关

可选的有界批量提取

付费的 GET /extract 和 GET /read（以及 MCP extract / read）会在结算后返回类型化记录。商户 HTTP 200 表示已交付该记录，并不证明来源成功或页面内容完整。JSON 保留 requestedUrl、观测到的 finalUrl（也会复制到 url 以保证兼容性）、来源 HTTP status、sourceOk、可为空的 error，以及一个 capture 对象，其中标明无 JavaScript 的 GET 请求、正文／摘录限制、字符集和截断情况。带有拦截文本的 403/404 并非空的 200。观测到的 HTTP 交付证据可用于判定是否符合架构、来源是否拒绝以及是否发生截断；这并不代表对买家有用，也不构成销售保证。extract 的 text 字段是有界摘录。未指定的请求默认保留 1,200 个字符。可选的 textExcerptLimitChars 取值为 1 到 40,000；如果不是此范围内的整数，会在付款前被拒绝；价格不变，也不会获取 /read。40,000 与 /read 的 Markdown 上限一致，因为正文已经限制为 3 MB。批量请求使用相同的解析器，但限制更严格，因此五段摘录不会在通过准入后超出 128 KiB 的响应上限。需要更长的 Markdown 时请使用 /read。这两个路由都不会执行 JavaScript，因此缺少讨论文本并不能证明其不存在。脚本数据区块和注释会被剥离；这不是完整的讨论内容读取器。生产环境的来源连接会验证并固定公开 IPv4 DNS 答案，重新验证最多三次重定向，并拒绝 URL 凭据、私有地址、IPv6，以及忽略所请求 identity 编码的压缩响应。Header/meta 字符集标签用于选择解码器；capture.charset 会标明实际使用的解码器。未知标签会回退到 UTF-8，并明确标记发生了回退。

批量行会保留请求的来源位置，包括重复项和失败项。每个已捕获行的 provenance.capture 会记录无 JavaScript 方法、实际字节限额，以及请求文本时的 1,200 字符限制。已知的正文或文本截断属于部分内容，而非完整内容。这无法检测未披露的缺失内容。即使错误页面包含文本，来源拒绝仍会使该行失败。进程内的 fetch/timeout 测试钩子没有 HTTP、MCP 或环境输入绑定，也不会改变结算或授权中间件。

EXTRACT_BATCH_ENABLED=1 会新增 POST /extract/batch 和 MCP extract_batch，每个通过准入的批次（包含 1–5 个公开 HTTPS URL）的试行价格为 0.01 USDC。默认关闭：25 个付费 HTTP 操作和 22 个 MCP 工具；启用后：26 个和 23 个。此价格不代表已测得的利润率保证。请使用一个服务进程和持久化的 COMMERCE_DATA_DIR；未知结算状态会被隔离，不会自动再次收费。有界的部分输出不保证涵盖每个来源或请求字段。

LOCKFILE_PIN_DELTA_ENABLED=1 会新增 POST /lockfile-pin-delta 和 MCP lockfile_pin_delta，用于比较调用方提供的两个 npm package-lock.json 对象。默认关闭。生产环境已启用 EXTRACT_BATCH_ENABLED=1（26 个付费 HTTP 操作／23 个 MCP 工具）。在此基础上启用 lockfile 后为 27／24。默认关闭时的目录保持为 25／22。默认价格为 $0.005（LOCKFILE_PIN_DELTA_PRICE），与线上 GET /extract 一致。利润率尚未得到证明。初始线上版本仅接受 x402；现有 MPP 路由（包括 extract_batch）保持不变。仅接受 HTTP JSON：不支持文件系统路径、任意命令或网络获取。相同的 pin 仅提供信息，不代表引擎失败。此处不会改写已签名的部署声明。lockfile MCP 工具的质询资源为 https://agents.samedaydesk.com/lockfile-pin-delta，而非 mcp:// 或 /extract/batch。 extract_batch MCP 工具映射了现有的 HTTP 支付和持久化重放处理程序。其挑战资源为 https://agents.samedaydesk.com/extract/batch，而非 mcp://：首次调用不带支付信息，然后将返回的 HTTP 资源和完全相同的参数与 _meta["x402/payment"] 一起重用。MPP 调用方可以使用结果 _meta["samedaydesk/http"].headers 中未修改的 www-authenticate 挑战，并通过 HTTP Authorization 发送其凭证。该元数据还包含 HTTP 状态和收据标头。切勿转换 MCP 资源凭证。现有 MCP 工具保留其原有的原生 MCP 支付边界。

签名声明在任一标志状态下均提供 25 项标准路由能力（Circle 除外）；它不声称已禁用的路由可用，也不授权支付。实时发现结果不包含已禁用的批量提取功能。

每个付费 HTTP 响应都会通过标准 HTTP describedby 链接关系公布 /.well-known/agent-payment-evidence.json。这个范围受限的免费清单将每个确切的方法和路由关联到卖方声明的只读效果、递归保证的 JSON 路径、响应模式摘要、精确重放绑定、收据行为以及现有的签名部署声明。它不会更改 x402 或 MPP 条款，也不构成消费授权；买方仍必须验证实时挑战、付费输出、收据和结算。

20 个按次付费的工具，涵盖确定性 Agent 工作机会预检、机器服务发现、支付报价预检、Morpho 借款人和市场决策、保护计划、URL 提取、Markdown 阅读、代码库安全扫描、公司和钱包信息补充、结构化数据生成、交易收据证据、委托签名者策略合规性、结算证明以及 AI 搜索就绪度审计。

• 产品页面：https://samedaydesk.com/x402
• Smithery：https://smithery.ai/servers/epistemedeus/x402-data-gateway
• 远程 MCP：https://agents.samedaydesk.com/mcp
• Agent Plugins 1.0 本地软件包：plugins/samedaydesk-x402（未列入市场）
• Claude Code 市场： .claude-plugin/marketplace.json 以及 plugins/samedaydesk-extract（samedaydesk-extract@samedaydesk-claude；未列入 Anthropic 官方目录）
• Goose 原生配置：goose/（YAML、会话标志和深层链接；不是 Goose 安装程序）
• Hermes Agent 技能：hermes/ 以及可移植的 plugins/samedaydesk-x402/skills（AgentSkills SKILL.md 即插即用；不是 Hermes 插件或安装程序）
• 实时资源清单：https://agents.samedaydesk.com/.well-known/x402
• OpenAPI：https://agents.samedaydesk.com/openapi.json
• 官方 MPP OpenAPI：https://agents.samedaydesk.com/mpp-openapi.json
• 技能契约：https://agents.samedaydesk.com/skill.md
• 操作目录：https://agents.samedaydesk.com/api/actions
• A2A Agent 卡片：https://agents.samedaydesk.com/.well-known/agent-card.json
• Global A2A Registry：https://www.a2a-registry.org/agent/9cb0b8e6-cb1f-422b-a604-861d0a79e24b
• 结算雷达：https://agents.samedaydesk.com/platforms
• 平台健康状态 JSON：https://agents.samedaydesk.com/v0/cards.json
• 汇总机器需求遥测数据：https://agents.samedaydesk.com/v0/commerce-demand.json
• Morpho 仓位风险：GET /defi/morpho-position?address=0x...&shocks=-10,-20,-30
• Morpho 保护报价：GET /defi/morpho-protection?address=0x...&targetHealthFactor=1.25&protectAgainstShockPct=-10
• Morpho 市场承保：GET /defi/morpho-market-underwrite?marketId=0x...
• Morpho PreLiquidation 重放：GET /defi/morpho-preliquidation-replay?transactionHash=0x...
• 机会预检：GET /work/opportunity-preflight?rewardUsd=10&hours=0.25&hourlyCostUsd=4&selectionProbabilityPct=20
• Agent 可发现性审计：GET /distribution/agent-discoverability-audit?origin=https://example.com&intent=extract+a+public+website+into+structured+JSON&route=/extract&method=GET&runtimeUrl=https%3A%2F%2Fexample.com%2Fextract%3Furl%3Dhttps%253A%252F%252Fexample.org&surfaceAudit=true&materializationAudit=true
• 付款报价预检：GET /commerce/payment-offer-preflight?url=https://example.com/paid-route
• 卖方完整性审计：GET /commerce/seller-integrity-audit?origin=https://seller.example&route=/paid-route&method=GET&requiredPaths=data.attributes
  • 买方可以添加一个 referral=r1_<sha256>，该值根据其完整的卖方签名 x402 结算收据生成。这会创建一个已声明的获客标签，而非经验证的证明。POST /commerce/referral-recheck 接受该收据以及来自不同付款方和交易的一张下游卖方签名结算收据，然后以原子方式最多授予一次免费的状态变更后重新检查。这些收据既不能证明应用返回了 HTTP 200 响应，也不能证明已交付或验证输出；公开发布或广播均为可选操作。符合 Agent402 PR 1070 可观测捕获契约的文件（不含捆绑的 Agent402 源代码的裸格式美化 JSON 收据），经过常规 JSON.parse 后即可直接输入；参见 docs/agent-outcome-referral-experiment.md 和 agent402-receipt-interop.test.mjs。
• 发现↔实时付款漂移（仅限库/CLI；不是托管或付费路由）：node discovery-drift.mjs observe --url 'https://agent-economy-signal-x402-mainnet.bronzetti-andrea.workers.dev/premium/agent-brief' --bazaar-pay-to '0xbda48b29607b9dc66ef7e38b68ad53f2b17efb23'
• 契约限定搜索：GET /commerce/contract-qualified-search?query=service+domain+ownership+code+provenance&requiredPaths=data.sourceRepository 返回针对缺失买方必需路径的有限 OpenAPI 修复计划，不会修改卖方文件，也不会推断未声明的属性类型。
• Base USDC 结算证明：GET /commerce/settlement-proof?transactionHash=0x...&recipient=0x...&amountAtomic=5000
• Base 或 Ethereum 交易收据：GET /chain/transaction-receipt?transactionHash=0x...&network=base
• 钱包策略符合性：POST /security/wallet-policy-conformance
• 钱包策略符合性契约：GET /schemas/wallet-policy-conformance-v1.json
• 有状态钱包策略符合性：POST /security/stateful-wallet-policy-conformance
• 有状态钱包策略契约：GET /schemas/stateful-wallet-policy-conformance-v1.json
• 重大变更警报探测：https://agents.samedaydesk.com/alerts
• Agoragentic 卖方回调：POST /integrations/agoragentic/ai-readiness-audit
• the402 签名履约 Webhook：POST /integrations/the402/webhook 无需 API 密钥或订阅。每个付费 HTTP 路由都会在同一个 402 响应中声明 x402 和原生 MPP Payment 身份验证。两种协议均会向同一个 Base 主网商户钱包结算完全相同的 USDC 金额。MCP 工具调用仍由 x402 门控。

Morpho 路由为只读。它根据协议整数值计算 LTV、LLTV、健康因子、清算余量和抵押品价格冲击情景，随后将索引的抵押品、借款份额和预言机价格与 Base RPC 直接读取的状态交叉核对。情景是计算结果，并非概率或交易建议。单独的保护路由会直接读取最新预言机数据，并直接确认抵押品和借款份额，以计算精确的部分还款和追加抵押品金额。它会返回未签名的代币授权和 Morpho 调用模板、明确的执行缓冲、重新验证要求以及经济后置条件。它不会访问钱包、签名、广播交易或托管资产。

该服务还会在持久化的 Railway 卷上维护一份保护隐私的需求观测记录。它会记录路由类别、运行时值通过共享 GET 存在性测试的查询键名称、质询／成功类别以及假名化的重复使用信号。外部抓取属于获取信号，而非经过验证的买家，因为身份不明的自动索引器仍可能存在。已识别的爬虫和 Agent 索引器用户代理会在采集时简化为受控来源标签，并在单独的机器发现视图中按来源和路由覆盖范围报告。这些观测衡量的是抓取，而非经过身份验证的目录引荐、意向或需求。 未匹配请求会与保守的语义候选子集分开报告；在独立调用者重复使用或转化之前，两者都不会计入需求。它不会记录原始 IP 地址、用户代理、URL、查询值、请求正文、付款标头、市场载荷或凭据。公开输出仅包含汇总数据；所有者流量会被排除，爬虫流量即使以受控发现计数另行报告，也仍会从需求中排除。.env、.git 和 WordPress 探测路径等常见利用探测也会被归类为扫描器流量并排除。

1.9.4 版新增了明确的付费流量类别，不会暴露买家地址。COMMERCE_PAYER_CLASSES 接受由 { "address", "class" } 记录组成的 JSON 数组。受控类别包括 internal、validation、incentivized、affiliated 和 independent。地址会转换为遥测中已使用的同一套密钥化付款方假名，并在读取时进行分类，因此也能在不存储原始地址的情况下进行追溯性更正。未知付款方仍会标记为 unclassified；不能通过推断将陌生钱包视为独立需求。公开快照会按类别报告付费成功次数，以及独立和重复独立参与者数量。

1.9.5 版新增了每个证据类别中的路由级付费成功计数。下游监控器据此可将市场验证视为会计和传输证据，对未分类的付费使用发出调查警报，并且仅在明确属于独立买家或重复独立买家的情况下推进需求论点。

1.9.6 版会在明确设定证据基线后，私下捕获成功的 x402 PAYMENT-RESPONSE 或 MPP Payment-Receipt 标头中的有效 Base 交易哈希。公开遥测仅按付款类别公开证明覆盖率、不同值计数和缺失引用计数。原始标头和交易引用会保留在私有卷中。引用缺失会成为重大结算完整性事件，但不会暴露引用本身。 Version 1.11.2 会基于内容协商返回根路径内容，不改变其机器端契约。在浏览器中导航时，若明确发送 Accept: text/html，则会收到一个响应式的人类可读页面，展示十四个工具、支付流程和权威发现链接。JSON 客户端、curl 的通配符 Accept 标头以及 Agent 仍会收到稳定的 JSON 描述符。响应会根据 Accept 变化，而人类可读页面不会重复支付架构。

Version 1.11.2 还新增了按来源归因的机器发现视图。它不会在公开快照中暴露原始用户 Agent 或网络地址，而是按受控来源和路由报告索引器未来的精确观测数据，并且仅将首次来源和首次路由覆盖范围的变化作为重要事件呈现给雷达。重复爬取量仍是可见数据，但不会变成需要关注的警报或需求信号。

Version 1.11.3 使该触达视图仅面向未来，并排除自身流量。单独的 COMMERCE_AGENT_DISCOVERY_SINCE 基线可防止把埋点前的爬虫历史归因于触达；同时，SameDayDesk 自有的监控用户 Agent 会从发现和外部需求观测中排除。这样可避免完整性巡检、品牌盲测和雷达探测自行制造获客信号。

Version 1.11.4 即使付费 Agent 的用户 Agent 表明其为爬虫或索引器，也会保留该事件。有效提交 x402 或 MPP 凭证后，事件会在爬虫分类之前进入经济遥测，而受控用户 Agent 标签会按来源和路由记录从来源到付费的转化。渠道标签仍由用户自行声明，并非经过认证的引荐证明；独立需求仍需遵循明确的付款方分类策略。

Version 1.11.5 将付费路由触达与挑战交付区分开来。面向未来的 Agent／索引器观测数据现在会报告付费路由探测、HTTP 402 挑战、不同挑战参与者及重复挑战参与者、挑战率，以及受控来源和路由明细。这有助于识别机器漏斗是在付费墙之前、挑战阶段还是提交凭证之后停止，同时不会将索引器探测视为购买意向。

Version 1.11.6 新增了保守的挑战到支付队列。只有同一网络与用户 Agent 组合所对应的密钥化 actor 在首次面临挑战后再次返回，付费成功才计为继续转化。公开快照会报告转化调用数、转化 actor 数、独立转化 actor 数、转化率，以及受控来源和证据类别总数，不含 actor ID。网络或用户 Agent 发生变化只会造成假阴性，因此该指标是下限，而非身份声明。

Version 1.11.7 新增了项目自有的 Glama 连接器验证，使用公开的 SameDayDesk 企业邮箱，验证地址为 /.well-known/glama.json。Glama 请求拥有独立的受控发现来源标签，因此可以衡量已传播的目录声明，而不会将其计为需求。

Version 1.11.8 新增了独立的凭证尝试漏斗。声明基线之后，尝试必须包含语法完整、可解析的 x402 v2 exact 绑定或 MPP evm/charge 凭证。签名有效性和结算仍属于后续结果。公开汇总数据会区分标头噪声与可解析尝试，并报告协议、结果、路由、受控来源和明确的付款方类别，不含原始凭证、actor ID 或地址。

Version 1.11.9 改进了 MCP 工具选择，不会重命名或重复任何工具。现在，每个工具都有独特的、以操作为导向的标题。对于功能重叠的网页和公司工具，标题会明确说明何时选择 extract 而不是 read、enrich 而不是 schemaforge，以及何时使用组合式的 deep_audit；wallet_enrich 也会说明其输入应为 EVM 地址，而非公司域名。支付路由、名称、价格、架构和处理程序均保持不变。 Version 1.11.10 为每个 opportunity_preflight 输入和三个 Morpho 保护控制项添加了明确说明。这有助于构造机器调用，同时不改变名称、路由、价格、必需输入、默认值、付款门槛和执行行为。

Version 1.11.11 为全部四个 Morpho MCP 工具添加了明确的同级工具选择指引。借款人诊断、未来保护规划、市场承销和历史 PreLiquidation 重放现在是彼此独立的机器选项，且不重命名工具，也不改变其路由、价格、架构、付款门槛或处理程序。

Version 1.11.12 开始对前瞻性 MCP 传输摩擦进行探测。它将四种常见的客户端预期——/mcp/sse、/mcp/messages、/mcp/tools 和 /mcp/events——与任意 /mcp/* 未匹配路径区分开来，但不会提供猜测的别名。公开聚合数据仅展示路由计数和以密钥处理的调用方总数。只有反复出现的独立使用或转化才能证明兼容路由确有必要。

Version 1.11.13 修复了面向机器买家的付款前响应契约。全部十三个路由都已编写明确的 JSON 输出架构，但 Bazaar v2 辅助程序要求将该架构放在 output.schema 下；此前顶层的 outputSchema 字段遭到静默忽略。现在，经过测试的单一适配器会将每个已编写的架构放在协议规定的位置，因此在 Agent 授权付款前，未付款的 402 挑战会同时提供示例和具体的必需响应字段。路由、输入、价格、结算和处理程序均未改变。

Version 1.11.14 将相同的十三项响应契约纳入免费的 OpenAPI 和操作目录。发现类 Agent 现在可以在试用付费路由前查看具体的必需字段和示例；/read 也被描述为其处理程序实际返回的 JSON 对象，而非原始 Markdown 字符串。由路由键控的单一契约映射同时驱动 x402 挑战、OpenAPI 和操作目录，避免这三个机器界面出现不一致。

Version 1.11.16 从机器根目录、OpenAPI 服务元数据和 llms.txt 链接到有版本号且无需凭据的 agent-payment-policy 参考资料。该参考资料不包含钱包执行器、付款签名器、托管功能或托管式付费验证器。它为机器买家提供稳定的策略和证据基础，同时不改变商家的路由、价格、付款要求或结算。

Version 1.13.1 将面向机器买家的参考资料更新为公开软件包 0.4.0。根目录、OpenAPI 元数据和 llms.txt 现在公布了精确执行形态授权，以及控制覆盖架构 v2（含十四个维度）。此次更新源于 Tempo 和 Solana 的第一手证据：提供方原生的方法和指令允许规则可能会放行重复的已批准操作。商家路由、价格、处理程序、付款要求或结算均未改变。

Version 1.14.0 将我们遇到的跨链委托签名者故障转化为无需凭据的付费产品。POST /security/wallet-policy-conformance 仅接受有界的标准化允许、拒绝和错误矩阵。它区分操作允许列表与精确执行形态控制，仅将明确的提供方策略拒绝计为提供方原生强制执行，并在不提供不透明分数的情况下返回 conformant、partial 或 unsafe。无效形态或包含机密的形态会在付款前被拒绝。评估器不接受钱包凭据、签名、交易正文、钱包访问权限或广播权限，也不会声称已执行调用方的提供方测试。 Version 1.14.1 在免费的规范化 /schemas/wallet-policy-conformance-v1.json 合约中，发布了精确的标准化用例、证据类别、输入模式、输出模式、方法、协议和单次价格。付费路由、价格、决策逻辑、付款门槛和结算均保持不变。机器客户端现在无需解析付款质询，即可构建和验证矩阵。

Version 1.14.2 将分类体系、严格验证器、离线评估器和 JSON Schema 移至公开的 [email protected]；托管产品现在导入该程序包，不再维护私有副本。公开程序包还提供 wallet-policy-init、wallet-policy-check 和 wallet-policy-schema CLI 命令。尚未运行的预期用例会被正确标记为 partial，而有证据证明预期操作被阻止，或有变更被允许，仍会被标记为 unsafe。托管路由、0.01-USDC 价格、付款条款和无凭据边界均保持不变。

Version 1.14.3 将公开标准依赖项升级至 [email protected]。Provider 原生控制项的信用现在要求该控制项的所有观测用例均通过。被拒绝的可选形态用例不再能掩盖已允许的重复批准操作用例。Privy Tempo 和 Solana 适配器均将精确执行形态归类为未验证，并将整体原生策略归类为不安全，与第一人称证据一致。路由、价格、付款和凭据边界均保持不变。

Version 1.15.0 根据项目的第一人称 Privy 累计限额实验，新增了一个独立的有状态钱包策略产品。POST /security/stateful-wallet-policy-conformance 会评估七个安全的标准化用例，涵盖顺序限额、已签名但未广播的计数、ABI 提取、并发超额、计数器引用故障和应用程序串行化。GET /schemas/stateful-wallet-policy-conformance-v1.json 发布免费的构建合约。评估器来自公开的 [email protected]，不接受凭据或原始 Provider 负载，并将 Provider 策略与应用程序强制执行分开处理。

Version 1.15.1 将第一人称的过期目录证据转化为范围明确的可发现性审计功能。调用方可提供 expectedPriceUsd 和精确路由，以比较十个公开发现视图中目录标示的路由价格。结果会区分价格匹配、价格偏差、结果不一致、价格未知和路由缺失等状态；只有在自有实时条款一致后，才会返回最多包含一次 canary 的修复序列。该功能绝不会将调用方预期视为运行时事实，不会进行目录付款，并将异步传播交由事件驱动监控处理。

Version 1.15.2 修复了两个免费钱包策略合约及其对应付费评估器的测量路径。现在，所有四个路由都有精确的商业分类。历史 /schemas/* 事件仍计入原始未匹配数量，但不会纳入语义需求解读，因为注重隐私的账本没有保留足够的路径细节来重新分类这些事件。新的精确事件会生成聚合的同客户端漏斗，追踪从成功读取免费合约，到付费路由质询、可解析凭据及交付的各个环节。公开快照不会暴露任何参与者、凭据、原始路径、钱包或 Provider 负载；合约读取仍仅作为触达证据，而非需求证据。 版本 1.16.0 将支付报价预检从仅验证协议一致性，升级为可选的目录与运行时一致性检查。调用方可以通过 POST 或 MCP 表单提交一个精确的目录候选项，产品会使用公开的 [email protected]，仅将其与匹配的实时未签名协议报价进行比较，比较范围包括请求、协议、金额、网络、资产、收款方和有效期。明确的偏差会产生 review_required；缺失的目录字段仍会显示为部分结果。x402 有效期窗口根据 maxTimeoutSeconds 推导，格式错误的目录输入会在付款前被拒绝，且请求仍不会使用目标凭据、钱包或签名，也不会进行结算、重定向或读取响应正文。

版本 1.16.1 升级了现有的 Agent 可发现性审计，不新增产品，也不改变 0.05 USDC 的价格。可选的 runtimeUrl 必须使用经过审计的源站和精确的请求路由。审计会发出一次不带凭据、固定 DNS、仅获取响应头的请求；只有当实时未签名的 x402 和 MPP 条款可解析且一致时，才会接受价格参考，随后将该规范化的 Base-USDC 金额与每条注册表观测结果进行比较。仍支持调用方提供的预期值，并会明确标注；与运行时实际情况不一致时，会单独生成一条发现结果。结果仍不会签署任何内容、向目标付款、跟随重定向或读取目标响应正文。

版本 1.16.2 为同一审计新增了路由级别的列表身份信息。现在，每条目录观测结果都会报告精确路由是规范项、重复项、仅别名，还是同时存在于规范源站和非规范源站。别名候选项必须具有明确的 payTo 并匹配精确路由；输出会说明这并不能证明主机名所有权。这样既能发现过时的市场别名和以 URL 为键的重复列表，也能发现价格偏差，同时保留相同的 0.05 USDC 产品、请求边界和不产生支出的目录扫描。

版本 1.16.3 明确了身份依据的证据边界。与调用方提供的 payTo 和精确路由相匹配的非规范记录是别名候选项，并不能证明卖家拥有该主机名。每个来源现在都会返回 identityBasis、ownershipProven 和通俗易懂的证据边界说明，以便自动修复在没有确凿证据时保留规范记录，而不下架第三方端点。

版本 1.23.35 扩展了现有审计，不新增路由，也不改变 0.05 USDC 的价格。启用 materializationAudit=true 后，可以将精确的 GET 或 POST 路由提交给 Coinbase 当前的卖家验证器。此可选检查不使用凭据、签名或付款；Coinbase 可能会使用请求的方法向卖家发出一次不付费的请求。

可发现性响应版本 1.12.0 撤销了 provider_accepted_not_materialized、作为组合目录状态的 seller_not_provider_eligible，以及重新索引操作。验证器资格仍属于独立维度。目录读取是一个受支持的任务搜索窗口。在该窗口中找不到精确目标，表示该查询对应的目录中是否存在该目标尚不明确。0.05 USDC 的价格不变。

响应版本 1.13.0 修正了该契约中的两种解读。只有当 valid 是布尔值 true 且 simulation.outcome 为 accepted 时，成功的 Coinbase 验证器响应正文才表示符合资格；只有当 valid 是布尔值 false 且 simulation.outcome 为 rejected 时，才表示不符合资格。任何其他成功响应正文仍属于未知状态，且不会提出修复建议。对于 CDP 搜索文档以外的目录，提供方总数或无法识别的计数不属于返回计数，也不会与规范化后的行数进行比较。 Version 1.16.4 将 route-audit 的私有身份分类器替换为公开且带有来源信息的 [email protected] 原语。现在，即使目录未返回匹配记录，也会将其记录为已检查且状态为 route_absent；规范来源匹配仍只是观测结果，而非所有权声明。这为在线卖家和独立买家工具提供了一个共享且可安装的契约，同时不引入凭据、钱包访问、签名、支付或保留的结算身份。

Version 1.18.3 补全了 Base 结算证明和 Solana 收据路由的机器可构造示例，并为 Circle Gateway 别名提供了与规范支付报价预检相同的编写版成功响应架构。

Version 1.18.2 按不可变的 v2 架构标识符发布递归响应报告。

Version 1.18.1 在有界报告中添加了递归保证的响应路径，因此仅要求顶层 data 封套的卖家不会看起来像是承诺提供嵌套的 data.attributes 决策载荷。

Version 1.18.0 保留已签名的目录别名身份控制，并为支付报价预检添加了有界卖家响应契约检查。该路由现在会在严格的大小上限内读取确切卖家同源的公开 OpenAPI 文档，并报告确切的 GET 操作是否声明了包含类型化必填字段的自包含 JSON 成功架构。它绝不会读取付费目标的响应正文；在付费响应通过买家独立授权的输出验证器之前，卖家声明仍仅供参考。

Version 1.22.3 将超出有界审计字节上限的卖家声明归为特定的 openapi_too_large 缺口，而非通用的有界审计失败。上限保持不变，且不会推断架构。

Version 1.22.2 在符合契约的搜索中同时排除规范 SameDayDesk 来源和已知的旧 Railway 目录别名。Agent402 在首次在线买家语言查询中为这两条记录都排了名，这证明只排除规范主机名并不能在服务身份层面排除自有供给。

Version 1.22.1 为新搜索工具添加了必需的 MCP 选择元数据，并强化了生产启动冒烟测试，确保发布不会仅因 HTTP 正在监听、而异步 MCP 挂载失败而通过。

Version 1.22.0 添加了付费的、符合契约的机器服务搜索。买家提供能力意图和递归必需的 JSON 响应路径。该路由搜索 Agent402 和官方 MPP 目录，在审计前排除自有供给和未解析的路由，并返回有界的机器可购买或契约就绪候选项，以及受控的拒绝代码。它不使用凭据或钱包，不向卖家发送 POST 请求或目标支付，不读取任何付费响应正文，且只返回查询摘要。现在，已签名的部署声明绑定二十三组确切的 HTTP 方法和路径对。

Version 1.17.0 通过来自 [email protected] 的可选已签名部署声明，消除了目录别名歧义。位于 /.well-known/agent-payment-policy-service-deployment.json 的短时效 JWS 将规范的 agents.samedaydesk.com 来源绑定到当时的付费 HTTP 方法和路径对，以及确切的 Base USDC x402 和 MPP 结算身份。每个部署来源都带有自己的路由和结算范围，因此未来的别名无法继承其他来源的权限。 位于 /.well-known/agent-payment-policy-service-deployment.pem 的公开 Ed25519 密钥与 SameDayDesk 的 Solana ERC-8004 注册中的 agentWallet 是同一个原始密钥。签名密钥保持离线状态，不会部署。JWS 响应仍是严格的信封；其密钥和注册指针通过 HTTP Link 标头和 ERC-8004 注册文档提供。/healthz 会报告声明 ID、密钥指纹、路由数量、到期时间和活动状态，以便监控轮换。 该声明可证明对已注册密钥及所声明服务绑定的控制权，但不会授权、签署或发送买方付款。

Version 1.11.15 会在启动前，根据各自的 JSON Schema 验证每项 Bazaar 声明。此前有六条较新的路由成功完成结算，但 Coinbase 拒绝了其发现元数据，因为输出示例缺少同一套 Schema 标记为必填的字段。现在这些示例已符合要求，而 bazaar-contract-audit.mjs 会通过不含凭据的 HTTP 402 探测，检查所有符合条件的实时 CDP Bazaar 付费路由，且不会保留标头或查询值。替代 x402 结算渠道会作为明确的排除项报告，而不会被误判为失败的 Bazaar 声明。

discovery-drift.mjs 是一个不含凭据的库和 CLI，用于比较注册表／目录发现结果与实时未付费付款要求，涵盖资源、网络、资产、amountAtomic 和观测时效性。它不是默认挂载的付费路由。复制粘贴：

node discovery-drift.mjs observe --url 'https://agent-economy-signal-x402-mainnet.bronzetti-andrea.workers.dev/premium/agent-brief' --bazaar-pay-to '0xbda48b29607b9dc66ef7e38b68ad53f2b17efb23'

Version 1.11.18 为公开汇总数据新增了来源质量漏斗。现在，每个受控发现来源都会报告发现、付费路由、质询、凭据尝试和付费成功各阶段的观测数量，以及不同参与者和重复参与者数量。质询率既按请求计算，也按参与者计算，因此单个高频爬虫不再会被误认为广泛的机器覆盖。质询到付款的转化会归因于首次观测到质询的来源。原始用户代理、网络地址和参与者标识符仍属私密信息，不会返回。

Version 1.11.19 启动了一个独立的、前瞻性的 AI 提供商来源队列。它使用提供商公布的精确 HTTP 标记，区分 OpenAI、Anthropic 和 Perplexity 的搜索、用户抓取及训练流量，以及 Google Cloud Vertex Agent 爬取流量。由于 Google 声明 Google-Extended 没有独立的 HTTP 用户代理字符串，因此有意将其排除。详细队列有自己的基线，会保留历史通用记录，报告相同的参与者漏斗，并将每个标签视为未经身份验证的观测，而非引荐证明。

Version 1.11.20 修复了具备付款能力的钱包 Agent 所使用的资源元数据。现在，十四个 x402 v2 质询中的每一个都会在标准顶层资源对象中携带经过验证的提供商级 serviceName 和五个有限路由能力标签。如果付费路由覆盖范围与元数据覆盖范围不一致，启动将以失败关闭。Bazaar 合约审计现在会拒绝扩展有效、但资源名称或标签缺失或无效的路由。 价格、输出、结算、隐私、路由和原生 MPP 条款均未改变。

Version 1.12.0 新增了 /chain/transaction-receipt，价格为 0.002 USDC。一次实时市场实验发现，低价链工具可实现提供商级结算，但一个浏览量很高的竞品交易收据路由出现了两次零支出交付失败。新路由接受一个已挖出的 Base 或 Ethereum 交易哈希，并返回标准化状态、区块时间、Gas 和费用字段、解码后的 ERC-20 Transfer 事件及规范 USDC 转账。无效哈希和不受支持的网络会在付款前被拒绝。原始日志、钱包访问、签名和广播不属于产品范围。 版本 1.12.1 修复了 Solana /commerce/payment-offer-preflight 商店的已认证交付边界。Solana 网关验证并结算自身的 x402 或 MPP 付款后，其私有内部标头现在会直接传递到确定性产品，而不会再遇到第二道 Base 付款门槛。没有提供完全匹配的私有标头的请求，仍采用常规的 Base x402 和 MPP 行为。目标凭据和目标付款仍在预检产品边界之外。

版本 1.12.2 确保卖家拥有的发现页面与规范付费操作目录保持同步。A2A Agent Card 现在使用实际服务版本，保留聚合目录技能作为首项，并为每条付费路由追加一个明确的仅用于发现的技能。ERC-8004 注册文档保留其协议入口点，并添加相同的直接付费操作 URL。A2A 描述符复用规范聚合技能 ID，入站消息必须包含规范的 user 角色、消息 ID，以及至少一个部分。这些变更改进了路由发现，但不表示支持尚未实现的 A2A 任务操作。

版本 1.12.3 将这一发现经验转化为可选的卖家审计。在现有的付费可发现性路由上设置 surfaceAudit=true，即可检查目标的公开 A2A Agent Card、ERC-8004 注册文档和操作目录中是否包含预期路由。目标请求仅限于三个固定的同源 JSON 路径，要求 DNS 返回完全公开的地址，拒绝重定向，每个响应上限为 512 KiB，并在五秒后超时。默认仍仅检查目录，不会请求目标源。

版本 1.12.4 让 JSON POST /work/opportunity-preflight 探测与现有 GET 路由采用相同的完整 Bazaar 输入和输出契约。这消除了机器发现的架构错误，同时不改变价格、验证、处理程序、响应或付款行为。未认证的空 POST 仍会返回仅用于发现的质询；付费调用仍必须提供并绑定必需的请求正文。

版本 1.13.0 新增了一项 0.002-USDC 的 Solana 已最终确认交易收据产品。它会在付款前验证签名，以及任何可选的铸币、接收方、金额和付款方声明；随后返回有界的最终确认状态、费用、SPL 代币持有者余额变动、规范 USDC 余额变动和确定性的匹配结果。它仅在结算后读取公开 RPC 状态，不具备钱包、签名、托管或广播权限。该路由可通过 Base x402、原生 MPP、MCP、A2A 和独立的 Solana 付款网关使用。

版本 1.11.23 为以下 MCP 客户端添加了范围有限的兼容桥：它们使用 x402 PAYMENT-SIGNATURE HTTP 标头重试付费的 tools/call，但未将相同的已签名负载复制到 _meta["x402/payment"] 中。商家仅在 tools/call 上解码有界且结构为对象的标头，绝不覆盖规范 MCP 元数据，并将结果传递给现有的 @x402/mcp 验证器。该桥不信任此标头，不更改付款条款，也不绕过签名、金额、资产、网络、随机数或结算验证。

版本 1.11.24 在 MCP tools/list 元数据中公布每个工具准确的实时 x402 付款选项。兼容客户端可以在调用前查看价格、资产、网络、接收方和方案，然后在首次 tools/call 时附上新签署的负载，而不必依赖质询重试。运行时验证和结算仍具有权威性，未付款质询路径保持不变。 Version 1.11.26 强化了面向机器的 /commerce/payment-offer-preflight 选择契约：在买方授权前比较 x402 和 MPP 支付质询及条款。这个售价为 0.005 USDC 的产品仍只接受一个精确的公开 HTTPS GET URL，并返回规范化报价、URL 和 realm 绑定检查、过期情况以及经济性对等结果。它会拒绝凭据、本地或非公开目标、未解析参数及重定向；固定一个公开 DNS 解析结果，仅读取响应头，不会为目标签名或发送支付，也不会返回不透明的质询状态。

Version 1.11.27 使精简的 /skill.md Agent 契约与十四路由操作目录保持同步。现在，它在选择词汇中列出了支付报价预检，并说明了目标检查边界：不读取凭据、目标签名或支付、重定向，也不读取响应正文。回归测试确保这个专注于买方授权的产品在后续版本中继续存在。

Version 1.11.28 消除了手动维护路由清单可能导致的遗漏。现在，精简契约会根据规范的机器操作目录呈现并验证每个付费操作、确切价格和支持的协议。操作契约为空、格式错误或有重复项时，系统会安全失败，确保未来添加路由时，精简的 Agent 界面不会悄然过时。

Version 1.11.29 为 AgenticTrade 添加了免费的机器目录交接功能，不会在 SameDayDesk 前再设一道支付门槛。目录会告知买方直接调用所选操作 URL，满足绑定到该路由的 x402 或 MPP 质询，并可选择携带声明的 agentictrade-v1 来源标签。该标签会进入已衡量的发现到支付漏斗，不会存储原始令牌，也不会影响价格、支付或访问权限。

Version 1.11.30 在目录响应中添加了不含值的 AgenticTrade 代理诊断信息。它只报告哪些 X-ACF-* 标头名称到达了源站，以及签名、时间戳和使用证明字段是否存在。它绝不会返回这些字段的值，且代理响应会标记为 private, no-store。

Version 1.11.31 在代理目录正文中也加入了同样的不含值诊断信息，因为 AgenticTrade 会有意只向调用方返回自身的计费标头。直接目录响应保持不变，仍可公开缓存。

Version 1.9.7 会将基线之后的每条引用与其规范的 Base 收据进行私下核对。只有在交易成功、恰好一笔规范的 Base USDC 转账到达已配置的金库、原子金额与付费响应相符，并且转账发送方与请求付款方假名（如有）相符时，记录才会被接受。重复引用和所有不匹配项都会导致安全失败。权限为 mode-0600 的私有账本会保留引用；公开健康状态和需求输出只会披露结算总数、按证据类别和路由划分的原子金额、问题计数，以及通用错误状态。

Version 1.9 为全部十二项付费 HTTP 能力添加了同路由 MPP evm/charge 支持，同时保留现有 x402 中间件。未付费的请求现在会同时携带 WWW-Authenticate: Payment 和 PAYMENT-REQUIRED。原生 MPP 凭据使用 Authorization: Payment，成功调用会返回 Payment-Receipt；x402 则保留其 Bazaar、支付标识符、签名报价／收据以及 PAYMENT-RESPONSE 扩展。MPP 质询会绑定到规范化的方法、路径和已排序的查询参数。两种协议都会参与保护隐私的遥测和请求重放，OpenAPI 3.1 还会为每项操作公开有效的 x-payment-info 报价。 1.9.3 版本基于同一组路由和价格来源生成两个面向不同注册表的发现视图。/openapi.json 包含结构化的 USD 价格、协议声明、Agent 指引、公开路由的身份验证声明，以及 AgentCash 和 MPPScan 使用的真实响应架构。 /mpp-openapi.json 包含官方 MPP offers[]，不含不兼容的扁平字段。稳定的操作 ID 和能力标签让 Agent 更容易搜索、排序和调用公开目录。运行时的 402 挑战对这两个视图仍具有权威性。

1.23.6 版本将请求绑定的重放扩展到每个付费 JSON POST 路由，并将重放指纹绑定到确切的已结算支付凭据和确切的原始请求字节。这样，丢失的成功 POST 响应可以重放，而无需执行处理程序或再次扣款；凭据、请求体、输入、付款方或支付条款发生变化时，则会返回未扣款的 HTTP 409。1.23.7 版本在 /.well-known/paid-action-effects.json、每个付费 POST OpenAPI 操作以及响应头中发布实验性的只读效果契约。它还会避免将未付费的付费 POST 请求纳入应用遥测，同时说明协议挑战状态仍可能存在，并且支付响应重放不等同于业务效果幂等性。这里并未声称采用任何外部标准。1.8 版本新增了确定性的付费机会预检。调用方提供奖励、执行时间、每小时机会成本、计算成本、强制支出、可复用价值、竞争情况，以及明确的选择概率。结果会返回 attempt、verify_first 或 abandon，并提供透明的盈亏平衡经济分析、严格的访问和资金门槛，以及可选的附日期结算雷达卡片。它不会抓取受限任务板，也不会触碰来源平台的账户、声明、出价、付款或提交。1.7 版本为提供 x402 支付标识符扩展的 HTTP 买家新增了请求绑定的幂等重放。成功的 JSON 响应会在私有 Railway 卷上缓存 15 分钟。缓存键是逻辑支付 ID 的 HMAC，绑定内容涵盖完整的规范 URL、HTTP 方法、付款方、网络、资产、金额和收款方。不会存储原始支付 ID、付款方地址或请求 URL。完全相同的重试会收到原始响应和已签名的结算凭证，不会再次扣款；输入、付款方或支付条款发生变化时，则会返回未扣款的 HTTP 409。重放事件会与新的付费成功事件分开计数。

观察到的 Agent 爬虫使用了多种发现约定。规范清单仍为 /.well-known/x402，并在 /.well-known/x402.json、/x402.json 和 /api/x402 提供兼容别名。兼容 AgentCash 的 OpenAPI 文档仍为 /openapi.json，而 /openapi.yaml 和 /swagger.json 返回相同的 JSON 文档。官方 MPP 发现端点为 /mpp-openapi.json，并提供别名 /openapi.mpp.json。GET /mcp 返回免费的传输描述；实际的 MCP 发现和付费工具调用使用 POST /mcp 进行流式 HTTP 传输。 偏好精简指令契约的 Agent 可以读取 /skill.md（或 /SKILL.md），而 /api/actions 会返回 13 个规范 GET 操作及其 URL、描述、精确的 USDC 原子单位价格、MIME 类型、网络和 payTo。Agent Skills 客户端可以在初始请求和付费重放请求中发送 X-SameDayDesk-Agent-Source: agent-skills-v1。遥测会将这一确切的允许列表值简化为适合公开使用的 agent-skills 标签，且绝不存储原始标头。这是已声明但可伪造的归因信息，而非身份验证；它不能更改价格、付款或访问权限。 位于 /.well-known/agent-card.json 的 A2A v1.0 卡片会公布一个范围有限的免费技能：discover-x402-paid-actions。POST /a2a/message:send 会以 A2A 直接消息的形式返回该确切目录，为 A2A 客户端提供一条基于标准的路径，使其能够从 Agent 发现转向现有的付费 x402 操作，同时不声称支持任意任务执行。 仓库根目录中的 agent-card.json 是一份兼容性清单，供 Global A2A Registry 当前的 GitHub 导入器使用。它指向规范的 v1.0 Agent Card 和 OpenAPI 文档；它不会取代生产卡片。Registry 自行生成的所有权清单位于单独的地址 https://samedaydesk.com/.well-known/agent-card.json；符合标准的 A2A v1.0 卡片仍以 agents.samedaydesk.com 上的版本为规范版本。

PreLiquidation 影子监控器

morpho-preliquidation-shadow.mjs 是由完整 Base 普查选定的仅观测前向证据通道。它监控历史执行最集中的五个市场，根据 LLTV 和 pre-LLTV 推导各市场的实际 PreLiquidation 健康阈值，在一个明确指定的 Base 区块上直接检查每项已观测的授权，并使用按合约划分的事件游标。

新的执行交易会通过确定性的归档 RPC 引擎重放，每次运行最多 20 笔。记录包含检测延迟、贷款资产总激励和原生 Gas，同时明确指出重放不涵盖兑换、资金、失败、竞争和 MEV 成本。债务低于明确的 1 USD 观察下限的头寸会被归类为尘埃，而非机会。

node morpho-preliquidation-shadow.mjs \
  --state /data/morpho-preliquidation-shadow-state.json \
  --history /data/morpho-preliquidation-shadow-history.ndjson

状态和历史文件的权限强制设为 0600。重大变化包括新增或移除授权、进入或退出协议特定风险窗口、流动性或利用率大幅变动，或出现经验证的新 PreLiquidation 执行。此监控器不涉及任何钱包、签名者、授权、托管或本金。

Agoragentic 回调是一个独立的市场分发桥接服务。市场负责买家路由、结算和卖家记账，而回调会在较低的单 IP 安全限额下执行相同的生产级 AI 搜索就绪度审核。直接 Agent 客户继续使用付费 x402 路由。

the402 桥接服务是第二条市场分发路径。它通过带时间戳的 HMAC 验证来验证已签名的任务派发，仅接受发往官方 API 源的回调，并提交结构化审核交付物以供自动结算。THE402_API_KEY、THE402_WEBHOOK_SECRET 和 THE402_SERVICE_ID 是仅供 Railway 使用的环境变量。

同一服务还托管两个免费的、明确披露的联盟营销跳转入口，供经过事实核查的 SameDayDesk 指南使用：/go/topify 和 /go/manychat。这些入口在服务端生成并缓存 Agent Hansa 的限时签名链接，验证重定向主机，不暴露 API 密钥，并返回 noindex, nofollow 和 no-store。

原始支付通道实现

一个 Node/Express 服务端，未付款时返回 HTTP 402 Payment Required，付款后提供资源，并将 USDC on Base mainnet 直接结算到我们自己的钱包：

payTo = 0x8904dF3DE6DFEe6a7C8cc38619d2f17806213Cee

已验证线上运行（2026 年 6 月至 8 月）。服务端可启动，并返回包含机器可读支付要求的正确 402 响应。Morpho 金丝雀配置为 amount=20000 = 0.02 USDC、network=eip155:8453，以及 asset=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 = Base USDC；payTo 等于我们的钱包，另附包含输入和输出架构的 Bazaar 发现扩展。

---

当前生产决策

路径	需要账户/API 密钥？	Base 主网？	发现范围
CDP facilitator（api.cdp.coinbase.com/platform/v2/x402）	需要，Coinbase CDP 账户以及 CDP_API_KEY_ID 和 CDP_API_KEY_SECRET	是	生产默认选项。 首次结算后，可通过 CDP Bazaar 目录、商家查询和语义搜索发现
xpay public facilitator（facilitator.xpay.sh）	不需要	是（eip155:8453，精确 scheme）	备用结算路径，仅提供自行发布的发现信息
x402.org public facilitator（x402.org/facilitator）	不需要	否，仅限 Base Sepolia 测试网	独立测试目录，位于 x402.org/facilitator/discovery/resources
生产环境使用 CDP。前十一条路由已通过实时 CDP 验证，并完成了真实结算。最初的八条路由已出现在 Bazaar 商家发现中。三个较新的 Morpho 决策路由已收到成功结算回执，且一个独立的已注资付款方为这三条路由都生成了 isValid: true 和 Bazaar 扩展状态 processing。在文档所述的缓存窗口过后并完成新一轮结算后，它们仍未进入商家发现，因此此问题被跟踪为下游 CDP 索引故障，而非路由元数据故障。不含密钥的复现材料已附在
x402 issue #2156。
保留 xpay 作为无密钥的连续性备用方案，而不要将其用作常规生产支付促进方。

第十二条路由 /work/opportunity-preflight 已上线，价格为 0.05 USDC，并完成了一笔排除所有者的结算，用于集成和索引 QA。第十三条路由 /distribution/agent-discoverability-audit 已上线，价格为 0.05 USDC，将 SameDayDesk 自身使用的品牌盲测目录基准产品化。它会在不使用目录凭据或付款的情况下查询 Bazaar、Agentic Market、Agent402、Circle、AgenticTrade、官方 MPP 目录、MPPScan、PayanAgent、x402.jobs 和 8004Market 的公开搜索；保留注册表原生排序，并将覆盖范围、排名、排在目标之前的竞争者以及基于证据的后续行动报告为特定时间点的观察结果，而非综合评分。Bazaar 和 Agentic Market 明确归为 Coinbase 的同一来源系列，因此输出不会将这两个视图分别计作获客渠道，从而夸大独立覆盖范围。PayanAgent 被标记为依赖型聚合器界面，因为其目录包含 Coinbase 来源供应等生态记录；其检索排名有参考价值，但不代表独立的底层供应。8004Market 被标记为身份传播界面，因为它会索引链上的 Solana Agent Registry 身份；在该平台检索到内容，证明的是公开身份和能力的传播，而非买家调用、结算或独立需求。可选的、范围受限的卖家界面检查会报告某条精确路由是否出现在目标的公开 Agent Card、ERC-8004 注册信息和操作目录中，且不会削弱默认的免凭据目录方法。

版本 1.11.42 为机器工作流买家新增 JSON 正文 POST /work/opportunity-preflight 合约，同时保留现有 GET 合约和 0.05 USDC 价格。空的、免凭据的 HEAD 或 POST 注册表探测可以检查付款挑战；缺失或格式错误的付费输入仍会返回不收费的 400 错误。这样一来，整数分美分工作流市场可以直接调用一款实用产品，无需重复创建路由或使用误导性的价格。

版本 1.11.43 为机器目录新增精确的免费样例 GET /work/opportunity-preflight?trial=1。它会返回固定算术结果，包含 sample: true 和 charged: false，不执行任何外部操作，也不接受调用方输入。自定义 GET 和 POST 调用仍需支付 0.05 USDC。

版本 1.11.41 会将规范的 x402 v2 Payment-Required 付款选项镜像到原本为空的 402 JSON 正文中，以供仍会索引旧版正文的注册表使用。付款选项预检还为工作流构建者提供了等效的 JSON 正文 POST 路由，同时保留已验证的 GET 路由。

版本 1.11.40 将 x402.jobs 添加为第十个公开搜索视图。由于 x402.jobs 搜索采用词法匹配而非语义匹配，该适配器使用确定性且已披露的精简关键词查询，然后保留其公开的人气排序，并检查预期目标路由。SameDayDesk 已验证的自有服务器现在列出了全部十四条 Base 路由，基线为零调用、零金额，因此后续活动可在不将验证或列表流量误称为需求的情况下进行衡量。 Version 1.11.39 在 /.well-known/x402-verification.json 中新增了公开的 x402.jobs 服务所有权证明。此挑战仅用于公开目录声明，不授予任何 API、钱包或支付权限。

Version 1.11.38 新增了独立的 Circle Gateway Nanopayments 访问路径，用于支付报价预检，价格仍为 0.005 USDC。它使用官方的 @circle-fin/x402-batching 3.3.0 卖方中间件，公布 Circle 在运行时报告的各个网络上的 GatewayWalletBatched x402 要求，并将结算款存入卖方的 Gateway 余额。现有的 Base exact、原生 MPP、MCP、产品实现和直连路由均未更改，因此 Gateway 故障不会影响它们。主 OpenAPI 和 x402 清单会公布这条备选路径；MPP OpenAPI 不会将其错误标记为 MPP 路由。

Version 1.11.37 在付费可发现性审计中新增 8004Market，作为第九个公开搜索视图。它会根据已编入索引的 Solana 身份元数据中持久的服务源和路由来匹配目标，同时保留 8004Market 原生的语义排序。

Version 1.11.36 扩展了 Solana 身份元数据，加入实际的路由级功能，以及 Base 和 Solana 的 OpenAPI、skill、x402 和 MPP 发现界面。此前，首轮冻结的 8004Market 基准测试显示，从更宽泛的启动说明中无法检索到任何功能。

Version 1.11.35 新增了 /.well-known/agent-registration.json，这是面向 Solana Agent Registry 的持久 ERC-8004 兼容注册文档。它关联现有的 MCP 和 A2A 界面、Solana x402 和 MPP 商店、专用 Solana 结算钱包，以及明确的 x402 支持。只有注册成功后才会注入链上资产标识符，因此 URI 保持稳定，且该文档不会在身份尚不存在时凭空创建身份。

Version 1.11.34 新增 PayanAgent 公开搜索，作为第八个注册表视图，并明确标注其依赖项。Version 1.11.33 新增了 MPPScan 公开搜索；其公开文本搜索顺序仍与直连上架状态分开。Version 1.11.32 新增了 AgenticTrade；官方 MPP 平面目录仍在本地排序。

支付报价预检路由已上线，价格为 0.005 USDC。它将买方授权边界产品化：获取一个精确公开 GET 路由的未付费请求头，规范化 x402 和 MPP 报价，验证 URL 和 realm 绑定，检测过期和跨协议差异，并在买方签署目标支付前返回范围受限的判定结果。

---

支付通道如何运作（为什么“无需账户”是安全的）

exact 方案通过 EIP-3009 transferWithAuthorization 结算 USDC：买方（Agent）签署授权，将 USDC 直接从其钱包转入我们的 payTo 链上地址。结算服务只会验证签名并广播交易，绝不会持有资金。因此：

• 无论选择哪个结算服务，USDC 都会进入我们的 payTo 钱包。
• 我们持有 payTo 的密钥；结算服务不持有。
• CDP 和 xpay 是非托管结算路径。CDP 转发了八笔在线卖方金丝雀交易，准确的 USDC 金额已到达我们的钱包。

Frantic 曾使用同一支付通道，向这个钱包支付真实的主网 USDC，因此我们已确认向 0x8904…3Cee 结算可正常运作。

---

对五个问题的回答

1. Facilitator + 自主性

• 公开的 x402.org facilitator 仅支持 Base Sepolia 测试网 （eip155:84532）；其 /supported 端点不列出 eip155:8453。 无法通过 x402.org 使用主网。
• Base 主网结算并非严格要求 Coinbase CDP 账户。 xpay 公共 facilitator（https://facilitator.xpay.sh）支持 Base 主网 eip155:8453 的 exact 方案，无需账户或 API 密钥（已通过其实时 /supported 端点验证）。这是完全自主的主网路径。
• CDP facilitator 需要 CDP 账户和 API 密钥。其优势在于 Bazaar 商家发现、 语义搜索和 Bazaar MCP 买家界面。
• 在实时 verify-only 矩阵测试和八次成功结算后，生产环境选择了 CDP。xpay 仍作为无需密钥的备用方案。

2. 精确的卖家代码

请参阅 server.js。当前的软件包版本（不是旧版扁平的 [email protected]）：

@x402/express     2.16.0   paymentMiddleware, x402ResourceServer
@x402/core        2.16.0   HTTPFacilitatorClient   (import from @x402/core/server)
@x402/evm         2.16.0   ExactEvmScheme          (import from @x402/evm/exact/server)
@x402/extensions  2.16.0   declareDiscoveryExtension (import from @x402/extensions/bazaar)
@coinbase/x402    2.1.0    createFacilitatorConfig (only needed for CDP mainnet)
mppx              0.8.15   native MPP EVM charge challenge, credential, and receipt support

核心接线：

const facilitatorClient = new HTTPFacilitatorClient(
  createFacilitatorConfig(process.env.CDP_API_KEY_ID, process.env.CDP_API_KEY_SECRET)
);
const resourceServer = new x402ResourceServer(facilitatorClient)
  .register("eip155:8453", new ExactEvmScheme());

app.use(paymentMiddleware(
  { "GET /premium": { accepts: [{ scheme: "exact", price: "$0.01",
      network: "eip155:8453", payTo: "0x8904dF3DE6DFEe6a7C8cc38619d2f17806213Cee" }],
      description: "...", mimeType: "application/json", extensions: { ... } } },
  resourceServer
));

3. Bazaar 发现

路由的 extensions 使用 declareDiscoveryExtension({ input, inputSchema, output, outputSchema })（已在 server.js 中）。这会在 402 负载中公布路由及其 JSON 架构（已确认实时响应中存在）。 要在 CDP Bazaar 中展示，必须使用 CDP facilitator：CDP 会在路由首次成功 结算后将其编入目录。生产环境的商家查询会返回最初的八个 SameDayDesk 路由；三个 较新的 Morpho 决策路由都已通过 CDP 成功结算并接受了 processing Bazaar 扩展， 但在文档所述的缓存窗口之后仍未显示。CDP 还可通过语义搜索找到最初的 Morpho 和深度审计路由。商家查询反映的是 CDP 目录状态，不应视为 SameDayDesk 功能数量的 权威统计；自有清单、MCP、A2A 和 OpenAPI 界面仍完整包含十四项功能。

CDP 拒绝了三个较旧的路由负载，其发现描述长度分别为 535、581 和 629 个字符， 尽管本地扩展验证已通过。精简改写后的长度分别为 294、258 和 301 个字符，均已 通过。之后的标准 x402 2.22.0 边界测试确定了确切的兼容性限制：501 个字符会被 拒绝，而 500 个字符则会在所有四个扩展均完整的情况下进入 facilitator 签名验证。 启动和界面测试现在会拒绝任何超过 500 个 Unicode 码位的资源。在注入资金进行 金丝雀测试前，先运行 CDP 实时 verify。

4. 结算验证

付费调用后，确认 USDC 已到达 Base 主网上的 payTo 地址。402/200 流程还会返回 包含结算数据的 PAYMENT-RESPONSE 标头。也可以独立验证：

# USDC balanceOf(payTo) on Base mainnet via public RPC, no key:
curl -s -X POST https://mainnet.base.org -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"eth_call","params":[{
    "to":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "data":"0x70a082310000000000000000000000008904df3de6dfee6a7c8cc38619d2f17806213cee"
  },"latest"]}'

结果是十六进制的 USDC 原子单位（除以 1e6）。也可以使用我们现有的 Base 主网 余额检查器。或者在 https://basescan.org/address/0x8904dF3DE6DFEe6a7C8cc38619d2f17806213Cee 查看钱包

5. 最推荐的简洁方案

**在 CDP 上部署生产店面。**它保留直接 USDC 结算，并增加目录、语义搜索、商家查询 和 Bazaar MCP 买家界面。将 xpay 配置为无需密钥的恢复方案。

---

部署步骤（Railway）

该仓库是一个无需配置的 Node 应用：npm start 会运行 node server.js 并绑定到 process.env.PORT（Railway 会设置该变量）。

1. 直接部署此目录，或推送仓库源代码。

2. 在 Railway 服务上设置环境变量：

   PAY_TO=0x8904dF3DE6DFEe6a7C8cc38619d2f17806213Cee
   NETWORK=eip155:8453
   PRICE=$0.05
   FACILITATOR=cdp
   CDP_API_KEY_ID=<CDP API key ID>
   CDP_API_KEY_SECRET=<CDP API key secret>
   MPP_SECRET_KEY=<random secret of at least 32 bytes>
   COMMERCE_DATA_DIR=/data
   COMMERCE_ACTOR_SECRET=<random 32-byte secret>
   COMMERCE_INTERNAL_TOKEN=<random owner-canary token of at least 32 UTF-8 bytes>
   COMMERCE_MCP_TYPED_SINCE=<ISO timestamp for the accepted typed-MCP producer generation>
   COMMERCE_EXTERNAL_SINCE=<ISO timestamp after controlled launch canaries>
   COMMERCE_AGENT_SOURCE_DETAIL_SINCE=<ISO timestamp after provider taxonomy release>
   COMMERCE_SETTLEMENT_EVIDENCE_SINCE=<ISO timestamp after settlement-proof release>
   COMMERCE_PAYER_CLASSES='[{"address":"0x...","class":"validation"}]'
   

   核心支付设置有安全默认值。生产遥测需要挂载到 /data 的 Railway 卷，以及上方的两个密钥变量。

   只有在请求提供了准确的内部令牌，以及一个与 [A-Za-z0-9._~-]{16,128} 匹配的唯一 x-samedaydesk-validation-marker 时，才会将发布验证 MCP 请求归因于该请求。存储的行中仅包含该标记经过域分离的 SHA-256 摘要。切勿重复使用标记、将其原始值与遥测数据一同持久化，或将生成的卖家运营验证行归类为独立需求、结算、会计或收入。

3. 为该服务生成公共域名。

4. 验证：

   curl https://<your-domain>/healthz          # -> {ok:true, network:eip155:8453, ...}
   curl -i 'https://<your-domain>/defi/morpho-position?address=0x...' # -> HTTP 402 + WWW-Authenticate and PAYMENT-REQUIRED
   

5. 为每条可发现路由完成一次有界结算，然后确认商家查询和语义搜索。将所有者结算记录为测试流程，而非收入。

无需更改路由代码即可回退到 xpay

如果 CDP 不可用，且连续性比集中发现更重要，请设置：

FACILITATOR=xpay

重新部署。Base 主网结算会继续，但新调用不再为 CDP Bazaar 质量和活动信号提供数据。

先在测试网上验证支付通道（可选）

FACILITATOR=testnet
NETWORK=eip155:84532

使用 x402.org 和 Base Sepolia（虚假 USDC），在接收主网资金前验证完整的 402→支付→200 流程。

---

Claude Code 市场

此仓库根目录是一个 Claude Code 市场。目录清单为 .claude-plugin/marketplace.json。自包含插件位于 plugins/samedaydesk-extract。这种布局与 plugins/samedaydesk-x402 中的 Agent Plugins 1.0 软件包格式不同。两者都要保留。

此目录清单位于公共默认分支后，可按常规方式安装：

/plugin marketplace add epistemedeus/x402-url-extractor
/plugin install samedaydesk-extract@samedaydesk-claude

然后使用一个公共 HTTPS URL 调用 /samedaydesk-extract:web-extract；批量调用时，使用 1–5 个 URL，并明确指定所需字段。 发现不收费。支付仍通过 SameDayDesk 现行的 402 流程进行。如果现有的买家授权已涵盖确切的现行方法、请求体和条款，则可使用该授权。列出和安装均不会授予任何权限。支付结果未知时应进行核对，而非重试。安装并不能证明模型调用、支付或需求。对于已持有的提取 JSON，可使用 --input、--mapping、--schema 和一个新的 --out 目录调用 /samedaydesk-extract:explicit-record。该技能不会获取数据或付款。 这不是向 Anthropic 官方插件目录提交的插件。有关针对 POST /extract/batch（默认）和向后兼容的 GET /extract 的无凭证 HTTP 预检及经明确授权的 @x402/fetch 购买路径（包括可选的发送前未签名尝试回执和只读核对），请参阅 examples/customer-x402。该示例不会让 Claude 具备支付能力。MCP 和 HTTP 凭证范围彼此独立。

在仓库根目录执行维护者检查：

npm run test:claude-marketplace
npm run test:claude-marketplace:live
claude plugin validate .
claude plugin validate ./plugins/samedaydesk-extract --strict

不要将 Claude 加入此仓库的系统 PATH。请使用已有二进制文件或任务本地二进制文件。GitHub 的 owner/repo 添加操作要等目录清单位于公共默认分支后才能视为已验证。在此之前，请在全新的隔离配置文件中检查本地 git 克隆，不要更改现有安装：

export CLAUDE_CONFIG_DIR="$(mktemp -d "${TMPDIR:-/tmp}/samedaydesk-claude.XXXXXX")"
export CLAUDE_CODE_PLUGIN_CACHE_DIR="$CLAUDE_CONFIG_DIR/plugins"
export DISABLE_AUTOUPDATER=1 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
unset ANTHROPIC_API_KEY ANTHROPIC_AUTH_TOKEN CLAUDE_CODE_OAUTH_TOKEN CLAUDE_API_KEY
claude plugin marketplace add "$PWD" --scope user
claude plugin install samedaydesk-extract@samedaydesk-claude --scope user --yes
claude plugin list --json

检查完成后，运行 unset CLAUDE_CONFIG_DIR CLAUDE_CODE_PLUGIN_CACHE_DIR，停止使用该配置文件。临时文件会保留；未提供清理辅助工具。

Goose 原生配置

配套的 Goose streamable_http 文件位于 goose/。它们不会安装 Goose、修改默认配置文件，也不会声称商家归属。使用维护中的 HTTP 客户端付费调用 POST /extract/batch 或 GET /extract，仍需使用 examples/customer-x402；仅安装 Goose 并不具备支付能力。

Goose 已安装时，可复制使用的隔离配置文件：

export GOOSE_PATH_ROOT="$(mktemp -d "${TMPDIR:-/tmp}/samedaydesk-goose.XXXXXX")"
mkdir "$GOOSE_PATH_ROOT/config"
cp goose/goose.config.isolated.yaml "$GOOSE_PATH_ROOT/config/config.yaml"
GOOSE_TELEMETRY_OFF=1 GOOSE_DISABLE_KEYRING=1 goose info -v

goose info -v 会读取该隔离配置。它不会开启 MCP 会话。实时的免费发现是单独的 initialize 加 tools/list 检查（npm run test:goose-native:live）。要求存在 extract 和 extract_batch，且它们具有实时输入／输出架构；允许存在其他无关工具。本仓库不包含 Goose fixture MCP 加载器。

默认 YAML 不会发送源站标头。可选的 goose/goose.config.with-declared-source.yaml 未经身份验证，未列入商家允许列表，也不会声称商家归属。

会话标志：

goose session --with-streamable-http-extension "https://agents.samedaydesk.com/mcp"

深度链接：goose/goose.deeplink.txt。

维护者打包检查：npm run test:goose-native。 离线记录方案：goose/record.recipe.yaml 加上 goose/record.workflow.md。如果已安装 Goose，请在全新的隔离配置文件中运行 goose recipe validate goose/record.recipe.yaml 进行验证。该检查不会执行模型，也不会获取或支付。

Hermes Agent 技能

Hermes Agent（Nous Research）已能加载便携式 AgentSkills SKILL.md 文件。本仓库不会添加 Hermes 插件、MCP YAML、钱包或第二道付费墙。现有的 extract 技能位于 plugins/samedaydesk-x402/skills/web-extract/SKILL.md。 离线页面变更方案位于 plugins/samedaydesk-x402/skills/page-change/SKILL.md。

可复制的隔离发现流程，不会触碰 ~/.hermes，也不会调用模型：

export HERMES_HOME="$(mktemp -d "${TMPDIR:-/tmp}/samedaydesk-hermes.XXXXXX")"
HERMES_HOME="$HERMES_HOME" HERMES_AGENT_SRC=/path/to/NousResearch/hermes-agent \
  python3 hermes/check-isolated-loader.py

商家也会在官方 well-known 索引 /.well-known/skills/index.json 提供这三项便携式技能。部署后：

export HERMES_HOME="$(mktemp -d "${TMPDIR:-/tmp}/samedaydesk-hermes.XXXXXX")"
hermes skills search https://agents.samedaydesk.com --source well-known
hermes skills inspect well-known:https://agents.samedaydesk.com/.well-known/skills/web-extract
hermes skills install well-known:https://agents.samedaydesk.com/.well-known/skills/web-extract --yes

check-isolated-loader.py 要求使用全新、空白的一次性配置文件，复制这三项技能，并调用 Hermes 官方的 agent.skill_utils 发现 API。它不会全局安装 Hermes、登录模型提供商、打开钱包或执行模型。发现和支付执行是分开的检查。

Git checkout 中的项目本地 .hermes/skills 或 .agents/skills 不会自动加载。Hermes 要求对此根目录运行 hermes skills trust。这是一个操作员审批关卡。此软件包不会添加这些目录。

技能路径存在于公共默认分支后，已安装 Hermes 的用户也可以运行：

hermes skills install epistemedeus/x402-url-extractor/plugins/samedaydesk-x402/skills/web-extract
hermes skills install epistemedeus/x402-url-extractor/plugins/samedaydesk-x402/skills/page-change

该 Hub 路径会将技能复制到该用户的配置文件中，并运行社区安全扫描。请勿从本仓库对已完成身份验证的配置文件运行此命令。使用维护中的 HTTP 客户端付费调用 POST /extract/batch 或 GET /extract，仍需使用 examples/customer-x402。该示例不会让 Hermes 具备支付能力。MCP 和 HTTP 凭据的作用域仍然彼此独立。

可复制的安装说明：hermes/INSTALL.txt。 维护者打包检查：npm run test:hermes-native。 设置 HERMES_AGENT_SRC 后验证官方加载器： npm run test:hermes-native:loader。网站索引适配器重放，遵循相同的隔离配置文件规则；绝不针对 ~/.hermes 运行，也绝不使用 --force 或 allow_private_urls：npm run test:hermes-native:well-known。

本地运行

npm install
npm start
# then:
curl -i 'http://localhost:3000/defi/morpho-position?address=0x...' # HTTP 402

文件

• server.js — 服务端（由环境变量驱动的协调器／网络／价格）。
• commerce-events.mjs — 隐私安全的持久化需求遥测。
• mpp-dual-stack.mjs — 同一路由原生 MPP 授权和收据适配器。
• morpho-position.mjs — 确定性的 Morpho 快照、压力测试和 RPC 检查。
• morpho-protection.mjs — 精确的压力情景修复金额和未签名操作模板。
• morpho-market-underwrite.mjs — 多来源的市场完整性、流动性、集中度、借款人健康状况、历史记录、坏账和 PreLiquidation 证据。
• morpho-preliquidation-replay.mjs — 通过直接读取区块状态获取的历史 PreLiquidate 事件经济数据。
• morpho-preliquidation-census.mjs — 可重复的 Base 供应、授权和执行普查，用于内部市场筛选。
• package.json — 精确固定的依赖项（已验证可安装并启动）。
• .claude-plugin/marketplace.json — Claude Code 市场目录。
• plugins/samedaydesk-extract/ — 独立的 Claude Code 插件（不是 Agent Plugins 1.0）。
• goose/：原生 Goose streamable_http 配置、提取和记录配方，以及工作流副本。
• hermes/：隔离的 Hermes AgentSkills 安装说明和官方加载器检查器。
• examples/customer-x402/ — 无需凭据的预检，以及明确授权的 @x402/fetch 购买示例，适用于 POST /extract/batch （默认）和向后兼容的 GET /extract。
• README.md — 本指南。
• extract.mjs — 现有的零依赖“URL → 清洁结构化数据”服务。将它放到 /premium 后面是很自然的付费资源：在 路由处理程序中，调用它的提取器处理 ?url= 查询参数，并返回结构化结果，而不是占位符 {value:42}。接入时，将 ?url 添加到 Bazaar 的 inputSchema 中。

来源（主要来源，已于 2026 年 8 月核实）

• x402 卖家快速入门：https://docs.x402.org/getting-started/quickstart-for-sellers
• CDP x402 文档：https://docs.cdp.coinbase.com/x402/welcome
• CDP 网络支持（x402.org 仅支持测试网；CDP 支持主网和密钥）：https://docs.cdp.coinbase.com/x402/network-support
• CDP Bazaar：https://docs.cdp.coinbase.com/x402/bazaar
• x402 单体仓库：https://github.com/coinbase/x402
• npm：@x402/express、@x402/core、@x402/evm、@x402/extensions、@coinbase/x402
• xpay 公共协调器实时 /supported（Base 主网，无需密钥）：https://facilitator.xpay.sh/supported