Skip to main content
Migrar desde Privy es una migración de código, no una migración de billeteras. Sustituyes el proveedor y el hook de Privy por los de Helius; el modelo conceptual (integrado, sin custodia e inicio de sesión con redes sociales o passkeys) es el mismo. Lo que no se transfiere son las billeteras existentes de tus usuarios: las billeteras de Privy no se pueden importar a Turnkey, por lo que cada usuario recibe una nueva billetera integrada de Helius la primera vez que inicia sesión en tu aplicación. El otro gran cambio es el modelo económico: Privy cobra por cada billetera activa mensualmente, además de tu RPC, mientras que Helius cobra 200 créditos por firma mediante los créditos que ya tienes.

​
Qué se migra y qué no

  • Se migra (tu integración): el proveedor, el hook, la configuración de inicio de sesión y el RPC. Este es el cambio de código que se describe en los pasos siguientes y, por lo general, requiere unas pocas horas de trabajo.
  • No se migran (las billeteras de tus usuarios): las billeteras, claves y saldos existentes de Privy. Turnkey no puede importarlos, por lo que cada usuario crea una nueva billetera integrada de Helius cuando inicia sesión por primera vez.
Si tienes 1,000 usuarios de Privy con fondos: después de la migración, cada uno inicia sesión y recibe una nueva billetera integrada de Helius vacía con una dirección diferente. Sus saldos de Privy permanecen en las billeteras anteriores. Mover los fondos es un paso aparte, iniciado por el usuario y coordinado por ti (consulta Las billeteras y los fondos de tus usuarios); ni Helius ni Turnkey pueden mover fondos en nombre de un usuario.

​
Equivalencias entre Privy y Helius WaaS

​
Migra tu integración

Estos pasos migran tu código de Privy a Helius. Ninguno de ellos modifica las billeteras de los usuarios finales; eso se explica más adelante.
1

Swap the provider

Sustituye PrivyProvider por HeliusWalletProvider y pasa tu clave de API de Helius en lugar de tu appId de Privy. Consulta Configuración.
2

Swap the hook

Sustituye las llamadas a usePrivy() / useSolanaWallets() por useHeliusWallet(). login, logout, user e exportWallet se asignan directamente; la firma pasa al mismo hook (signTransaction, signAndSendTransaction, signMessage).
3

Move auth config to the dashboard

Configura tus métodos de inicio de sesión en el panel, en WaaS → Configuration, en lugar de hacerlo en las propiedades del proveedor. Consulta Configurar métodos de inicio de sesión.
4

Point RPC at Helius

Los envíos ya se enrutan mediante Helius. Elimina la configuración de tu proveedor de RPC independiente y usa connection / rpcUrl del hook, o agrega el controlador de ruta para obtener una inclusión optimizada por Sender.

​
Las billeteras y los fondos de tus usuarios

La primera vez que cada usuario inicia sesión después de que implementes el cambio, recibe una billetera integrada de Helius completamente nueva, con una dirección diferente de la de su billetera de Privy y saldo cero. Las billeteras antiguas de Privy y sus fondos permanecen intactos. Si necesitas que los usuarios conserven sus saldos existentes, planifica una ventana de migración:
1

Surface the new address

Muestra a cada usuario que haya iniciado sesión su nueva dirección de Helius (address de useHeliusWallet()).
2

Have users move their funds

Los usuarios transfieren los fondos de su billetera antigua de Privy a su nueva dirección de Helius. Esta es una acción individual iniciada por cada usuario; ni Helius ni Turnkey pueden mover fondos en su nombre.
3

Retire the old integration

Una vez que los usuarios estén usando sus billeteras de Helius, elimina el SDK de Privy.
¿Los usuarios no pueden seguir usando su billetera existente? No como sustituto de la billetera integrada. La billetera externa se ofrece como método de inicio de sesión: autentica al usuario en una billetera integrada de Helius, pero no opera directamente las claves de la billetera externa. Firmar directamente desde una billetera externa omitiría Helius por completo (sin firma de Turnkey ni medición), por lo que no sustituye a la billetera integrada en la que se ejecuta tu aplicación.