Skip to content

docs(wallets): add end-user troubleshooting for common unanswered assistant questions #2349

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
GigaHierz wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(wallets): add end-user troubleshooting for common unanswered assistant questions #2349

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 32 additions & 1 deletion home/wallets.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Wallets
description: Overview of digital wallets available to send, spend, and earn Celo assets.
description: Choose a wallet to hold CELO and stablecoins on Celo, connect MetaMask, find your address and move funds in or out
---

<Info>
Expand Down Expand Up @@ -175,3 +175,34 @@ Zerion Wallet is a non-custodial wallet for crypto that gives you access to a br

- [Homepage](https://www.mtpelerin.com/bridge-wallet)
- Platforms: iOS, Android

## Troubleshooting

### Connect MetaMask to Celo

MetaMask does not show Celo until the network is added. Follow [Configure MetaMask for Celo](/tooling/wallets/metamask/setup); the chain ID and RPC URL are on the [network overview](/build-on-celo/network-overview). If an app asks you to install MetaMask when you already have it, the app could not detect the extension in that browser. Open the app in the browser profile where MetaMask is installed, or connect with another wallet from the lists above.

@palango palango Oct 1, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/tooling/wallets/metamask/setup is the developer page ("Programmatic Setup", a wallet_addEthereumChain JS snippet). An end user is better served by the one-click AddNetworkButton on /build-on-celo/network-overview, or you could embed it here as home/celo.mdx does (import { AddNetworkButton } from '/snippets/AddNetworkButton.jsx'). The mislabel came from tooling/wallets/metamask/use.mdx, which lists the same page under "For end users". That one is a separate fix.


### Find your Celo address

Celo uses Ethereum-style addresses (`0x…`, 42 characters). Open your wallet and copy the address it shows for Celo. Check the network name before you send: a transfer on the wrong network can be lost.

### You cannot sign in or recover a wallet

Celo has no accounts or passwords. A wallet is controlled by the wallet app that created it, so recovery goes through that wallet's app or support, not through Celo.

@palango palango Oct 1, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is wrong for every wallet on this page, and the wording is risky. They are all non-custodial: whoever holds the recovery phrase or private key controls the wallet, not the app. If the phrase is lost, the wallet's support team can't recover the funds either. Telling stuck users to "contact support" is how the fake-support scam usually starts.

Suggested direction:

Celo has no usernames or passwords. A wallet is controlled by its recovery phrase (seed phrase) or private key. To restore a wallet, import the recovery phrase into a wallet app. Without it, no one can recover the funds: not Celo, and not the wallet's maker. Never share your recovery phrase with anyone, including people who say they are support.

("No accounts" is also loose, since an address is an account, so I'd say "usernames or passwords" instead.)


### A token does not appear in your wallet

Check that the wallet is on the Celo network, then add the token by its contract address. Stablecoin addresses are listed in [stablecoin contracts](/tooling/contracts/stablecoin-contracts). Tokens sent on another network do not show up on Celo.

@palango palango Oct 1, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The stablecoin contracts table puts mainnet and Celo Sepolia addresses side by side, so a reader can easily copy the testnet one. Worth adding "use the Celo Mainnet column".


### Move funds in or out

- [Ramps](/home/ramps): convert between local currency and crypto with a provider.
- [Exchanges](/home/exchanges): buy or sell CELO.
- [Bridges](/home/bridged-tokens/bridges): move assets between Celo and other networks.

Which providers work in your country depends on the provider. Check availability and fees with the provider before you send funds.

## Related

- [Fee abstraction](/build-on-celo/fee-abstraction/overview): pay gas in stablecoins, and which wallets support it
- [Self-custody](/home/manage/self-custody): keep control of your own funds

@palango palango Oct 1, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/home/manage/self-custody doesn't match this description. It is a Celo CLI + Ledger guide for ReleaseGold beneficiaries who gave their address to cLabs. It doesn't explain how to keep control of your own funds. I'd drop this bullet.

Loading