Skip to content

docs: clarify Bazaar v2 metadata placement#2008

Open
Bortlesboat wants to merge 1 commit intox402-foundation:mainfrom
Bortlesboat:codex/x402-bazaar-v2-docs-1945
Open

docs: clarify Bazaar v2 metadata placement#2008
Bortlesboat wants to merge 1 commit intox402-foundation:mainfrom
Bortlesboat:codex/x402-bazaar-v2-docs-1945

Conversation

@Bortlesboat
Copy link
Copy Markdown
Contributor

Summary

This tightens the Bazaar v2 docs/spec around where seller-declared metadata actually lives.

  • update Bazaar docs and the seller quickstart to show v2 metadata in resource plus extensions.bazaar
  • remove or reframe examples that implied sellers should put Bazaar metadata directly in accepts[]
  • align the MCP examples in the Bazaar spec with the live toolName field used by the SDKs

Why

Issue #1945 points at a real source of confusion: the repo currently mixed v1-style enriched accepts[] examples with the v2 wire contract. That makes it hard to tell which fields are seller-declared versus facilitator-enriched catalog output.

This PR is docs/spec only. It does not change facilitator behavior or the public catalog shape.

Refs #1945

Verification

  • npx --yes prettier --check docs/extensions/bazaar.mdx docs/getting-started/quickstart-for-sellers.mdx specs/extensions/bazaar.md
  • git diff --check

@vercel
Copy link
Copy Markdown

vercel bot commented Apr 12, 2026

@Bortlesboat is attempting to deploy a commit to the Coinbase Team on Vercel.

A member of the Team first needs to authorize it.

@github-actions github-actions bot added specs Spec changes or additions docs labels Apr 12, 2026
@Bortlesboat Bortlesboat marked this pull request as ready for review April 13, 2026 02:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs specs Spec changes or additions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant