feat: Add upgrade of superchain singletons

[maurelian]

TL;DR

Added support for upgrading SuperchainConfig and ProtocolVersions contracts through the OPContractsManager.

What changed?

• Added superchainConfigImpl and protocolVersionsImpl to the OPContractsManager's Implementations struct
• Created a new DeploySuperchainImplementations library to handle deployment of superchain implementation contracts
• Modified the upgrade function in OPContractsManager to handle upgrading superchain contracts
• Updated deployment scripts and tests to accommodate the new implementation contracts

How to test?

1. Run the existing test suite which includes new tests for superchain upgrades
2. Verify that the OPContractsManager can successfully upgrade SuperchainConfig and ProtocolVersions contracts
3. Check that proper revert conditions are in place when upgrade requirements aren't met

Why make this change?

To enable coordinated upgrades of superchain-level contracts (SuperchainConfig and ProtocolVersions) alongside other system contracts through the OPContractsManager. This provides a more unified and secure upgrade process for the entire system.

[maurelian]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• feat: Add upgrade of superchain singletons #13814 👈 (View in Graphite)
• TEMP: upgrade ASR with reinitializer(2) #13803
• OPCM upgrade full PoC #13574 : 1 other dependent PR (#13652 )
• Add deployImplementations to ForkLive flow #13573 : 1 other dependent PR (#13683 )
• feat: remove contractAddressesPath and disk reading #13649
• feat: remove redundant loadInitializeSlot func #13650
• feat: add etchLabelAndAllow #13651
• Deploy Cleanup: Make Artifacts stand alone and etch into global state #13648
• develop

This stack of pull requests is managed by Graphite. Learn more about stacking.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 38.68%. Comparing base (ee36e4e) to head (a943dc7).
Report is 2 commits behind head on opcm-up/upgrade-asr.

❗ There is a different number of reports uploaded between BASE (ee36e4e) and HEAD (a943dc7). Click for more details.

HEAD has 1 upload less than BASE

Flag	BASE (ee36e4e)	HEAD (a943dc7)
contracts-bedrock-tests	1	0

Additional details and impacted files

@@                   Coverage Diff                   @@
##           opcm-up/upgrade-asr   #13814      +/-   ##
=======================================================
- Coverage                45.85%   38.68%   -7.17%     
=======================================================
  Files                      901      792     -109     
  Lines                    75294    70665    -4629     
  Branches                   760        0     -760     
=======================================================
- Hits                     34525    27339    -7186     
- Misses                   38046    40945    +2899     
+ Partials                  2723     2381     -342     

Flag	Coverage Δ
contracts-bedrock-tests	?

Flags with carried forward coverage won't be shown. Click here to find out more.

see 184 files with indirect coverage changes