Skip to content

Remove Scroll Sepolia testnet content from the English docs - #562

Merged
roylou merged 5 commits into
prodfrom
remove-scroll-sepolia-prod
Jul 30, 2026
Merged

Remove Scroll Sepolia testnet content from the English docs#562
roylou merged 5 commits into
prodfrom
remove-scroll-sepolia-prod

Conversation

@roylou

@roylou roylou commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Description

Scroll Sepolia is being shut down, so this removes the testnet from the English documentation. Scoped to English on purpose — the es/tr/zh translations are being handled separately.

Changes

English content

  • developers/scroll-contracts — drop the whole "Scroll Sepolia Testnet" section (network info, contract addresses, predeploys, tokens)
  • developers/ (FAQ) — drop the Sepolia network parameters table, the Sepolia RPC provider list, the "Testnet ETH" section and the Sepolia node snapshot link
  • developers/faucetpage deleted; it was entirely about Scroll Sepolia testnet ETH. Its sidebar entry and the user-guide/faucet/en/developers/faucet redirect go with it, so the redirect doesn't start pointing at a 404
  • guides/bridge-erc20-through-the-custom-gateway and guides/scroll-messenger-cross-chain-interaction — these were written end-to-end against Sepolia. Rather than delete two complete tutorials, they are retargeted at Ethereum mainnet / Scroll Mainnet: contract addresses swapped for their mainnet counterparts, sepolia.etherscan.ioetherscan.io, and the bridge API example moved to mainnet-api-bridge-v2
  • l1-and-l2-bridging/the-scroll-messenger, transaction-fees-on-scroll, guides/running-a-scroll-node, guides/estimating-gas-and-tx-fees, ethereum-and-scroll-differences, technology/bridge/cross-domain-messaging, article-components — Sepolia endpoints, addresses and mentions removed or pointed at mainnet

Site config (single files, so these apply to every locale)

  • sidebar.ts — remove the "Sepolia Resources" section and the faucet entry
  • SearchModal.tsx — "Sepolia Testnet Contracts" search suggestion renamed
  • NetworkTabs.astro — deleted; it hardcoded a Sepolia/Mainnet tab pair and had no remaining usage
  • public/locales/en/translation.json — drop the now-unreferenced Sepolia keys

Left untouched

  • es/tr/zh translations — handled separately. Note that because the sidebar and redirects are shared across locales, those entries disappear for every language while the localized page content stays as-is
  • technology/overview/scroll-upgrades/* — the Sepolia mentions there record when each upgrade shipped to testnet, which stays true after the shutdown. One thing worth a follow-up: feynman-upgrade still carries operational Sepolia instructions (--scroll-sepolia flag, sepolia-sequencer-proxy.scroll.io, the Sepolia S3 blob endpoint) that will stop working
  • en/sdk/* — Sepolia there almost always means Ethereum Sepolia used as the L1 basechain for a self-hosted chain, which is unaffected. Three spots do refer to Scroll Sepolia and could be cleaned up later: sdk-faq ("defaults to the behavior seen on Scroll Sepolia"), production-deployment ("Scroll's Sepolia environment" resource table), and the "a public testnet like Scroll Sepolia" line in the AWS and DigitalOcean guides

Verification

astro build passes — 458 pages. No new Prettier violations (31 files in this set were already non-conforming on prod, unchanged after this).

Drive-by fix

guides/running-a-scroll-node had the mainnet and Sepolia S3 blob endpoints swapped in a comment (# scroll-mainnet : https://scroll-sepolia-blob-data...). Only the correct mainnet line remains.

Scroll Sepolia is being shut down, so remove the testnet from the
English documentation:

- drop the "Scroll Sepolia Testnet" section from the contract page
- drop the Sepolia network parameters, RPC providers, testnet ETH FAQ
  and node snapshot from the developer FAQ
- delete the Testnet ETH Faucet page along with its sidebar entry and
  the user-guide/faucet redirect that fed it
- retarget the custom gateway and ScrollMessenger guides at Ethereum
  mainnet / Scroll Mainnet (addresses, explorer links, bridge API)
- point the Scroll Messenger, transaction fee and node guides at the
  mainnet endpoints only
- remove the "Sepolia Resources" sidebar section, its English
  translation keys, the Sepolia search suggestion and the unused
  NetworkTabs component

Left untouched:

- the es/tr/zh translations, which are handled separately
- historical release notes under technology/overview/scroll-upgrades,
  whose Sepolia mentions record when each upgrade shipped
- the Scroll SDK docs, where Sepolia almost always means Ethereum
  Sepolia used as the L1 basechain, which is unaffected by this

Note that sidebar.ts, the search suggestions and redirects.json are
shared across locales, so those entries go for every language.
@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)
scroll-documentation Ready Ready Preview Jul 30, 2026 12:10am

Request Review

Comment thread src/content/docs/en/developers/transaction-fees-on-scroll.mdx Outdated
Comment thread src/content/docs/en/developers/scroll-contracts.mdx
Deleting faucet.mdx and dropping its redirects.json entry would have
404'd ten live URLs: /developers/faucet and its four locale variants
(generated from the doc collection) plus /user-guide/faucet and its
four locale variants. Point both sources at /en/developers/ instead.

Also drop the faucet from the support FAQ question, since there is no
faucet to ask about anymore.
roylou added 3 commits July 30, 2026 07:58
Addressing review feedback on #562.

Keep the Scroll Sepolia section on the contracts page rather than
deleting it — the addresses are useful for historical reference. It now
opens with a caution telling readers the network was shut down after
July 30th, 2026 and that the addresses are not for new work. The
address list itself is byte-identical to what was there before.

Restore the "Scroll Sepolia has already undergone this upgrade" line in
transaction-fees-on-scroll and cross-domain-messaging, plus the Sepolia
L1MessageQueueWithGasPriceOracle address and the Scroll Sepolia
L1GasPriceOracle link. Those record what happened during the February
2024 bridge upgrade, which stays true after the shutdown. Both files
are now unchanged from prod.
Thegaram's review asked to keep chain ids alongside the contract
addresses. The chain id lives in the developer FAQ's network parameter
table, not on the contracts page, so restore that table with the same
shutdown caution and reword the question to past tense.

Still gone: the Scroll Sepolia RPC provider list, the Testnet ETH
section and the Sepolia node snapshot link. Those point at third-party
infrastructure and build artifacts for a dead chain rather than being
reference data worth preserving.
Restore both snapshot URLs, annotating the Sepolia one with the
shutdown date rather than dropping it.
@roylou
roylou merged commit 7dddb01 into prod Jul 30, 2026
4 checks passed
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