Forknet

System contract defining the forknet Aggchain logic. It only enforces bridge accounting (pessimistic) proofs to protect the shared bridge while the Aggchain state transitions are not proven. They must instead be signed by 1 aggchainSigner(s).

• Roles:
  • admin: EOA 2
  • aggchainSigners: EOA 3

Contains configuration parameters such as the Sequencer address, gas limit on this chain and the unsafe block signer address.

• Roles:
  • admin: ProxyAdmin; ultimately Conduit Multisig 1
  • batcherHash: EOA 1
  • owner: Conduit Multisig 1

The dispute game factory allows the creation of dispute games, used to propose state roots and eventually challenge them.

• Roles:
  • admin: ProxyAdmin; ultimately Conduit Multisig 1

The OptimismPortal contract usually is the main entry point to deposit funds from L1 to L2 or for finalizing withdrawals. It specifies which game type can be used for withdrawals, which currently is the PermissionedDisputeGame. This specific fork of the standard contract disables the depositTransaction() function, which prevents users from sending or forcing any transactions from L1 to L2, including token deposits. It is instead used for configuration and administration of the system.

• Roles:
  • admin: ProxyAdmin; ultimately Conduit Multisig 1

A verifier gateway for pessimistic proofs. Manages a map of chains and their verifier keys and is used to route proofs based on the first 4 bytes of proofBytes data in a proof submission. The SP1 verifier is used for all proofs.

• Roles:
  • addPpRoute: Timelock; ultimately PolygonAdminMultisig
  • admin: SharedProxyAdmin; ultimately PolygonAdminMultisig
  • aggchainDefaultVKey: PolygonAdminMultisig
  • alMultisig: PolygonAdminMultisig
  • freezePpRoute: PolygonAdminMultisig

The shared bridge contract, escrowing user funds sent to Agglayer chains. It is usually mirrored on each chain and can be used to transfer both ERC20 assets and arbitrary messages.

• Roles:
  • admin: SharedProxyAdmin; ultimately PolygonAdminMultisig
  • proxiedTokensManager: Timelock; ultimately PolygonAdminMultisig
• This contract can store any token.

The central shared managing contract for Polygon Agglayer chains. This contract coordinates chain deployments and proof validation. All connected Layer 2s can be globally paused by activating the ‘Emergency State’. This can be done by the PolygonSecurityCouncil or by anyone after 1 week of inactive verifiers.

• Roles:
  • admin: SharedProxyAdmin; ultimately PolygonAdminMultisig
  • createRollup: PolygonAdminMultisig, PolygonCreateRollupMultisig
  • defaultAdmin: Timelock; ultimately PolygonAdminMultisig
  • emergencyCouncilAdmin: PolygonSecurityCouncil
  • trustedAggregator: EOA 4, EOA 5
  • tweakParameters: PolygonAdminMultisig

A merkle tree storage contract aggregating state roots of each participating Layer 2, thus creating a single global merkle root representing the global state of the Agglayer, the ‘global exit root’. The global exit root is synchronized to all connected Layer 2s to help with their interoperability.

• Roles:
  • admin: SharedProxyAdmin; ultimately PolygonAdminMultisig

A timelock with access control. In the case of an activated emergency state in the AgglayerManager, all transactions through this timelock are immediately executable. The current minimum delay is 3d.

• Roles:
  • timelockAdmin: PolygonAdminMultisig (no delay if in emergency state), Timelock (no delay if in emergency state); ultimately PolygonAdminMultisig (no delay if in emergency state)

The main entry point to deposit ERC20 tokens from host chain to this chain.

• Roles:
  • admin: ProxyAdmin; ultimately Conduit Multisig 1

Sends messages from host chain to this chain, and relays messages back onto host chain. In the event that a message sent from host chain to this chain is rejected for exceeding this chain’s epoch gas limit, it can be resubmitted via this contract’s replay function.

• Roles:
  • admin: ProxyAdmin; ultimately Conduit Multisig 1

Used to bridge ERC-721 tokens from host chain to this chain.

• Roles:
  • admin: ProxyAdmin; ultimately Conduit Multisig 1

Contains the latest confirmed state root that can be used as a starting point in a dispute game.

• Roles:
  • admin: ProxyAdmin; ultimately Conduit Multisig 1

The PreimageOracle contract is used to load the required data from L1 for a dispute game.

A helper contract that generates OptimismMintableERC20 contracts on the network it’s deployed to. OptimismMintableERC20 is a standard extension of the base ERC20 token contract designed to allow the L1StandardBridge contracts to mint and burn tokens. This makes it possible to use an OptimismMintableERC20 as this chain’s representation of a token on the host chain, or vice-versa.

• Roles:
  • admin: ProxyAdmin; ultimately Conduit Multisig 1

• Roles:
  • owner: Conduit Multisig 1

Same as FaultDisputeGame, but only two permissioned addresses are designated as proposer and challenger. In the context of this permissioned aggkit deployment, there are no state proposals made here and the op stack fault proof system is not used.

Contract designed to hold the bonded ETH for each game. It is designed as a wrapper around WETH to allow an owner to function as a backstop if a game would incorrectly distribute funds.

• Roles:
  • admin: ProxyAdmin; ultimately Conduit Multisig 1
  • owner: Conduit Multisig 1

• Roles:
  • owner: Conduit Multisig 1

The MIPS contract is used to execute the final step of the dispute game which objectively determines the winner of the dispute.

Verifier contract for SP1 proofs (v5.0.0).

• Roles:
  • owner: Timelock

Extension contract of the AgglayerBridge for asset metadata…