Skip to main content

Upgrade from Web3Wallet to WalletKit for Web

Upgrade to Reown WalletKit​

This document outlines the steps to migrate from the old @walletconnect/web3wallet package to the new @reown/walletkit packages in your project.

Step 1. Update your package.json​

Replace your existing @walletconnect/web3wallet dependency with @reown/walletkit:

"@walletconnect/web3wallet": "^x.y.z"
"@reown/walletkit": "^1.0.0"

Step 2. Install @reown/walletkit​

Run npm install (or your prefered package manager command) to install the new package.

Step 3. Update your imports​

Replace the imports in your project:

import { Web3Wallet } from "@walletconnect/web3wallet";
import { WalletKit } from "@reown/walletkit";

and your initialization to use the new package:

await Web3Wallet.init()
await WalletKit.init()

If you're using additional imports from @walletconnect/web3wallet, you can replace them with their corresponding version from @reown/walletkit such as:

import { IWeb3Wallet } from "@walletconnect/web3wallet";
import { IWalletKit } from "@reown/walletkit";

You're all set!​

Final Notes​

  • public API documentation can be found here
  • auth_request is deprecated in favor of session_authenticate. Docs can be found here