Migrer vers WalletConnect v2

Préparez votre dApp pour la mise à niveau v2 en 5 minutes ou moins

Le protocole WalletConnect v1 sera mis hors service le 28 juin 2023, et RainbowKit vous soutient pour rendre la transition très simple.

Le support pour WalletConnect v2 est désormais standard dans RainbowKit, sans changements majeurs. Il suffit de mettre à niveau et de consulter le guide ci-dessous pour plus de détails.

Comprendre WalletConnect v2

WalletConnect est le protocole qui permet aux utilisateurs de connecter leurs portefeuilles mobiles à votre dApp, et c'est une fondation importante de RainbowKit. La récente sortie de WalletConnect v2 apporte un certain nombre de mises à niveau importantes pour améliorer encore l'expérience portefeuille-dApp.

Avec la v2, vos utilisateurs peuvent maintenant se connecter simultanément à plusieurs chaînes, ce qui vous évite d'avoir à changer de chaîne. Elle élargit également le support pour plus de réseaux et apporte des améliorations qui rendent la connexion avec Ethereum encore plus rapide.

Mise à niveau de votre dApp

Si vous avez déjà suivi les guides de migration pour RainbowKit 0.12.x et 1.0.x, alors vous y êtes presque ! Il suffit de mettre à niveau vers la dernière version patch et de l'essayer.

RainbowKit a activé WalletConnect v2 par défaut avec 0.12.15 et 1.0.2. Nous continuons à supporter 0.12.x au cas où votre dApp n'a pas encore été mise à niveau vers wagmi v1 et RainbowKit v1.

1. Mise à niveau des dépendances

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

Si vous utilisez une version de RainbowKit antérieure à 0.12.x ou 1.0.x, suivez simplement les Guides de Migration pour vous mettre à jour.

Il est recommandé que les dApps 0.12.x commencent à se mettre à niveau vers wagmi v1, car les améliorations de stabilité pour WalletConnect v2 ne seront incluses que dans les futures versions de wagmi.

2. Fourniture d'un projectId

Toute dApp qui dépend de WalletConnect doit maintenant obtenir un projectId de WalletConnect Cloud. C'est absolument gratuit et ne prend que quelques minutes.

Fournissez votre projectId à getDefaultWallets et aux connecteurs de portefeuille RainbowKit individuels comme suit :

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 est sûr et vous avertira lorsque un projectId est manquant. Reportez-vous à nos exemples pour voir v2 en action :

Reportez-vous à docs pour des options supplémentaires prises en charge.