Skip to main content
O Helius TypeScript SDK (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:

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:
Isso ocorre quando uma solicitação tem parâmetros inválidos.
Isso ocorre quando uma chave de API inválida é fornecida ou o acesso é restrito devido a regras RPC.
Isso indica que o usuário excedeu o limite de solicitações em um determinado período ou está sem créditos.
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.
Se você encontrar algum desses erros:
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

Contribuindo

Acolhemos todas as contribuições aos nossos SDKs! Leia o guia de contribuições antes de abrir um pull request.