Skip to main content
Migrar do Privy é uma migração de código, não uma migração de carteira. Você troca o provedor e o hook do Privy pelo do Helius — o modelo mental (incorporado, não custodial, login social/passkey) é o mesmo. O que não é transferido são as carteiras existentes dos seus usuários: as carteiras do Privy não podem ser importadas para o Turnkey, então cada usuário obtém uma nova carteira incorporada Helius na primeira vez que fizer login no seu aplicativo. A outra grande mudança é a economia: o Privy cobra por carteira ativa mensalmente além do seu RPC, enquanto o Helius cobra 200 créditos por assinatura através dos créditos que você já possui.

​
O que migra — e o que não migra

  • Migra (sua integração): o provedor, hook, configuração de login e RPC. Esta é a troca de código nos passos abaixo — geralmente algumas horas de trabalho.
  • Não migra (carteiras dos seus usuários): carteiras, chaves e saldos Privy existentes. O Turnkey não pode importá-las, então cada usuário cria uma nova carteira incorporada Helius no primeiro login.
Se você tem 1.000 usuários Privy com fundos: após a migração, cada um faz login e obtém uma nova carteira incorporada Helius vazia em um endereço diferente. Os saldos do Privy permanecem nas carteiras antigas. Mover os fundos é um passo separado, iniciado pelo usuário que você orquestra (veja Carteiras e fundos dos seus usuários) — nem Helius nem Turnkey podem mover fundos em nome de um usuário.

​
Mapeamentos Privy para Helius WaaS

​
Migre sua integração

Estas etapas trocam seu código de Privy para Helius. Nenhuma delas toca nas carteiras dos usuários finais — isso é abordado abaixo.
1

Troque o provedor

Substitua PrivyProvider por HeliusWalletProvider e passe sua chave de API Helius em vez do seu Privy appId. Veja Configuração.
2

Troque o hook

Substitua chamadas usePrivy() / useSolanaWallets() por useHeliusWallet(). login, logout, user, e exportWallet mapeiam diretamente; a assinatura se move para o mesmo hook (signTransaction, signAndSendTransaction, signMessage).
3

Mova a configuração de autenticação para o painel

Configure seus métodos de login no painel em WaaS → Configuration em vez de nos props do provedor — veja Configurar métodos de login.
4

Direcione o RPC para o Helius

O envio já é roteado através do Helius. Remova sua configuração de provedor RPC independente e use connection / rpcUrl do hook, ou adicione o manipulador de rota para um pouso otimizado para o Sender.

​
Carteiras e fundos dos seus usuários

No primeiro login após a implantação da troca, cada usuário recebe uma nova carteira incorporada Helius — um endereço diferente da carteira do Privy, com saldo zero. As carteiras antigas do Privy e seus fundos permanecem intocados. Se você precisar que os usuários mantenham seus saldos existentes, planeje uma janela de migração:
1

Apresente o novo endereço

Mostre a cada usuário logado seu novo endereço Helius (address do useHeliusWallet()).
2

Faça com que os usuários movam seus fundos

Os usuários transferem fundos de suas antigas carteiras Privy para o novo endereço Helius. Esta é uma ação por usuário, iniciada pelo usuário — nem Helius nem Turnkey podem mover fundos em seu nome.
3

Retire a antiga integração

Depois que os usuários estiverem em suas carteiras Helius, remova o SDK Privy.
Os usuários não podem simplesmente continuar usando sua carteira existente? Não como um substituto para a carteira incorporada. A carteira externa é oferecida como um método de login — ela autentica um usuário em uma carteira incorporada Helius, não opera diretamente as chaves da carteira externa. Assinar diretamente de uma carteira externa ignoraria totalmente o Helius (sem assinatura do Turnkey, sem medição), portanto, não é um substituto para a carteira incorporada em que seu aplicativo opera.