Skip to main content
Die Migration von Privy ist eine Code-Migration, keine Wallet-Migration. Sie tauschen den Privy-Anbieter und Hook gegen die von Helius aus — das mentale Modell (eingebettet, nicht verwahrend, soziale/Passkey-Anmeldung) bleibt dasselbe. Was nicht übernommen wird, sind die bestehenden Wallets Ihrer Nutzer: Privy-Wallets können nicht in Turnkey importiert werden, sodass jeder Nutzer ein neues Helius Embedded Wallet erhält, wenn er sich zum ersten Mal bei Ihrer App anmeldet. Die andere große Änderung betrifft die Wirtschaftlichkeit: Privy rechnet pro monatlich aktivem Wallet zusätzlich zu Ihrem RPC ab, während Helius 200 Credits pro Signatur über die Credits berechnet, die Sie bereits haben.

​
Was migriert — und was nicht

  • Migriert (Ihre Integration): der Anbieter, Hook, Anmeldekonfiguration und RPC. Dies ist der Code-Austausch in den Schritten unten — normalerweise ein paar Stunden Arbeit.
  • Nicht migriert (die Wallets Ihrer Nutzer): bestehende Privy-Wallets, Schlüssel und Guthaben. Turnkey kann diese nicht importieren, daher erstellt jeder Nutzer ein neues Helius-Embedded-Wallet bei der ersten Anmeldung.
Wenn Sie 1.000 Privy-Nutzer mit Guthaben haben: Nach der Migration meldet sich jeder an und erhält ein neues, leeres Helius Embedded Wallet an einer anderen Adresse. Ihre Privy-Guthaben bleiben in den alten Wallets. Das Verschieben der Gelder ist ein separater, vom Nutzer initiierter Schritt, den Sie orchestrieren (siehe Die Wallets und Guthaben Ihrer Nutzer) — weder Helius noch Turnkey können Gelder im Namen eines Nutzers bewegen.

​
Privy-Zuordnungen zu Helius WaaS

​
Migrieren Sie Ihre Integration

Diese Schritte tauschen Ihren Code von Privy zu Helius aus. Keiner von ihnen betrifft Endnutzer-Wallets — das wird unten behandelt.
1

Tauschen Sie den Anbieter aus

Ersetzen Sie PrivyProvider durch HeliusWalletProvider und übergeben Sie Ihren Helius-API-Schlüssel anstelle Ihres Privy appId. Siehe Setup.
2

Tauschen Sie den Hook aus

Ersetzen Sie usePrivy() / useSolanaWallets()-Anrufe durch useHeliusWallet(). login, logout, user und exportWallet ordnen sich direkt zu; das Signieren bewegt sich auf denselben Hook (signTransaction, signAndSendTransaction, signMessage).
3

Verschieben Sie die Authentifizierungskonfiguration zum Dashboard

Konfigurieren Sie Ihre Anmeldemethoden im Dashboard unter WaaS → Konfiguration anstelle von Anbietereigenschaften — siehe Anmeldemethoden konfigurieren.
4

Zeigen Sie RPC auf Helius

Das Senden wird bereits über Helius geleitet. Lassen Sie Ihre eigenständige RPC-Anbieter-Konfiguration fallen und verwenden Sie den connection / rpcUrl vom Hook, oder fügen Sie den Routen-Handler für eine senderoptimierte Landung hinzu.

​
Die Wallets und Guthaben Ihrer Nutzer

Bei der ersten Anmeldung, nachdem Sie den Swap verschifft haben, erhält jeder Nutzer ein brandneues Helius Embedded Wallet — eine andere Adresse als ihr Privy-Wallet, mit einem Null-Saldo. Alte Privy-Wallets und deren Guthaben bleiben unberührt. Wenn Sie möchten, dass die Nutzer ihre bestehenden Guthaben behalten, planen Sie ein Migrationsfenster:
1

Zeigen Sie die neue Adresse an

Zeigen Sie jedem eingeloggten Nutzer seine neue Helius-Adresse (address von useHeliusWallet()) an.
2

Lassen Sie die Nutzer ihre Gelder verschieben

Nutzer übertragen Gelder von ihrem alten Privy-Wallet auf ihre neue Helius-Adresse. Dies ist eine pro Nutzer, vom Nutzer initiierte Aktion — weder Helius noch Turnkey können Gelder im Namen der Nutzer bewegen.
3

Setzen Sie die alte Integration außer Betrieb

Sobald die Nutzer auf ihren Helius-Wallets sind, entfernen Sie das Privy-SDK.
Können die Nutzer nicht einfach ihr bestehendes Wallet weiterverwenden? Nicht als Ersatz für das Embedded Wallet. Externes Wallet wird als Anmeldemethode angeboten — es authentifiziert einen Nutzer in ein Helius Embedded Wallet, es verwaltet nicht direkt die Schlüssel des externen Wallets. Das direkte Signieren von einem externen Wallet würde Helius vollständig umgehen (kein Turnkey-Signieren, kein Messen), daher ist es kein Ersatz für das Embedded Wallet, auf dem Ihre App läuft.