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.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Base 문서","colors":{"primary":"#0000ff","light":"#578BFA","dark":"#578BFA"},"logo":{"light":"https://mintcdn.com/daehan-base/P6uZlVymhSgrc9h1/logo/logo_light.svg?fit=max\u0026auto=format\u0026n=P6uZlVymhSgrc9h1\u0026q=85\u0026s=03f1805473a1095c95149560b3d859f4","dark":"https://mintcdn.com/daehan-base/P6uZlVymhSgrc9h1/logo/logo_dark.svg?fit=max\u0026auto=format\u0026n=P6uZlVymhSgrc9h1\u0026q=85\u0026s=c7dadab25be74bc32a1dd354ced567eb"},"favicon":"https://mintcdn.com/daehan-base/MGWA5xqCXHO5_iCo/logo/favicon.png?fit=max\u0026auto=format\u0026n=MGWA5xqCXHO5_iCo\u0026q=85\u0026s=a000bfadf9b45aeb1629d643b0f20a38","api":{"playground":{"display":"simple"},"examples":{"languages":["javascript"]}},"navbar":{"links":[{"icon":"github","href":"https://github.com/base","label":"GitHub"},{"icon":"discord","href":"https://discord.com/invite/buildonbase","label":"지원"},{"icon":"github","href":"https://github.com/Daehan-Base","label":"대한베이스 GitHub"},{"icon":"message","href":"https://t.me/daehan_base_devs","label":"대한베이스 텔레그램"}],"primary":{"type":"button","label":"Base 빌드","href":"https://base.dev"}},"footer":{"socials":{"x":"https://x.com/base","github":"https://github.com/base","reddit":"https://www.reddit.com/r/BASE","linkedin":"https://linkedin.com/company/coinbase"},"links":[{"header":"Base","items":[{"label":"Base.org","href":"https://base.org"},{"label":"블로그","href":"https://blog.base.dev/"},{"label":"개인정보 처리방침","href":"https://docs.base.org/privacy-policy"},{"label":"서비스 약관","href":"https://docs.base.org/terms-of-service"},{"label":"쿠키 정책","href":"https://docs.base.org/cookie-policy"}]}]},"seo":{"metatags":{"og:type":"website","og:site_name":"Base 문서"}},"integrations":{"ga4":{"measurementId":"G-TKCM02YFWN"}},"contextual":{"options":["copy","view","claude","chatgpt"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"daehan-base","hasAudioNarration":false,"actualSubdomain":"daehan-base","customDomains":[],"gitSource":{"type":"github","owner":"daehan-base","repo":"docs","deployBranch":"master","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae94907e5b11aa510b5da83:success","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Base Account","count":48},{"language":"default","tag":"Base Chain","count":32},{"language":"default","tag":"AI 에이전트","count":20},{"language":"default","tag":"퀵스타트","count":16},{"language":"default","tag":"프레임워크 통합","count":16},{"language":"default","tag":"시작하기","count":15},{"language":"default","tag":"네트워크 정보","count":10},{"language":"default","tag":"가이드","count":9},{"language":"default","tag":"스킬","count":9},{"language":"default","tag":"앱","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".danger-admonition{border:1px solid rgba(239, 68, 68, 0.2);background-color:rgba(254, 242, 242, 0.5)}.dark\\:danger-admonition:is(.dark *){border-color:rgba(239, 68, 68, 0.3);background-color:rgba(239, 68, 68, 0.1)}.assistant-entry{background-color:#0000ff!important;color:#ffffff!important;border:1px solid rgba(0, 0, 0, 0.15)!important;box-shadow:none!important;font-weight:600!important}.assistant-entry:hover{transform:translateY(-1px)!important;box-shadow:none!important}.assistant-entry:focus-visible{outline:2px solid rgba(0, 0, 0, 0.25)!important;outline-offset:2px!important}.dark .assistant-entry{background-color:#0000ff!important;border-color:rgba(0, 0, 0, 0.55)!important}.dark .assistant-entry:focus-visible{outline:2px solid rgba(0, 0, 0, 0.65)!important}.base_header_img{margin:auto}.nav-logo{height:1.25rem}.homepage_wrapper{width:75%;max-width:1376px;margin:auto;margin-bottom:50px}.home_header{padding-bottom:0!important}.home_header h1{margin-bottom:24px}.use-cases{display:grid;grid-template-columns:repeat(3, 1fr);gap:2rem;padding-bottom:2rem}.use-cases-links a{font-weight:normal;display:block;width:fit-content;margin-bottom:0.25rem;color:#0000ff;text-decoration:none;border-bottom:none}.use-cases-links a:hover{color:#000000}.dark .use-cases-links a{color:#578BFA}.dark .use-cases-links a:hover{color:#ffffff}.resources-section{padding-top:2rem}.resources-section h3{margin-bottom:0}.resources-row{display:grid;grid-template-columns:repeat(2, 1fr);gap:2rem}.resources-row h4{margin-top:0.75rem;margin-bottom:0.5rem;opacity:0.7}.resource-link{display:block;margin-bottom:0.25rem}.resource-link a{font-weight:normal;color:#0000ff;margin-left:0.25rem;text-decoration:none;border-bottom:none}.resource-link a:hover{color:#000000}.dark .resource-link a{color:#578BFA}.dark .resource-link a:hover{color:#ffffff}.home_header div p{margin-top:10px}.dark .callout :is(h1,h2,h3,h4,h5,h6){color:inherit}#content-area ol{padding-left:2rem}"}]}
{"page":{"pagePath":"onchainkit/migrate-from-onchainkit","slug":"/onchainkit/migrate-from-onchainkit","pageMetadata":{"title":"OnchainKit 앱 마이그레이션","description":"Base 마이그레이션 스킬을 사용해 OnchainKit 앱을 wagmi와 viem으로 옮기는 방법을 안내합니다.","href":"/onchainkit/migrate-from-onchainkit"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Base 마이그레이션 스킬을 사용해 OnchainKit 앱을 wagmi와 viem으로 옮기는 방법을 안내합니다.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`OnchainKit은 더 이상 유지보수되지 않습니다. 이 가이드는 Base 마이그레이션 스킬을 사용해 기존 OnchainKit 앱을 독립적인 `,_jsx(_components.a,{href:`https://wagmi.sh`,children:`wagmi`}),` 프로젝트로 옮기는 방법을 안내합니다.`]}),`\n`,_jsx(Heading,{level:`2`,id:`개요`,children:`개요`}),`\n`,_jsxs(_components.p,{children:[`이 스킬은 `,_jsx(_components.code,{children:`OnchainKitProvider`}),`, `,_jsx(_components.code,{children:`Wallet`}),`, `,_jsx(_components.code,{children:`Transaction`}),` 세 가지 컴포넌트를 처리합니다. 각 항목마다 다음 작업을 수행합니다.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`프로젝트에 있는 기존 OnchainKit 컴포넌트 코드를 제거합니다.`}),`\n`,_jsx(_components.li,{children:`wagmi/viem 기반의 대체 파일을 새로 생성합니다.`}),`\n`,_jsxs(_components.li,{children:[`발생한 오류를 프로젝트 루트의 `,_jsx(_components.code,{children:`mistakes.md`}),` 파일에 기록합니다.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`사전-준비`,children:`사전 준비`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`OnchainKit을 사용 중인 Next.js 또는 React 프로젝트`}),`\n`,_jsx(_components.li,{children:`스킬 실행을 지원하는 AI 코딩 도우미(Claude Code 또는 Cursor)`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`스킬-설치`,children:`스킬 설치`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` skills`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` base/base-skills`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`마이그레이션-프롬프트`,children:`마이그레이션 프롬프트`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`개별적으로 마이그레이션한다면 아래 `,_jsx(_components.code,{children:`Provider`}),` 프롬프트부터 시작하세요. 지갑과 트랜잭션 컴포넌트는 `,_jsx(_components.code,{children:`WagmiProvider`}),`가 먼저 구현되어 있어야 합니다.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`원샷-실행-세-컴포넌트-한-번에`,children:`원샷 실행(세 컴포넌트 한 번에)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Migrate my OnchainKit app to use standalone wagmi and viem. Replace the provider, wallet component, and transaction component. Remove the OnchainKit dependency entirely.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`provider`,children:`Provider`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Replace my OnchainKitProvider with WagmiProvider and QueryClientProvider.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`wallet`,children:`Wallet`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Migrate my OnchainKit wallet component to a standalone wagmi-based connect button.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`transaction`,children:`Transaction`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Migrate my OnchainKit transaction component to use wagmi hooks directly.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`검증`,children:`검증`}),`\n`,_jsx(_components.p,{children:`마이그레이션이 끝나면 아래 프롬프트를 실행해 세 컴포넌트가 완전히 교체되었는지 확인하세요.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Run npm run build and confirm there are no remaining imports of OnchainKitProvider, Wallet, or Transaction from @coinbase/onchainkit in the project.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"OnchainKit 앱 마이그레이션","description":"Base 마이그레이션 스킬을 사용해 OnchainKit 앱을 wagmi와 viem으로 옮기는 방법을 안내합니다.","href":"/onchainkit/migrate-from-onchainkit"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"개요","slug":"개요","depth":2,"children":[]},{"title":"사전 준비","slug":"사전-준비","depth":2,"children":[]},{"title":"스킬 설치","slug":"스킬-설치","depth":2,"children":[]},{"title":"마이그레이션 프롬프트","slug":"마이그레이션-프롬프트","depth":2,"children":[{"title":"원샷 실행(세 컴포넌트 한 번에)","slug":"원샷-실행-세-컴포넌트-한-번에","depth":3,"children":[]},{"title":"Provider","slug":"provider","depth":3,"children":[]},{"title":"Wallet","slug":"wallet","depth":3,"children":[]},{"title":"Transaction","slug":"transaction","depth":3,"children":[]}]},{"title":"검증","slug":"검증","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/daehan-base/4d86dd86bab42f08/iframe-theme.js"],"subdomain":"daehan-base","siteName":"Base 문서","title":"OnchainKit 앱 마이그레이션 - Base 문서","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-19T05:37:24.306Z","originalFileLocation":"onchainkit/migrate-from-onchainkit.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Base 마이그레이션 스킬을 사용해 OnchainKit 앱을 wagmi와 viem으로 옮기는 방법을 안내합니다.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Base 문서\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/daehan-base/KoBuCx1k_uYiwNAc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/daehan-base/KoBuCx1k_uYiwNAc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/daehan-base/KoBuCx1k_uYiwNAc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/daehan-base/KoBuCx1k_uYiwNAc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/daehan-base/KoBuCx1k_uYiwNAc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/daehan-base/KoBuCx1k_uYiwNAc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/daehan-base/KoBuCx1k_uYiwNAc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/daehan-base/KoBuCx1k_uYiwNAc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/daehan-base/KoBuCx1k_uYiwNAc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"OnchainKit 앱 마이그레이션 - Base 문서\">\u003cmeta data-mint-head property=\"og:description\" content=\"Base 마이그레이션 스킬을 사용해 OnchainKit 앱을 wagmi와 viem으로 옮기는 방법을 안내합니다.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Base 문서\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://daehan-base.mintlify.app/onchainkit/migrate-from-onchainkit\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://daehan-base.mintlify.site/_mintlify/api/og/v2?division=%EB%A7%88%EC%9D%B4%EA%B7%B8%EB%A0%88%EC%9D%B4%EC%85%98\u0026amp;title=OnchainKit+%EC%95%B1+%EB%A7%88%EC%9D%B4%EA%B7%B8%EB%A0%88%EC%9D%B4%EC%85%98\u0026amp;description=Base+%EB%A7%88%EC%9D%B4%EA%B7%B8%EB%A0%88%EC%9D%B4%EC%85%98+%EC%8A%A4%ED%82%AC%EC%9D%84+%EC%82%AC%EC%9A%A9%ED%95%B4+OnchainKit+%EC%95%B1%EC%9D%84+wagmi%EC%99%80+viem%EC%9C%BC%EB%A1%9C+%EC%98%AE%EA%B8%B0%EB%8A%94+%EB%B0%A9%EB%B2%95%EC%9D%84+%EC%95%88%EB%82%B4%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=eb12feed2504cf2a58743cea\u0026amp;signature=18f8dea2cc3badd83e66533fd4731a71cfe3def41a3aabfba1806d4ebc9ed3b2\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"OnchainKit 앱 마이그레이션 - Base 문서\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Base 마이그레이션 스킬을 사용해 OnchainKit 앱을 wagmi와 viem으로 옮기는 방법을 안내합니다.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://daehan-base.mintlify.site/_mintlify/api/og/v2?division=%EB%A7%88%EC%9D%B4%EA%B7%B8%EB%A0%88%EC%9D%B4%EC%85%98\u0026amp;title=OnchainKit+%EC%95%B1+%EB%A7%88%EC%9D%B4%EA%B7%B8%EB%A0%88%EC%9D%B4%EC%85%98\u0026amp;description=Base+%EB%A7%88%EC%9D%B4%EA%B7%B8%EB%A0%88%EC%9D%B4%EC%85%98+%EC%8A%A4%ED%82%AC%EC%9D%84+%EC%82%AC%EC%9A%A9%ED%95%B4+OnchainKit+%EC%95%B1%EC%9D%84+wagmi%EC%99%80+viem%EC%9C%BC%EB%A1%9C+%EC%98%AE%EA%B8%B0%EB%8A%94+%EB%B0%A9%EB%B2%95%EC%9D%84+%EC%95%88%EB%82%B4%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=eb12feed2504cf2a58743cea\u0026amp;signature=18f8dea2cc3badd83e66533fd4731a71cfe3def41a3aabfba1806d4ebc9ed3b2\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/daehan-base/KoBuCx1k_uYiwNAc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Base 문서\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0000ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://daehan-base.mintlify.app/onchainkit/migrate-from-onchainkit\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/onchainkit/migrate-from-onchainkit.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://daehan-base.mintlify.app/#organization\",\"name\":\"Base 문서\",\"url\":\"https://daehan-base.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/daehan-base/P6uZlVymhSgrc9h1/logo/logo_light.svg?fit=max\u0026auto=format\u0026n=P6uZlVymhSgrc9h1\u0026q=85\u0026s=03f1805473a1095c95149560b3d859f4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://daehan-base.mintlify.app#website\",\"name\":\"Base 문서\",\"url\":\"https://daehan-base.mintlify.app\",\"publisher\":{\"@id\":\"https://daehan-base.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://daehan-base.mintlify.app/onchainkit/migrate-from-onchainkit#webpage\",\"url\":\"https://daehan-base.mintlify.app/onchainkit/migrate-from-onchainkit\",\"name\":\"OnchainKit 앱 마이그레이션\",\"description\":\"Base 마이그레이션 스킬을 사용해 OnchainKit 앱을 wagmi와 viem으로 옮기는 방법을 안내합니다.\",\"dateModified\":\"2026-04-19T05:37:24.306Z\",\"isPartOf\":{\"@id\":\"https://daehan-base.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://daehan-base.mintlify.app/onchainkit/migrate-from-onchainkit#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://daehan-base.mintlify.app/onchainkit/migrate-from-onchainkit#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Base 문서\",\"item\":\"https://daehan-base.mintlify.app\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"OnchainKit 앱 마이그레이션\",\"item\":\"https://daehan-base.mintlify.app/onchainkit/migrate-from-onchainkit\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://daehan-base.mintlify.app/onchainkit/migrate-from-onchainkit#article\",\"headline\":\"OnchainKit 앱 마이그레이션\",\"name\":\"OnchainKit 앱 마이그레이션\",\"description\":\"Base 마이그레이션 스킬을 사용해 OnchainKit 앱을 wagmi와 viem으로 옮기는 방법을 안내합니다.\",\"url\":\"https://daehan-base.mintlify.app/onchainkit/migrate-from-onchainkit\",\"mainEntityOfPage\":{\"@id\":\"https://daehan-base.mintlify.app/onchainkit/migrate-from-onchainkit#webpage\"},\"dateModified\":\"2026-04-19T05:37:24.306Z\",\"publisher\":{\"@id\":\"https://daehan-base.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://daehan-base.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Base 문서\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Base 문서\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/onchainkit/migrate-from-onchainkit.md","siteName":"Base 문서","nav":{"global":null,"tabs":[{"tab":"시작하기","pages":[{"title":"시작하기","href":"/get-started/base"}]},{"tab":"Base Chain","pages":[{"title":"Base Chain","href":"/base-chain/quickstart/why-base"}]},{"tab":"Base Account","pages":[{"title":"Base Account","href":"/base-account/overview/what-is-base-account"}]},{"tab":"AI 에이전트","pages":[{"title":"AI 에이전트","href":"/ai-agents"}]},{"tab":"앱","pages":[{"title":"앱","href":"/apps/quickstart/migrate-to-standard-web-app"}]},{"tab":"OnchainKit","groups":[{"group":"마이그레이션","pages":[{"title":"OnchainKit 앱 마이그레이션","href":"/onchainkit/migrate-from-onchainkit"}]}]},{"tab":"Based Builder 가이드","pages":[{"title":"Based Builder 가이드","href":"/based-builder"}]}]},"basePath":"","title":"OnchainKit 앱 마이그레이션 - Base 문서","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}