Overview
This release candidate enables fault proofs in the withdrawal path of the bridge on L1. It also modifies the SystemConfig
to remove the legacy L2OutputOracle
contract in favor of the DisputeGameFactory
.
Specification here.
Contracts Changed
L2OutputOracle
- The
L2OutputOracle
has been removed from the deployed protocol.
- The
OptimismPortal
- The
OptimismPortal
has been modified to allow users to prove their withdrawals against outputs that were proposed as dispute games, created via a trustedDisputeGameFactory
contract. spec.
- The
SystemConfig
- The
SystemConfig
has been changed to remove theL2_OUTPUT_ORACLE
storage slot as well as the getter for the contract. To replace it, a new getter for theDisputeGameFactory
proxy has been added.
- The
New Contracts
DisputeGameFactory
- The
DisputeGameFactory
is the new inbox for L2 output proposals on L1, creating dispute games. - Output proposals are now permissionless by default.
- Challenging output proposals is now permissionless by default.
- The
FaultDisputeGame
- The
FaultDisputeGame
facilitates trustless disputes over L2 output roots proposed on L1. spec.
- The
PermissionedDisputeGame
- A child of the
FaultDisputeGame
contract, that permissions proposing and challenging. Deployed as a safety mechanism to temporarily restore liveness in the event of theFaultDisputeGame
's failure.
- A child of the
MIPS
- The
MIPS
VM is a minimal kernel emulating the MIPS32 ISA with a subset of available Linux syscalls. This contract allows for executing single steps of a fault proof program at the base case of disputes in theFaultDisputeGame
. spec.
- The
PreimageOracle
- The
PreimageOracle
contract is responsible for serving verified data to the program running on top of theMIPS
VM during single-step execution. When data enters thePreimageOracle
, it is verified to be correctly formatted and honest. spec.
- The
AnchorStateRegistry
- The
AnchorStateRegistry
contract is responsible for tracking the latest finalized root claims from various dispute game types.
- The
DelayedWETH
DelayedWETH
is an extension ofWETH9
that delays unwrapping operations. Bonds that are placed in dispute games are held within this contract, and the owner may intervene in withdrawals to redistribute funds to submitters in case of dispute game resolution failure.