OnchainKit 앱 마이그레이션

Base 마이그레이션 스킬을 사용해 OnchainKit 앱을 wagmi와 viem으로 옮기는 방법을 안내합니다.

OnchainKit은 더 이상 유지보수되지 않습니다. 이 가이드는 Base 마이그레이션 스킬을 사용해 기존 OnchainKit 앱을 독립적인 wagmi 프로젝트로 옮기는 방법을 안내합니다.

개요

이 스킬은 OnchainKitProvider, Wallet, Transaction 세 가지 컴포넌트를 처리합니다. 각 항목마다 다음 작업을 수행합니다.

• 프로젝트에 있는 기존 OnchainKit 컴포넌트 코드를 제거합니다.
• wagmi/viem 기반의 대체 파일을 새로 생성합니다.
• 발생한 오류를 프로젝트 루트의 mistakes.md 파일에 기록합니다.

사전 준비

• OnchainKit을 사용 중인 Next.js 또는 React 프로젝트
• 스킬 실행을 지원하는 AI 코딩 도우미(Claude Code 또는 Cursor)

스킬 설치

npx skills add base/base-skills

마이그레이션 프롬프트

개별적으로 마이그레이션한다면 아래 Provider 프롬프트부터 시작하세요. 지갑과 트랜잭션 컴포넌트는 WagmiProvider가 먼저 구현되어 있어야 합니다.

원샷 실행(세 컴포넌트 한 번에)

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.

검증

마이그레이션이 끝나면 아래 프롬프트를 실행해 세 컴포넌트가 완전히 교체되었는지 확인하세요.

Run npm run build and confirm there are no remaining imports of OnchainKitProvider, Wallet, or Transaction from @coinbase/onchainkit in the project.