docs: deprecate Polygon Parity trace_*/erigon_* ahead of Erigon sunset (Aug 1, 2026)

[akegaviar]

What

Polygon Labs is sunsetting the Erigon client on Polygon PoS mainnet by August 1, 2026. Erigon serves the Parity trace_* namespace and the erigon_* namespace; Bor (the remaining Polygon client) serves the Geth debug_trace* methods. After the cutover, trace_* and erigon_* stop working on Polygon.

Today our docs mark all of these as available with no caveat, so anyone (including AI assistants reading the method pages) building on Polygon trace_* gets no warning that the methods are about to disappear.

Changes

• docs/polygon-methods.mdx — deprecation <Warning> + a trace_* → debug_trace* migration table; annotated the 8 trace_* and 8 erigon_* rows with "Deprecating Aug 1, 2026 — Erigon sunset" (kept the availability checkmarks since the methods still work until the cutover).
• reference/polygon-trace_transaction.mdx — deprecation <Warning> → migrate to debug_traceTransaction.
• reference/polygon-trace_block.mdx — deprecation <Warning> → migrate to debug_traceBlockByNumber.

Migration

Erigon trace_*	Replacement on Bor
trace_transaction	debug_traceTransaction + callTracer
trace_block	debug_traceBlockByNumber + callTracer
trace_call	debug_traceCall + callTracer
trace_filter / trace_replay*	debug_traceBlockByNumber per block, or eth_getLogs for event ranges

Verification

• Source: Polygon Community Forum "Sunsetting Erigon Support" (Aug 1, 2026 mainnet; archive via Bor + PBSS).
• Live on Chainstack Polygon mainnet (2026-07-07): trace_transaction returns data via Erigon today; debug_traceTransaction and debug_traceBlockByNumber with callTracer return equivalent call traces on Bor — so the migration target is valid on our infrastructure.
• mint validate → build validation passed.

Follow-ups (not in this PR)

• After Aug 1, 2026: flip these Warnings from "deprecating" to "removed" (and consider whether the two trace_* reference pages should redirect).
• Optional: a changelog heads-up entry for broader customer reach.
• Separate: Erigon v3.5.0 inverted the disableMemory/disableReturnData trace flags — several *-tracecall/*-tracetransaction reference pages need version-qualified notes (tracked separately).

[infra-bot-atlantis]

Error: This repo is not allowlisted for Atlantis.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ed157cba-7afe-4cca-8c62-d99715e43ebe

📥 Commits

Reviewing files that changed from the base of the PR and between d0374f3 and 05fced0.

📒 Files selected for processing (3)

• docs/polygon-methods.mdx
• reference/polygon-trace_block.mdx
• reference/polygon-trace_transaction.mdx

---

📝 Walkthrough

Summary by CodeRabbit

• Documentation
  • Added clearer warnings about Polygon’s upcoming Erigon support sunset on August 1, 2026.
  • Updated method references to show which erigon_* and trace_* options are being deprecated.
  • Added migration guidance for using Bor-based debug_trace* alternatives, including equivalent call-tracing recommendations for trace_block and trace_transaction.

Walkthrough

This PR adds deprecation warnings across Polygon documentation pages, notifying users that Erigon support is sunsetting on August 1, 2026, and instructs migration from Erigon/Parity trace_* methods to Bor debug_trace* methods.

Changes

Erigon Sunset Documentation

Layer / File(s)	Summary
Methods overview warning and migration table docs/polygon-methods.mdx	Adds a top-level warning about Erigon sunset, a migration table mapping trace_* to debug_trace* methods, and deprecation comments on erigon_* and trace_* rows in the availability table.
Individual trace method deprecation warnings reference/polygon-trace_block.mdx, reference/polygon-trace_transaction.mdx	Adds deprecation <Warning> blocks directing users to migrate to debug_traceBlockByNumber/debug_traceTransaction with callTracer.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Poem

Hop, hop, the docs now warn and glow,
Erigon's trail begins to slow.
Bor stands ready, tracer bright,
To carry traces through the night.
A rabbit's nudge, a gentle sign—
Migrate now, all will be fine! 🐇📜

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the Polygon trace and erigon deprecation ahead of the Aug 1, 2026 sunset.
Description check	✅ Passed	The description is directly related to the docs changes and explains the deprecation and migration guidance.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/polygon-erigon-trace-deprecation

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
chainstack	🟢 Ready	View Preview	Jul 7, 2026, 4:03 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.