Skip to content

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

Open
GigaHierz wants to merge 1 commit into
mainfrom
GigaHierz/assistant-gap-fill
Open

GigaHierz wants to merge 1 commit into
mainfrom
GigaHierz/assistant-gap-fill

Conversation

@GigaHierz

Copy link
Copy Markdown
Contributor

Refs #2314, #2320, #2324, #2343

Each weekly assistant report lists readers' questions that returned no citation. The recurring in-scope ones were wallet and funds basics: connecting MetaMask, finding an address, signing in, tokens not showing, moving money in or out.

What changed

Deliberately not written (need an owner's input)

  • Country availability (e.g. "can I use it in Nigeria"): needs a statement from the wallet/ramp owners; the page only says availability depends on the provider.
  • Official partnership contact/form, and whether any rewards/points program exists.
  • Questions about a specific "relayer" or third-party tokens: ambiguous or not Celo docs.
  • Probe/injection and off-topic questions: no doc change.

Verification

$ mint broken-links
success no broken links found
$ bash scripts/check-orphans.sh
No orphan pages found.

🤖 Generated with Claude Code

…istant could not answer

Covers connecting MetaMask, finding your address, wallet recovery, missing
tokens and moving funds in or out, each linking an existing page.

Refs #2314, #2320, #2324, #2343

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@GigaHierz
GigaHierz requested review from a team as code owners October 1, 2026 13:29
@GigaHierz
GigaHierz requested review from palango and seolaoh and removed request for a team October 1, 2026 13:29

@palango palango left a comment

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.

Good scope: the questions picked are the ones readers keep asking, and leaving availability, partnerships and rewards out is the right call. All internal links resolve, and the description and section order follow AGENTS.md.

Two entries send readers to the wrong place, though, and I'd fix those before merge (inline comments). The recovery one matters most because of the scam risk. The other two inline comments are smaller.

One thing I couldn't check: whether current MetaMask builds already list Celo among their built-in networks. If they do, "MetaMask does not show Celo until the network is added" needs softening.

Comment thread home/wallets.mdx

### 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.

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.)

Comment thread home/wallets.mdx
## 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

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.

Comment thread home/wallets.mdx

### 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.

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.

Comment thread home/wallets.mdx

### 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.

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".

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants