Skip to content

docs: add x402 payments section at /x402#13

Merged
hayarobi merged 1 commit into
mainfrom
docs/x402-section
Jun 29, 2026
Merged

docs: add x402 payments section at /x402#13
hayarobi merged 1 commit into
mainfrom
docs/x402-section

Conversation

@nolnol3

@nolnol3 nolnol3 commented Jun 29, 2026

Copy link
Copy Markdown
Member

Summary

Adds a standalone x402 documentation product served at /x402, modeled on the CDP x402 docs. It is a dedicated Docusaurus instance with its own navbar tab — the same pattern as /hub and /hpp-router — so it is independent of the main HPP builder docs.

Pages (x402/)

  • Overview (/x402, landing) — what x402 is, what HPP provides
  • How it works — roles, the 402 flow + real V2 response body, exact/upto schemes, replay/idempotency
  • Networks & Token — chain IDs, RPC/explorer, USDC.e, funding
  • Quickstart: Sellers@x402/express resource server, USDC.e registration, priced routes
  • Quickstart: BuyerswrapFetchWithPayment client/agent, failure handling
  • Facilitator — hosted endpoints, /supported /verify /settle, gasless upto, self-hosting
  • SDK & reference — packages, CAIP-2 aliases, discovery, links

Config

  • New x402 content-docs plugin instance (routeBasePath: 'x402'), sidebarsX402.ts, navbar x402 entry, and x402 added to local search indexing.

Notes

  • Code examples are grounded in the real @x402 SDK and working HPP server/client code; facts (networks, USDC.e 0x401eCb…, facilitator endpoints, exact+upto schemes, sponsor addresses, CORS) were verified against the live /supported endpoints.
  • npm run build passes with onBrokenLinks: 'throw'.
  • The Facilitator page (/x402/facilitator) is intended as the link target for the x402-foundation facilitator registry.

@nolnol3 nolnol3 requested a review from hayarobi June 29, 2026 07:00

@hayarobi hayarobi left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Checked that lll links are intact.

Add a standalone x402 documentation product (its own Docusaurus instance
served at /x402, with its own navbar tab), modeled on the CDP x402 docs:

- intro (overview/landing), how-it-works (roles, 402 flow + body, schemes),
  networks-and-token, quickstart (sellers/buyers), facilitator, sdk
- new `x402` content-docs plugin instance + sidebarsX402.ts + navbar entry,
  x402 added to local search indexing

The facilitator page documents the hosted HPP facilitators
(facilitator.hpp.io / facilitator-sepolia.hpp.io) and is intended as the
link target for the x402-foundation facilitator registry.
@hayarobi hayarobi force-pushed the docs/x402-section branch from 0222753 to 785f0f7 Compare June 29, 2026 09:11
@hayarobi hayarobi merged commit ca26869 into main Jun 29, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants