Skip to content

Base to network - #1129

Merged
brandonleekramer merged 5 commits into
mainfrom
base-to-network
Nov 18, 2026
Merged

brandonleekramer merged 5 commits into
mainfrom
base-to-network

Conversation

@brandonleekramer

Copy link
Copy Markdown
Member

Summary

Three updates: sync Supported Networks with networks registry v0.8.14, move the Base page to the Network-only template, and merge the Subgraph How-to Guides into a new Guides & Best Practices section with an overview page.

Supported Networks (registry v0.8.8 → v0.8.14)

  • New: Elysium page (/supported-networks/elysium/), Kinetiq's Arbitrum Orbit L2 on HyperEVM. Substreams via The Graph Market.
  • zkSync Era: Pinax added Substreams, so the page now covers both Subgraphs and Substreams.
  • Removed: Blast, Starknet, Starknet Testnet, and Robinhood Chain Testnet have no providers left in the registry, so the table no longer lists them. Their custom pages are deleted and their routes redirect to /supported-networks/.
  • Substreams overview and quick start: removed Starknet, Vara, and MANTRA, none of which has a live endpoint.

Base

  • The Base page now uses the same template as BSC and Polygon: longer intro, a "Find Existing Subgraphs on Base" card grid (Uniswap V4, Uniswap V3, Aerodrome, Morpho Blue, Aave V3, Moonwell), and the Graph Network publishing flow.
  • Follow-up needed in the registry: v0.8.14 still lists a Studio entry for Base. The "no Studio indexing" warning will show only after that entry is removed, the same change networks-registry#263 made for BSC and Polygon.

Guides & Best Practices

  • Merged How-to Guides into /subgraphs/best-practices/ under the nav title Guides & Best Practices.
  • New default page: Subgraph Guides & Best Practices, with a performance checklist and a map of the section.
  • Reordered the pages to follow the overview: contract design → schema → storage and queries → debugging and grafting → composition → migration.
  • Rewrote the pages in one voice: removed the "Subgraph Best Practice N" titles and the 1-6 lists, replaced TLDR and Conclusion sections with a short opening paragraph, switched to second person, and ended every page with a shared "Learn More" block.
  • Merged the two grafting pages into one Grafting page that covers both hotfixes and contract replacement. Its compatible-schema list now matches the official reference.
  • Renamed Tooling to Testing & Tooling (URL unchanged).
  • Fixed content bugs: a mangled * operator in the timeseries docs, graph-example/graft-example typos, and stale /developing/ and /cookbook/ links.

Redirects (nginx.conf)

  • /subgraphs/guides/*, /subgraphs/cookbook/*, and /cookbook/* → /subgraphs/best-practices/*, in one step with no redirect chains. Old tooling and public-Subgraph slugs still go to their own sections.
  • /subgraphs/best-practices/grafting-hotfix/ → /subgraphs/best-practices/grafting/
  • /subgraphs/best-practices/, /subgraphs/guides/, and /subgraphs/cookbook/ → the overview page.
  • Fixed redirects that led to removed pages: Arweave → Supported Networks, multisig → Studio FAQ, substreams/sps/* → Substreams overview.

Checks

  • Prettier, tsc, and an MDX compile of every changed page pass.
  • Every internal link and anchor in the section resolves.
  • route-lockfile.txt was updated by hand. Confirm it matches the CI-generated version.

🤖 Generated with Claude Code

https://claude.ai/code/session_01HpT75uYTePhuL7KFioUPqS

brandonleekramer and others added 2 commits November 16, 2026 19:01
…rk template, and add Guides & Best Practices

Supported Networks (registry v0.8.8 -> v0.8.14)
- Add an Elysium page (Substreams via The Graph Market)
- Remove pages for networks dropped from the table (Blast, Starknet,
  Starknet Testnet, Robinhood Chain Testnet) and redirect their routes
  to /supported-networks/
- zkSync Era: add Pinax Substreams section and "two ways" intro
- Substreams overview and quick start: drop Starknet, Vara, and MANTRA

Base
- Use the BSC/Polygon template: longer intro, "Find Existing Subgraphs
  on Base" cards, Graph Network publishing flow

Subgraphs: Guides & Best Practices
- Merge How-to Guides into best-practices/ under the nav title
  "Guides & Best Practices"; rename "Tooling" to "Testing & Tooling"
- Add the Subgraph Guides & Best Practices overview as the first page
- Reorder pages to follow the overview, rewrite pages in one voice,
  and merge the two grafting pages into one
- Redirect guides/, cookbook/, and grafting-hotfix URLs to their final
  pages in nginx.conf, and fix redirects to removed pages

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01HpT75uYTePhuL7KFioUPqS
Promote the intro headings to h2 so each page's first heading is rank 2
(remark-lint-first-heading-level).

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01HpT75uYTePhuL7KFioUPqS
brandonleekramer and others added 2 commits November 17, 2026 03:24
- Declared eth_call examples: use the manifest event signature format
  `TransferWithPool(indexed address,indexed address,uint256,indexed bytes32)`
- Overview: nested sorting works one level deep (String/ID fields), so
  recommend storing frequent sort keys on the entity rather than saying
  nested sorting is impossible
- Overview: loadInBlock returns entities created or updated in the current
  block; a non-null result does not prove the entity is new
- Overview: gnd dev --watch only redeploys the build output; run
  gnd build --watch (or graph build --watch) alongside it to recompile
- Grafting: switching to Bytes IDs is not graft-compatible, but mutable to
  immutable is supported when the copied history has no updates or deletions
- Grafting: a non-grafted republish after a contract replacement needs data
  sources for both contracts, and a single-data-source graft stops indexing
  the old contract after the graft block

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01HpT75uYTePhuL7KFioUPqS
gnd --watch only redeploys the build output and does not compile, so the
local verification step now starts graph build --watch (or gnd build
--watch) in one terminal and gnd --watch in a second terminal.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01HpT75uYTePhuL7KFioUPqS
The local verification step now runs `gnd dev --ethereum-rpc ... --watch`
instead of plain `gnd`, and the surrounding copy and Windows note say
`gnd dev` to match.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01HpT75uYTePhuL7KFioUPqS
@juanmardefago
juanmardefago self-requested a review November 18, 2026 17:58
@brandonleekramer
brandonleekramer merged commit 065c831 into main Nov 18, 2026
4 checks passed
@brandonleekramer
brandonleekramer deleted the base-to-network branch November 18, 2026 18:10
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