ops: integrate op-fetcher

[bitwiseguy]

Overview

Integrates op-fetcher from the monorepo into this repo in order to pull chain config info on-demand from onchain instead of relying on static, hard-coded addresses in the chain config .toml files. This will help prevent data in the chain config .toml and codegen files from going stale and requiring manual updates. Instead, a daily ci job will run and open a pr to update the following codegen files if it notices any diffs between what is onchain and what is stored offchain in the registry:

• addresses.json
• chainList.json
• chainList.toml
• CHAINS.md

Details

The existing ops/cmd/codegen command has been modified to use op-fetcher instead of pulling all of its information from hardcoded information in the chain config .toml files.

In addition to contract and roles addresses, op-fetcher also outputs a faultProofsStatus struct. This information is now stored in the ChainListEntry struct that comprises chainList.json and chainList.toml.

Usage

1. Update all chains: this is how the ci job will invoke the command. Any superchain (mainnet, sepolia, sepolia-dev-0) will be updated if an l1-rpc-url with the appropriate l1 chainId is provided.

go run ./cmd/codegen \
  --l1-rpc-urls="$SEPOLIA_RPC_URL,$MAINNET_RPC_URL"

2. Update all chains for a single superchain:

go run ./cmd/codegen \
  --l1-rpc-urls="$SEPOLIA_RPC_URL,$MAINNET_RPC_URL" \
  --superchains="mainnet"

3. Update specific chains by passing a --chain-ids flag: this will be used when an individual chain is added or modified. This command will fail if none of the given l1-rpc-urls have the appropriate l1 chainId to query the l2(s) contracts.

go run ./cmd/codegen \
  --l1-rpc-urls="$SEPOLIA_RPC_URL,$MAINNET_RPC_URL" \
  --chain-ids=<l2-chain-id>

Related Issues

• Closes retrieve chain's L1 contract addresses onchain optimism#14757
• Closes display fault proof status for chains #857

Follow-up Work

Remove all addresses from the individual chain config .toml files except the following ones. The full collection of addresses should be read from the more up-to-date addresses.json file, or read on-demand using op-fetcher.

• SystemConfigProxy
• L1StandardBridgeProxy
• OptimismPortalProxy (op-node reads this from rollup configs)
• ProxyAdminOwner (role)
• ProxyAdmin (contract)

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 36.64596% with 306 lines in your changes missing coverage. Please review.

Project coverage is 41.92%. Comparing base (fb90035) to head (f903fa2).

Files with missing lines	Patch %	Lines
ops/internal/manage/fetch_onchain.go	38.09%	63 Missing and 2 partials ⚠️
ops/cmd/codegen/main.go	0.00%	53 Missing ⚠️
ops/internal/manage/codegen.go	65.49%	31 Missing and 18 partials ⚠️
ops/internal/config/chain.go	35.82%	41 Missing and 2 partials ⚠️
ops/internal/config/superchain.go	0.00%	33 Missing ⚠️
ops/internal/paths/paths.go	0.00%	29 Missing ⚠️
ops/cmd/sync_staging/main.go	0.00%	15 Missing ⚠️
ops/internal/config/address.go	48.27%	14 Missing and 1 partial ⚠️
ops/internal/manage/collect.go	60.00%	3 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #951      +/-   ##
==========================================
- Coverage   43.64%   41.92%   -1.73%     
==========================================
  Files          39       40       +1     
  Lines        2305     2674     +369     
==========================================
+ Hits         1006     1121     +115     
- Misses       1210     1450     +240     
- Partials       89      103      +14     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[mslipper]

A few gaps before this is ready to merge. Specifically:

• Stuff that touches the disk should use an FS helper in paths
• We should be scanning the disk once for all chain configs/superchains, then using in-memory data for further filtering operations. This is the architecture for other ops tools, and makes things much simpler