Upgrade from Web3Modal to Reown AppKit on Unity

This document outlines the steps to migrate from the old com.walletconnect packages to the new com.reown package in your Unity project.

Step 1. Replace the corresponding dependency in your manifest.json#

{  "dependencies": {    // Remove the following code lines    "com.walletconnect.web3modal": "1.0.0",    // Add the following code lines    "com.reown.appkit": "0.4.2"  },  "scopedRegistries": [    {      "name": "package.openupm.com",      "url": "https://package.openupm.com",      "scopes": [        // Remove the following code lines        "com.walletconnect",        // Add the following code lines        "com.reown"      ]    }  ]}

Alternatively, you can use the OpenUPM CLI:

# Remove the old packageopenupm remove com.walletconnect.web3modal# Add the new packageopenupm add com.reown.appkit

If the com.walletconnect.web3modal package was installed manually via the Package Manager window or directly from the GitHub repository, remove all com.walletconnect packages and replace them with the com.reown packages. You can find the list of all necessary packages in the Installation Documentation under Package Manager with OpenUPM tab.

Step 2. Update your AppKit config#

The com.walletconnect.web3modal package used two configuration objects: WalletConnectProjectConfig scriptable object and optional Web3ModalConfig class.

The Reown AppKit combines these two configurations into a single AppKitConfig class that can be passed into AppKit initialization method.

1. Delete WalletConnectProjectConfig scriptable object
2. Initialize AppKit from your script

private async void Start(){    await AppKit.InitializeAsync(        new AppKitConfig(            projectId: "Your Project ID from WalletConnectProjectConfig",            new Metadata(                name: "My Game",                description: "Example description",                url: "https://example.com",                iconUrl: "Your icon URL"            )        )    );}

Step 3. Update references to the namespaces#

The modern IDE such as Rider or Visual Studio should be able to automatically update the namespaces for you. If not, you can manually update the namespaces as follows:

Note that some objects from WalletConnectUnity.Core were moved into Reown.AppKit.Unity namespace, therefore we recommend to rely on the IDE to automatically update the namespaces.

Step 4. Update references to the classes#

Change Web3Modal to AppKit in your codebase. For example:

// Remove the following code lineWeb3Modal.Open();// Add the following code lineAppKit.Open();// Remove the following code lineawait Web3Modal.Evm.SendTransactionAsync(address, value);// Add the following code lineawait AppKit.Evm.SendTransactionAsync(address, value);

Step 5. Rename USS variables#

If you customized any AppKit USS variables, simply change --wui part of the variable name to --ro. For example:

// Remove the following code line--wui-color-accent-100: rgb(156, 81, 65);// Add the following code line--ro-color-accent-100: rgb(156, 81, 65);

Final notes#

• Ensure that you have updated all relevant configurations and imports in your project to reflect the changes from Web3Modal to AppKit.
• Test your application thoroughly to ensure that the migration has been successful and that all functionality is working as expected.