Coinbase Wallet SDK에서 마이그레이션

Coinbase Wallet SDK에서 Base Account SDK로 마이그레이션하는 가이드

개요

Base Account SDK를 통해 Base Account 사용자는 서드파티 모바일 및 웹 애플리케이션에 연결할 수 있습니다. Base Account SDK는 현재 레거시로 간주되는 Coinbase Wallet SDK의 후속 제품입니다.

개발자는 사용자가 “Base로 로그인” 또는 “Base” 버튼을 통해 연결하도록 Base Account SDK를 연동해야 합니다.

기존 앱의 “Coinbase Wallet” 버튼을 즉시 교체하는 것은 권장하지 않습니다. 대신 “Coinbase Wallet” 버튼 옆에 Base Account 버튼을 추가 옵션으로 추가하세요. 이를 통해 사용자가 새로운 Base 브랜드에 익숙해지는 전환 기간을 제공할 수 있습니다.

이 변경의 배경에는 모바일 앱의 전환이 있습니다: Coinbase Wallet 앱이 이제 Base 앱으로 전환되고 있습니다. 스마트 지갑 플랫폼으로 구동되는 Base Account를 갖도록 모든 사용자를 점진적으로 전환하고 있습니다.

아래는 기존 사용자 유형과 현재 및 미래에 앱에 연결하는 방법을 정리한 표입니다:

사용자 유형	현재	미래 (~2025년 하반기)
스마트 지갑 사용자 (웹 및 모바일 앱)	자동으로 Base Account 보유, “Base로 로그인” 사용 가능	변경 없음
신규 Base 앱 사용자	자동으로 Base Account 보유, “Base로 로그인” 사용 가능	변경 없음
Coinbase Wallet 확장 프로그램 사용자	”Coinbase Wallet” 버튼으로 계속 연결	Base Account로 마이그레이션하여 “Base로 로그인” 사용 경로 제공
Coinbase Wallet 모바일 앱 EOA 사용자	”Coinbase Wallet” 버튼으로 계속 연결	Base Account로 마이그레이션하여 “Base로 로그인” 사용 경로 제공

”Coinbase Wallet” 클릭 시 사용자 경험 변경

SDK v4.0부터 Coinbase Wallet 확장 프로그램이 없는 사용자는 팝업 창으로 안내되며, WalletLink를 통한 모바일 앱 연결이나 웹에서 네이티브로 패스키 기반 스마트 지갑을 사용할 수 있는 옵션을 선택할 수 있습니다.

이는 계속 유지되지만, 로그아웃 경험이 변경되어 스마트 지갑 사용자에게 향후에는 “Base로 로그인”을 사용해야 한다는 안내를 제공합니다. 데스크톱에서의 모습은 다음과 같습니다.

Coinbase Wallet 사용자를 위한 업데이트된 로그아웃 흐름을 보여주는 데스크톱 경험

팝업 창이 표시되지 않도록 하려면 Coinbase Wallet SDK 버전 4.0 미만을 사용하는 것을 권장합니다.

최신 Coinbase Wallet SDK 버전은 여기에서 확인할 수 있습니다.

마이그레이션 방법

SDK를 사용하는 경우, Coinbase Wallet SDK를 Base Account SDK로 간단히 교체할 수 있습니다.

import { createBaseAccountSDK } from "@base-org/account";

const baseAccount = createBaseAccountSDK({
  // ...
});

자세한 내용은 퀵스타트 가이드를 참고하세요.

서드파티 라이브러리를 사용하는 경우, Wagmi, RainbowKit 또는 Privy 가이드를 따르세요.

더 완전한 마이그레이션 가이드를 곧 제공할 예정입니다.