Skip to main content

Protocol Contracts

This document aggregates Gate Layer system contracts across GateChain (L1) and Gate Layer (L2). For clarity, items are separated into Mainnet, Testnet.


Mainnet · Core L1 Contracts

Contracts currently deployed on GateChain mainnet for the Gate Layer system:

Contract NameAddressDescription
AddressManager0x5446e2bea992f5fa70d717fadb998073702dc1a6Address resolution/registry (legacy-compatible shape).
ProxyAdmin0x977ce593493a3d1bca355187b573aeb37fa099a3Proxy upgrade admin.
L1StandardBridge0x1b30f00bbfea2d2daaabbaf28059477cea9e0e36Handles ETH/ERC20 deposits/withdrawals between L1 and L2.
L1CrossDomainMessenger0x030b1fa1112a52dcc3b131d393d40234d36ec741Cross-domain messenger L1 side.
OptimismPortal0x48a4c3f12e489452e5b45facc04df901d7adc8cfL2 data submission entry + withdrawal proofs.
DisputeGameFactory0x089a3b9d9caa629d1b3ce382f3b212b9ebb78730Fault-proof/challenge factory.
SystemConfig0xd929985b14c809ce4d7b20dfc008e0f3c0c80b66L2 fee parameters and config.
L1ERC721Bridge0x9176cb94f3663f28454b133a66c9305e01be3b85ERC721 bridge L1 side.
OptimismMintableERC20Factory0x92bebadd993314a24d612fcd72eecf0e4fe5be0dL2 mintable token factory counterpart.
AnchorStateRegistry0x0826e88946941b9b2153b73250706e10c7af7b7eAnchor state registry.

Mainnet · Implementation Contracts

The following are the implementation addresses that current proxies point to on mainnet:

Contract NameImplementation Address
L1StandardBridge Impl0x0b09ba359a106c9ea3b181cbc5f394570c7d2a7a
L1CrossDomainMessenger Impl0x5d5a095665886119693f0b41d8dfee78da033e8b
OptimismPortal Impl0xb1dfde4e7c3018b97fa68b12f7d5648c96e4674e
DisputeGameFactory Impl0x4bba758f006ef09402ef31724203f316ab74e4a0
SystemConfig Impl0xec6c6d47ec88f474bffa4defd38930fb2e79084c
L1ERC721Bridge Impl0x7ae1d3bd877a4c5ca257404ce26be93a02c98013
OptimismMintableERC20Factory Impl0x5493f4677a186f64805fe7317d6993ba4863988f

Mainnet · L2 Predeploy Contracts

Currently identical to testnet; if customized later, this section will be updated.

Contract NameAddressDescription
L2CrossDomainMessenger0x4200000000000000000000000000000000000007L2-side cross-domain messenger paired with L1 XDM.
L2StandardBridge0x4200000000000000000000000000000000000010L2 side of the standard asset bridge (ETH/ERC20).
L2ToL1MessagePasser0x4200000000000000000000000000000000000016Low-level channel/record for L2→L1 withdrawals/messages.
L1Block0x4200000000000000000000000000000000000015Provides L1 block info and base fee readings (read-only).
GasPriceOracle0x420000000000000000000000000000000000000FL2 fee oracle interface (baseFee, overhead/scalar, etc.).
L2ERC721Bridge0x4200000000000000000000000000000000000014L2 ERC721 bridge.
OptimismMintableERC20Factory (L2)0x4200000000000000000000000000000000000012Creates mintable mirror tokens for deposited assets on L2.
SequencerFeeVault0x4200000000000000000000000000000000000011Sequencer fee vault.
BaseFeeVault0x4200000000000000000000000000000000000019Base fee vault.
L1FeeVault0x420000000000000000000000000000000000001AL1 fee vault.
OperatorFeeVault0x420000000000000000000000000000000000001BOperator fee vault.
ProxyAdmin0x4200000000000000000000000000000000000018Proxy admin (upgrade management).

Testnet · Core L1 Contracts

These are the primary contracts currently deployed on the testnet.

Contract NameAddressDescription
L1StandardBridge0x75ded3be4d69e8403c9079ae5cf5e059a23f6a67Handles deposits and withdrawals of ETH and standard ERC20 tokens between L1 and L2.
L1CrossDomainMessenger0x60cad8d7d622be3d62786b2e7a6617765d0f4d94Passes arbitrary messages between L1 and L2, forming the basis for cross-domain communication.
OptimismPortal0x0d69cdd07cf93075fe53769945575274fc563ba9The entry point for L2 transaction data submission to L1 and handles withdrawal proofs. A core part of the system.
DisputeGameFactory0x6f419bb5d754033e39f758d20133d7fea8e2bb55The core of the fault-proof system, used to create and manage challenges against L2 output roots.
SystemConfig0xaeb4b93732c30c5d74ab3220cd73aa0fcdd275f8Stores L2 gas-related parameters, such as overhead and scalar.
L1ERC721Bridge0xa19cbb87428a6b943912f2f44241ca1cb3a8cec1Handles the bridging of ERC721 NFT tokens between L1 and L2.
OptimismMintableERC20Factory0xca1bbd1187ccbf2297c828c48f5c0896d9985636Creates "mintable" versions of ERC20 tokens on L2 that correspond to deposited L1 tokens.
ProxyAdmin0x1be6f451a7578cb48ddbd8fea8d2fd25462e5d16Manages the upgrade permissions for the core contracts listed above.
AddressManager0x6cbd08ae08136ab974ae121a0895d3836c8a00ce(Legacy) A registry used to resolve and manage system contract addresses.

Testnet · Implementation Contracts

The following are the logic implementation addresses that the proxy contracts listed above currently point to. These addresses may change with protocol upgrades.

Contract NameImplementation Address
L1StandardBridge Impl0x0b09ba359a106c9ea3b181cbc5f394570c7d2a7a
L1CrossDomainMessenger Impl0x5d5a095665886119693f0b41d8dfee78da033e8b
OptimismPortal Impl0xb1dfde4e7c3018b97fa68b12f7d5648c96e4674e
DisputeGameFactory Impl0x4bba758f006ef09402ef31724203f316ab74e4a0
SystemConfig Impl0xec6c6d47ec88f474bffa4defd38930fb2e79084c
L1ERC721Bridge Impl0x7ae1d3bd877a4c5ca257404ce26be93a02c98013
OptimismMintableERC20Factory Impl0x5493f4677a186f64805fe7317d6993ba4863988f

Testnet · L2 Predeploy Contracts (Standard Fixed Addresses)

| Contract Name | Address | Description | | ------------------------------------- | -------------------------------------------- | ---------------------------------------------------------- | --- | | L2CrossDomainMessenger | 0x4200000000000000000000000000000000000007 | L2-side cross-domain messenger paired with L1 XDM. | | L2StandardBridge | 0x4200000000000000000000000000000000000010 | L2 side of the standard asset bridge (ETH/ERC20). | | L2ToL1MessagePasser | 0x4200000000000000000000000000000000000016 | Low-level channel/record for L2→L1 withdrawals/messages. | | L1Block | 0x4200000000000000000000000000000000000015 | Provides L1 block info and base fee readings (read-only). | | GasPriceOracle | 0x420000000000000000000000000000000000000F | L2 fee oracle interface (baseFee, overhead/scalar, etc.). | | L2ERC721Bridge | 0x4200000000000000000000000000000000000014 | L2 ERC721 bridge. | | OptimismMintableERC20Factory (L2) | 0x4200000000000000000000000000000000000012 | Creates mintable mirror tokens for deposited assets on L2. | | SequencerFeeVault | 0x4200000000000000000000000000000000000011 | Sequencer fee vault. | | BaseFeeVault | 0x4200000000000000000000000000000000000019 | Base fee vault. | | L1FeeVault | 0x420000000000000000000000000000000000001A | L1 fee vault. | | OperatorFeeVault | 0x420000000000000000000000000000000000001B | Operator fee vault. | | ProxyAdmin | 0x4200000000000000000000000000000000000018 | Proxy admin (upgrade management). | |

Last updated on 2025/09/25