Skip to main content

Instalação

Instale helius-wallet-kit do npm (Node.js 18+):
Dependências peer obrigatórias:
  • react >= 18
  • react-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 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
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.
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 /api/helius/[...path]:
app/api/helius/[...path]/route.ts
Defina 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.