Skip to content

docs(bridge-api): NEAR Intents routing provider + supported matrix endpoint - #19

Merged
shawnmuggle merged 1 commit into
mainfrom
docs/near-intents-provider
Aug 28, 2026
Merged

docs(bridge-api): NEAR Intents routing provider + supported matrix endpoint#19
shawnmuggle merged 1 commit into
mainfrom
docs/near-intents-provider

Conversation

@shawnmuggle

Copy link
Copy Markdown
Member

Documents the new optional provider field (auto | rozo | near), the feeInfo.provider block, NEAR-specific error codes, and the live GET /payment-api/payments/supported discovery endpoint. Backend shipped in RozoAI/rozo-intents-api#273.

🤖 Generated with Claude Code

https://claude.ai/code/session_016qMKQzEapJkLUJnRPByRX8

…, live supported matrix endpoint

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016qMKQzEapJkLUJnRPByRX8
@shawnmuggle
shawnmuggle merged commit 7b6079b into main Aug 28, 2026
@shawnmuggle
shawnmuggle deleted the docs/near-intents-provider branch August 28, 2026 15:35

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3df99c1d4e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

* The response always echoes the **resolved** rail in `provider` (never `auto`) and in `feeInfo.provider`, so you can show users which rail and fee applied (e.g. "0.1% via Rozo" / "0.3% via NEAR Intents").
* `near` orders can currently settle only on Base (`8453`), Solana (`900`) and Stellar (`1500`). Asking for `near` on a route it cannot serve returns `400 ROUTE_NOT_SUPPORTED_BY_PROVIDER` — it is never silently downgraded.
* `near` deposit addresses are single-use and expire; never reuse one.
* Use [`GET /payment-api/payments/supported`](supported-tokens-and-chains.md#live-supported-matrix) to discover which rails serve which chains and tokens.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Update the published OpenAPI contract

The repository advertises docs/openapi-v2.0.0.yaml as its downloadable API specification, but this feature is added only to the prose documentation: the spec still has no /payments/supported path, no provider property on CreatePaymentRequest, and no provider/feeInfo fields on PaymentResponse. Consumers generating clients from that contract therefore cannot call the discovery endpoint or set and read the newly documented routing fields; update the OpenAPI document alongside these examples.

Useful? React with 👍 / 👎.

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