Skip to content

docs(x402): x402 mUSD payments quickstart#1

Merged
ryanRfox merged 1 commit intomainfrom
docs/x402-mezo-quickstart
Apr 22, 2026
Merged

docs(x402): x402 mUSD payments quickstart#1
ryanRfox merged 1 commit intomainfrom
docs/x402-mezo-quickstart

Conversation

@ryanRfox
Copy link
Copy Markdown
Owner

Summary

Migration from vativ/mezo-hack#1 as part of the repo-reorg epic hq-ubcjh. Consolidates two docs pages (Overview + Quickstart) for Mezo-based x402 payments, plus 13 trivial auto-format cleanups.

Squash of 15 commits authored 2026-04-17..2026-04-22 on vativ/mezo-hack:docs/x402-hackathon-quickstart (head 8e1990cb). The old PR remains open as a bridge until this one lands.

Contents

New pages:

  • src/content/docs/docs/developers/getting-started/musd-payments-x402/index.mdx — Overview: how x402 works on Mezo, MUSD specifics, what you can build
  • src/content/docs/docs/developers/getting-started/musd-payments-x402/x402-quickstart.mdx — Hands-on: install, build seller, browser buyer flow, troubleshooting

Sidebar / IA:

  • astro.config.mjs — new group "MUSD Payments With X402" under Getting Started
  • src/content/docs/docs/SUMMARY.md — mirrored

Preview-build supporting infra (from the hackathon preview branch):

  • .github/workflows/pages.yml — GitHub Pages deploy for docs/** branches
  • .gitignore additions

Diagram:

  • src/assets/diagrams/x402-mezo-flow.mmd — Mermaid source (sequence: Buyer → Server → Facilitator → Mezo chain)
  • src/assets/diagrams/x402-mezo-flow.svg — rendered

Trivial cleanups (13 files):

  • 9 locale 404/index.mdx: RedirectScript.astro import-path correction (one extra ../)
  • get-gas.mdx, musd-bridge.mdx: YAML description reformatted to multi-line block style

Review notes

  • The old PR (vativ/mezo-hack#1) had two LGTMs on pre-rebase commits; those are on stale SHAs. Re-review on this squash is welcome.
  • mainnet-edits branch from vativ/mezo-hack is explicitly excluded from this squash per mayor's scope call — it's a 64-commit parallel stream that deserves its own migration path.
  • Protocol-mechanics in the tutorial are aligned with the apps/humor reference (vativ/x402-mezo-preview/mezo-fox/apps-humor branch): same install recipe, same paymentMiddleware 4-arg form with createPaywall().withNetwork(evmPaywall).build(), same eip155:* scheme registration, same facilitator.vativ.io. Four minor alignment items outstanding with mezo/fox (mail sent 2026-04-21).

Test plan

  • pnpm install && pnpm run dev renders both new pages at localhost:4321/docs/developers/getting-started/musd-payments-x402/ and .../x402-quickstart/
  • Sidebar "MUSD Payments With X402" group appears under Developer Documentation → Getting Started
  • Mermaid diagram SVG renders on the Overview page
  • No broken internal links (path fixes to ./x402-quickstart/ and /docs/users/musd/mint-musd/)
  • New-tab link on "Borrow and Mint MUSD ↗" opens in a new window

…hack#1

Squash of 15 commits authored 2026-04-17..2026-04-22 on vativ/mezo-hack:docs/x402-hackathon-quickstart (head 8e1990c), plus 13 trivial auto-format cleanups (404 RedirectScript path corrections + YAML description reformats) carried in the working tree.

Migration per repo-reorg epic hq-ubcjh.
@ryanRfox ryanRfox merged commit c51dd56 into main Apr 22, 2026
1 check passed
ryanRfox added a commit that referenced this pull request Apr 23, 2026
… > MUSD (hq-1d1rb)

The 'MUSD Payments With X402' collapsed group was originally placed
under Developers > Getting Started (as a peer of Configure Mezo
Passport, Integrations and Partners, etc.). Semantically it belongs
with the other Developers > MUSD material — MUSD Development Guide,
MUSD Redemptions — so that readers looking up MUSD tooling see all
three in one place.

Change:

- astro.config.mjs: removed the X402 group from the Getting Started
  items list; inserted it below MUSD Redemptions in the Developers >
  MUSD items list.
- SUMMARY.md: mirrored the move so GitBook-style sidebars stay in
  sync.

URLs untouched. The overview and quickstart still live at
/docs/developers/getting-started/musd-payments-x402/ and
/docs/developers/getting-started/musd-payments-x402/x402-quickstart/
because:

1. The preview deploy's 301 redirect from the prior
   /x402-hackathon-quickstart URL targets the /getting-started/...
   path and is in production.
2. External links to the current URL are likely already circulating
   (PR #1 merged, humor.vativ.io README points at these docs).
3. Sidebar re-parenting + URL migration are separate concerns;
   migration would need a new redirect from /getting-started/musd-
   payments-x402/... to whatever the new path is.

If a URL migration to /developers/musd/x402/ (or similar) is also
wanted, that's a follow-up. Flagging in the nudge so Ryan can call
it if so.

Validation: dev server HTTP fetch of the rendered quickstart page
shows the 'MUSD Payments With X402' label no longer appearing inside
the Getting Started sidebar block (scans clean for 'X402' capital
across that offset range) and now appears inside the MUSD group
block (between MUSD Redemptions and chains). Dev server responds
200 with the rebuilt sidebar. Anchor check unchanged since the
content files themselves were not edited.
@ryanRfox ryanRfox deleted the docs/x402-mezo-quickstart branch April 24, 2026 20:07
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.

1 participant