Skip to content

developer-hub: sunset Express Relay docs (OP-PIP-124) - #3943

Open
aditya520 wants to merge 3 commits into
mainfrom
hydra/i-hjiycyfb/head
Open

developer-hub: sunset Express Relay docs (OP-PIP-124)#3943
aditya520 wants to merge 3 commits into
mainfrom
hydra/i-hjiycyfb/head

Conversation

@aditya520

@aditya520 aditya520 commented Jul 29, 2026

Copy link
Copy Markdown
Member

Winds down the Express Relay section of the developer hub following Pyth governance decision OP-PIP-124: Express Relay Wind-Down. All changes are confined to apps/developer-hub/.

What changed

Sunset page. content/docs/express-relay/index.mdx is replaced with a short notice that Express Relay has been wound down, pointing existing integrators at the Pyth developer forum for migration guidance and at Price Feeds / Entropy for Pyth's other products. The Gavel icon and full: true frontmatter are kept so the page keeps its existing top-tab styling.

Deleted content. Every other page under content/docs/express-relay/ is removed: the protocol and searcher integration guides, the HTTP and WebSocket API references, contract addresses, error codes, the whole how-express-relay-works/ section, and the four diagram images.

Sidebar. content/docs/express-relay/meta.json collapses to a single index page. content/docs/meta.json is unchanged — Express Relay keeps its top-level slot, it just now lands on the sunset page.

Cross-references removed. The "Express Relay — MEV Protection" section in src/app/llms.txt/route.ts, the SDK bullet and product-table row in src/app/SKILL.md/route.ts, and the folder-tree entry in README.md.

Redirects. A /express-relay/:path+/express-relay permanent redirect funnels every deep link to the sunset page. :path+ (one-or-more) rather than :path* so /express-relay itself is not redirected to itself.

Not in scope

The homepage product cards already omit Express Relay and are untouched. Retiring the SDK packages (@pythnetwork/express-relay-js, express_relay Python), the auction service, and the on-chain contracts is separate wind-down work.

Verification

pnpm turbo run test:lint, test:lint:stylelint, test:types, test:format, and build all pass (routing and MDX schema changed, so a production build was run per AGENTS.md).

Against a dev server on port 3627:

  • /express-relay returns 200 and renders the sunset copy; no self-redirect.
  • /express-relay/integrate-as-protocol, /express-relay/how-express-relay-works/auction, /express-relay/integrate-as-searcher/svm, and /express-relay/errors all return 308 to /express-relay.
  • /llms.txt, /SKILL.md, and /llms-full.txt contain no Express Relay mentions; /sitemap.xml lists only /express-relay.
  • The rendered sunset page contains no links to any deleted page.
  • The homepage is unchanged and contains no Express Relay references.

Note for reviewers

The express-relay entry in src/components/Root/index.tsx TABS is deliberately kept — it now points at the sunset page. Separately, TABS appears to have no consumer left in apps/developer-hub/; that is pre-existing and out of scope here.

@vercel
vercel Bot temporarily deployed to Preview – staking July 29, 2026 15:28 Inactive
@vercel
vercel Bot temporarily deployed to Preview – api-reference July 29, 2026 15:28 Inactive
@vercel

vercel Bot commented Jul 29, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
component-library Ready Ready Preview Jul 29, 2026 11:18pm
developer-hub Ready Ready Preview Jul 29, 2026 11:18pm
5 Skipped Deployments
Project Deployment Actions Updated (UTC)
api-reference Skipped Skipped Jul 29, 2026 11:18pm
entropy-explorer Skipped Skipped Jul 29, 2026 11:18pm
insights Skipped Skipped Jul 29, 2026 11:18pm
proposals Skipped Skipped Jul 29, 2026 11:18pm
staking Skipped Skipped Jul 29, 2026 11:18pm

Request Review

@vercel
vercel Bot temporarily deployed to Preview – entropy-explorer July 29, 2026 15:28 Inactive
@vercel
vercel Bot temporarily deployed to Preview – insights July 29, 2026 15:28 Inactive
@vercel
vercel Bot temporarily deployed to Preview – proposals July 29, 2026 15:28 Inactive

@devin-ai-integration devin-ai-integration Bot 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.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

Open in Devin Review

@github-actions

Copy link
Copy Markdown
Contributor

🤖 llms.txt Content Review

Documentation changes detected, but no product-specific llms.txt files were affected.

Note: Product files contain curated content. Deep dive page URLs in each file link to individual .mdx pages for full detail.

Files analyzed
apps/developer-hub/content/docs/express-relay/contract-addresses.mdx
apps/developer-hub/content/docs/express-relay/errors.mdx
apps/developer-hub/content/docs/express-relay/how-express-relay-works/auction.mdx
apps/developer-hub/content/docs/express-relay/how-express-relay-works/index.mdx
apps/developer-hub/content/docs/express-relay/how-express-relay-works/opportunities.mdx
apps/developer-hub/content/docs/express-relay/how-express-relay-works/permissioning.mdx
apps/developer-hub/content/docs/express-relay/http-api-reference.mdx
apps/developer-hub/content/docs/express-relay/index.mdx
apps/developer-hub/content/docs/express-relay/integrate-as-protocol.mdx
apps/developer-hub/content/docs/express-relay/integrate-as-searcher/index.mdx
apps/developer-hub/content/docs/express-relay/integrate-as-searcher/svm.mdx
apps/developer-hub/content/docs/express-relay/websocket-api-reference.mdx

@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: 7f84d418fe

ℹ️ 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".

Auction-based MEV capture and order flow protection for DeFi protocols.
> https://docs.pyth.network/express-relay/index.mdx

## Unsure Which Price Feed Product?

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 Regenerate metadata after changing curated outputs

When clients use /llms-manifest.json hashes to decide whether to refetch content, these deletions are invisible because src/data/llm-token-counts.json was not regenerated: /llms.txt changed from 2459 to 2297 bytes and /SKILL.md from 10593 to 10467 bytes, while GET still publishes their old hashes, sizes, and token counts. Such clients can retain the removed Express Relay recommendations, so run pnpm count:llm-tokens and commit the generated JSON with these route changes.

Useful? React with 👍 / 👎.

@@ -58,7 +58,6 @@ Use this Skill when the user asks for:
- Standard DeFi: Pyth Core + \`hermes-client\` + \`pyth-sdk-solidity\`
- Low latency HFT: Pyth Pro + \`pyth-lazer-sdk\`
- Randomness: Entropy + \`entropy-sdk-solidity\`

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 Resolve the orphaned MEV-protection workflow

When an agent receives a request for MEV protection, the skill still explicitly claims that use case at line 19 and classifies it at line 54, but this deletion leaves step 2 without any corresponding product or action. The agent can therefore proceed into unrelated price-feed or randomness guidance instead of explaining the wind-down; either remove MEV protection from the supported classifications or replace this branch with the sunset and migration guidance.

Useful? React with 👍 / 👎.

…page

Removes the "Existing integrators: reach out on the Pyth developer forum"
line from the Express Relay sunset page.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01D7KUNWBSvBPgHuMvkXH9jJ
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