Skip to content

docs: pin wagmi to v2.18.0 and add wagmi 2.x compatibility warning #767

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
devin-ai-integration wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: pin wagmi to v2.18.0 and add wagmi 2.x compatibility warning #767

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a244f8b
docs: pin wagmi to v2.18.0 and add wagmi 2.x compatibility warning
devin-ai-integration[bot] Mar 19, 2026
c319f69
docs: remove v3 warning sentence from wagmi compatibility notice
devin-ai-integration[bot] Mar 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 8 additions & 4 deletions appkit/javascript/core/installation.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,22 +46,26 @@ After installation, you can ask your AI assistant for help with AppKit setup, im
<Tabs>
<Tab title="Wagmi">

<Warning>
AppKit is only compatible with wagmi 2.x. Ensure you are using a compatible version (e.g., `wagmi@2.18.0`).
</Warning>

<CodeGroup>

```bash npm
npm install @reown/appkit @reown/appkit-adapter-wagmi wagmi viem
npm install @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem
```

```bash Yarn
yarn add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem
yarn add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem
```

```bash Bun
bun add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem
bun add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem
```

```bash pnpm
pnpm add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem
pnpm add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem
```

</CodeGroup>
Expand Down
8 changes: 4 additions & 4 deletions appkit/migration/from-privy-next.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,19 +21,19 @@ Replace Privy dependencies with AppKit by running the following commands for you
<CodeGroup>

```bash npm
npm install @reown/appkit @reown/appkit-adapter-wagmi wagmi viem && npm uninstall @privy-io/react-auth @privy-io/server-auth
npm install @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem && npm uninstall @privy-io/react-auth @privy-io/server-auth
```

```bash Yarn
yarn add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem && yarn remove @privy-io/react-auth @privy-io/server-auth
yarn add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem && yarn remove @privy-io/react-auth @privy-io/server-auth
```

```bash Bun
bun a @reown/appkit @reown/appkit-adapter-wagmi wagmi viem && bun remove @privy-io/react-auth @privy-io/server-auth
bun a @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem && bun remove @privy-io/react-auth @privy-io/server-auth
```

```bash pnpm
pnpm add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem && pnpm remove @privy-io/react-auth @privy-io/server-auth
pnpm add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem && pnpm remove @privy-io/react-auth @privy-io/server-auth
```
</CodeGroup>

Expand Down
12 changes: 8 additions & 4 deletions appkit/next/core/installation.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,22 +44,26 @@ After installation, you can ask your AI assistant for help with AppKit setup, im
<Tabs>
<Tab title="Wagmi">

<Warning>
AppKit is only compatible with wagmi 2.x. Ensure you are using a compatible version (e.g., `wagmi@2.18.0`).
</Warning>

<CodeGroup>

```bash npm
npm install @reown/appkit @reown/appkit-adapter-wagmi wagmi viem @tanstack/react-query
npm install @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem @tanstack/react-query
```

```bash Yarn
yarn add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem @tanstack/react-query
yarn add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem @tanstack/react-query
```

```bash Bun
bun add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem @tanstack/react-query
bun add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem @tanstack/react-query
```

```bash pnpm
pnpm add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem @tanstack/react-query
pnpm add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem @tanstack/react-query
```

</CodeGroup>
Expand Down
12 changes: 8 additions & 4 deletions appkit/nuxt/core/installation.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,22 +38,26 @@ After installation, you can ask your AI assistant for help with AppKit setup, im
<Tabs>
<Tab title="Wagmi">

<Warning>
AppKit is only compatible with wagmi 2.x. Ensure you are using a compatible version (e.g., `wagmi@2.18.0`).
</Warning>

<CodeGroup>

```bash npm
npm install @reown/appkit @reown/appkit-adapter-wagmi wagmi viem @wagmi/vue @tanstack/vue-query
npm install @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem @wagmi/vue @tanstack/vue-query
```

```bash Yarn
yarn add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem @wagmi/vue @tanstack/vue-query
yarn add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem @wagmi/vue @tanstack/vue-query
```

```bash Bun
bun add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem @wagmi/vue @tanstack/vue-query
bun add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem @wagmi/vue @tanstack/vue-query
```

```bash pnpm
pnpm add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem @wagmi/vue @tanstack/vue-query
pnpm add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem @wagmi/vue @tanstack/vue-query
```

</CodeGroup>
Expand Down
6 changes: 3 additions & 3 deletions appkit/react-native/core/migration-multichain.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,10 +51,10 @@ Based on the blockchains your dApp needs to support, install the corresponding a
- **EVM (Wagmi):**
```bash
# For Expo
npx expo install @reown/appkit-wagmi-react-native wagmi viem@2.x @tanstack/react-query
npx expo install @reown/appkit-wagmi-react-native wagmi@2.18.0 viem@2.x @tanstack/react-query
# For RN CLI
# npm install @reown/appkit-wagmi-react-native wagmi viem@2.x @tanstack/react-query
# yarn add @reown/appkit-wagmi-react-native wagmi viem@2.x @tanstack/react-query
# npm install @reown/appkit-wagmi-react-native wagmi@2.18.0 viem@2.x @tanstack/react-query
# yarn add @reown/appkit-wagmi-react-native wagmi@2.18.0 viem@2.x @tanstack/react-query
```
- **Solana:**
```bash
Expand Down
12 changes: 8 additions & 4 deletions appkit/react/core/installation.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,22 +48,26 @@ After installation, you can ask your AI assistant for help with AppKit setup, im
<Tabs>
<Tab title="Wagmi">

<Warning>
AppKit is only compatible with wagmi 2.x. Ensure you are using a compatible version (e.g., `wagmi@2.18.0`).
</Warning>

<CodeGroup>

```bash npm
npm install @reown/appkit @reown/appkit-adapter-wagmi wagmi viem @tanstack/react-query
npm install @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem @tanstack/react-query
```

```bash Yarn
yarn add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem @tanstack/react-query
yarn add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem @tanstack/react-query
```

```bash Bun
bun add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem @tanstack/react-query
bun add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem @tanstack/react-query
```

```bash pnpm
pnpm add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem @tanstack/react-query
pnpm add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem @tanstack/react-query
```

</CodeGroup>
Expand Down
2 changes: 1 addition & 1 deletion appkit/recipes/tenderly-virtual-testnets.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ The above command creates a Next app and sets the name of the Next app as “app
Now, we need to install AppKit and other dependencies that we need for our app to function as expected. For this tutorial, we will be using “wagmi” as our preferred Ethereum library. However, you can also use [Ethers](https://docs.reown.com/appkit/next/core/installation?platform=ethers).

```bash
npm install @reown/appkit @reown/appkit-wagmi-adapter wagmi @tanstack/react-query
npm install @reown/appkit @reown/appkit-wagmi-adapter wagmi@2.18.0 @tanstack/react-query
```

> You can also use other package managers such as `yarn`, `bun`, `pnpm`, etc.
Expand Down
12 changes: 8 additions & 4 deletions appkit/svelte/core/installation.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,22 +43,26 @@ After installation, you can ask your AI assistant for help with AppKit setup, im
<Tabs>
<Tab title="Wagmi">

<Warning>
AppKit is only compatible with wagmi 2.x. Ensure you are using a compatible version (e.g., `wagmi@2.18.0`).
</Warning>

<CodeGroup>

```bash npm
npm install @reown/appkit @reown/appkit-adapter-wagmi wagmi viem
npm install @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem
```

```bash Yarn
yarn add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem
yarn add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem
```

```bash Bun
bun add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem
bun add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem
```

```bash pnpm
pnpm add @reown/appkit @reown/appkit-adapter-wagmi wagmi viem
pnpm add @reown/appkit @reown/appkit-adapter-wagmi wagmi@2.18.0 viem
```

</CodeGroup>
Expand Down
2 changes: 1 addition & 1 deletion appkit/upgrade/from-web3modal-react-native.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ Add the new Reown AppKit packages:
yarn add @reown/appkit-react-native @react-native-async-storage/async-storage react-native-get-random-values react-native-svg @react-native-community/netinfo @walletconnect/react-native-compat

# Wagmi adapter and its dependencies
yarn add @reown/appkit-wagmi-react-native wagmi viem@2.x @tanstack/react-query
yarn add @reown/appkit-wagmi-react-native wagmi@2.18.0 viem@2.x @tanstack/react-query

# Optional: Additional adapters for other chains
yarn add @reown/appkit-solana-react-native @reown/appkit-bitcoin-react-native
Expand Down
4 changes: 4 additions & 0 deletions appkit/vue/core/installation.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,10 @@ After installation, you can ask your AI assistant for help with AppKit setup, im
<Tabs>
<Tab title="Wagmi">

<Warning>
AppKit is only compatible with wagmi 2.x. Ensure you are using a compatible version (e.g., `wagmi@2.18.0`).
</Warning>

<CodeGroup>

```bash npm
Expand Down
Loading