> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bermigrasi dari Privy

> Pindahkan aplikasi dompet tertanam Privy yang ada ke Helius Wallet-as-a-Service

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](/docs/id/billing/credits) 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](#migrasikan-integrasi-anda) — 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.

<Warning>
  **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](#dompet-dan-dana-pengguna-anda)) — baik Helius maupun Turnkey tidak dapat memindahkan
  dana atas nama pengguna.
</Warning>

## Pemetaan Privy ke Helius WaaS

| Privy                                     | Helius WaaS                                                                               |
| ----------------------------------------- | ----------------------------------------------------------------------------------------- |
| `PrivyProvider` dengan `appId`            | `HeliusWalletProvider` dengan `{ apiKey }`                                                |
| `usePrivy()` — `login`, `logout`, `user`  | `useHeliusWallet()` — `login`, `logout`, `user`, `status`                                 |
| `useSolanaWallets()` / dompet tertanam    | `address`, `signTransaction`, `signAndSendTransaction`, `signMessage` dari hook yang sama |
| Metode login diatur di dasbor Privy       | Metode masuk diatur di dasbor Helius (**WaaS → Configuration**)                           |
| `exportWallet()`                          | `exportWallet()`                                                                          |
| Penagihan per MAU + penyedia RPC terpisah | Satu tagihan: 200 kredit / tanda tangan melalui kredit Helius, termasuk RPC               |

## 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](#dompet-dan-dana-pengguna-anda).

<Steps>
  <Step title="Swap the provider">
    Ganti `PrivyProvider` dengan `HeliusWalletProvider` dan teruskan kunci API Helius Anda sebagai pengganti `appId` Privy. Lihat [Penyiapan](/docs/id/waas/quickstart#penyiapan).
  </Step>

  <Step title="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`).
  </Step>

  <Step title="Move auth config to the dashboard">
    Konfigurasikan metode masuk Anda di dasbor pada **WaaS → Configuration**, bukan di properti penyedia — lihat [Konfigurasikan metode masuk](/docs/id/waas/configuration#konfigurasikan-metode-masuk).
  </Step>

  <Step title="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](/docs/id/waas/quickstart#penyiapan) untuk pendaratan yang dioptimalkan Sender.
  </Step>
</Steps>

## 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**:

<Steps>
  <Step title="Surface the new address">
    Tampilkan alamat Helius baru kepada setiap pengguna yang telah masuk (`address` dari `useHeliusWallet()`).
  </Step>

  <Step title="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.
  </Step>

  <Step title="Retire the old integration">
    Setelah pengguna beralih ke dompet Helius, hapus SDK Privy.
  </Step>
</Steps>

<Note>
  **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.
</Note>