[maxfain]

Circle's marketplace reviewers, its readiness check and buying agents all read /openapi.json. Since #183 it told buyers they could pay "on Base, Polygon or Arc". Production offers Arc only once CIRCLE_API_KEY is set, and that key isn't set. The hire request schemas also listed Base Sepolia and Arc in their network enum, which production refuses with 400 bounty_network_not_allowed. Circle's services inspect builds probe bodies from that schema, so some probes would pick a network we refuse.

Changes

The spec is served with the networks offered here. openApiForEnv already adjusted prices to the live minimum. It now also narrows the hire endpoints to fundableBountyNetworks(env):

• the network enum of X402TierHireRequest and X402HireRequest;
• the networks example of the price list;
• the network wording in info.x-guidance and the hire operations' descriptions, in the file's three phrasings ("Base, Polygon or Arc", "Base eip155:8453, Polygon eip155:137 or Arc eip155:5042", "Base, then Polygon, then Arc").

What production serves:

Circle key set?	Served networks
No (today)	Base and Polygon
Yes	Base, Polygon and Arc

A testnet is never served in production. Off production, Base Sepolia stays. Other operations keep their wording, for example /v1/tasks, whose text already qualifies Arc. The file itself is unchanged.

externalDocs. The spec links the runbook, https://basedagents.ai/skill.md. Circle's readiness page gives a docs link 5 points (M("docsUrl", a.docsUrl, 5, …) in its score bundle). Our spec had none, and we scored 95/100.

The Bazaar block declares its output. extensions.bazaar.schema.properties.output is now {type: object, properties: {type: string, example: object}, required: [type]}, as the reference declareDiscoveryExtension emits it. Circle's catalog copies some sellers' response schema from this block.

Checked

• CDP's validator. The free, read-only POST https://api.cdp.coinbase.com/platform/v2/x402/validate with method: POST returns valid: true and simulation.outcome: accepted for all four hire URLs on the current production. CDP documents it as making no payment and indexing nothing. So Bazaar listing: forward our own resource and Bazaar block to the facilitator #184's forwarded Bazaar block is not at risk of invalid_bazaar_extension.
• The new block. The live 402 with the output schema added passes the reference validateDiscoveryExtension, validateDiscoveryExtensionSpec, validateAndExtract and extractDiscoveryInfo (@x402/extensions 2.28.0). A broken output.example is rejected, so the schema is enforced.

Tests

• openapi.test.ts:
  • the file contains the three wordings that are rewritten;
  • production without the key serves no "Arc" or eip155:5042 in x-guidance or the hire operations, and [8453, 137] enums and example;
  • production with the key serves the file's wording and [8453, 137, 5042];
  • off production, Base Sepolia stays and Arc goes;
  • /v1/tasks and the file are untouched;
  • externalDocs.url is set.
• x402-tasks.test.ts: the 402 declares the output schema.
• Results:
  • API 1281 passed.
  • Typecheck clean; lint 0 errors (1 pre-existing warning).
  • Positioning, front-door self-tests, sync-skill and examples pass.
  • The web build passes.

After merge

• Re-run the CDP validator on the four hire URLs.
• Confirm the served /openapi.json names only Base and Polygon.

Docs

SPEC (GET /openapi.json and the price-check bullet) and CHANGELOG.

🤖 Generated with Claude Code

https://claude.ai/code/session_01VX2Nm8D11UusvYsuAtrcY9

---

Generated by Claude Code

[github-actions]

🔎 Console preview: https://92735c36.basedagents-console.pages.dev
🌐 Site preview: https://f73d27d1.auth-ai-web.pages.dev

(Passkey ceremonies only work on app.basedagents.ai — previews are for UI review.)

[greptile-apps]

Confidence Score: 5/5

[Critical impact] The PR appears safe to merge; no actionable issues were found.

Summary

The served API spec now matches the networks available for hiring in each deployment.

• Hire docs show only payment networks this deployment offers.
• The API spec points readers to the buyer and agent runbook.
• Hire payment quotes declare the shape of their response.

No actionable issues were found. This review checked source code and tests; it did not run tests or external validators.

_{Reviews (1) · Last reviewed commit: "Served API spec offers only the networks..." · Reviewed by Greptile}