From 82f488d77dab412890e15a1037451312e84fcdc4 Mon Sep 17 00:00:00 2001 From: Paul Lange Date: Fri, 2 Oct 2026 11:05:11 +0200 Subject: [PATCH 1/4] docs(metamask): point end users at the add-network button and the wallets page --- build/tools/wallets/metamask/use.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/build/tools/wallets/metamask/use.mdx b/build/tools/wallets/metamask/use.mdx index 86bdea68da..fdde2c44c0 100644 --- a/build/tools/wallets/metamask/use.mdx +++ b/build/tools/wallets/metamask/use.mdx @@ -15,7 +15,7 @@ Since Celo network's [Donut Hardfork](https://github.com/celo-org/celo-proposals ### **For end users:** -- [Configure a MetaMask Desktop or Web Wallet to Work with Celo](/build/tools/wallets/metamask/setup) +- [Add Celo Mainnet or Celo Sepolia to MetaMask](/build-on-celo/network-overview) - [Setup a Ledger to Work with MetaMask to Work With Celo](/build/tools/wallets/ledger/setup) ### **For developers:** @@ -44,5 +44,5 @@ While gas on Celo can usually be paid in [many different currencies](/build/fee- In some cases, the MetaMask UI may display the Ethereum logo in places where it should display a CELO logo or no logo at all. -MetaMask is primarily used for interacting with the Ethereum blockchain and does not natively support Celo compatibility. Alternatively, you may choose a Celo native wallet [here](/build/tools/wallets/metamask/setup). +MetaMask is primarily used for interacting with the Ethereum blockchain and does not natively support Celo compatibility. Alternatively, you may choose a Celo native wallet [here](/home/wallets). \ No newline at end of file From 680db4227ebac99def8e640e623a5a3067168385 Mon Sep 17 00:00:00 2001 From: Paul Lange Date: Fri, 2 Oct 2026 14:29:41 +0200 Subject: [PATCH 2/4] docs(metamask): address review on the MetaMask overview Link the Sepolia manual guide, give the wallets link a descriptive label, sentence-case the headings, add an audience line and Related section. --- build/tools/wallets/metamask/use.mdx | 37 +++++++++++++++++----------- 1 file changed, 23 insertions(+), 14 deletions(-) diff --git a/build/tools/wallets/metamask/use.mdx b/build/tools/wallets/metamask/use.mdx index fdde2c44c0..00f41aa19a 100644 --- a/build/tools/wallets/metamask/use.mdx +++ b/build/tools/wallets/metamask/use.mdx @@ -1,32 +1,35 @@ --- title: MetaMask and Celo -description: Overview of MetaMask and how you can get started with MetaMask on Celo. +description: Add Celo to MetaMask, import a Celo account by private key and understand why MetaMask pays gas in CELO --- - -Do not send ETH to your Celo address. Do not send CELO assets to your Ethereum address. Always make sure that you are connected to the correct network. - +This page is for people who hold CELO and want to use MetaMask on Celo, and for app developers whose users connect with MetaMask. [MetaMask](https://metamask.io/) is a crypto wallet that can be used in a web browser and on mobile devices to interact with the Ethereum blockchain. Many apps in the space integrate with MetaMask, and we're excited to bring its functionality to the Celo ecosystem. Since Celo network's [Donut Hardfork](https://github.com/celo-org/celo-proposals/blob/master/CIPs/cip-0027.md), activated on Mainnet on May 19th, 2021, the protocol now supports [Ethereum-compatible transactions](https://github.com/celo-org/celo-proposals/blob/master/CIPs/cip-0035.md). This means that users may use MetaMask to interact with the Celo blockchain and app developers can more easily port Ethereum apps to the Celo blockchain. -## **How to use MetaMask with Celo** + +Do not send ETH to your Celo address. Do not send CELO assets to your Ethereum address. Always make sure that you are connected to the correct network. + + +## How to use MetaMask with Celo -### **For end users:** +### For end users -- [Add Celo Mainnet or Celo Sepolia to MetaMask](/build-on-celo/network-overview) +- Add Celo Mainnet or Celo Sepolia to MetaMask with one click ([network information](/build-on-celo/network-overview)) +- [Add Celo Sepolia manually](/build/tools/wallets/metamask/add-celo-testnet-to-metamask) - [Setup a Ledger to Work with MetaMask to Work With Celo](/build/tools/wallets/ledger/setup) -### **For developers:** +### For developers - [Set up MetaMask to work with your app](/build/tools/wallets/metamask/setup) -## **Things to Keep in Mind** +## Things to keep in mind MetaMask does not natively support Celo compatibility and some features won’t work perfectly. Here are some things to be aware of when using MetaMask with Celo. -## **Private Key Import** +## Private key import Celo and Ethereum use different derivation paths for generating seed phrases. Because MetaMask does not let you specify a derivation path to use: @@ -35,14 +38,20 @@ Celo and Ethereum use different derivation paths for generating seed phrases. Be - See this guide if you would like to [Import a Valora Account to MetaMask with a Private Key](/build/tools/wallets/metamask/import) - See these guides if you accidentally sent ETH to CELO addresses or CELO to ETH addresses. -## **Gas Fees Require CELO** +## Gas fees require CELO While gas on Celo can usually be paid in [many different currencies](/build/fee-abstraction/overview), when using MetaMask, gas fees will automatically be paid in CELO. This is because MetaMask will be using the [Ethereum-compatible Celo transaction format](https://github.com/celo-org/celo-proposals/blob/master/CIPs/cip-0035.md), which doesn't include the `feeCurrency` field. -## **Incorrect Logo** +## Incorrect logo In some cases, the MetaMask UI may display the Ethereum logo in places where it should display a CELO logo or no logo at all. -MetaMask is primarily used for interacting with the Ethereum blockchain and does not natively support Celo compatibility. Alternatively, you may choose a Celo native wallet [here](/home/wallets). - \ No newline at end of file +MetaMask is primarily used for interacting with the Ethereum blockchain and does not natively support Celo compatibility. Alternatively, you may choose one of [the native wallets on Wallets for users](/home/wallets#celo-native-wallets). + + +## Related + +- [Programmatic Setup](/build/tools/wallets/metamask/setup) - add Celo to MetaMask from your app with `wallet_addEthereumChain` +- [Wallets for users](/home/wallets) - Celo native wallets and the other wallets that work with Celo +- [Network information](/build-on-celo/network-overview) - chain IDs, RPC URLs and the add-network buttons for Celo Mainnet and Celo Sepolia \ No newline at end of file From a0c8cd8d10507cf93c8e33ae2155634161ff8fb7 Mon Sep 17 00:00:00 2001 From: Paul Lange Date: Fri, 2 Oct 2026 14:45:31 +0200 Subject: [PATCH 3/4] docs(metamask): drop promotional and dated wording and a pointer to guides that don't exist --- build/tools/wallets/metamask/use.mdx | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/build/tools/wallets/metamask/use.mdx b/build/tools/wallets/metamask/use.mdx index 00f41aa19a..d2ded9b8a3 100644 --- a/build/tools/wallets/metamask/use.mdx +++ b/build/tools/wallets/metamask/use.mdx @@ -5,9 +5,9 @@ description: Add Celo to MetaMask, import a Celo account by private key and unde This page is for people who hold CELO and want to use MetaMask on Celo, and for app developers whose users connect with MetaMask. -[MetaMask](https://metamask.io/) is a crypto wallet that can be used in a web browser and on mobile devices to interact with the Ethereum blockchain. Many apps in the space integrate with MetaMask, and we're excited to bring its functionality to the Celo ecosystem. +[MetaMask](https://metamask.io/) is a crypto wallet that can be used in a web browser and on mobile devices to interact with the Ethereum blockchain. Many apps integrate with MetaMask. -Since Celo network's [Donut Hardfork](https://github.com/celo-org/celo-proposals/blob/master/CIPs/cip-0027.md), activated on Mainnet on May 19th, 2021, the protocol now supports [Ethereum-compatible transactions](https://github.com/celo-org/celo-proposals/blob/master/CIPs/cip-0035.md). This means that users may use MetaMask to interact with the Celo blockchain and app developers can more easily port Ethereum apps to the Celo blockchain. +Celo supports [Ethereum-compatible transactions](https://github.com/celo-org/celo-proposals/blob/master/CIPs/cip-0035.md), added in the [Donut hard fork](https://github.com/celo-org/celo-proposals/blob/master/CIPs/cip-0027.md) in May 2021. Users can use MetaMask on Celo, and app developers can port Ethereum apps to Celo. Do not send ETH to your Celo address. Do not send CELO assets to your Ethereum address. Always make sure that you are connected to the correct network. @@ -36,7 +36,6 @@ Celo and Ethereum use different derivation paths for generating seed phrases. Be - You can't import an existing Celo account into the MetaMask wallet using its seed phrase, as you'd get the Ethereum version of it. Instead, you have to import it using the associated private key. - If you want to import the Celo account you made on MetaMask to a different Celo wallet (e.g. [Valora](https://valoraapp.com/) you'd have to import it using the private key itself, NOT the seed phrase that MetaMask gives you. - See this guide if you would like to [Import a Valora Account to MetaMask with a Private Key](/build/tools/wallets/metamask/import) -- See these guides if you accidentally sent ETH to CELO addresses or CELO to ETH addresses. ## Gas fees require CELO From 392a8353cd644d575500c06467fe0b491bea3ef5 Mon Sep 17 00:00:00 2001 From: Paul Lange Date: Tue, 6 Oct 2026 14:29:15 +0200 Subject: [PATCH 4/4] docs(metamask): link the moved learn/ pages and fix two text defects The network overview and wallets pages moved under learn/, so link the final paths instead of redirects. Close the Valora parenthesis and sentence-case the Ledger bullet. --- build/tools/wallets/metamask/use.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/build/tools/wallets/metamask/use.mdx b/build/tools/wallets/metamask/use.mdx index d2ded9b8a3..ab8883b6d7 100644 --- a/build/tools/wallets/metamask/use.mdx +++ b/build/tools/wallets/metamask/use.mdx @@ -17,9 +17,9 @@ Do not send ETH to your Celo address. Do not send CELO assets to your Ethereum a ### For end users -- Add Celo Mainnet or Celo Sepolia to MetaMask with one click ([network information](/build-on-celo/network-overview)) +- Add Celo Mainnet or Celo Sepolia to MetaMask with one click ([network information](/learn/network/overview)) - [Add Celo Sepolia manually](/build/tools/wallets/metamask/add-celo-testnet-to-metamask) -- [Setup a Ledger to Work with MetaMask to Work With Celo](/build/tools/wallets/ledger/setup) +- [Set up a Ledger to use with MetaMask on Celo](/build/tools/wallets/ledger/setup) ### For developers @@ -34,7 +34,7 @@ MetaMask does not natively support Celo compatibility and some features won’t Celo and Ethereum use different derivation paths for generating seed phrases. Because MetaMask does not let you specify a derivation path to use: - You can't import an existing Celo account into the MetaMask wallet using its seed phrase, as you'd get the Ethereum version of it. Instead, you have to import it using the associated private key. -- If you want to import the Celo account you made on MetaMask to a different Celo wallet (e.g. [Valora](https://valoraapp.com/) you'd have to import it using the private key itself, NOT the seed phrase that MetaMask gives you. +- If you want to import the Celo account you made on MetaMask to a different Celo wallet (e.g. [Valora](https://valoraapp.com/)), you'd have to import it using the private key itself, NOT the seed phrase that MetaMask gives you. - See this guide if you would like to [Import a Valora Account to MetaMask with a Private Key](/build/tools/wallets/metamask/import) ## Gas fees require CELO @@ -46,11 +46,11 @@ While gas on Celo can usually be paid in [many different currencies](/build/fee- In some cases, the MetaMask UI may display the Ethereum logo in places where it should display a CELO logo or no logo at all. -MetaMask is primarily used for interacting with the Ethereum blockchain and does not natively support Celo compatibility. Alternatively, you may choose one of [the native wallets on Wallets for users](/home/wallets#celo-native-wallets). +MetaMask is primarily used for interacting with the Ethereum blockchain and does not natively support Celo compatibility. Alternatively, you may choose one of [the native wallets on Wallets for users](/learn/wallets#celo-native-wallets). ## Related - [Programmatic Setup](/build/tools/wallets/metamask/setup) - add Celo to MetaMask from your app with `wallet_addEthereumChain` -- [Wallets for users](/home/wallets) - Celo native wallets and the other wallets that work with Celo -- [Network information](/build-on-celo/network-overview) - chain IDs, RPC URLs and the add-network buttons for Celo Mainnet and Celo Sepolia \ No newline at end of file +- [Wallets for users](/learn/wallets) - Celo native wallets and the other wallets that work with Celo +- [Network information](/learn/network/overview) - chain IDs, RPC URLs and the add-network buttons for Celo Mainnet and Celo Sepolia \ No newline at end of file