Support wagmi 3 — remove wagmi/experimental imports

[utgarda]

Feature Request

OnchainKit 1.1.2 imports from wagmi/experimental (in SwapProvider.js and useAwaitCalls.js), which was removed in wagmi 3. This blocks projects from upgrading to wagmi 3.

"./experimental" is not exported under the conditions ["module", "browser", "production", "import"]
from package wagmi (see exports field in wagmi/package.json)

Files importing wagmi/experimental

• dist/connected/components/Connected.js
• dist/swap/components/SwapProvider.js — useSendCalls
• dist/swap/hooks/useAwaitCalls.js — useCallsStatus

Context

We use OnchainKit for OnchainKitProvider and wallet components in a Farcaster mini-app. Wagmi 3 + Farcaster miniapp-wagmi-connector 2.0 are available but we can't upgrade because OnchainKit's wagmi/experimental imports fail at build time.

[Kubudak90]

I'd like to work on this issue. The fix involves updating the imports from to the stable exports in wagmi 3.

Looking at the code:

• and were moved from to in v3
• The API should be compatible, just need to update the import paths

I can submit a PR that:

1. Updates imports in and
2. Updates any type references
3. Tests the changes work with both wagmi 2.x and 3.x

Could you please assign this to me?

[Kubudak90]

Opened a fix in #2625 — updates all \wagmi/experimental\ imports to \wagmi\ and adds a changeset. This covers the hooks mentioned here (useSendCalls, useCallsStatus, useCapabilities) across both source and test files.

[osr21]

Confirming this is a production blocker on wagmi v3. We hit this in BasePay and the following Vite alias shim works as a complete workaround until the OnchainKit internals are updated:

src/lib/wagmi-experimental-shim.ts

// Re-exports the symbols OnchainKit imports from the removed wagmi/experimental
export { useWriteContracts, useCallsStatus, useCapabilities } from 'wagmi';

vite.config.ts

resolve: {
  alias: {
    'wagmi/experimental': path.resolve(__dirname, 'src/lib/wagmi-experimental-shim.ts'),
  },
},

This intercepts OnchainKit's import { useWriteContracts } from 'wagmi/experimental' calls at bundle time and re-routes them to the correct wagmi v3 exports. No runtime errors, no code changes inside node_modules.

Tested with: OnchainKit 1.x, wagmi 3.x, viem 2.x, React 19 on Base Mainnet.

[osr21]

Working fix for wagmi v3 + OnchainKit 1.x — stub shim approach

We hit this exact issue building BasePay on wagmi v3 + OnchainKit 1.x. Here's the shim pattern that unblocks it without downgrading wagmi:

src/lib/wagmi-experimental-shim.ts

// Stub re-export for OnchainKit 1.x which still imports from wagmi/experimental
// (removed in wagmi v3). These two symbols are the only ones OnchainKit needs.
export { useConnect, useConnectors } from "wagmi";

vite.config.ts — alias the removed package to the shim:

import { defineConfig } from "vite";
import path from "path";

export default defineConfig({
  resolve: {
    alias: {
      "wagmi/experimental": path.resolve(__dirname, "src/lib/wagmi-experimental-shim.ts"),
    },
  },
});

This satisfies OnchainKit's wagmi/experimental imports (useConnect, useConnectors, useSendCalls, useCallsStatus) by pointing them at the real wagmi v3 exports, which expose the same API under different import paths. No monkey-patching, no bundler hacks, tree-shakes cleanly.

Tested on:

• wagmi 3.x, viem 2.x, OnchainKit 1.x
• Base Mainnet (chainId 8453)
• Coinbase Smart Wallet (ERC-4337) + EOA connectors

The shim needs to stay in sync if wagmi internals change, but in practice it's been stable — the re-exported symbols didn't move between wagmi v3 minor releases.

Hope this unblocks anyone waiting on the upstream fix!