Skip to main content
Bermigrasi dari Privy adalah migrasi kode, bukan migrasi dompet. Anda mengganti penyedia dan hook Privy dengan milik Helius — model mentalnya (tertanam, nonkustodial, login sosial/passkey) tetap sama. Hal yang tidak ikut dipindahkan adalah dompet pengguna Anda yang sudah ada: dompet Privy tidak dapat diimpor ke Turnkey, sehingga setiap pengguna mendapatkan dompet tertanam Helius baru saat pertama kali masuk ke aplikasi Anda. Perubahan besar lainnya adalah aspek ekonomi: Privy mengenakan biaya per dompet aktif bulanan di luar biaya RPC Anda, sedangkan Helius mengenakan 200 kredit per tanda tangan melalui kredit yang sudah Anda miliki.

​
Yang dimigrasikan — dan yang tidak

  • Dimigrasikan (integrasi Anda): penyedia, hook, konfigurasi masuk, dan RPC. Ini adalah penggantian kode dalam langkah-langkah di bawah — biasanya memerlukan beberapa jam kerja.
  • Tidak dimigrasikan (dompet pengguna Anda): dompet, kunci, dan saldo Privy yang sudah ada. Turnkey tidak dapat mengimpornya, sehingga setiap pengguna membuat dompet tertanam Helius baru saat pertama kali masuk.
Jika Anda memiliki 1.000 pengguna Privy dengan dana: setelah Anda bermigrasi, setiap pengguna masuk dan mendapatkan dompet tertanam Helius yang baru dan kosong di alamat yang berbeda. Saldo Privy mereka tetap berada di dompet lama. Memindahkan dana adalah langkah terpisah yang dimulai oleh pengguna dan Anda atur (lihat Dompet dan dana pengguna Anda) — baik Helius maupun Turnkey tidak dapat memindahkan dana atas nama pengguna.

​
Pemetaan Privy ke Helius WaaS

​
Migrasikan integrasi Anda

Langkah-langkah ini mengganti kode Anda dari Privy ke Helius. Tidak ada langkah yang menyentuh dompet pengguna akhir — hal tersebut dibahas di bawah.
1

Swap the provider

Ganti PrivyProvider dengan HeliusWalletProvider dan teruskan kunci API Helius Anda sebagai pengganti appId Privy. Lihat Penyiapan.
2

Swap the hook

Ganti pemanggilan usePrivy() / useSolanaWallets() dengan useHeliusWallet(). login, logout, user, dan exportWallet dipetakan secara langsung; penandatanganan dipindahkan ke hook yang sama (signTransaction, signAndSendTransaction, signMessage).
3

Move auth config to the dashboard

Konfigurasikan metode masuk Anda di dasbor pada WaaS → Configuration, bukan di properti penyedia — lihat Konfigurasikan metode masuk.
4

Point RPC at Helius

Pengiriman sudah dirutekan melalui Helius. Hapus konfigurasi penyedia RPC mandiri Anda dan gunakan connection / rpcUrl dari hook, atau tambahkan handler rute untuk pendaratan yang dioptimalkan Sender.

​
Dompet dan dana pengguna Anda

Saat pertama kali masuk setelah Anda merilis penggantian tersebut, setiap pengguna mendapatkan dompet tertanam Helius yang benar-benar baru — dengan alamat yang berbeda dari dompet Privy mereka dan saldo nol. Dompet Privy lama beserta dananya tidak berubah. Jika pengguna harus mempertahankan saldo yang sudah ada, rencanakan periode migrasi:
1

Surface the new address

Tampilkan alamat Helius baru kepada setiap pengguna yang telah masuk (address dari useHeliusWallet()).
2

Have users move their funds

Pengguna mentransfer dana dari dompet Privy lama ke alamat Helius baru mereka. Ini adalah tindakan per pengguna yang dimulai oleh pengguna — baik Helius maupun Turnkey tidak dapat memindahkan dana atas nama mereka.
3

Retire the old integration

Setelah pengguna beralih ke dompet Helius, hapus SDK Privy.
Tidak bisakah pengguna tetap menggunakan dompet mereka yang sudah ada? Tidak sebagai pengganti dompet tertanam. Dompet eksternal ditawarkan sebagai metode masuk — metode ini mengautentikasi pengguna ke dompet tertanam Helius, tetapi tidak mengoperasikan kunci dompet eksternal secara langsung. Penandatanganan langsung dari dompet eksternal akan sepenuhnya melewati Helius (tanpa penandatanganan Turnkey, tanpa pengukuran penggunaan), sehingga dompet tersebut tidak dapat menggantikan dompet tertanam yang digunakan aplikasi Anda.