FAQ & Troubleshooting
General
- Is Cat Wallet on mainnet?
Nope, supporting Ritual Testnet only (chain ID 1979) for now. See the Roadmap for mainnet plans.
- Does Cat Wallet ever have custody of my funds or private key?
No, Every transaction is signed by your own wallet (embedded or external), Cat Wallet never holds keys or funds. See Security.
- I don't have any testnet tokens – How do I get some?
Use the in-app Faucet link on the Swap page or you can claim directly from a token contract's claim() function. Faucet claims are rate-limited to one per address per 6 hours per token.
Connection issues
- "Wrong network" banner won't go away.
Your wallet is connected but not switched to Ritual Testnet (chain ID 1979). Click "Switch network" in the banner or switch manually in your wallet if the prompt doesn't appear.
Transactions
- My transaction failed with "transaction type not supported."
Some external wallets try to submit a fee-type Ritual Testnet's RPC doesn't accept. where, Cat Wallet explicitly overrides this on every transaction it sends – if you still see this error, it usually means a transaction was submitted outside Cat Wallet's own flow (directly through the wallet's UI, for example).
- I got an RPC error mentioning "could not coalesce."
This is a transient issue with Ritual's public RPC batching multiple requests together. Cat Wallet's read provider is configured to avoid this (batchMaxCount: 1); if you still see it, it's usually a temporary RPC hiccup – retry.
- Swap says "Price moved" and won't go through.
The pool's price shifted between when you saw the quote and when the transaction confirmed. Try again – the new quote will reflect the current price or increase your slippage tolerance if the pool is thin and moves quickly.
- "Very high price impact" warning.
You're trying to trade a large amount relative to the pool's liquidity, which will get you a much worse rate than the quoted spot price. This is a real warning, not a bug – try a smaller amounting or explicitly acknowledge the warning if you understand the tradeoff.
Staking
- Why did my unstake happen instantly instead of going through a cooldown?
The current unstake cooldown is set to 0 on testnet, so requestUnstake completes and returns your funds in the same transaction. This is expected – the UI reflects it as an immediate withdrawal rather than a pending cooldown.
- Claiming rewards fails with "pool empty."
The staking contract's reward pool (funded separately from staked principal) doesn't have enough balance to pay out. Use the in-app "Fund pool" button, or wait for it to be topped up – this is a liquidity/funding issue, not a bug in your stake.
Chat
- My messages disappeared / chat history is gone.
This was a real, now-fixed bug: chat messages used to be held only in server memory, which could reset between requests on serverless hosting. Messages are now persisted in Redis and should not disappear. If you're still missing history, it may predate that fix.
- A message I sent shows up as garbled text for the recipient (or vice versa).
Chat is end-to-end encrypted and a message is unreadable to anyone without the right private key. If you see literal encrypted-looking text, it usually means the app's decryption and step didn't run (e.g. an unsupported/very old client). Refreshing usually resolves it.
- Can the Cat Wallet team read my messages? Nope, see Security → Encrypted messaging. The relay server only ever stores ciphertext for text messages. Image and voice attachments are the exception: they're stored on public IPFS, unencrypted.