Skip to content

docs: point Polygon node API references at the Bor Global Node endpoint#584

Merged
akegaviar merged 1 commit into
mainfrom
docs/polygon-reference-endpoint-swap
Jul 24, 2026
Merged

docs: point Polygon node API references at the Bor Global Node endpoint#584
akegaviar merged 1 commit into
mainfrom
docs/polygon-reference-endpoint-swap

Conversation

@akegaviar

Copy link
Copy Markdown
Member

The Polygon node API reference pages (under API → Node APIs → Polygon node API) had their "Try it" endpoint and code samples pointing at the retired Erigon demo node. That node no longer reflects the live Polygon service — most importantly, trace calls there return misleading results versus the Bor end-state we now document.

This swaps every Polygon node API spec and reference page to the current Polygon Bor Global Node demo endpoint (archive + debug/trace).

Scope

  • 41 OpenAPI specs under openapi/polygon_node_api/servers host + operation path.
  • 39 reference pages — the openapi: frontmatter path.
  • Covers both the polygon-* pages and the older unprefixed pages (chainid, getcode, ethcall, …) — all are in the Polygon node API nav section.
  • One spec (eth_sendRawTransactionSync) was already on the new endpoint.

Only the endpoint host and token changed (121 lines); line endings preserved, no whitespace churn.

Verified live

Confirmed the new endpoint serves everything the references exercise: bor v2.9.0, chainId 0x89, archive state (balance at block 1,000,000), callTracer + flatCallTracer, debug_traceBlockByNumber, and the bor_* namespace (bor_getAuthor, bor_getSignersAtHash) — all respond correctly.

mint broken-links clean.

…ndpoint

The Polygon node API reference 'Try it' calls and code samples pointed at
the retired Erigon demo node, which no longer reflects the live Bor
service (and returns wrong/misleading results for trace calls). Swap all
Polygon node API specs and reference pages to the current Polygon Bor
Global Node (archive + debug/trace + bor namespace).

Verified against the endpoint: bor v2.9.0, chainId 0x89, archive state,
callTracer + flatCallTracer, debug_traceBlockByNumber, and bor_* methods
all respond correctly. Scoped strictly to polygon_node_api specs and the
reference pages that use them (41 specs + 39 pages); line endings
preserved, only the endpoint host and token changed.
@infra-bot-atlantis

Copy link
Copy Markdown
Error: This repo is not allowlisted for Atlantis.

@coderabbitai

coderabbitai Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 999ea433-8a78-40c0-b97d-6f6f1c198f10

📥 Commits

Reviewing files that changed from the base of the PR and between 76af618 and 7b701eb.

📒 Files selected for processing (80)
  • openapi/polygon_node_api/account_info/eth_getBalance.json
  • openapi/polygon_node_api/account_info/eth_getCode.json
  • openapi/polygon_node_api/account_info/eth_getProof.json
  • openapi/polygon_node_api/account_info/eth_getStorageAt.json
  • openapi/polygon_node_api/account_info/eth_getTransactionCount.json
  • openapi/polygon_node_api/blocks_info/eth_blockNumber.json
  • openapi/polygon_node_api/blocks_info/eth_getBlockByHash.json
  • openapi/polygon_node_api/blocks_info/eth_getBlockByNumber.json
  • openapi/polygon_node_api/blocks_info/eth_getBlockTransactionCountByHash.json
  • openapi/polygon_node_api/blocks_info/eth_getBlockTransactionCountByNumber.json
  • openapi/polygon_node_api/blocks_info/eth_newBlockFilter.json
  • openapi/polygon_node_api/bor/bor_getAuthor.json
  • openapi/polygon_node_api/bor/bor_getCurrentProposer.json
  • openapi/polygon_node_api/bor/bor_getCurrentValidators.json
  • openapi/polygon_node_api/bor/bor_getRootHash.json
  • openapi/polygon_node_api/bor/bor_getSignersAtHash.json
  • openapi/polygon_node_api/chain_info/eth_chainId.json
  • openapi/polygon_node_api/chain_info/eth_syncing.json
  • openapi/polygon_node_api/client_info/net_listening.json
  • openapi/polygon_node_api/client_info/net_peerCount.json
  • openapi/polygon_node_api/client_info/web3_clientVersion.json
  • openapi/polygon_node_api/debug_and_trace/debug_traceBlockByHash.json
  • openapi/polygon_node_api/debug_and_trace/debug_traceBlockByNumber.json
  • openapi/polygon_node_api/debug_and_trace/debug_traceCall.json
  • openapi/polygon_node_api/debug_and_trace/debug_traceTransaction.json
  • openapi/polygon_node_api/debug_and_trace/trace_block.json
  • openapi/polygon_node_api/debug_and_trace/trace_transaction.json
  • openapi/polygon_node_api/execute_transactions/eth_call.json
  • openapi/polygon_node_api/execute_transactions/eth_sendRawTransaction.json
  • openapi/polygon_node_api/filter_handling/eth_getFilterChanges.json
  • openapi/polygon_node_api/filter_handling/eth_uninstallFilter.json
  • openapi/polygon_node_api/gas_data/eth_estimateGas.json
  • openapi/polygon_node_api/gas_data/eth_gasPrice.json
  • openapi/polygon_node_api/logs_and_events/eth_getLogs.json
  • openapi/polygon_node_api/logs_and_events/eth_newFilter.json
  • openapi/polygon_node_api/transaction_info/eth_getBlockReceipts.json
  • openapi/polygon_node_api/transaction_info/eth_getTransactionByBlockHashAndIndex.json
  • openapi/polygon_node_api/transaction_info/eth_getTransactionByBlockNumberAndIndex.json
  • openapi/polygon_node_api/transaction_info/eth_getTransactionByHash.json
  • openapi/polygon_node_api/transaction_info/eth_getTransactionReceipt.json
  • openapi/polygon_node_api/transaction_info/eth_newPendingTransactionFilter.json
  • reference/chainid.mdx
  • reference/clientversion.mdx
  • reference/estimategas.mdx
  • reference/ethcall.mdx
  • reference/gasprice.mdx
  • reference/getbalance.mdx
  • reference/getblockbyhash.mdx
  • reference/getcode.mdx
  • reference/getfilterchanges.mdx
  • reference/getlogs.mdx
  • reference/getstorageat.mdx
  • reference/gettransactioncount.mdx
  • reference/netlistening.mdx
  • reference/newfilter.mdx
  • reference/peercount.mdx
  • reference/polygon-borgetauthor.mdx
  • reference/polygon-borgetcurrentproposer.mdx
  • reference/polygon-borgetcurrentvalidators.mdx
  • reference/polygon-borgetroothash.mdx
  • reference/polygon-borgetsignersathash.mdx
  • reference/polygon-getblockbynumber.mdx
  • reference/polygon-getblocknumber.mdx
  • reference/polygon-getblockreceipts.mdx
  • reference/polygon-getblocktransactioncountbyhash.mdx
  • reference/polygon-getblocktransactioncountbynumber.mdx
  • reference/polygon-getproof.mdx
  • reference/polygon-gettransactionbyblockhashandindex.mdx
  • reference/polygon-gettransactionbyblocknumberandindex.mdx
  • reference/polygon-gettransactionbyhash.mdx
  • reference/polygon-gettransactionreceipt.mdx
  • reference/polygon-newblockfilter.mdx
  • reference/polygon-newpendingtransactionfilter.mdx
  • reference/polygon-traceblockbyhash.mdx
  • reference/polygon-traceblockbynumber.mdx
  • reference/polygon-tracecall.mdx
  • reference/polygon-tracetransaction.mdx
  • reference/sendrawtransaction.mdx
  • reference/syncing.mdx
  • reference/uninstallfilter.mdx

📝 Walkthrough

Summary by CodeRabbit

  • Documentation
    • Updated Polygon API reference mappings and examples to use the current mainnet endpoint.
    • Refreshed endpoint links across account, block, transaction, filter, tracing, and network methods.
    • Request and response schemas, descriptions, and examples remain unchanged.

Walkthrough

Polygon OpenAPI specifications now use the Chainstack mainnet server and a new hashed operation path. Matching Polygon reference pages update their OpenAPI mappings to the same path identifier without changing operation schemas or documentation content.

Changes

Polygon OpenAPI specifications

Layer / File(s) Summary
Core RPC specifications
openapi/polygon_node_api/account_info/*, openapi/polygon_node_api/blocks_info/*, openapi/polygon_node_api/bor/*, openapi/polygon_node_api/chain_info/*, openapi/polygon_node_api/client_info/*
Server URLs and hashed paths keys are updated across account, block, Bor, chain, and client operations.
Extended RPC specifications
openapi/polygon_node_api/debug_and_trace/*, openapi/polygon_node_api/execute_transactions/*, openapi/polygon_node_api/filter_handling/*, openapi/polygon_node_api/gas_data/*, openapi/polygon_node_api/logs_and_events/*
Server URLs and operation path identifiers are updated for tracing, execution, filters, gas, and logs endpoints.
Transaction specifications
openapi/polygon_node_api/transaction_info/*
Transaction-related server URLs and hashed path keys are updated while operation definitions remain unchanged.

Documentation mappings

Layer / File(s) Summary
Reference OpenAPI mappings
reference/*.mdx
Polygon reference frontmatter updates each POST OpenAPI mapping to the new operation path identifier.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

  • chainstack/dev-portal#577: Updates related Polygon OpenAPI specifications and reference pages for eth_getProof and bor_* endpoints.

Poem

A rabbit hops through paths anew,
With Chainstack skies of Polygon blue.
Old hashes sleep, new routes gleam,
Docs and specs now share one stream.
“Thump!” says Bun—the links are true!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main change: Polygon node API references were repointed to the Bor Global Node endpoint.
Description check ✅ Passed The description is directly related to the diff and correctly describes the endpoint migration and affected Polygon docs.
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-reference-endpoint-swap

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

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

@mintlify

mintlify Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
chainstack 🟢 Ready View Preview Jul 24, 2026, 1:39 AM

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

@akegaviar
akegaviar merged commit 88c7f95 into main Jul 24, 2026
3 checks passed
@akegaviar
akegaviar deleted the docs/polygon-reference-endpoint-swap branch July 24, 2026 01:40
@mintlify

mintlify Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
chainstack 🟡 Building Jul 24, 2026, 1:34 AM

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant