[bug] add support of `[email protected]`

[StackOverflowExcept1on]

Link to minimal reproducible example

https://github.com/reown-com/appkit-web-examples/tree/main/react/react-wagmi

Steps to Reproduce

update your dependencies to the latest versions. problem is that there is an endless loading process when connecting the wallet.

Summary

expected behavior is working wallet connection button

List of related npm package versions

wagmi 3.0

Node.js Version

24.11.0

Package Manager

11.6.2

[linear[bot]]

APKT-4317

[wearedood]

Hi @StackOverflowException,

I've analyzed your issue and found the root cause. The current AppKit version (1.8.13) is designed to work with wagmi v2.x, but you're trying to upgrade to wagmi v3.0.

Looking at the official AppKit React-Wagmi example, the current dependencies are:

"wagmi": "^2.18.0",
"wagmi/core": "^2.22.0",
"@reown/appkit": "1.8.13",
"@reown/appkit-adapter-wagmi": "1.8.13"

Solution: For now, you should stick with wagmi v2.x until AppKit officially supports wagmi v3.0. Try using:

npm install wagmi@^2.18.0 wagmi/core@^2.22.0

Workaround: If you absolutely need wagmi v3.0 features, you might need to wait for an AppKit update that supports it, or consider contributing to the compatibility effort.

The endless loading issue you're experiencing is likely due to breaking changes in wagmi v3.0's API that AppKit hasn't been updated to handle yet.

Hope this helps! 🚀

[PaulRBerg]

Maybe in the meantime:

• Update the docs to recommend installing wagmi@2 instead of just wagmi?
• Set a peer dependency on Wagmi v2?

[kaumudpa]

+1

[PaulRBerg]

Hey AppKit team (@tomiir @enesozturk @svenvoskamp), adding this warning wouldn't take you long time but it would save a lot of debugging pain for users of AppKit. Can you please inform users about the dependency on wagmi v2? 🙏