Troubleshooting WalletConnect

If you're experiencing issues connecting your wallet to Aster Mobile through WalletConnect, this guide covers the most common problems and their solutions. Most connection issues can be resolved by reconnecting your wallet.

Error: "Given link couldn't be opened"

Problem: You tap your wallet but receive an error message saying the link couldn't be opened.

Solution: Make sure you have the wallet app installed on your phone. WalletConnect uses app deep linking – if the compatible wallet app isn't installed, the connection will fail.

Fix:

1. Install the supported wallet app

2. Try connecting again

Wallet Opens but No Connection Prompt Appears

Problem: Your wallet app opens, but it doesn't show a prompt asking you to approve the connection.

Solution: This sometimes happens due to a temporary glitch with WalletConnect. Force-closing both apps and reconnecting usually resolves the issue.

Fix:

1. Force-close both Aster Mobile and your wallet app

2. Reopen Aster Mobile and try connecting again

Wallet Doesn't Open or Switch Back to Aster Mobile

Problem: The apps aren't automatically switching back and forth during the connection or signature process.

Solution: WalletConnect doesn't always automatically switch between apps, especially on certain devices. You may need to manually return to each app to complete the steps.

Fix:

Manually switch back to Aster Mobile or your wallet to complete the current step.

Wallet Accounts Not Switching

Problem: Changing your wallet account or network doesn't update in Aster Mobile.

Solution: WalletConnect sessions are tied to the specific account and network you originally approved. Changing either inside your wallet doesn't automatically update your Aster Mobile session.

Fix:

1. Disconnect your wallet from Aster Mobile

2. Reconnect using your desired account and network

Still Having Issues?

If none of these solutions work, reach out to the Aster community on Discord for additional support.