Troubleshooting & FAQ

Common issues and quick fixes for installing, unlocking, and using Keythings Wallet.

Extension issues

Extension icon missing

  • Open chrome://extensions and confirm Keythings Wallet is installed and enabled.
  • Pin the extension via the browser’s extension menu (puzzle icon).
  • Restart the browser if the icon still does not appear.

Blank or unresponsive popup

  • Update your browser to the latest stable version.
  • Temporarily disable other extensions that modify pages or block scripts.
  • Toggle Keythings Wallet off/on in chrome://extensions.

Unlock & recovery

Wrong password

  • Check Caps Lock / keyboard layout.
  • After repeated failures, the wallet intentionally slows additional attempts to resist brute-force attacks — wait for the delay to expire before trying again.

Lost password

  • If you still have your seed phrase, install a fresh copy of the extension and choose Restore Wallet.
  • If you have lost both password and seed phrase, funds controlled by that wallet cannot be recovered by the Keythings team.

Transactions

Transaction stuck as pending

  • Open the item in the Activity tab and follow the link to the Keeta explorer.
  • Confirm you are on the correct network (testnet vs mainnet).
  • Wait a few minutes and refresh; history is loaded in pages to keep the UI responsive.

Transaction failed

  • Verify your balance covers the transfer amount plus network fees.
  • Ensure the recipient address is correct for the selected network.
  • If using a dApp, review its documentation for additional requirements.

dApp connectivity

dApp cannot detect the wallet

  • Confirm the extension is installed and unlocked.
  • Reload the dApp after installing or updating Keythings Wallet.
  • In development, host the dApp on http://localhost:3000 or another allowed origin from the integration docs.

dApp says you are not connected

  • Open the wallet and check Connected Sites.
  • Reconnect the origin if it was previously removed.
  • Approve any new capability requests the dApp legitimately needs.

Security warnings

If the wallet shows a risk warning for a transaction or dApp:

  • Verify the dApp URL, smart contract, and documentation.
  • Reject the request if anything looks suspicious.

Need more help?

  • Check the main README and SECURITY policy in the open-source repository.
  • For suspected vulnerabilities, follow the process in the security policy instead of opening a public issue.
4 of 27