Skip to main content
Na Helius, desenvolvemos um Node.js e um Rust SDK para facilitar o desenvolvimento no Solana. A página a seguir inclui informações sobre a instalação e uso desses SDKs. Também aborda o tratamento comum de erros, onde encontrar a documentação mais recente e como contribuir para esses SDKs. Também descrevemos uma lista de SDKs não oficiais criados pela nossa maravilhosa comunidade. Observe que esses SDKs não são mantidos oficialmente pela nossa equipe — apenas os SDKs de Node.js e Rust são.

SDK Node.js

SDK Node.js oficial da Helius para desenvolvimento Solana

SDK Rust

SDK Rust oficial da Helius para desenvolvimento Solana

SDK Node.js

Observe que o SDK Node.js foi reescrito na versão 2.0.0. Isso foi feito para usar @solana/kit e remover a dependência de @solana/web3.js versões superiores a 1.73.2. Para aqueles que estão migrando para a versão mais recente, consulte nosso guia de migração.

Instalação

O SDK Node.js da Helius pode ser instalado com qualquer um dos seguintes gerenciadores de pacotes:

Início Rápido

Abaixo está um exemplo simples de como usar o SDK Node.js para buscar uma lista de ativos pertencentes a um determinado endereço:

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 a documentação de referência da API, consulte nossa documentação e a documentação oficial do Solana para ajuda geral com a API JSON RPC do Solana. Para ajuda geral com o Kit, consulte a documentação do Kit.

SDK Rust

Instalação

1

Adicionar dependência ao Cargo.toml

Para começar a usar o SDK Rust da Helius em seu projeto, adicione-o como uma dependência via cargo. Abra o Cargo.toml do seu projeto e adicione a seguinte linha sob [dependencies]:
onde x.y.z é a versão desejada.
2

Alternativa: Use o comando cargo add

Alternativamente, use cargo add helius para adicionar a dependência diretamente via linha de comando. Isso encontrará automaticamente a versão mais recente compatível com o seu projeto e a adicionará ao seu Cargo.toml.
3

Mantenha seu SDK atualizado

Lembre-se de executar cargo update regularmente para obter a versão mais recente do SDK.

Início Rápido

Abaixo está um exemplo simples de uso da Enhanced Transactions API para analisar uma transação específica:

Documentação

Docs Rust

Documentação mais recente no docs.rs

Referência da API

Documentação da API Helius

Exemplos

Exemplos de código no repositório GitHub

Tratamento de Erros

Uma mensagem de erro será lançada quando a API retornar um status de não-sucesso (ou seja, código 4xx ou 5xx).
Por exemplo, abaixo está um erro 401 gerado por uma chamada incorreta de getAsset usando o SDK Node.js:

Códigos de Erro Comuns

Ao trabalhar com o SDK Helius, 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 ajudar na solução de problemas:
Isso ocorre quando uma solicitação possui 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 de tempo ou está sem créditos.
Esta é uma mensagem de erro genérica para problemas do lado do servidor. 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 errors.rs para uma lista de todos os erros possíveis retornados pelo cliente Helius, se estiver usando o SDK Rust. Para o SDK Node.js, consulte erros do Kit
2

Revise a documentação

Consulte a documentação da Helius para mais orientações
3

Entre em contato com o suporte

Entre em contato com a equipe de suporte da Helius para assistência mais detalhada

Contribuição para Nossos SDKs

Agradecemos todas as contribuições para nossos SDKs! Se estiver interessado, aqui estão nossos repositórios GitHub:

SDK Node.js

Contribua para nosso SDK Node.js

SDK Rust

Contribua para nosso SDK Rust
Interessado em contribuir especificamente para o SDK Rust da Helius? Leia o seguinte guia de contribuições antes de abrir um pull request!

SDKs da Comunidade Não Oficiais

Nossos membros incríveis da comunidade também criaram seus próprios SDKs para interagir com nossas APIs REST. Observe que nossa equipe não mantém oficialmente esses SDKs.

SDK Kotlin

SDK PHP

SDK Python

SDK Rust (Síncrono)

SDK Rust (Assíncrono)