Skip to main content

Web3Wallet Integration Checklist

To ensure a smooth integration process, we perform internal testing of the WalletConnect experience. You can find more information about the WalletConnect v2 experience here.

Below, you'll find different tests that wallets want to perform to ensure a consistent experience across all platforms. For testing in-production dapps, we have included staging links here.

Please note that the links to SDK versions and sample wallets can be found in the respective sections below.

WalletConnect v2 🪄

Please use the latest Web3Wallet SDK version which can be found here ⬇️

🌐 Web

🤖 Android

🍏 iOS

Sample wallets:

🌐 Web GitHub Repo

🤖 Android GitHub Repo

🍏 iOS GitHub Repo

🔗 Chain Switching​

Chain Switching enables users to experience a seamless chain agnostic UX. In WalletConnect's v2 functionality, the wallet can switch the active chain by triggering a chainChanged event.

Android 🤖​

📕 Kotlin docs → https://docs.walletconnect.com/web3wallet/wallet-usage?platform=android#namespace-builder

📱Example app → Link

iOS 🍏​

📕 Swift docs → https://docs.walletconnect.com/web3wallet/wallet-usage?platform=ios#namespace-builder

📱Example app → Link

🔄 Automatic Redirect​

Automatic Redirect assesses the user flow after the wallet signs and authorizes an account. The test involves verifying the wallet's ability to redirect to the dapp after a user signs or sends a transaction. Use this Test Dapp to evaluate.

Android 🤖​

📕 Kotlin docs → https://docs.walletconnect.com/web3wallet/mobileLinking?platform=android

iOS 🍏​

📕 Swift docs → https://docs.walletconnect.com/web3wallet/mobileLinking?platform=ios

📱Example app → Link

📱Example app → Link

📢 Sign Notifications​

Sign Notifications ensure users receive a push notification for any pending dapp request, even when their wallet isn't open. To test this functionality, follow this link.

Android 🤖​

📕 Kotlin docs → https://docs.walletconnect.com/web3wallet/wallet-usage?platform=android#extra-platform-specificn

📱Example app → Link

iOS 🍏​

📕 Swift docs → https://docs.walletconnect.com/apiweb3wallet/notify/usage?platform=ios

📱Example app → Link

Account Switching:​

Account Switching is about the user's ability to change accounts and sign a message from a different account than the one proposed initially in the session. The wallet can switch the active account by triggering a accountsChanged event.

📕 JS docs: https://docs.walletconnect.com/web3wallet/wallet-usage?platform=web#updating-a-session

📕 Kotlin docs: https://docs.walletconnect.com/web3wallet/wallet-usage?platform=android#updating-a-session

📕 Swift docs: https://docs.walletconnect.com/web3wallet/wallet-usage?platform=ios#updating-a-session

Production Dapps​

These dapps have provided us staging links so that wallets can test functionality.