feat: custom gas token

[tynes]

Description

Implements the custom gas token spec found in ethereum-optimism/specs#111
Includes the full feature set and extensive test coverage.

• contracts-bedrock: custom gas token L1 contracts
• contracts-bedrock: custom gas token L2 contracts
• contracts-bedrock: custom gas token contracts
• contracts-bedrock: custom gas token scripts
• contracts-bedrock: custom gas token tests
• op-bindings: update with custom gas token
• op-chain-ops: fixup tests
• contracts-bedrock: snapshots

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 29.22%. Comparing base (53f0080) to head (c21302e).
Report is 2 commits behind head on develop.

Additional details and impacted files

@@             Coverage Diff              @@
##           develop   #10143       +/-   ##
============================================
- Coverage    42.33%   29.22%   -13.11%     
============================================
  Files           73       31       -42     
  Lines         4845     2898     -1947     
  Branches       766      614      -152     
============================================
- Hits          2051      847     -1204     
+ Misses        2684     1976      -708     
+ Partials       110       75       -35     

Flag	Coverage Δ
cannon-go-tests	?
chain-mon-tests	27.14% <ø> (ø)
common-ts-tests	?
contracts-ts-tests	12.25% <ø> (ø)
core-utils-tests	?
sdk-tests	40.27% <ø> (ø)

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

see 42 files with indirect coverage changes

[mds1]

Looks really great on my first pass. Next week I'd like to re-review the spec and give a more security-focused review of the code and tests in this PR

[tynes]

@mds1 Needs versions such that they are -beta+custom-gas-token

[0xfuturistic]

implemented comments here: #10219

[semgrep-app]

Semgrep found 6 sol-style-return-arg-fmt findings:

• packages/contracts-bedrock/src/universal/StandardBridge.sol
  • L138 - Triage
  • L141 - Triage
• packages/contracts-bedrock/src/universal/CrossDomainMessenger.sol
  • L372 - Triage
  • L375 - Triage
• packages/contracts-bedrock/src/libraries/GasPayingToken.sol
  • L15 - Triage
  • L17 - Triage

Named return arguments to functions must be appended with an underscore (_)

_{Ignore this finding from sol-style-return-arg-fmt.}

[tynes]

@mds1 This branch has been rebased on top of your codesize checks and also includes all of the recent specs changes (IGasToken). I think this PR should be good to go at this point

[coderabbitai]

Actionable comments posted: 0

Out of diff range and nitpick comments (1)

packages/contracts-bedrock/test/L1/OptimismPortal.t.sol (1)

Line range hint 697-697: Avoid using blockhash(block.number) as it always returns 0.

- blockhash(block.number)
+ blockhash(block.number - 1) // Use the hash of the previous block

[coderabbitai]

Actionable comments posted: 0

Out of diff range and nitpick comments (1)

packages/contracts-bedrock/test/L1/OptimismPortal.t.sol (1)

Line range hint 697-697: Avoid using blockhash(block.number) as it always returns 0.

- optimismPortal.l2Oracle().proposeL2Output(proposal.outputRoot, optimismPortal.l2Oracle().nextBlockNumber(), blockhash(block.number), block.number);
+ optimismPortal.l2Oracle().proposeL2Output(proposal.outputRoot, optimismPortal.l2Oracle().nextBlockNumber(), blockhash(block.number - 1), block.number);

Using blockhash(block.number) results in a value of 0, which is not useful. Use blockhash(block.number - 1) instead to get the hash of the most recent block.

[trianglesphere]

go changes LGTM