Berpindah ke WalletConnect v2

Siapkan dApp Anda untuk peningkatan v2 dalam waktu 5 menit atau kurang

Protokol WalletConnect v1 akan dimatikan pada 28 Juni 2023, dan RainbowKit memiliki dukungan Anda untuk membuat transisi menjadi sangat mudah.

Dukungan untuk WalletConnect v2 sekarang menjadi standar di RainbowKit, tanpa perubahan yang merusak. Cukup tingkatkan dan rujuk panduan di bawah untuk detail tambahan.

Memahami WalletConnect v2

WalletConnect adalah protokol yang memungkinkan pengguna menghubungkan dompet seluler mereka ke dApp Anda, dan ini merupakan fondasi penting dari RainbowKit. Rilis terbaru WalletConnect v2 membawa sejumlah peningkatan penting untuk membuat pengalaman wallet-dApp menjadi lebih baik.

Dengan v2, pengguna Anda sekarang dapat menghubungkan secara bersamaan ke beberapa rantai, sehingga Anda dapat melupakan tentang jabat tangan pergantian rantai. Ini juga memperluas dukungan untuk lebih banyak jaringan, dan membawa peningkatan yang membuat Masuk dengan Ethereum menjadi lebih cepat.

Mengupgrade dApp Anda

Jika Anda sudah mengikuti panduan migrasi untuk RainbowKit 0.12.x dan 1.0.x, maka Anda hampir sampai! Cukup tingkatkan ke rilis patch terbaru dan coba.

RainbowKit mengaktifkan WalletConnect v2 secara default dengan 0.12.15 dan 1.0.2. Kami terus mendukung 0.12.x jika dApp Anda belum ditingkatkan ke wagmi v1 dan RainbowKit v1.

1. Mengupgrade dependensi

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

Jika Anda menggunakan versi RainbowKit sebelum 0.12.x atau 1.0.x, cukup ikuti Panduan Migrasi untuk mendapatkan pembaruan.

Dianjurkan agar dApps 0.12.x mulai meningkatkan ke versi wagmi v1, karena peningkatan stabilitas untuk WalletConnect v2 hanya akan dimasukkan dalam versi wagmi mendatang.

2. Menyediakan projectId

Setiap dApp yang bergantung pada WalletConnect sekarang harus memperoleh projectId dari WalletConnect Cloud. Ini benar-benar gratis dan hanya membutuhkan beberapa menit.

Berikan projectId Anda ke getDefaultWallets dan penghubung dompet RainbowKit individu seperti berikut:

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

RainbowKit aman tipe dan akan memperingatkan Anda jika projectId hilang. Rujuk contoh kami untuk melihat v2 dalam aksi:

Rujuk docs untuk opsi dukungan tambahan.