# WalletConnect v1 to v2 migration

**URL:** <https://forum.celo.org/t/walletconnect-v1-to-v2-migration/5184>\
**Category:** Developers\
**Created:** [February 14, 2023, 5:36pm UTC](https://forum.celo.org/t/walletconnect-v1-to-v2-migration/5184 "2023-02-14T17:36:19Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![arthurgousset](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.celo.org/arthurgousset/32/11117_2.png) [@arthurgousset](https://forum.celo.org/u/arthurgousset)\
**Post date:** [February 14, 2023, 5:36pm UTC](https://forum.celo.org/t/walletconnect-v1-to-v2-migration/5184/1 "2023-02-14T17:36:19Z")

</div>

## Context 🛠

If you are a wallet or dapp developer, you will undoubtedly have heard of [WalletConnect](https://walletconnect.com/).

Last year, the WalletConnect team:

- released [WalletConnect v2 in production](https://medium.com/walletconnect/walletconnect-sign-v2-0-the-final-release-is-here-864b21e8d1ca),
- announced the [sunsetting of WalletConnect v1](https://medium.com/walletconnect/walletconnect-v1-0-sunset-notice-and-migration-schedule-8af9d3720d2e), and
- shared a [plan to migrate from v1 → v2](https://docs.walletconnect.com/2.0/advanced/migrating-from-v1.0).

> **[Page Not Found](https://docs.reown.com/2.0/advanced/migrating-from-v1.0)**

## TLDR 💡

✨ _Edit: new timeline, see [update](https://forum.celo.org/t/walletconnect-v1-to-v2-migration/5184/2) below_

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

 ![image](https://us1.discourse-cdn.com/flex020/uploads/celo/original/2X/7/7acae43d666a375896d81257b31a38e7b30899ad.png)  
_Source: [https://medium.com/walletconnect/walletconnect-v1-0-sunset-notice-and-migration-schedule-8af9d3720d2e](https://medium.com/walletconnect/walletconnect-v1-0-sunset-notice-and-migration-schedule-8af9d3720d2e)_

## Next Steps 💬

If you haven’t upgraded to WalletConnectv2, please refer to the [official WalletConnect migration documentation](https://docs.walletconnect.com/2.0/advanced/migrating-from-v1.0) for instructions.

If you have trouble upgrading to WalletConnect v2, please refer to the WalletConnect [Github Discussion](https://github.com/orgs/WalletConnect/discussions).

👉 **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](mailto:devrel@celo.org).

---

<div class="post-metadata">

**Author:** ![arthurgousset](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.celo.org/arthurgousset/32/11117_2.png) [@arthurgousset](https://forum.celo.org/u/arthurgousset)\
**Post date:** [February 17, 2023, 2:01pm UTC](https://forum.celo.org/t/walletconnect-v1-to-v2-migration/5184/2 "2023-02-17T14:01:57Z")

</div>

# New Extended Timeline

👉 _The WalletConnect team has changed the migration timeline._

## 📆 TLDR

The new timeline is:

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

🎩 h/t @ericnakagawa (thanks for sharing!)

## 💬 Learn more

WallectConnect **[post](https://medium.com/walletconnect/weve-reset-the-clock-on-the-walletconnect-v1-0-shutdown-now-scheduled-for-june-28-2023-ead2d953b595)**:

[https://medium.com/walletconnect/weve-reset-the-clock-on-the-walletconnect-v1-0-shutdown-now-scheduled-for-june-28-2023-ead2d953b595](https://medium.com/walletconnect/weve-reset-the-clock-on-the-walletconnect-v1-0-shutdown-now-scheduled-for-june-28-2023-ead2d953b595)

WalletConnect **[tweet](https://twitter.com/pedrouid/status/1626299015728885762)**:

[![image](https://us1.discourse-cdn.com/flex020/uploads/celo/original/2X/1/170cceae554bd47f1771e07a5ff396d8989594d3.png)](https://twitter.com/pedrouid/status/1626299015728885762)

---

<div class="post-metadata">

**Author:** ![arthurgousset](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.celo.org/arthurgousset/32/11117_2.png) [@arthurgousset](https://forum.celo.org/u/arthurgousset)\
**Post date:** [June 20, 2023, 5:09pm UTC](https://forum.celo.org/t/walletconnect-v1-to-v2-migration/5184/3 "2023-06-20T17:09:18Z")

</div>

# ⏰ 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`](https://www.npmjs.com/package/@rainbow-me/rainbowkit)

TLDR: 👉 **You must be on \>v0.12._x_.**

- [NPM releases](https://www.npmjs.com/package/@rainbow-me/rainbowkit?activeTab=versions)
- [Github release notes](https://github.com/rainbow-me/rainbowkit/releases)

From the [Rainbowkit migration guide](https://www.rainbowkit.com/docs/migration-guide#012x-breaking-changes):

> 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](https://cloud.walletconnect.com/) `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](https://www.rainbowkit.com/docs/migration-guide#012x-breaking-changes) to migrate.

### Dapp developers using [`react-celo`](https://www.npmjs.com/package/@celo/react-celo)

TLDR: 👉 **You must be on \>v5.0.4**

- [NPM release v5.0.4](https://www.npmjs.com/package/@celo/react-celo/v/5.0.4)
- [Github release notes v5.0.4](https://github.com/celo-org/react-celo/releases/tag/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](mailto:devrel@celo.org).
