OnchainKit is no longer maintained. This guide helps you migrate your existing OnchainKit app to a standalone wagmi project using the Base migration skill.
Overview
The skill handles three components: OnchainKitProvider, Wallet, and Transaction. For each it:
- Deletes existing OnchainKit component code from your project
- Creates new wagmi/viem-based replacement files
- Logs any errors in a
mistakes.md file at your project root
Prerequisites
- A Next.js or React project using OnchainKit
- An AI coding assistant that supports skills (Claude Code or Cursor)
Install the Skill
npx skills add base/base-skills
Migration Prompts
If migrating individually, start with the Provider prompt below. The wallet and transaction components depend on WagmiProvider being implemented first.
One-Shot (all three components)
Migrate my OnchainKit app to use standalone wagmi and viem. Replace the provider, wallet component, and transaction component. Remove the OnchainKit dependency entirely.
Provider
Replace my OnchainKitProvider with WagmiProvider and QueryClientProvider.
Wallet
Migrate my OnchainKit wallet component to a standalone wagmi-based connect button.
Transaction
Migrate my OnchainKit transaction component to use wagmi hooks directly.
Verify
After migration, run this prompt to confirm the three migrated components are fully replaced:
Run npm run build and confirm there are no remaining imports of OnchainKitProvider, Wallet, or Transaction from @coinbase/onchainkit in the project.
