Migration auf WalletConnect v2

Bereiten Sie Ihre dApp auf das Upgrade auf v2 in weniger als 5 Minuten vor.

Das WalletConnect v1-Protokoll wird am 28. Juni 2023 abgeschaltet, und RainbowKit unterstützt Sie, damit der Übergang super einfach ist.

Unterstützung für WalletConnect v2 ist jetzt standardmäßig in RainbowKit integriert, ohne Breaking Changes. Einfach upgraden und den folgenden Leitfaden für weitere Details heranziehen.

Verständnis von WalletConnect v2

WalletConnect ist das Protokoll, das es Benutzern ermöglicht, ihre mobilen Wallets mit Ihrer dApp zu verbinden, und es bildet eine wichtige Grundlage von RainbowKit. Die kürzlich veröffentlichte WalletConnect v2 bringt eine Reihe wichtiger Upgrades, um das Wallet-dApp-Erlebnis noch besser zu machen.

Mit v2 können Ihre Benutzer jetzt gleichzeitig mehrere Chains verbinden, sodass Sie den Chain-Switching-Handshake vergessen können. Es erweitert auch die Unterstützung für mehr Netzwerke und bringt Verbesserungen, die das Sign-in mit Ethereum noch schneller machen.

Aktualisierung Ihrer dApp

Wenn Sie bereits die Migrationsleitfäden für RainbowKit 0.12.x und 1.0.x befolgt haben, sind Sie fast am Ziel! Aktualisieren Sie einfach auf die neueste Patch-Version und probieren Sie es aus.

RainbowKit hat WalletConnect v2 standardmäßig mit 0.12.15 und 1.0.2 aktiviert. Wir unterstützen weiterhin 0.12.x, falls Ihre dApp noch nicht auf Wagmi v1 und RainbowKit v1 aktualisiert wurde.

1. Aktualisierung der Abhängigkeiten

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

Wenn Sie eine Version von RainbowKit vor 0.12.x oder 1.0.x verwenden, folgen Sie einfach den Migrationsleitfäden, um auf den neuesten Stand zu kommen.

Es wird empfohlen, dass 0.12.x dApps beginnen, auf Wagmi v1 zu aktualisieren, da Stabilitätsverbesserungen für WalletConnect v2 nur in zukünftigen Versionen von Wagmi enthalten sein werden.

2. Bereitstellung einer projectId

Jede dApp, die auf WalletConnect angewiesen ist, muss jetzt eine projectId von WalletConnect Cloud erhalten. Dies ist absolut kostenlos und dauert nur wenige Minuten.

Geben Sie Ihre projectId in getDefaultWallets und in individuellen Wallet-Verbindern von RainbowKit wie folgt an:

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 ist typsicher und warnt Sie, wenn eine projectId fehlt. Sehen Sie sich unsere Beispiele an, um v2 in Aktion zu sehen:

Schauen Sie in die Dokumentation für weitere unterstützte Optionen.