helius-sdk) facilita o desenvolvimento em Solana usando TypeScript — no Node.js, no navegador ou em qualquer outro runtime. Esta página abrange a instalação e o uso do SDK, tratamento de erros comuns e onde encontrar a documentação mais recente.
Observe que o SDK foi reescrito a partir da versão 2.0.0. Isso foi feito para usar @solana/kit e remover a dependência de versões @solana/web3.js superiores a 1.73.2. Para aqueles que estão migrando para a versão mais recente, consulte nosso guia de migração.
Repositório GitHub
SDK oficial Helius TypeScript para desenvolvimento Solana
Instalação
O Helius TypeScript SDK pode ser instalado com qualquer um dos seguintes gerenciadores de pacotes:- npm
- pnpm
- Yarn
Início Rápido
Abaixo está um exemplo simples de como usar o TypeScript SDK para buscar uma lista de ativos possuídos por um endereço específico:Documentação
O diretório de exemplos está repleto de exemplos de código detalhados que cobrem cada método e uso básico, organizados por namespace. Para documentação de referência da API, consulte nossa documentação e a documentação oficial do Solana para ajuda geral com a Solana JSON RPC API. Para ajuda geral com o Kit, consulte a documentação do Kit.Tratamento de Erros
Uma mensagem de erro será lançada quando a API retornar um resultado sem sucesso (ou seja, código de status 4xx ou 5xx). Por exemplo, abaixo está um 401 lançado para uma chamada incorreta de getAsset:Códigos de Erro Comuns
Ao trabalhar com o Helius SDK, você pode encontrar vários códigos de erro. Abaixo está uma tabela detalhando alguns dos códigos de erro comuns juntamente com informações adicionais para ajudá-lo na solução de problemas:400: Solicitação Incorreta
400: Solicitação Incorreta
Isso ocorre quando uma solicitação tem parâmetros inválidos.
401: Não Autorizado
401: Não Autorizado
Isso ocorre quando uma chave de API inválida é fornecida ou o acesso é restrito devido a regras RPC.
429: Muitas Solicitações
429: Muitas Solicitações
Isso indica que o usuário excedeu o limite de solicitações em um determinado período ou está sem créditos.
5XX: Erro Interno do Servidor
5XX: Erro Interno do Servidor
Esta é uma mensagem de erro genérica para problemas no lado do servidor. Por favor, entre em contato com o suporte da Helius para assistência.
1
Verifique a documentação de erros
Consulte erros do Kit para uma lista dos erros que você pode encontrar
2
Revise a documentação
Consulte a documentação Helius para mais orientações
3
Entre em contato com o suporte
Entre em contato com a equipe de suporte da Helius para obter assistência mais detalhada