Celo core contracts

Table of Contents

To facilitate Celo features and governance, the Celo chain has a set of core contracts.

Contracts List

Mainnet

L1 Contracts

ContractAddress
AddressManager0x55093104b76FAA602F9d6c35A5FFF576bE78d753
AnchorStateRegistryProxy0xa24Bf5Bc02997f63da4e2C7F802067e05a102504
CeloSuperchainConfigProxy0xa440975E5A6BB19Bc3Bee901d909BB24b0f43D33
CustomGasTokenProxy (Celo Token)0x057898f3C43F129a17517B9056D23851F124b19f
DelayedWETHProxy0xa316D42E8Fd98D2Ec364b8bF853d2623E768f95a
DisputeGameFactoryProxy0xFbAC162162f4009Bb007C6DeBC36B1dAC10aF683
L1CrossDomainMessengerProxy0x1AC1181fc4e4F877963680587AEAa2C90D7EbB95
L1ERC721BridgeProxy0x3C519816C5BdC0a0199147594F83feD4F5847f13
L1StandardBridgeProxy0x9C4955b92F34148dbcfDCD82e9c9eCe5CF2badfe
L2OutputOracleProxy0x7617b249AEb1F06c90BDF9C4F6C903C09a6a4220
Mips0x8A12E1754f729C0856E2E32D4821577f0B245bfA
OptimismMintableERC20FactoryProxy0x6f0E4f1EB98A52EfaCF7BE11d48B9d9d6510A906
OptimismPortal0x0b9F190282E4Df9da350B9a087B793F9019a1fC9
OptimismPortal20x3Da872782f9fB696fD72Af2ec9313a56bDA6f06d
OptimismPortalProxy0xc5c5D157928BDBD2ACf6d0777626b6C75a9EAEDC
PermissionedDelayedWETHProxy0x9c314E8057025F2982aa4B3923Abd741A8e8DE91
PreimageOracle0xfaB0F466955D87e596Ca87E20c505bB6470D0DC4
ProtocolVersionsProxy0x1b6dEB2197418075AB314ac4D52Ca1D104a8F663
ProxyAdmin0x783A434532Ee94667979213af1711505E8bFE374
SafeProxyFactory0xa6B71E26C5e0845f74c812102Ca7114b6a896AB2
SafeSingleton0xd9Db270c1B5E3Bd161E8c8503c55cEABeE709552
StorageSetter0x6322C2f2D6a4305Fc033754d486A5A067Ee5F9b1
SuperchainConfigProxy0x95703e0982140D16f8ebA6d158FccEde42f04a4C
SystemConfigProxy0x89E31965D844a309231B1f17759Ccaf1b7c09861
SystemOwnerSafe0x4092A77bAF58fef0309452cEaCb09221e556E112

L2 Contracts

Addresses for L2 contracts remain unchanged after the transition, please refer to the documentation.

See also the config files for the deployment

Alfajores testnet

L1 Contracts

ContractAddress
AddressManager0xF9f47a32F0BB1F92cF200b1CC9a1713F96b65284
CustomGasTokenProxy0x3E3FEA3F31ff162a460f11Af4c53f39E743fd88c
DisputeGameFactoryProxy0xE28AAdcd9883746c0e5068F58f9ea06027b214cb
L1CrossDomainMessengerProxy0xF1eE12842631A56a860A38C20B588F4Bb872a4F8
L1ERC721BridgeProxy0x514912297580a20B7a0C2930BC8503d2C13Da642
L1StandardBridgeProxy0xD1B0E0581973c9eB7f886967A606b9441A897037
L2OutputOracleProxy0x4a2635e9e4f6e45817b1D402ac4904c1d1752438
OptimismMintableERC20FactoryProxy0xa950F004F069B0bF9201b17e71549c7711d4a9d5
OptimismPortalProxy0x82527353927d8D069b3B452904c942dA149BA381
PreimageOracle0x68967789277F6E831c9Dd73b5B67E598f79C248D
ProtocolVersionsProxy0x5E5FEA4D2A8f632Af05D1E725D7ca865327A080b
ProxyAdmin0x4630583d066520aF0E3fda0de2C628EEd2888683
SafeProxyFactory0xa6B71E26C5e0845f74c812102Ca7114b6a896AB2
SafeSingleton0xd9Db270c1B5E3Bd161E8c8503c55cEABeE709552
SuperchainConfigProxy0xdf4Fb5371B706936527B877F616eAC0e47c9b785
SystemConfigProxy0x499b0C1F4BDC76d61b1D13b03384eac65FAF50c7
SystemOwnerSafe0xf05f102e890E713DC9dc0a5e13A8879D5296ee48

L2 Contracts

ContractAddress
Registry0x000000000000000000000000000000000000ce10
Accounts0xed7f51A34B4e71fbE69B3091FcF879cD14bD73A9
Attestations0xAD5E5722427d79DFf28a4Ab30249729d1F8B4cc0
BlockchainParameters0xE5aCbb07b4Eed078e39D50F66bF0c80cF1b93abe
CELO (GoldToken)0xF194afDf50B03e69Bd7D057c1Aa9e10c9954E4C9
CeloUnreleasedTreasury0x07bf0b2461A0cb608D5CF9a82ba97dAbA850F79F
DoubleSigningSlasher0x88A4c203C488E8277f583942672E1aF77e2B5040
DowntimeSlasher0xf2224c1d7b447D9A43a98CBD82FCCC0eF1c11CC5
Election0x1c3eDf937CFc2F6F51784D20DEB1af1F9a8655fA
EpochRewards0xB10Ee11244526b94879e1956745bA2E35AE2bA20
Escrow0xb07E10c5837c282209c6B9B3DE0eDBeF16319a37
FeeCurrencyDirectory0x9212Fb72ae65367A7c887eC4Ad9bE310BAC611BF
FederatedAttestations0x70F9314aF173c246669cFb0EEe79F9Cfd9C34ee3
FeeHandler0xEAaFf71AB67B5d0eF34ba62Ea06Ac3d3E2dAAA38
Freezer0xfe0Ada6E9a7b782f55750428CC1d8428Cd83C3F1
Governance0xAA963FC97281d9632d96700aB62A4D1340F9a28a
LockedGold0x6a4CC5693DC5BFA3799C699F3B941bA2Cb00c341
MentoFeeHandlerSeller0xae83C63B5FB50C353c8d23397bcC9dBf3a9837Ac
OdisPayments0x645170cdB6B5c1bc80847bb728dBa56C50a20a49
Random0xdd318EEF001BB0867Cd5c134496D6cF5Aa32311F
Reserve0xa7ed835288Aa4524bB6C73DD23c0bF4315D9Fe3e
SortedOracles0xFdd8bD58115FfBf04e47411c1d228eCC45E93075
StableToken0x874069Fa1Eb16D44d622F2e0Ca25eeA172369bC1
StableTokenBRL0xE4D517785D091D3c54818832dB6094bcc2744545
StableTokenEUR0x10c892A6EC43a53E45D0B916B4b7D383B1b78C0F
TransferWhitelist0x52449A99e3455acB831C0D580dCDAc8B290d5182
UniswapFeeHandlerSeller0xc7b6E77C3702666DDa8EB5b7F30234B020788b21
Validators0x9acF2A99914E083aD0d610672E93d14b0736BBCc

See also the config files for the deployment

Baklava testnet

L1 Contracts

L2 Contracts

ContractAddress
Registry0x000000000000000000000000000000000000ce10
Accounts0x64FF4e6F7e08119d877Fd2E26F4C20B537819080
Attestations0xaeB505a8ba97241cc85d98c2e892608dD16Da3cc
BlockchainParameters0x2F6fEAcB6a4326c47E5AC16dddb5542ADAf45FC8
CELO (GoldToken)0xdDc9bE57f553fe75752D61606B94CBD7e0264eF8
CeloUnreleasedTreasury0x022c5d5837E177B6d145761feb4C5574e5b48F5e
DoubleSigningSlasher0x9c2FBF60Aa2A8dDc73c499C9b724e86D8C15F72f
DowntimeSlasher0xC743C9a58050a669ec4aff41D8A6C76f2264e206
Election0x7eb2b2f696C60A48Afd7632f280c7De91c8E5aa5
EpochRewards0xfdc7D3da53Ca155dDCE793B0de46f4c29230EecD
Escrow0xDDc9821C93203d00A264514888De01Fc1129DBFF
FeeCurrencyDirectory0xD59E1599F45e42Eb356202B2C714D6C7b734C034
FederatedAttestations0xea2e712082E7B5c5C7B1BC004929ECfDf8F36AbD
FeeHandler0xeed0A69c51079114C280f7b936C79e24bD94013e
Freezer0x3f155CD55697C44fb6e4e0CB7D885fAeaE38B62d
Governance0x28443b1d87db521320a6517A4F1B6Ead77F8C811
LockedGold0xF07406D8040fBD831e9983CA9cC278fBfFeB56bF
MentoFeeHandlerSeller0xd3f13216B1286459B04C444a25D91892Ee2FAAc9
OdisPayments0x77150d61ba9fbA8f0413849e8Ea8cb1b1d636E34
Random0x3fcEcdaFf7C2d48EA73fBf338E99E375A3d6754F
Reserve0x68Dd816611d3DE196FDeb87438B74A9c29fd649f
SortedOracles0x88A187a876290E9843175027902B9f7f1B092c88
StableToken0x62492A644A588FD904270BeD06ad52B9abfEA1aE
StableTokenBRL0x6a0EEf2bed4C30Dc2CB42fe6c5f01F80f7EF16d1
StableTokenEUR0xf9ecE301247aD2CE21894941830A2470f4E774ca
TransferWhitelist0x4Bb0805692a74Dd0815E11FC1a66441C65F5b5D9
UniswapFeeHandlerSeller0xdd28Ff369472B2Cf9ddc64acD1087b4a8BfF78FD
Validators0xcb3A2f0520edBb4Fc37Ecb646d06877E339bBC9D

See also the config files for the deployment

ABIs

JSON ABI descriptions for all core contracts are available in the @celo/abi npm package.