WalletConnect v2로 마이그레이션 하기

5분 이내로 v2 업그레이드를 위해 당신의 dApp을 준비하세요

WalletConnect v1 프로토콜은 2023년 6월 28일에 종료되며, RainbowKit이 간단한 전환을 지원합니다.

RainbowKit에서는 이제 WalletConnect v2 지원이 표준으로 제공되며, 변경 사항은 없습니다. 추가 세부사항은 아래의 가이드를 참고하세요.

WalletConnect는 사용자가 모바일 지갑을 당신의 dApp에 연결할 수 있게 하는 프로토콜이며 RainbowKit의 중요한 기반입니다. 최근에 발매된 WalletConnect v2는 지갑-dApp 경험을 더욱 좋게 만들기 위한 여러 중요한 업그레이드를 제공합니다.

v2를 통해 이제 사용자는 여러 체인에 동시에 연결할 수 있으므로, 체인 스위칭 핸드셰이크를 잊을 수 있습니다. 또한 더 많은 네트워크에 대한 지원을 확대하고, Ethereum으로 로그인하는 속도를 더욱 빠르게 개선합니다.

이미 RainbowKit 0.12.x 및 1.0.x의 마이그레이션 가이드를 따랐다면 거의 다 왔습니다! 최신 패치 릴리스로 업그레이드하고 시도해보세요.

RainbowKit는 0.12.15 및 1.0.2와 함께 WalletConnect v2를 기본으로 활성화했습니다. wagmi v1과 RainbowKit v1로 dApp이 아직 업그레이드되지 않았다면, 0.12.x를 계속 지원합니다.

1. 의존성 업그레이드

npm i @rainbow-me/rainbowkit@^1.0.2 wagmi@^1.2

RainbowKit의 0.12.x 또는 1.0.x 이전 버전을 사용 중이시면, 마이그레이션 가이드를 따라 최신 상태로 업데이트하세요.

WalletConnect v2의 안정성 향상이 future wagmi 버전에만 포함될 것이기 때문에 0.12.x dApp은 wagmi v1로 업그레이드할 것을 권장합니다.

2. projectId 제공하기

이제 WalletConnect에 의존하는 모든 dApp은 WalletConnect Cloud에서 프로젝트 ID를 얻어야 합니다. 이는 완전 무료이며 몇 분밖에 걸리지 않습니다.

아래와 같이 getDefaultWallets 및 개별 RainbowKit 지갑 커넥터에 projectId를 제공하세요:

const projectId = 'YOUR_PROJECT_ID';
const { wallets } = getDefaultWallets({
  appName: 'My RainbowKit App',
  projectId,
  chains,
});
const connectors = connectorsForWallets([
  ...wallets,
  {
    groupName: 'Other',
    wallets: [
      readyWallet({ projectId, chains }),
      trustWallet({ projectId, chains }),
      ledgerWallet({ projectId, chains }),
    ],
  },
]);

RainbowKit은 타입 안정성을 보장하며 projectId가 누락되었을 때 경고합니다. v2의 작동을 확인하려면 예제를 참고하세요:

• Create React App
• Next.js
• Next.js App Router
• Remix
• Vite
• React Router

추가로 지원되는 옵션에 대한 자세한 내용은 문서를 참조하세요.