Instalação
Instalehelius-wallet-kit do npm (Node.js 18+):
react >= 18react-dom >= 18@solana/web3.js ^1.98
next >= 14 é um peer opcional — instale-o se você usar o manipulador de rota do servidor.
Configuração
1
Envolva seu app no provedor
Adicione Você escolhe quais métodos de login seus usuários veem no painel — veja Configurar métodos de login. Como a chave do cliente é exposta no navegador, restrinja-a aos seus domínios — veja Protegendo sua chave.
HeliusWalletProvider próximo à raiz do seu app em um componente cliente e passe sua chave de API Helius. Esta é a única configuração necessária — o SDK resolve seu ID do projeto e URLs Secure RPC sem chave automaticamente.app/providers.tsx
2
Importe os estilos
Importe a folha de estilos do SDK uma vez, no layout raiz:
app/layout.tsx
3
(Opcional) Adicione o manipulador de rota do servidor
Por padrão, o SDK se comunica com o Helius diretamente do navegador usando seus URLs Secure RPC sem chave do projeto — sem necessidade de rota de servidor. Para rotear suas chamadas de RPC, envio e histórico de transações através do seu próprio servidor (e para usar Página de destino otimizada para remetente e histórico de transações), monte o manipulador de rota abrangente em Defina
/api/helius/[...path]:app/api/helius/[...path]/route.ts
HELIUS_API_KEY como uma variável de ambiente do servidor; o manipulador a injeta nessas solicitações encaminhadas.A inicialização da carteira ainda usa seu
apiKey no lado do cliente — é passada
para o provedor config e enviada para /waas/config do navegador — então
a chave está presente no navegador mesmo com o manipulador de rota. Use uma
chave restrita por domínio (defina origens permitidas na chave no seu
painel), restrita à origem do seu app, e rotacione-a se necessário. O gerenciamento
de chave totalmente no lado do servidor está no roadmap. Veja Protegendo sua
chave para detalhes completos.Próximos passos
Configuração
Opções de configuração e métodos de login do painel.
Usando a carteira
Leia o estado de autenticação, assine, envie e leia o histórico.