From 7cc298201236a29f6165f63867f8b6209f75726d Mon Sep 17 00:00:00 2001 From: Jane Wang Date: Wed, 18 Feb 2026 13:48:23 -0500 Subject: [PATCH 1/7] Add x402 page on dev docs --- config/theme/navbar.ts | 5 +++++ docs/build/apps/x402.mdx | 39 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 44 insertions(+) create mode 100644 docs/build/apps/x402.mdx diff --git a/config/theme/navbar.ts b/config/theme/navbar.ts index 6ab0ddb65e..7172631e87 100644 --- a/config/theme/navbar.ts +++ b/config/theme/navbar.ts @@ -79,6 +79,11 @@ const build: NavbarItem = { label: 'Tutorial: Dapp Frontend', activeBasePath: 'docs/build/apps/dapp-frontend', }, + { + to: '/docs/build/apps/x402', + label: 'x402 on Stellar', + activeBasePath: 'docs/build/apps/x402', + }, { to: '/docs/build/apps/zk', label: 'ZK Proofs on Stellar', diff --git a/docs/build/apps/x402.mdx b/docs/build/apps/x402.mdx new file mode 100644 index 0000000000..12f5bb11bb --- /dev/null +++ b/docs/build/apps/x402.mdx @@ -0,0 +1,39 @@ +--- +title: x402 on Stellar +sidebar_position: 74 +sidebar_label: x402 +description: "Use the x402 protocol for per-request HTTP payments on Stellar, with support for AI agents and APIs." +--- + +## What is x402? + +x402 is an open protocol from the Coinbase Developer Platform that enables programmatic, per request payments over HTTP, designed especially for AI agents and APIs. It effectively turns the old “402 Payment Required” HTTP status code into something usable, for both humans and AI agents. + +On Stellar, x402 works with Soroban authorization so that clients can pay for API requests via signed auth entries, ideal for micropayments and payment enabled apps. To build an x402-enabled service or integrate payments into your app, see [Build Applications](./README.mdx) and the resources below. + +## x402 Compatible Wallets + +To support x402 on Stellar, a wallet must support [auth-entry signing](../guides/transactions/signing-soroban-invocations.mdx#method-2-auth-entry-signing) (Soroban authorization entry signing). The following wallets support auth-entry signing: + +- Freighter Browser Extension +- Albedo +- Hana +- HOT +- Klever +- One Key + +:::note Freighter Mobile does not currently support x402; use the Freighter browser extension. Mobile support is planned for a future release. ::: + +## x402 Facilitator + +The [OpenZeppelin Relayer](https://github.com/OpenZeppelin/relayer-plugin-x402-) is enabled as an x402 Facilitator on Stellar, allowing relayed and sponsored flows for x402 payments. + +## Resources + +- **x402 Starter Template** — A starter template for building payment-enabled applications with x402. Simplified scaffolding demonstrating x402 payment protocol integration with browser wallet support; use it as a foundation for micropayment-enabled services, SaaS applications, or any project that needs frictionless web payments. [View on GitHub](https://github.com/ElliotFriend/x402/tree/stellar-browser-wallet-example/examples/typescript/fullstack/browser-wallet-example) +- **Economic Load Balancer** — An intelligent multi-chain payment router that automatically selects the most cost-efficient network for high-frequency AI agent micropayments. [View on GitHub](https://github.com/marcelosalloum/x402/tree/x402-hackathon) + +## Learn more + +- [x402 protocol (Coinbase Developer Platform)](https://docs.cdp.coinbase.com/x402) — Official x402 protocol overview and spec +- [Signing Soroban invocations](../guides/transactions/signing-soroban-invocations.mdx) — Auth-entry signing and transaction signing on Stellar From 865b6d70aec8217c9c0ee70d2623b5ce98781e8d Mon Sep 17 00:00:00 2001 From: Jane Wang Date: Wed, 18 Feb 2026 13:52:18 -0500 Subject: [PATCH 2/7] Add format fix --- docs/build/apps/x402.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/build/apps/x402.mdx b/docs/build/apps/x402.mdx index 12f5bb11bb..546e7fc598 100644 --- a/docs/build/apps/x402.mdx +++ b/docs/build/apps/x402.mdx @@ -22,7 +22,11 @@ To support x402 on Stellar, a wallet must support [auth-entry signing](../guides - Klever - One Key -:::note Freighter Mobile does not currently support x402; use the Freighter browser extension. Mobile support is planned for a future release. ::: +::::note + +Freighter Mobile does not currently support x402; use the Freighter browser extension. Mobile support is planned for a future release. + +:::: ## x402 Facilitator From 7a81156df1ac4b40ec87e7f17ea3d0478fa7f9db Mon Sep 17 00:00:00 2001 From: Jane Wang Date: Wed, 18 Feb 2026 15:15:01 -0500 Subject: [PATCH 3/7] Update routes.txt --- routes.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/routes.txt b/routes.txt index a938acb244..e63f373851 100644 --- a/routes.txt +++ b/routes.txt @@ -42,6 +42,7 @@ /docs/build/apps/wallet/sep6 /docs/build/apps/wallet/sep7 /docs/build/apps/wallet/stellar +/docs/build/apps/x402 /docs/build/apps/zk /docs/build/guides /docs/build/guides/archival From 74c75975c493a07b57d5e65059a542600376d66e Mon Sep 17 00:00:00 2001 From: Jane Wang Date: Wed, 18 Feb 2026 15:28:15 -0500 Subject: [PATCH 4/7] Update docs/build/apps/x402.mdx Co-authored-by: Elliot Voris --- docs/build/apps/x402.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/apps/x402.mdx b/docs/build/apps/x402.mdx index 546e7fc598..7d460c7884 100644 --- a/docs/build/apps/x402.mdx +++ b/docs/build/apps/x402.mdx @@ -22,7 +22,7 @@ To support x402 on Stellar, a wallet must support [auth-entry signing](../guides - Klever - One Key -::::note +:::note Freighter Mobile does not currently support x402; use the Freighter browser extension. Mobile support is planned for a future release. From 84320a1d19be650b5a4055ae0870757d714de98e Mon Sep 17 00:00:00 2001 From: Jane Wang Date: Wed, 18 Feb 2026 15:28:28 -0500 Subject: [PATCH 5/7] Update docs/build/apps/x402.mdx Co-authored-by: Elliot Voris --- docs/build/apps/x402.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/apps/x402.mdx b/docs/build/apps/x402.mdx index 7d460c7884..65a9552bbb 100644 --- a/docs/build/apps/x402.mdx +++ b/docs/build/apps/x402.mdx @@ -26,7 +26,7 @@ To support x402 on Stellar, a wallet must support [auth-entry signing](../guides Freighter Mobile does not currently support x402; use the Freighter browser extension. Mobile support is planned for a future release. -:::: +::: ## x402 Facilitator From 1660f483afc74c78f3fd69989ff57bf746f354c8 Mon Sep 17 00:00:00 2001 From: Jane Wang Date: Wed, 18 Feb 2026 15:32:14 -0500 Subject: [PATCH 6/7] Fix path --- docs/build/apps/x402.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/apps/x402.mdx b/docs/build/apps/x402.mdx index 65a9552bbb..79360e5219 100644 --- a/docs/build/apps/x402.mdx +++ b/docs/build/apps/x402.mdx @@ -30,7 +30,7 @@ Freighter Mobile does not currently support x402; use the Freighter browser exte ## x402 Facilitator -The [OpenZeppelin Relayer](https://github.com/OpenZeppelin/relayer-plugin-x402-) is enabled as an x402 Facilitator on Stellar, allowing relayed and sponsored flows for x402 payments. +The [OpenZeppelin Relayer](https://github.com/OpenZeppelin/relayer-plugin-x402-facilitator) is enabled as an x402 Facilitator on Stellar, allowing relayed and sponsored flows for x402 payments. ## Resources From 289d342c74f348f227dd11714f089564ee8f668f Mon Sep 17 00:00:00 2001 From: Jane Wang Date: Wed, 18 Feb 2026 17:46:30 -0500 Subject: [PATCH 7/7] Add updates --- docs/build/apps/x402.mdx | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/build/apps/x402.mdx b/docs/build/apps/x402.mdx index 79360e5219..1c39cda6f9 100644 --- a/docs/build/apps/x402.mdx +++ b/docs/build/apps/x402.mdx @@ -28,9 +28,15 @@ Freighter Mobile does not currently support x402; use the Freighter browser exte ::: -## x402 Facilitator +## x402 Facilitator from OpenZeppelin -The [OpenZeppelin Relayer](https://github.com/OpenZeppelin/relayer-plugin-x402-facilitator) is enabled as an x402 Facilitator on Stellar, allowing relayed and sponsored flows for x402 payments. +The [OpenZeppelin Relayer x402 Plugin for x402](https://github.com/OpenZeppelin/relayer-plugin-x402-facilitator) implements the x402 facilitator API so you can serve x402 payments directly from a Relayer instance. It works with the Coinbase x402 ecosystem (e.g., @x402/express) and exposes the expected `/verify`, `/settle`, and `/supported` endpoints under the Relayer plugin router. + +:::note + +This version supports x402 v2 specification. For x402 v1 support, please use a previous version of this plugin (check git history for v1 compatible releases). + +::: ## Resources