From 0d4981ecd3a5d4f98caeabcea6670ac7ea146178 Mon Sep 17 00:00:00 2001 From: Angela Gilhotra Date: Tue, 16 Jun 2026 00:19:58 -0400 Subject: [PATCH 1/2] docs: add pre-production testing tip to facilitators reference Demo change to showcase the i18n translation CI workflow. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/pages/en/reference/agentic-facilitators.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/pages/en/reference/agentic-facilitators.mdx b/docs/pages/en/reference/agentic-facilitators.mdx index 04ed6e6..5cf746b 100755 --- a/docs/pages/en/reference/agentic-facilitators.mdx +++ b/docs/pages/en/reference/agentic-facilitators.mdx @@ -55,6 +55,7 @@ Point your middleware at `https://facilitator.heurist.xyz`. No API key is requir - Use a hosted facilitator (Semantic Pay or Heurist) to start fast. No infrastructure to run, no gas tokens to manage. - Pick by what matters most for your workload: Semantic Pay if you want Stable-native tooling with lifecycle callbacks and agent oversight controls; Heurist if you need a single endpoint that spans Stable plus other EVM networks, or if OFAC screening is a hard requirement. - Self-host if you need full control over settlement policy, want to keep payment data in your own environment, or expect volume that justifies the operational overhead. +- Whichever route you choose, test against a small payment first to confirm verification and settlement behave as you expect before sending production traffic. - Both facilitators settle x402 on Stable today. The same `/settle` endpoint can also serve as the on-chain submission target for an MPP server, since MPP's wire format only differs from x402 on the client ↔ resource-server hop. See [Build an MPP endpoint on Stable](/en/how-to/build-mpp-endpoint). --- From e78d2c991bd26bfa8158d619eef21486ba674490 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Tue, 16 Jun 2026 04:21:43 +0000 Subject: [PATCH 2/2] i18n: auto-translate cn/ko for changed en content --- .../cn/reference/agentic-facilitators.mdx | 53 ++++++++++--------- .../ko/reference/agentic-facilitators.mdx | 29 +++++----- 2 files changed, 42 insertions(+), 40 deletions(-) diff --git a/docs/pages/cn/reference/agentic-facilitators.mdx b/docs/pages/cn/reference/agentic-facilitators.mdx index b40f96e..7438247 100644 --- a/docs/pages/cn/reference/agentic-facilitators.mdx +++ b/docs/pages/cn/reference/agentic-facilitators.mdx @@ -1,34 +1,34 @@ --- source_path: reference/agentic-facilitators.mdx -source_sha: 04ed6e6dfcf00c9a5b1d3bb17c3cd9db40f7e5b2 -title: "结算服务商" -description: "在 Stable 上验证并提交 x402 智能体支付的结算服务，让你无需自行运行基础设施。" +source_sha: 5cf746b0d59fef3aa6e7b08015a429884f044d41 +title: "结算服务商（Facilitators）" +description: "在 Stable 上验证并提交 x402 代理支付的结算服务，让你无需自行运行基础设施。" diataxis: "reference" --- -# 结算服务商 +# 结算服务商（Facilitators） -结算服务商（facilitator）负责验证已签名的 x402 支付，并提交在 Stable 上以 USDT0 进行结算的链上调用。使用托管的结算服务商意味着你无需运行结算基础设施或管理 gas 代币。关于支付通道层面的背景信息，请参阅 [智能体结算](/cn/explanation/agent-settlement)。 +结算服务商（facilitator）负责验证已签名的 x402 支付，并提交在 Stable 上以 USDT0 结算的链上调用。使用托管的结算服务商意味着你无需运行结算基础设施或管理 gas 代币。如需了解通道层面的背景信息，请参阅 [代理结算](/cn/explanation/agent-settlement)。 -## 总览表 +## 概览表 | **服务商** | **类别** | **文档 / 快速开始** | **说明** | | :--- | :--- | :--- | :--- | -| [**Semantic Pay**](https://x402.semanticpay.io) | x402 结算服务商 | [https://docs.semanticpay.io/supported-chains#stable](https://docs.semanticpay.io/supported-chains#stable) | 面向 Stable 的公开 x402 结算服务商；通过 ERC-3009 验证并结算 USDT0 支付 | -| [**Heurist**](https://facilitator.heurist.xyz) | x402 结算服务商 | [https://docs.heurist.ai/x402-products/facilitator#supported-networks](https://docs.heurist.ai/x402-products/facilitator#supported-networks) | 支持 Stable 的多链 x402 结算服务商；具备高吞吐量验证与结算，并提供 OFAC 筛查 | +| [**Semantic Pay**](https://x402.semanticpay.io) | x402 结算服务商 | [https://docs.semanticpay.io/supported-chains#stable](https://docs.semanticpay.io/supported-chains#stable) | 面向 Stable 的公共 x402 结算服务商；通过 ERC-3009 验证并结算 USDT0 支付 | +| [**Heurist**](https://facilitator.heurist.xyz) | x402 结算服务商 | [https://docs.heurist.ai/x402-products/facilitator#supported-networks](https://docs.heurist.ai/x402-products/facilitator#supported-networks) | 支持 Stable 的多链 x402 结算服务商；高吞吐量的验证与结算，并具备 OFAC 筛查 | ## Semantic Pay -面向 AI 智能体的支付基础设施：无需信任、点对点、无需许可。Semantic Pay 作为兼容 x402 的支付结算服务商运行于 Stable 之上，通过 ERC-3009（`transferWithAuthorization`）结算 USDT0 支付。智能体的钱包中无需单独的 gas 代币。 +面向 AI 代理的支付基础设施：无需信任、点对点、无需许可。Semantic Pay 在 Stable 上作为兼容 x402 的支付结算服务商运行，通过 ERC-3009（`transferWithAuthorization`）结算 USDT0 支付。代理无需在其钱包中持有单独的 gas 代币。 在 Stable 上集成 x402 的开发者只需将其中间件指向 `https://x402.semanticpay.io`，无需任何自定义结算基础设施。 -**功能特性** +**能力** -- 通过 USDT0 进行支付负载验证（`/verify`）和链上结算（`/settle`） -- 使用 ERC-3009 `transferWithAuthorization` 实现无 gas 转账 -- 用于智能体监管的支出限额、审批流程和紧急停止开关 -- 端到端可追溯性，提供从意图到结算的完整审计日志 +- 通过 USDT0 进行支付载荷验证（`/verify`）和链上结算（`/settle`） +- 使用 ERC-3009 `transferWithAuthorization` 的无 gas 转账 +- 用于代理监管的消费限额、审批流程和紧急停止开关 +- 从意图到结算的全程可追溯，具备完整的审计日志 - 用于实时支付生命周期更新的事件回调 **结算服务商端点：** `https://x402.semanticpay.io` @@ -37,16 +37,16 @@ diataxis: "reference" ## Heurist -Heurist 运营一个支持 Stable 以及 Base、Base Sepolia 和 X Layer 的多链 x402 结算服务商。它面向高频智能体工作负载，吞吐量经过调优，可达到每秒数千次支付验证与结算。 +Heurist 运营一个多链 x402 结算服务商，支持 Stable 以及 Base、Base Sepolia 和 X Layer。它面向高频代理工作负载，吞吐量经过调优，每秒可处理数千次支付验证和结算。 -将你的中间件指向 `https://facilitator.heurist.xyz`。开始使用无需 API 密钥。 +将你的中间件指向 `https://facilitator.heurist.xyz`。无需 API 密钥即可开始使用。 -**功能特性** +**能力** -- 通过单一端点跨多个网络进行支付验证和链上结算 -- 为高频智能体流量量身定制的吞吐量 -- 对发送方地址自动进行 OFAC 筛查 -- 对验证和结算活动进行实时可观测性监控 +- 从单一端点跨多个网络进行支付验证和链上结算 +- 为高频代理流量量身打造的吞吐量 +- 自动对发送方地址进行 OFAC 筛查 +- 对验证和结算活动的实时可观测性 **结算服务商端点：** `https://facilitator.heurist.xyz` @@ -54,11 +54,12 @@ Heurist 运营一个支持 Stable 以及 Base、Base Sepolia 和 X Layer 的多 ## 如何选择 -- 使用托管的结算服务商（Semantic Pay 或 Heurist）可快速上手。无需运行基础设施，也无需管理 gas 代币。 -- 根据对你的工作负载最重要的因素来选择：如果你想要 Stable 原生工具，并需要生命周期回调和智能体监管控制，选择 Semantic Pay；如果你需要一个跨越 Stable 及其他 EVM 网络的单一端点，或者 OFAC 筛查是硬性要求，选择 Heurist。 -- 如果你需要对结算策略拥有完全控制权、希望将支付数据保留在自己的环境中，或预期流量足以证明运维开销的合理性，则可自行托管。 -- 目前两家结算服务商都能在 Stable 上结算 x402。同一个 `/settle` 端点也可以作为 MPP 服务器的链上提交目标，因为 MPP 的传输格式仅在客户端 ↔ 资源服务器这一跳上与 x402 不同。请参阅 [在 Stable 上构建 MPP 端点](/cn/how-to/build-mpp-endpoint)。 +- 使用托管的结算服务商（Semantic Pay 或 Heurist）可以快速起步。无需运行基础设施，也无需管理 gas 代币。 +- 根据你的工作负载中最看重的方面进行选择：如果你想要具备生命周期回调和代理监管控制的 Stable 原生工具，选择 Semantic Pay；如果你需要一个同时覆盖 Stable 及其他 EVM 网络的单一端点，或者 OFAC 筛查是硬性要求，选择 Heurist。 +- 如果你需要对结算策略拥有完全控制权、希望将支付数据保留在自己的环境中，或预期的交易量足以证明运维开销是值得的，则可以自行托管。 +- 无论你选择哪种方式，都应先用一笔小额支付进行测试，确认验证和结算行为符合你的预期，然后再发送生产流量。 +- 这两个结算服务商目前都可在 Stable 上结算 x402。同一个 `/settle` 端点也可以作为 MPP 服务器的链上提交目标，因为 MPP 的线路格式仅在客户端 ↔ 资源服务器这一跳上与 x402 有所不同。参阅 [在 Stable 上构建 MPP 端点](/cn/how-to/build-mpp-endpoint)。 --- -已经在 Stable 上集成了智能体支付？请通过 [bizdev@stable.xyz](mailto:bizdev@stable.xyz) 与我们联系。 +已经有与 Stable 的代理支付集成？请通过 [bizdev@stable.xyz](mailto:bizdev@stable.xyz) 与我们联系。 diff --git a/docs/pages/ko/reference/agentic-facilitators.mdx b/docs/pages/ko/reference/agentic-facilitators.mdx index c371447..6436b19 100644 --- a/docs/pages/ko/reference/agentic-facilitators.mdx +++ b/docs/pages/ko/reference/agentic-facilitators.mdx @@ -1,34 +1,34 @@ --- source_path: reference/agentic-facilitators.mdx -source_sha: 04ed6e6dfcf00c9a5b1d3bb17c3cd9db40f7e5b2 +source_sha: 5cf746b0d59fef3aa6e7b08015a429884f044d41 title: "퍼실리테이터" -description: "Stable에서 x402 에이전트 결제를 검증하고 제출하는 정산 서비스로, 자체 인프라를 운영할 필요가 없습니다." +description: "Stable에서 x402 에이전트 결제를 검증하고 제출하는 정산 서비스로, 직접 인프라를 운영할 필요가 없습니다." diataxis: "reference" --- # 퍼실리테이터 -퍼실리테이터는 서명된 x402 결제를 검증하고 이를 Stable의 USDT0로 정산하는 온체인 호출을 제출합니다. 호스팅된 퍼실리테이터를 사용하면 정산 인프라를 운영하거나 가스 토큰을 관리할 필요가 없습니다. 레일 수준의 맥락은 [에이전트 정산](/ko/explanation/agent-settlement)을 참조하세요. +퍼실리테이터는 서명된 x402 결제를 검증하고, 이를 Stable에서 USDT0로 정산하는 온체인 호출을 제출합니다. 호스팅된 퍼실리테이터를 사용하면 정산 인프라를 운영하거나 가스 토큰을 관리할 필요가 없습니다. 레일 수준의 맥락은 [에이전트 정산](/ko/explanation/agent-settlement)을 참조하세요. ## 개요 표 -| **제공자** | **카테고리** | **문서 / 시작하기** | **참고** | +| **제공업체** | **카테고리** | **문서 / 시작하기** | **비고** | | :--- | :--- | :--- | :--- | | [**Semantic Pay**](https://x402.semanticpay.io) | x402 퍼실리테이터 | [https://docs.semanticpay.io/supported-chains#stable](https://docs.semanticpay.io/supported-chains#stable) | Stable용 공개 x402 퍼실리테이터; ERC-3009를 통해 USDT0 결제를 검증하고 정산 | | [**Heurist**](https://facilitator.heurist.xyz) | x402 퍼실리테이터 | [https://docs.heurist.ai/x402-products/facilitator#supported-networks](https://docs.heurist.ai/x402-products/facilitator#supported-networks) | Stable을 지원하는 멀티체인 x402 퍼실리테이터; OFAC 스크리닝을 갖춘 고처리량 검증 및 정산 | ## Semantic Pay -AI 에이전트를 위한 결제 인프라: 신뢰 불필요(trustless), P2P, 무허가(permissionless). Semantic Pay는 Stable에서 x402 호환 결제 퍼실리테이터로 작동하며, ERC-3009(`transferWithAuthorization`)를 통해 USDT0 결제를 정산합니다. 에이전트는 지갑에 별도의 가스 토큰이 필요하지 않습니다. +AI 에이전트를 위한 결제 인프라: 트러스트리스, P2P, 무허가형. Semantic Pay는 Stable에서 x402 호환 결제 퍼실리테이터로 작동하며, ERC-3009(`transferWithAuthorization`)를 통해 USDT0 결제를 정산합니다. 에이전트는 지갑에 별도의 가스 토큰이 필요하지 않습니다. -Stable에서 x402를 통합하는 개발자는 미들웨어를 `https://x402.semanticpay.io`로 지정합니다. 별도의 맞춤형 정산 인프라가 필요하지 않습니다. +Stable에서 x402를 통합하는 개발자는 미들웨어를 `https://x402.semanticpay.io`로 지정합니다. 별도의 정산 인프라가 필요하지 않습니다. **기능** - USDT0를 통한 결제 페이로드 검증(`/verify`) 및 온체인 정산(`/settle`) - ERC-3009 `transferWithAuthorization`를 사용한 가스리스 전송 -- 에이전트 감독을 위한 지출 한도, 승인 플로우, 킬 스위치 -- 의도부터 정산까지 전체 감사 로깅을 통한 엔드 투 엔드 추적성 +- 에이전트 감독을 위한 지출 한도, 승인 흐름 및 킬 스위치 +- 인텐트부터 정산까지 전체 감사 로깅을 갖춘 엔드투엔드 추적성 - 실시간 결제 라이프사이클 업데이트를 위한 이벤트 콜백 **퍼실리테이터 엔드포인트:** `https://x402.semanticpay.io` @@ -45,8 +45,8 @@ Heurist는 Base, Base Sepolia, X Layer와 함께 Stable을 지원하는 멀티 - 하나의 엔드포인트에서 여러 네트워크에 걸친 결제 검증 및 온체인 정산 - 고빈도 에이전트 트래픽에 맞춘 처리량 -- 발신자 주소에 대한 자동 OFAC 스크리닝 -- 검증 및 정산 활동에 대한 실시간 관측성(observability) +- 발신자 주소의 자동 OFAC 스크리닝 +- 검증 및 정산 활동에 대한 실시간 가시성 **퍼실리테이터 엔드포인트:** `https://facilitator.heurist.xyz` @@ -55,10 +55,11 @@ Heurist는 Base, Base Sepolia, X Layer와 함께 Stable을 지원하는 멀티 ## 선택 방법 - 빠르게 시작하려면 호스팅된 퍼실리테이터(Semantic Pay 또는 Heurist)를 사용하세요. 운영할 인프라도, 관리할 가스 토큰도 없습니다. -- 워크로드에 가장 중요한 것을 기준으로 선택하세요: 라이프사이클 콜백과 에이전트 감독 제어를 갖춘 Stable 네이티브 도구를 원한다면 Semantic Pay; Stable과 기타 EVM 네트워크를 아우르는 단일 엔드포인트가 필요하거나 OFAC 스크리닝이 필수 요건이라면 Heurist를 선택하세요. -- 정산 정책에 대한 완전한 제어가 필요하거나, 결제 데이터를 자체 환경에 유지하고자 하거나, 운영 오버헤드를 정당화할 만한 볼륨이 예상된다면 자체 호스팅을 하세요. -- 두 퍼실리테이터 모두 현재 Stable에서 x402를 정산합니다. MPP의 와이어 포맷은 클라이언트 ↔ 리소스 서버 구간에서만 x402와 다르기 때문에, 동일한 `/settle` 엔드포인트는 MPP 서버의 온체인 제출 대상으로도 사용할 수 있습니다. [Stable에서 MPP 엔드포인트 구축하기](/ko/how-to/build-mpp-endpoint)를 참조하세요. +- 워크로드에서 가장 중요한 것을 기준으로 선택하세요: 라이프사이클 콜백과 에이전트 감독 제어 기능을 갖춘 Stable 네이티브 도구를 원한다면 Semantic Pay, Stable과 기타 EVM 네트워크를 아우르는 단일 엔드포인트가 필요하거나 OFAC 스크리닝이 필수 요건이라면 Heurist를 선택하세요. +- 정산 정책에 대한 완전한 제어가 필요하거나, 결제 데이터를 자체 환경에 보관하고 싶거나, 운영 부담을 정당화할 만한 볼륨이 예상된다면 자체 호스팅하세요. +- 어떤 경로를 선택하든, 프로덕션 트래픽을 보내기 전에 먼저 소액 결제로 테스트하여 검증과 정산이 예상대로 작동하는지 확인하세요. +- 두 퍼실리테이터 모두 현재 Stable에서 x402를 정산합니다. MPP의 와이어 포맷은 클라이언트 ↔ 리소스 서버 홉에서만 x402와 다르기 때문에, 동일한 `/settle` 엔드포인트는 MPP 서버의 온체인 제출 대상으로도 사용할 수 있습니다. [Stable에서 MPP 엔드포인트 구축하기](/ko/how-to/build-mpp-endpoint)를 참조하세요. --- -Stable과의 에이전틱 결제 통합이 있으신가요? [bizdev@stable.xyz](mailto:bizdev@stable.xyz)로 연락주세요. +Stable과의 에이전트 결제 통합을 보유하고 계신가요? [bizdev@stable.xyz](mailto:bizdev@stable.xyz)로 문의하세요.