Di cư lên WalletConnect v2

Chuẩn bị dApp của bạn cho nâng cấp v2 trong 5 phút hoặc ít hơn

Giao thức WalletConnect v1 sẽ bị ngừng hoạt động vào ngày 28 tháng 6 năm 2023, và RainbowKit đã sẵn sàng để bạn có thể chuyển đổi dễ dàng hơn rất nhiều.

Hỗ trợ cho WalletConnect v2 bây giờ là tiêu chuẩn trong RainbowKit, không có thay đổi nào phá vỡ. Chỉ cần nâng cấp và tham khảo hướng dẫn bên dưới để biết thêm chi tiết.

WalletConnect là giao thức cho phép người dùng kết nối ví di động của họ với dApp của bạn, và là nền tảng quan trọng của RainbowKit. Phiên bản WalletConnect v2 mới đây mang lại một số cải tiến quan trọng để làm cho trải nghiệm ví-dApp trở nên tốt hơn.

Với v2, người dùng của bạn có thể đồng thời kết nối đến nhiều chuỗi, vì vậy bạn có thể quên đi việc chuyển đổi chuỗi. Nó cũng mở rộng hỗ trợ cho nhiều mạng hơn và mang lại các cải tiến giúp Đăng nhập với Ethereum nhanh hơn.

Nếu bạn đã theo các hướng dẫn di chuyển cho RainbowKit 0.12.x và 1.0.x, thì bạn gần như đã tới mục tiêu! Chỉ cần nâng cấp lên phiên bản vá lỗi mới nhất và thử nghiệm.

RainbowKit kích hoạt WalletConnect v2 theo mặc định với 0.12.15 và 1.0.2. Chúng tôi vẫn cung cấp hỗ trợ cho 0.12.x trong trường hợp dApp của bạn chưa nâng cấp lên wagmi v1 và RainbowKit v1.

1. Nâng cấp phụ thuộc

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

Nếu bạn đang sử dụng phiên bản RainbowKit trước 0.12.x hoặc 1.0.x, chỉ cần theo dõi Hướng dẫn Di chuyển để cập nhật.

Khuyến nghị rằng các dApp 0.12.x nên bắt đầu nâng cấp lên wagmi v1, vì các cải tiến ổn định cho WalletConnect v2 sẽ chỉ được bao gồm trong các phiên bản tương lai của wagmi.

2. Cung cấp projectId

Mọi dApp phụ thuộc vào WalletConnect bây giờ cần phải lấy một projectId từ WalletConnect Cloud. Điều này hoàn toàn miễn phí và chỉ mất vài phút.

Cung cấp projectId của bạn cho getDefaultWallets và các kết nối ví RainbowKit cá nhân tương tự như sau:

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 là kiểu an toàn và sẽ cảnh báo bạn khi thiếu projectId. Tham khảo các ví dụ của chúng tôi để xem v2 hoạt động như thế nào:

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

Tham khảo tài liệu để biết các tùy chọn hỗ trợ bổ sung.