Skip to main content
AppKit support for Wagmi 3.0 is in beta. Test your app thoroughly before shipping to production.
This guide walks through upgrading a React project that uses the Wagmi adapter from AppKit 1.x with Wagmi 2.x to the AppKit beta (2.0.0-wagmi-3.0) with Wagmi 3.x. It uses the React Wagmi example as the starting point and the upgraded React Wagmi example as the end result. Only package.json changes. The application code stays the same.

​
Before and after

package.json

​
Migration steps

1

Update the Reown packages

Set every @reown/* package in your project to 2.0.0-wagmi-3.0. All Reown packages must use the same version, including any additional adapters (for example @reown/appkit-adapter-solana or @reown/appkit-adapter-bitcoin).
package.json
2

Update Wagmi and viem to the latest version

Update wagmi to the latest 3.x release and viem to the latest 2.x release.
package.json
3

Add the @wagmi/connectors package

Wagmi 3.0 requires @wagmi/connectors as a direct dependency. Add it, or update it to the latest version if your project already includes it.
package.json
4

Reinstall dependencies

Remove node_modules and your lockfile, then install the updated packages:
5

Run your app

Start your app and confirm that the AppKit modal opens and wallets connect as before. Your WagmiAdapter and createAppKit configuration stays the same.If your app calls Wagmi hooks or actions directly, check the Wagmi 3.x migration guide for breaking changes in the Wagmi API.

React Wagmi example (Wagmi 3.0)

Check the upgraded React Wagmi example

​
Report a bug

If you find a bug while using the Wagmi 3.0 beta, contact support from the Reown Dashboard through the Intercom bubble, or report an issue.