Skip to content

$CHEQ Keplr Migration Guide

cheqd - Keplr Config Migration Guide

cheqd Keplr Config Migration Guide

Use this guide to remove old, stale, or untrusted cheqd Keplr chain settings and migrate to the official cheqd Keplr config page.

Mobile: Add cheqd Mainnet in Keplr Wallet App (iOS and Android)

Use this section for Keplr Mobile only. Keplr Mobile does not use the desktop experimentalSuggestChain popup flow described later in this guide. On mobile, enable cheqd only through the official Keplr Wallet app and only if Cheqd / cheqd-mainnet-1 appears inside Keplr Mobile’s own chain list.

This mobile section covers cheqd mainnet only. Do not use it for cheqd-testnet-6.

 

iOS

  1. Install or update Keplr – Crypto Wallet from the Apple App Store.
  2. Open the Keplr Wallet app and unlock your wallet.
  3. If needed, restore the same wallet account you use on desktop, but only inside the official Keplr app. Never enter your seed phrase into a website, config page, QR-code flow, support chat, or direct message.
  4. From the wallet home / portfolio screen, open the chain management or chain search area. Depending on the app version, this may be labelled Manage Chains, Chain Visibility, Add Chains, or available through search.
  5. Search for Cheqd, CHEQ, or cheqd-mainnet-1.
  6. Select Cheqd. Confirm that the chain ID shown is cheqd-mainnet-1.
  7. Enable or add the chain in Keplr Mobile.
  8. Confirm that the wallet address for cheqd starts with cheqd1 before receiving funds or signing transactions.

 

Android

  1. Install or update Keplr – Crypto Wallet from Google Play.
  2. Open the Keplr Wallet app and unlock your wallet.
  3. If needed, restore the same wallet account you use on desktop, but only inside the official Keplr app. Never enter your seed phrase into a website, config page, QR-code flow, support chat, or direct message.
  4. From the wallet home / portfolio screen, open the chain management or chain search area. Depending on the app version, this may be labelled Manage Chains, Chain Visibility, Add Chains, or available through search.
  5. Search for Cheqd, CHEQ, or cheqd-mainnet-1.
  6. Select Cheqd. Confirm that the chain ID shown is cheqd-mainnet-1.
  7. Enable or add the chain in Keplr Mobile.
  8. Confirm that the wallet address for cheqd starts with cheqd1 before receiving funds or signing transactions.

 

If cheqd Does Not Appear in Keplr Mobile

Stop and use the desktop browser extension migration flow below. Do not use unofficial mobile workarounds.

The desktop experimentalSuggestChain / Suggest in Keplr flow is for the Keplr browser extension. Keplr Mobile should be treated as a native / registry-supported flow only: if Cheqd / cheqd-mainnet-1 is not available inside the official mobile app, there is no equivalent official mobile suggest-chain workaround in this guide.

Use Only the Official Source

The only trusted source for cheqd Keplr configuration is:

https://keplr-config.cheqd.io

Treat every other cheqd Keplr config page, mirror, JSON snippet, QR code, social post, Discord DM, GitHub gist, or third-party “helper” site as fake or impersonating. Do not use it.

This matters because Keplr’s suggest-chain feature is permissionless. Other people can publish chain config prompts, but that does not make them official cheqd configuration.

Never enter your seed phrase, private key, mnemonic, or recovery phrase into any cheqd config page. The official cheqd config page only asks Keplr to suggest or enable a chain. It does not need wallet secrets.

Before You Start on Desktop

  • Use the Keplr browser extension on desktop.
  • Update Keplr to the latest version available in your browser extension store.
  • Unlock Keplr before starting.
  • Manually type https://keplr-config.cheqd.io into the browser address bar or use a bookmark you created yourself.
  • Do not follow search ads, shortened links, QR codes, or direct messages.

Desktop Browser Extension Migration Steps

1. Remove Existing cheqd Custom Chains

Before adding the official config, remove any existing cheqd custom chain entries from Keplr.

  1. Open the Keplr browser extension.
  2. Open the menu, then go to Settings.
  3. Open the chain management area, usually labelled Add/Remove Chains or Manage Chains.
  4. Search for cheqd, CHEQ, cheqd-mainnet-1, and cheqd-testnet-6.
  5. Use Remove Custom Chains, the remove button, or the trash action for any existing cheqd custom or beta entries.
  6. Confirm the removal in Keplr.
  7. Close and reopen the Keplr extension.

Do not skip this step. Removing old custom entries prevents Keplr from keeping stale RPC, REST, gas, staking, or metadata values from an older or untrusted config.

 

2. Open the Official cheqd Config Page

Go to:

https://keplr-config.cheqd.io

Check the address carefully before clicking anything:

  1. It must use https://.
  2. The hostname must be exactly keplr-config.cheqd.io.
  3. Any other domain is not trusted for cheqd Keplr config.

 

3. Suggest the Official Chain Config

On the official page:

  1. Choose the network you want to add.
  2. Use cheqd-mainnet-1 for mainnet.
  3. Use cheqd-testnet-6 for testnet.
  4. Click Suggest in Keplr.
  5. Review the Keplr popup.
  6. Approve only if the chain ID and source page match the official cheqd config page.

If Keplr does not open a popup, return to Step 1 and confirm that old cheqd custom chains were removed. Then reload https://keplr-config.cheqd.io and try again.

 

4. Enable the Chain

After approving the suggested config:

  1. Click Enable on the same official page if Keplr does not enable the chain automatically.
  2. Approve the Keplr permission request.
  3. Confirm that cheqd appears in Keplr with the expected cheqd address prefix.

 

5. Verify Before Using Funds

Before sending funds or signing transactions:

  1. Confirm you used only https://keplr-config.cheqd.io.
  2. Confirm the chain ID is cheqd-mainnet-1 for mainnet or cheqd-testnet-6 for testnet.
  3. Confirm the address prefix is cheqd.
  4. Confirm the token is CHEQ.
  5. Reject any popup that comes from another cheqd config page or asks for wallet secrets.

 

If Something Looks Wrong

Stop immediately if:

  1. The page URL is not exactly https://keplr-config.cheqd.io.
  2. Keplr shows an unexpected chain ID.
  3. A site asks for your seed phrase, private key, mnemonic, or recovery phrase.
  4. A link was sent through a direct message or points to a different domain.
  5. A config claims to be an alternative official cheqd Keplr config.

Those sources should be treated as fake or impersonating.

Report suspicious links through official cheqd support and do not approve their Keplr popups.

References

  1. Official cheqd Keplr config page: https://keplr-config.cheqd.io
  2. Keplr chain registry cheqd mainnet config: https://raw.githubusercontent.com/chainapsis/keplr-chain-registry/main/cosmos/cheqd-mainnet.json
  3. Keplr suggest-chain developer documentation: https://docs.keplr.app/api/guide/suggest-chain
  4. Keplr add non-native chains page: https://chains.keplr.app
  5. Keplr Mobile deeplink documentation: https://docs.keplr.app/api/mobile/deeplink
  6. Keplr Mobile WalletConnect documentation: https://docs.keplr.app/api/mobile/wallet-connect
  7. Keplr beginner guide security guidance: https://help.keplr.app/start

Share

Eduardo Hotta

Eduardo Hotta

Eduardo is a branding and demand generation expert, and has led successful marketing teams in several industries, including data analytics, cyber security, and marketing automation.

Related articles

join the community

Become a cheqmate

Join our community to learn more about what we’re building. Get the latest news and insights in our groups below.

Discover cheqd in your language

Select your language to view our content