> ## 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.

# Privyからの移行

> 既存のPrivy埋め込み型ウォレットアプリをHelius Wallet-as-a-Serviceに移行

Privyからの移行は**ウォレットの移行ではなく、コードの移行**です。PrivyのプロバイダーとフックをHeliusのものに置き換えるだけで、メンタルモデル（埋め込み型、非管理型、ソーシャル/パスキーでのログイン）は同じです。引き継がれないのはユーザーの既存ウォレットです。PrivyウォレットはTurnkeyにインポートできないため、各ユーザーはアプリにサインインした際に**新しいHelius埋め込みウォレットを取得**します。

もう一つの大きな変化は経済面です。Privyは月間アクティブウォレット単位で課金し、Heliusは既に持っている[クレジット](/ja/billing/credits)を利用して署名ごとに200クレジットを請求します。

## 移行されるものとされないもの

* **移行される（あなたの統合）：** プロバイダー、フック、サインイン設定、RPC。これは[以下のステップ](#migrate-your-integration)でのコードの置き換えで、通常数時間の作業です。
* **移行されない（ユーザーのウォレット）：** 既存のPrivyウォレット、キー、残高。Turnkeyではインポートできないため、各ユーザーは初回サインイン時に新しいHelius埋め込みウォレットを作成します。

<Warning>
  **1,000人のPrivyユーザーが資金を持っている場合：** 移行後、各ユーザーはサイン
  インして、別のアドレスに**新しく空の**Helius埋め込みウォレットを取得します。
  彼らのPrivy残高は古いウォレットに残ります。移行は、ユーザーが自ら行う別のステップです（[ユーザーのウォレットと資金](#your-users-wallets-and-funds)を参照）— HeliusもTurnkeyもユーザーの代わりに資金を移動することはできません。
</Warning>

## PrivyからHelius WaaSへのマッピング

| Privy                                    | Helius WaaS                                                                              |
| ---------------------------------------- | ---------------------------------------------------------------------------------------- |
| `PrivyProvider` with `appId`             | `HeliusWalletProvider` with `{ apiKey }`                                                 |
| `usePrivy()` — `login`, `logout`, `user` | `useHeliusWallet()` — `login`, `logout`, `user`, `status`                                |
| `useSolanaWallets()` / embedded wallet   | `address`, `signTransaction`, `signAndSendTransaction`, `signMessage` from the same hook |
| Login methods set in the Privy dashboard | Sign-in methods set in Helius dashboard (**WaaS → Configuration**)                       |
| `exportWallet()`                         | `exportWallet()`                                                                         |
| Per-MAU billing + separate RPC provider  | One bill: 200 credits / signature via Helius credits, RPC included                       |

## 統合を移行する

これらのステップは、PrivyからHeliusへのコードの置き換えを行います。いずれもエンドユーザーのウォレットには触れません — それは[こちらで](#your-users-wallets-and-funds)取り扱います。

<Steps>
  <Step title="プロバイダーを入れ替える">
    `PrivyProvider`を`HeliusWalletProvider`に置き換え、Privyの`appId`の代わりにHeliusのAPIキーを渡します。[セットアップ](/ja/waas/quickstart#setup)を参照してください。
  </Step>

  <Step title="フックを入れ替える">
    `usePrivy()` / `useSolanaWallets()`の呼び出しを`useHeliusWallet()`に置き換えます。`login`、`logout`、`user`、および`exportWallet`は直接マップされ、署名は同じフックに移行します（`signTransaction`、`signAndSendTransaction`、`signMessage`）。
  </Step>

  <Step title="認証設定をダッシュボードに移動">
    サインイン方法をプロバイダーのプロップスではなく、ダッシュボードの**WaaS → Configuration**で設定します。[サインイン方法の設定](/ja/waas/configuration#configure-sign-in-methods)を参照してください。
  </Step>

  <Step title="RPCをHeliusに向ける">
    送信はすでにHeliusを経由しています。スタンドアロンのRPCプロバイダー設定を削除し、フックから`connection` / `rpcUrl`を使用するか、Sender-optimized landing用に[ルートハンドラー](/ja/waas/quickstart#setup)を追加します。
  </Step>
</Steps>

## ユーザーのウォレットと資金

置き換えを出荷後初回サインイン時に、各ユーザーは**全く新しい埋め込み型Heliusウォレット**を取得します — それはPrivyウォレットとは異なるアドレスで、残高はゼロです。古いPrivyウォレットとその資金はそのままです。

ユーザーに既存の残高を維持させる必要がある場合、**移行ウィンドウ**を計画してください。

<Steps>
  <Step title="新しいアドレスを表示">
    サインインした各ユーザーに新しいHeliusアドレスを表示します（`address` from `useHeliusWallet()`）。
  </Step>

  <Step title="ユーザーに資金を移動させる">
    ユーザーは古いPrivyウォレットから新しいHeliusアドレスに資金を転送します。これは各ユーザーが自発的に行うアクションであり、HeliusやTurnkeyが代理で資金を移動することはできません。
  </Step>

  <Step title="古い統合を退役させる">
    ユーザーがHeliusウォレットに移行したら、Privy SDKを削除します。
  </Step>
</Steps>

<Note>
  **ユーザーは既存のウォレットをそのまま使用できないのですか？** 埋め込みウォレットの代わりとしてはできません。外部ウォレットは**サインイン方法**として提供され、Helius埋め込みウォレットにユーザーを認証するだけで、外部ウォレットのキーを直接操作するものではありません。外部ウォレットから直接署名すると、Heliusを完全にバイパスすることになります（Turnkeyの署名なし、メータリングなし）ので、アプリで動作する埋め込みウォレットの代替とはなりません。
</Note>