Skip to main content

Upgrade from Web3Wallet to Reown WalletKit for iOS

This upgrade guide helps developers transition from using the Web3Wallet library to the WalletKit within reown-swift. The guide involves updating import statements, modifying instance references, changing configuration methods, and updating repository URLs for CocoaPods and Swift Package Manager (SPM).

Step 1. Update the Repository URL​

The Web3Wallet library has been moved to a new repository under the reown-com organization. If you are using Swift Package Manager (SPM) to manage dependencies, update your Package.swift file to point to the new repository:

- .package(url: "https://github.com/WalletConnect/WalletConnectSwiftV2", from: "1.0.0"),
+ .package(url: "https://github.com/reown-com/reown-swift", from: "1.0.0"),

Step 2. Update Imports in Your Code​

All references to Web3Wallet in your import statements should be updated to use WalletKit.

- import Web3Wallet
+ import WalletKit

Step 3. Update Instance Access and Method Calls​

The singleton instance access for Web3Wallet has been replaced with WalletKit. Update all instances where Web3Wallet.instance is used to WalletKit.instance.

- Web3Wallet.instance.authRequestPublisher.sink { (id, result) in
-    // Your code here
- }
+ WalletKit.instance.authRequestPublisher.sink { (id, result) in
+     // Your code here
+ }

Step 4. Update Configuration Method​

The configure method has been updated to reflect the new branding. Replace calls to Web3Wallet.configure with WalletKit.configure.

- Web3Wallet.configure(
-   ...
- )
+ WalletKit.configure(
+   ...
+ )

Step 5. Update CocoaPods Podspec​

If you are using CocoaPods to manage dependencies, update your Podfile to use the new library name.

- pod 'Web3Wallet', '~> 1.0'
+ pod 'WalletKit', '~> 1.0'

Step 6. Test Your Changes​

After updating all references to Web3Wallet to use WalletKit, thoroughly test your application to ensure that all functionalities work as expected.