WCV2 Migration

Jorge

This document describes the steps needed to migrate thirdweb's packages before tomorrow's WalletConnect V1 shutdown at 2pm, UTC.

Released on 2023-06-27

• WalletConnectV1: We have officially deprecated the WalletConnectV1 class in this version. Going forward, WalletConnect will be our official implementation of WalletConnect v2. The WalletConnectV1 class will just be an alias for our WalletConnect class. Please, make sure you adjust the implementation if you are inheriting these classes
• Please, make sure to delete your cache and node_modules to make sure you're using the latest code.

Note: All our WalletConnect backed wallets are using a common WC projectId we defined. You don't need to create your own for testing but we encourage you to create your own and pass it to the wallets before launch. Example:

const metamaskWallet = new MetaMaskWallet({ projectId: 'wc-project-id' })

Read more in our WalletConnect V2 Documentation

• MetaMask: The MM implementation in this package now uses WalletConnect in the background. You shouldn't notice any API changes if you're using the MM wallet directly.
• Zerion: The Zerion implementation in this package now uses WalletConnect in the background. You shouldn't notice any API changes if you're using the Zerion wallet directly.

Read more in our Wallets Documentation

Released on 2023-06-27

• walletConnectV1: We have officially deprecated the walletConnectV1 wallet config. walletConnectV1 is now an alias of walletConnect, which is our implementation of WalletConnectV2. You can now pass the WC projectId as part of the config. Notice that this is an optional field but we recommend you create your own before releasing your app to productoin:

<ThirdwebProvider supportedWallets={[walletConnect({ projectId: 'wc-project-id })]}>

Read more in our WalletConnect React Documentation

The Rainbow, Trust, MetaMask and Zerion wallets implementations in this package are all extending the WalletConnect class. You can now pass to them the same config as the WalletConnect config described before.

Read more in our React Wallets Documentation

Released on 2023-06-27

The Rainbow, Trust and MetaMask wallets implementations in this package are all extending the WalletConnect class. You can now pass to them the same config as the WalletConnect config described before, e.g:

metamasWallet({ projectId: 'wc-project-id'})

Read more in our React Native Wallets Documentation

Released on 2023-06-27

• WalletProvider.WalletConnectV1 has been deprecated in favor of `WalletProvider.WalletConnect`

• New customizeable UI Prefab WalletProvider_WalletConnectV2 for native platforms.
• walletConnectProjectId optional field added to the ThirdwebManager

Please, make sure to copy the updated embeds from dashboard to get the latest code.

Please note that these updates involve important changes but are mandatory since WalletConnect is shutting down their V1 servers tomorrow at 2pm UTC. We recommend reading the relevant documentation and testing in a safe environment before updating your production systems. For any questions or concerns, feel free to reach out to our support team:

Discord

GitHub