Published in


How to Prepare for the WalletConnect v1.0 Shutdown

  • Wallet handles namespaces that have extra or unsupported chains, methods, events via giving feedback to the user or still approving them to handle requests for supported cases or showing user feedback later on when performing requests for unsupported ones.
  • Wallet handles disconnecting sessions correctly from both wallet and dapp side (also if this event occurs in the background i.e. user’s wallet is closed and they disconnect from dapp side. Wallet should cleanup and delete such sessions when it boots up by listening to appropriate events).
  • Wallet handles signing requests and sends responses correctly. After connection is established, there is a test “sign message” action in the laboratory.
  • Wallet sends the correct response when the user rejects connection. Not doing this results in web3modal not knowing when to refresh qr code / connection string for further connection attempts.
  • If you are using @walletconnect/ethereum-provider, simply change the version number to the latest available version.
  • If you are using @walletconnect/web3-provider, please change to @walletconnect/ethereum-provider and ensure that you are using the latest available version.
  • If you are using Web3Modal v1.0, switch to Web3Modal v2.0. We have installation guides for React, HTML, and standalone mode. If you would like to continue using Web3Modal v1.0, upgrade the @walletconnect/ethereum-provider to WalletConnect v2.0 and make sure you use the latest available version.
  • If you are using our redesigned Web3Modal, enable WalletConnect v2.0 by using the feature flag version: ‘2’ when injecting modal connectors. Check out the code snippet here.
  • If you are using @walletconnect/react-native-dapp, we currently don’t have an equivalent package for this but will publish a react-native version of Web3Modal in the coming months. In the meantime, you can list all the wallet mobile links from our Cloud Explorer API and integrate the latest available version of @walletconnect/ethereum-provider.



The communications protocol for web3, WalletConnect brings the ecosystem together by enabling hundreds of wallets and apps to securely connect and interact.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store