Celo core contracts

Table of Contents

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

Contracts List

Mainnet

See also the config files

L1 Contracts

ContractAddress
AddressManager0x55093104b76FAA602F9d6c35A5FFF576bE78d753
AnchorStateRegistry0x17B8E21aEC1B119321d2e3090B12F331845C9eAc
AnchorStateRegistryProxy0xa24Bf5Bc02997f63da4e2C7F802067e05a102504
CeloSuperchainConfig0x693cFD911523ccaE1a14AdE2501ae4a0A463b446
CeloSuperchainConfigProxy0xa440975E5A6BB19Bc3Bee901d909BB24b0f43D33
CustomGasToken0x64fE3f9201E6534D2d744c7C57D134E709131a6e
CustomGasTokenProxy0x057898f3C43F129a17517B9056D23851F124b19f
DelayedWETH0xDFBB69681F217aB3221E94AFCA4fEa51f5c6a779
DelayedWETHProxy0xa316D42E8Fd98D2Ec364b8bF853d2623E768f95a
DisputeGameFactory0xe8b013bEE7Bd603e2f0B4825638559d645A4C4CB
DisputeGameFactoryProxy0xFbAC162162f4009Bb007C6DeBC36B1dAC10aF683
FaultDisputeGame_00x876e8eeE292F23F163C9bCA406eDD65bEAEFBEBC
L1CrossDomainMessenger0xDE47b113E4157ed15fA46c5572562aC11146c5eA
L1CrossDomainMessengerProxy0x1AC1181fc4e4F877963680587AEAa2C90D7EbB95
L1ERC721Bridge0xad5D111e961A5E451C8172034115bcc0551b6551
L1ERC721BridgeProxy0x3C519816C5BdC0a0199147594F83feD4F5847f13
L1StandardBridge0x5e21245e97A7BB4733f72c412DcdDCED1f408587
L1StandardBridgeProxy0x9C4955b92F34148dbcfDCD82e9c9eCe5CF2badfe
L2OutputOracle0xA7585b14cd18675cA4668b5175F0FB0449f52471
L2OutputOracleProxy0x7617b249AEb1F06c90BDF9C4F6C903C09a6a4220
Mips0x8A12E1754f729C0856E2E32D4821577f0B245bfA
OptimismMintableERC20Factory0x0B3004b843dA84FE5D4C46AeB5E80F826e5CD69A
OptimismMintableERC20FactoryProxy0x6f0E4f1EB98A52EfaCF7BE11d48B9d9d6510A906
OptimismPortal0x0b9F190282E4Df9da350B9a087B793F9019a1fC9
OptimismPortal20x3Da872782f9fB696fD72Af2ec9313a56bDA6f06d
OptimismPortalProxy0xc5c5D157928BDBD2ACf6d0777626b6C75a9EAEDC
PermissionedDelayedWETHProxy0x9c314E8057025F2982aa4B3923Abd741A8e8DE91
PermissionedDisputeGame0x2bCeB78Fda0d5e3bfA7F4B8c499aa74bDf8D7755
PreimageOracle0xfaB0F466955D87e596Ca87E20c505bB6470D0DC4
ProtocolVersions0xfF53E1A6885B5A90B24327e13B04B95E2B97bd6C
ProtocolVersionsProxy0x1b6dEB2197418075AB314ac4D52Ca1D104a8F663
ProxyAdmin0x783A434532Ee94667979213af1711505E8bFE374
SafeProxyFactory0xa6B71E26C5e0845f74c812102Ca7114b6a896AB2
SafeSingleton0xd9Db270c1B5E3Bd161E8c8503c55cEABeE709552
StorageSetter0x6322C2f2D6a4305Fc033754d486A5A067Ee5F9b1
SuperchainConfigProxy0x95703e0982140D16f8ebA6d158FccEde42f04a4C
SystemConfig0x7b5a84F818B6fC3F079EE87c214F369062188D2A
SystemConfigProxy0x89E31965D844a309231B1f17759Ccaf1b7c09861
SystemOwnerSafe0x4092A77bAF58fef0309452cEaCb09221e556E112

L2 Contracts

ContractAddress
Registry0x000000000000000000000000000000000000ce10
Accounts0x7d21685C17607338b313a7174bAb6620baD0aaB7
Attestations0xdC553892cdeeeD9f575aa0FBA099e5847fd88D20
BlockchainParameters0x6E10a8864C65434A721d82e424d727326F9d5Bfa
CELO (GoldToken)0x471EcE3750Da237f93B8E339c536989b8978a438
CeloUnreleasedTreasury0x7A8c7a833565fc428cdFBa20FE03fAfb178A434f
DoubleSigningSlasher0x50C100baCDe7E2b546371EB0Be1eACcf0A6772ec
DowntimeSlasher0x71CAc3B31c138F3327C6cA14f9a1c8d752463fDd
Election0x8D6677192144292870907E3Fa8A5527fE55A7ff6
EpochRewards0x07F007d389883622Ef8D4d347b3f78007f28d8b7
Escrow0xf4Fa51472Ca8d72AF678975D9F8795A504E7ada5
FeeCurrencyDirectory0x15F344b9E6c3Cb6F0376A36A64928b13F62C6276
FederatedAttestations0x0aD5b1d0C25ecF6266Dd951403723B2687d6aff2
FeeHandler0xcD437749E43A154C07F3553504c68fBfD56B8778
Freezer0x47a472F45057A9d79d62C6427367016409f4fF5A
Governance0xD533Ca259b330c7A88f74E000a3FaEa2d63B7972
LockedGold0x6cC083Aed9e3ebe302A6336dBC7c921C9f03349E
MentoFeeHandlerSeller0x4eFa274B7e33476C961065000D58ee09F7921A74
OdisPayments0xAE6B29f31B96e61DdDc792f45fDa4e4F0356D0CB
Random0x22a4aAF42A50bFA7238182460E32f15859c93dfe
Reserve0x9380fA34Fd9e4Fd14c06305fd7B6199089eD4eb9
SortedOracles0xefB84935239dAcdecF7c5bA76d8dE40b077B7b33
StableToken0x765DE816845861e75A25fCA122bb6898B8B1282a
StableTokenBRL0xe8537a3d056DA446677B9E9d6c5dB704EaAb4787
StableTokenEUR0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73
TransferWhitelist0xb49E4d6F0B7f8d0440F75697E6c8b37E09178BCF
UniswapFeeHandlerSeller0x399e78488ecC13794f4a4d9534c20a8c1A6e5A8b
Validators0xaEb865bCa93DdC8F47b8e29F40C5399cE34d0C58

Alfajores testnet

See also the config files

L1 Contracts

ContractAddress
AddressManager0xF9f47a32F0BB1F92cF200b1CC9a1713F96b65284
AnchorStateRegistry0x4808399b1FE4e64aB2E1fb6AEb677be1e0486E48
AnchorStateRegistryProxy0x235CCA09E27697230ae7c1C671760d6eEB92b12B
CustomGasToken0xDe320eD3fB9aC264aFf931166624FBD7c00eF14D
CustomGasTokenProxy0x3E3FEA3F31ff162a460f11Af4c53f39E743fd88c
DelayedWETH0xc2E34eea5C05dA48859413cA3EDaD6312ecb9f8B
DelayedWETHProxy0x8e2a6D372557c9661045f26B140E7A189C38D80C
DisputeGameFactory0x3874804fCCC0D3920eEbE1279D7d9D7239Df3099
DisputeGameFactoryProxy0xE28AAdcd9883746c0e5068F58f9ea06027b214cb
L1CrossDomainMessenger0xC2ebeDd961385B2b69b649176fbF45Fc639264C8
L1CrossDomainMessengerProxy0xF1eE12842631A56a860A38C20B588F4Bb872a4F8
L1ERC721Bridge0x7eaB38385dA918e37d8Ad4A7260AA35c72Fb1231
L1ERC721BridgeProxy0x514912297580a20B7a0C2930BC8503d2C13Da642
L1StandardBridge0x93c43a17Cc9Ed1e686848A85a0b15d54FFC24718
L1StandardBridgeProxy0xD1B0E0581973c9eB7f886967A606b9441A897037
L2OutputOracle0x8D2c7a8E3563347198336fdc25Aa9Ed599EC86f4
L2OutputOracleProxy0x4a2635e9e4f6e45817b1D402ac4904c1d1752438
Mips0x786D6F6D3b5405E75dE009694e0bA51696ebBD6a
OptimismMintableERC20Factory0x757412A2D3cd8f1D93CACAc086A007822D32BC40
OptimismMintableERC20FactoryProxy0xa950F004F069B0bF9201b17e71549c7711d4a9d5
OptimismPortal0x837AA1b09c4991B3b1Cda3811355aa17A356F815
OptimismPortal20xaC8f44aE4946700C9521089Ab39Be3e4af203dAd
OptimismPortalProxy0x82527353927d8D069b3B452904c942dA149BA381
PermissionedDelayedWETHProxy0xB1A97AB7C0c1507Ea0e55A76e34EF4C86793ef28
PreimageOracle0x68967789277F6E831c9Dd73b5B67E598f79C248D
ProtocolVersions0x1C1EA96d23ED31727DEFdF39703C2826C74F4f5a
ProtocolVersionsProxy0x5E5FEA4D2A8f632Af05D1E725D7ca865327A080b
ProxyAdmin0x4630583d066520aF0E3fda0de2C628EEd2888683
SafeProxyFactory0xa6B71E26C5e0845f74c812102Ca7114b6a896AB2
SafeSingleton0xd9Db270c1B5E3Bd161E8c8503c55cEABeE709552
SuperchainConfig0xeCdf3fbeEA73054e44c42c88A4d2B58ec2DC38be
SuperchainConfigProxy0xdf4Fb5371B706936527B877F616eAC0e47c9b785
SystemConfig0x83E71BBFe96C07d793705f930DAC8808fbf86201
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
UniswapFeeHandlerSeller0x7aa66e35D2c9763cf8067CD011F11D2f6715BF3A
Validators0x9acF2A99914E083aD0d610672E93d14b0736BBCc

Baklava testnet

See also the config files

L1 Contracts

ContractAddress
AddressManager0x156aa732322e878E01e3fB9d6C7a3b30b267bBA4
AnchorStateRegistry0xFbAe891e299D97A8B1e142d8413E26b771BE24Fa
AnchorStateRegistryProxy0x9C4B83AED7e5103dC6F38DfA265933Fe418Ed090
CeloSuperchainConfig0x6fD51d9A96e7822B33ddEb0bcB614342C6E6C179
CeloSuperchainConfigProxy0x6ac47E296d59A8D3b8933276EA3dB1CC28e920DA
CustomGasToken0x7Fad4A58727B2e926a3fA29ec5Dd2cfe913Ee8E5
CustomGasTokenProxy0xE692fD8305e097b0e73f1b61aCA8b74Cd921443B
DelayedWETH0x7866c074fCaBF85C256CBd713d334d2331be34e8
DelayedWETHProxy0x9B014033014c8C9026Dbc5151049ffFA8581942E
DisputeGameFactory0xB590770Fb259c4e3CB8a485a0b65332F9B6a5957
DisputeGameFactoryProxy0x788ef5850c3a51d41f59Dc4327017EF8D754eD80
L1CrossDomainMessenger0xbbbD1661C9DF6caB8398a1d0d6450f3c745D3858
L1CrossDomainMessengerProxy0x418F16753b868adDc5f0C2860b05D8b921fCee75
L1ERC721Bridge0x27c38F647AC92007C63755399450dE02Ad4e2795
L1ERC721BridgeProxy0xe65F0FE051FCe8a8De3A5c8DcFa474025F6F2D73
L1StandardBridge0x494Ba1b1F7A5504F3E2241001CF1AdA463337516
L1StandardBridgeProxy0x6fd3fF186975aD8B66Ab40b705EC016b36da0486
L2OutputOracle0xBFE7aC127012f5C647288a4987F0f7286Baa97c1
L2OutputOracleProxy0x1C084a644951A5d189396c8761A9F95b33c282E6
Mips0x8F5a62ceb69c0D0674937DA29023b49BA279F164
OptimismMintableERC20Factory0x91A3E5DaDbAd1A2333202769295d0b3a34A36dC9
OptimismMintableERC20FactoryProxy0x0e8e9173e163C593AcF823BA0880f25bCF40fEa1
OptimismPortal0xC10869a4674bd8cB8ea6182d6354cE4E04307470
OptimismPortal20x6C6cE21Bd9b7Fc9a52aC4Ff84C637e2D0968e8cF
OptimismPortalProxy0x87e9cB54f185a32266689138fbA56F0C994CF50c
PermissionedDelayedWETHProxy0x913D24b7E2730Cab1d97423cE154aC1C224734f2
PreimageOracle0x3052f7e497870bE9aD7cd2C1fFC415c5Fb8ecFC3
ProtocolVersions0x3eeB36750BEe9E2f85485fc8cff214216377caac
ProtocolVersionsProxy0x3d438C63e0431DA844d3F60E6c712d10FC75c529
ProxyAdmin0xBF101Bd81fb69aB00ab261465454dF1a171726Bf
SafeProxyFactory0xa6B71E26C5e0845f74c812102Ca7114b6a896AB2
SafeSingleton0xd9Db270c1B5E3Bd161E8c8503c55cEABeE709552
StorageSetter0x5C808C7339e812321ef47d1118194337C5fed4E4
SuperchainConfig0x2E4F0959330C65860738221DD5Fcf9D421A92Be9
SuperchainConfigProxy0xf07502A4a950d870c43b12660fB1Dd18c170D344
SystemConfig0x7e1C54769795f1Be7cd427b5879ae9c8023FFbbF
SystemConfigProxy0x3ee24bF404e4a5D27A437d910F56E1eD999B1De8
SystemOwnerSafe0xd542f3328ff2516443FE4db1c89E427F67169D94

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
UniswapFeeHandlerSeller0xB53F049eE8E9e0c48AC430b70d9e030f23d4727D
Validators0xcb3A2f0520edBb4Fc37Ecb646d06877E339bBC9D

ABIs

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