WalletConnect v1 to v2 migration

Developers
1

Context :hammer_and_wrench:

If you are a wallet or dapp developer, you will undoubtedly have heard of WalletConnect.

Last year, the WalletConnect team:

TLDR :bulb:

:sparkles: Edit: new timeline, see update below

  • Wallet migration deadline: Fri, Dec 16 2022
  • Dapp migration deadline: now Tue, Jun 27 2023 (:sparkles:), previously Tue, Feb 28 2023
  • WalletConnect v1 shutdown: now Wed, Jun 28 2023 (:sparkles:), previously Wed, Mar 1 2023

image
image720×332 24.7 KB

Source: WalletConnect v1.0 Sunset Notice and Migration Schedule | by Pedro Gomes | WalletConnect | Medium

Next Steps :speech_balloon:

If you haven’t upgraded to WalletConnectv2, please refer to the official WalletConnect migration documentation for instructions.

If you have trouble upgrading to WalletConnect v2, please refer to the WalletConnect Github Discussion.

:point_right: Feel free to comment if you have successfully upgraded to WalletConnect v2

If you think you ran into a Celo specific issue in the migration, please comment on this forum post or share a message in #wallets-development on Discord. If you have a particularly sensitive issue please reach out to devrel@celo.org.

2 Likes
2

New Extended Timeline

:point_right: The WalletConnect team has changed the migration timeline.

:calendar: TLDR

The new timeline is:

  • Wallet migration deadline: Fri, Dec 16 2022 (unchanged)
  • Dapp migration deadline: now Tue, Jun 27 2023 (:sparkles:), previously Tue, Feb 28 2023
  • WalletConnect v1 shutdown: now Wed, Jun 28 2023 (:sparkles:), previously Wed, Mar 1 2023

:tophat: h/t @ericnakagawa (thanks for sharing!)

:speech_balloon: Learn more

WallectConnect post:

WalletConnect tweet:

image

3

:alarm_clock: Reminder (8 days to go)

On June 28, 2023, WalletConnect v1 bridge servers will be shutdown:

  • If you are a dapp developer, WalletConnect v1 bridge servers are shutdown, and you don’t upgrade your dapp to WalletConnect v2, users will not be able to connect to your dapp from 3rd party wallets via WalletConnect.
  • If you are a wallet developer, WalletConnect v1 bridge servers are shutdown, and you don’t support WalletConnect v2, users will not be able to connect to 3rd party dapps from your wallet via WalletConnect.

Dapp developers using rainbowkit

TLDR: :point_right: You must be on >v0.12.x.

From the Rainbowkit migration guide:

RainbowKit has adopted the WalletConnectLegacyConnector connector in wagmi for continued WalletConnect v1 support.
Support for WalletConnect v2 and WalletConnectConnector will soon be available as a patch release, without breaking changes.

Wallets will be transitioned automatically in future releases.

Every dApp must now provide a WalletConnect Cloud projectId to enable WalletConnect v2. This must be completed before WalletConnect v1 bridge servers are shutdown on June 28, 2023. RainbowKit will quietly prefer v1 for all wallets if projectId is unspecified.
Follow the steps below to migrate.

Dapp developers using react-celo

TLDR: :point_right: You must be on >v5.0.4

Questions

If you think you ran into a Celo specific issue in the migration, please comment on this forum post. If you have a particularly sensitive issue please reach out to devrel@celo.org.