Katana

The main system contract defining the katana Layer 2 logic. As this contract is based on the OP-Succinct L2OutputOracle, OP stack outputRoots (L2 state roots) are saved here.

• Roles:
  • aggchainManager: Katana Foundation Engineering/Security Multisig
  • optimisticModeManager: Katana Foundation Engineering/Security Multisig
  • trustedSequencer: EOA 2 optimisticMode is enabled by the optimisticModeManager

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 Katana Foundation Engineering/Security Multisig

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

• Roles:
  • admin: ProxyAdmin; ultimately Katana Foundation Engineering/Security Multisig
  • batcherHash: EOA 1
  • owner: Katana Foundation Engineering/Security Multisig

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
  • freezePpRoute: PolygonAdminMultisig

The shared bridge contract, escrowing user funds sent to AggLayer participants. 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 3, EOA 4
  • 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 PolygonRollupManager, 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)

This token contract uses a standard ‘vault bridge token’ implementation created by Agglayer CDK. It keeps deposited assets in a vault and issues an IOU token (Vault Bridge WBTC) which can be deposited to Agglayer. The underlying asset is generating yield, which does not accrue to the vbWBTC-IOU but is sent to Katana yieldRecipient Mulsitig.

• Roles:
  • admin: ProxyAdmin; ultimately Katana vaultBridge Multisig 1

This token contract uses a standard ‘vault bridge token’ implementation created by Agglayer CDK. It keeps deposited assets in a vault and issues an IOU token (Vault Bridge ETH) which can be deposited to Agglayer. The underlying asset is generating yield, which does not accrue to the vbETH-IOU but is sent to Katana yieldRecipient Mulsitig.

• Roles:
  • admin: ProxyAdmin; ultimately Katana vaultBridge Multisig 1

This token contract uses a standard ‘vault bridge token’ implementation created by Agglayer CDK. It keeps deposited assets in a vault and issues an IOU token (Vault Bridge USDS) which can be deposited to Agglayer. The underlying asset is generating yield, which does not accrue to the vbUSDS-IOU but is sent to Katana yieldRecipient Mulsitig.

• Roles:
  • admin: ProxyAdmin; ultimately Katana vaultBridge Multisig 2

Helper contract for the vaultBridge tokens on Layer 2. If any vbTokens are minted ‘natively’ on Layer 2, this contract can receive the underlying assets and lock them in the Layer 1 vaults.

• Roles:
  • admin: ProxyAdmin; ultimately Polygon Labs Engineering/Security Multisig

This token contract uses a standard ‘vault bridge token’ implementation created by Agglayer CDK. It keeps deposited assets in a vault and issues an IOU token (Vault Bridge USDC) which can be deposited to Agglayer. The underlying asset is generating yield, which does not accrue to the vbUSDC-IOU but is sent to Katana yieldRecipient Mulsitig.

• Roles:
  • admin: ProxyAdmin; ultimately Katana vaultBridge Multisig 3

This token contract uses a standard ‘vault bridge token’ implementation created by Agglayer CDK. It keeps deposited assets in a vault and issues an IOU token (Vault Bridge USDT) which can be deposited to Agglayer. The underlying asset is generating yield, which does not accrue to the vbUSDT-IOU but is sent to Katana yieldRecipient Mulsitig.

• Roles:
  • admin: ProxyAdmin; ultimately Katana vaultBridge Multisig 1

• Roles:
  • owner: Katana vaultBridge Multisig 1

• Roles:
  • owner: Katana Foundation Engineering/Security Multisig

• Roles:
  • owner: Polygon Labs Engineering/Security Multisig

Same as FaultDisputeGame, but only two permissioned addresses are designated as proposer and challenger.

• Roles:
  • owner: Katana vaultBridge Multisig 1

• Roles:
  • owner: Katana vaultBridge Multisig 1

• Roles:
  • owner: Katana Foundation Engineering/Security Multisig

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

• Roles:
  • admin: ProxyAdmin; ultimately Katana Foundation Engineering/Security Multisig

• Roles:
  • owner: Katana vaultBridge Multisig 3

• Roles:
  • owner: Katana vaultBridge Multisig 2

Verifier contract for SP1 proofs (v5.0.0).

• Roles:
  • owner: Timelock