Skip to main content

Manual Setup

How to manually add a Celo network to your existing MetaMask wallet.


tip

If you're a dApp developer and want to set up your wallet this programmatically, view programmatic setup.

Setup

Make sure to have MetaMask installed. See here to download. Then, follow the instructions to create an account. Make sure to save your seed phrase safely!

Adding a Celo Network to MetaMask

  1. Open MetaMask, click your profile image on the top right corner, and then click "Settings". Next, scroll down to "Networks" and click. Finally, press the "Add Network" button.
  2. Fill in the following values depending on which Celo network you would like to connect to: Alfajores, Baklava, or Mainnet.
Network Name: Celo (Mainnet)
New RPC URL: https://forno.celo.org
Chain ID: 42220
Currency Symbol (Optional): CELO
Block Explorer URL (Optional): https://explorer.celo.org
  1. Press "Save". The Celo network you just configured should now show up under MetaMask's "Networks" dropdown list.

Adding Tokens (e.g. cUSD, cEUR)

  1. From MetaMask's Home screen, click on "Add Token" in the "Assets" tab.
  2. Click "Custom Token", and fill in the value for "Token Contract Address" for the token you'd like to add. The "Token Symbol" and "Decimals of Precision" should be filled in automatically.

The following are examples for cUSD and cEUR.

  • Token Contract Address for cUSD: 0x765de816845861e75a25fca122bb6898b8b1282a
  • Token Contract Address for cEUR: 0xd8763cba276a3738e6de85b4b3bf5fded6d6ca73

Sending assets to Metamask

Celo addresses have the same format as Ethereum addresses, so copying and pasting an address into the "to" field should work for most applications.

warning

If you are scanning a QR code to populate transaction information some applications may give you an error. For example, Metamask prefixes addresses in QR codes with "ethereum:". This can cause problems when trying to send CELO to Metamask when scanning your Metamask address QR code with the Coinbase mobile application. To avoid this issue, simply copy and paste the address rather than use the QR code scanner.