Skip to content

docs(x402): drop discovery indexes that do not list Celo endpoints - #2408

Merged
GigaHierz merged 3 commits into
mainfrom
GigaHierz/celo-x402-roles-review
Oct 22, 2026
Merged

GigaHierz merged 3 commits into
mainfrom
GigaHierz/celo-x402-roles-review

Conversation

@GigaHierz

Copy link
Copy Markdown
Contributor

What

The x402 discovery page described two indexes a Celo-only endpoint cannot get into. This removes them and corrects one detail.

  • Removed the Coinbase x402 discovery and x402scan sections, table rows, troubleshooting rows and resource links. Coinbase's facilitator settles on Base, Base Sepolia, Polygon, Arbitrum, World and Solana, and x402scan accepts Base and Solana, so neither lists a Celo-only offer.
  • agent402.tools: the crawler re-probes every 30 minutes (the page said hourly). Added that Celo has its own market page there, and that its router holds no Celo wallet, so buyers pay a Celo-only seller directly.
  • Troubleshooting row reworded from "after an hour" to "after registering", since registering lists the origin at once.

Verified

  • agent402.tools/sell: 30-minute probe, instant listing, Celo market page, router wallets for Base, Algorand, Solana and Tempo only.
  • usebuy.ai: runs on Celo mainnet. The buy-skill issue form states the catalog is curated and offers Celo mainnet and Celo Sepolia.
  • mint broken-links passes.

Not verified

  • 8004scan lists Celo agents (seen on the site), but I could not load an agent page to confirm it surfaces x402Support or services from the registration file. The ERC-8004 page in this repo documents those fields.

Does not do

No other pages change. The x402 page still links here.

Remove the Coinbase and x402scan sections, which only accept Base, Solana and other
non-Celo resources. Correct the agent402.tools probe interval to 30 minutes and note
that its router does not pay on Celo.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@GigaHierz
GigaHierz requested a review from a team as a code owner October 21, 2026 22:21
@GigaHierz
GigaHierz requested a review from palango October 21, 2026 22:21
palango
palango previously approved these changes Oct 22, 2026

@palango palango left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Checked the claims behind this and they hold. Coinbase's network-support page lists Base, Polygon, Arbitrum, Monad, World and Solana (plus testnets), and its get-discovered guide only indexes calls settled through the CDP facilitator, so a Celo-only offer can't get into the Bazaar. x402scan's source has SUPPORTED_CHAINS = [Chain.BASE, Chain.SOLANA]. agent402.tools/sell confirms the 30-minute re-probe and router wallets on Base, Algorand, Solana and Tempo only. Nothing else in the repo links to the removed sections.

Two small things inline, neither blocking. Since the extension is still called bazaar, one line saying Coinbase's Bazaar and x402scan don't list Celo-only offers might save readers a dead end, but I'm fine either way.

Comment thread build/agents/x402-get-discovered.mdx Outdated

- A resource server that returns `402 Payment Required` on Celo. Set one up on the [x402 page](/build/agents/x402#pointing-a-resource-server-at-it) first.
- A public HTTPS origin. Indexes probe your endpoint from the outside, and some probe it every hour.
- A public HTTPS origin. Indexes probe your endpoint from the outside, and some probe it every 30 minutes.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Only agent402.tools probes on a schedule now, so "some" reads as more than one. Maybe "and agent402.tools probes it every 30 minutes."

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

FIXED in bc722cd.

Comment thread build/agents/x402-get-discovered.mdx Outdated
## Register with agent402.tools

One request lists your origin. The crawler probes the x402 surface hourly and ranks listings by health.
One request lists your origin at once, and Celo has its own market page there. The crawler re-probes the x402 surface every 30 minutes and ranks listings by crawl health, then by distinct payers and price. Its own router pays sellers only on chains it holds wallets for, and Celo is not one of them, so buyers pay a Celo-only seller directly rather than through the router.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Worth linking the market page: its own market page.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

FIXED in bc722cd.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@GigaHierz
GigaHierz requested a review from palango October 22, 2026 10:38
@GigaHierz

Copy link
Copy Markdown
Contributor Author

@palango all three suggestions are in (bc722cd): the probe sentence now names agent402.tools, the market page is linked, and a line says Coinbase's Bazaar and x402scan do not list Celo-only offers. The branch was also merged with main (921c838), which dismissed your approval, so this needs a fresh review before it can merge. mint broken-links and CI pass.

@palango palango left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Thanks, all three points are in. Line 12 now names agent402.tools as the one that probes every 30 minutes, the Celo market page is linked, and line 28 says why Bazaar and x402scan are missing. The main merge doesn't touch this file and CI is green. One optional wording nit inline, approving either way.

| [8004scan](https://8004scan.io) | Register an [ERC-8004](/build/agents/8004) identity whose registration file lists your endpoints and sets `x402Support` | An identity on Celo |
| [Buy catalog](https://usebuy.ai) | Ask for a listing with the [buy-skill issue form](https://github.com/celo-org/buy-skill/issues/new?template=list-your-service.yml) | A public origin, a description, a price, and the networks and tokens you accept |

The extension is named `bazaar` after Coinbase's Bazaar, but Coinbase's Bazaar and x402scan do not list Celo-only offers, so they are not covered here.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Nit, take it or leave it: the bazaar spec doesn't say the name comes from Coinbase's Bazaar, and "Coinbase's Bazaar" appears twice. Maybe: "Coinbase's Bazaar, which shares the extension's name, and x402scan do not list Celo-only offers, so this page does not cover them."

@GigaHierz
GigaHierz merged commit 2b77ce0 into main Oct 22, 2026
5 checks passed
@GigaHierz
GigaHierz deleted the GigaHierz/celo-x402-roles-review branch October 22, 2026 16:32
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