移行されるものとされないもの
- 移行される(あなたの統合): プロバイダー、フック、サインイン設定、RPC。これは以下のステップでのコードの置き換えで、通常数時間の作業です。
- 移行されない(ユーザーのウォレット): 既存のPrivyウォレット、キー、残高。Turnkeyではインポートできないため、各ユーザーは初回サインイン時に新しいHelius埋め込みウォレットを作成します。
PrivyからHelius WaaSへのマッピング
統合を移行する
これらのステップは、PrivyからHeliusへのコードの置き換えを行います。いずれもエンドユーザーのウォレットには触れません — それはこちらで取り扱います。1
プロバイダーを入れ替える
PrivyProviderをHeliusWalletProviderに置き換え、PrivyのappIdの代わりにHeliusのAPIキーを渡します。セットアップを参照してください。2
フックを入れ替える
usePrivy() / useSolanaWallets()の呼び出しをuseHeliusWallet()に置き換えます。login、logout、user、およびexportWalletは直接マップされ、署名は同じフックに移行します(signTransaction、signAndSendTransaction、signMessage)。3
認証設定をダッシュボードに移動
サインイン方法をプロバイダーのプロップスではなく、ダッシュボードのWaaS → Configurationで設定します。サインイン方法の設定を参照してください。
4
RPCをHeliusに向ける
送信はすでにHeliusを経由しています。スタンドアロンのRPCプロバイダー設定を削除し、フックから
connection / rpcUrlを使用するか、Sender-optimized landing用にルートハンドラーを追加します。ユーザーのウォレットと資金
置き換えを出荷後初回サインイン時に、各ユーザーは全く新しい埋め込み型Heliusウォレットを取得します — それはPrivyウォレットとは異なるアドレスで、残高はゼロです。古いPrivyウォレットとその資金はそのままです。 ユーザーに既存の残高を維持させる必要がある場合、移行ウィンドウを計画してください。1
新しいアドレスを表示
サインインした各ユーザーに新しいHeliusアドレスを表示します(
address from useHeliusWallet())。2
ユーザーに資金を移動させる
ユーザーは古いPrivyウォレットから新しいHeliusアドレスに資金を転送します。これは各ユーザーが自発的に行うアクションであり、HeliusやTurnkeyが代理で資金を移動することはできません。
3
古い統合を退役させる
ユーザーがHeliusウォレットに移行したら、Privy SDKを削除します。
ユーザーは既存のウォレットをそのまま使用できないのですか? 埋め込みウォレットの代わりとしてはできません。外部ウォレットはサインイン方法として提供され、Helius埋め込みウォレットにユーザーを認証するだけで、外部ウォレットのキーを直接操作するものではありません。外部ウォレットから直接署名すると、Heliusを完全にバイパスすることになります(Turnkeyの署名なし、メータリングなし)ので、アプリで動作する埋め込みウォレットの代替とはなりません。