> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Helius Solana TypeScript SDK

> SDK oficial Helius TypeScript para desenvolvimento Solana. Instale o helius-sdk, execute sua primeira consulta e trate erros com uma API abrangente, transações aprimoradas e suporte a DAS.

O Helius TypeScript SDK ([`helius-sdk`](https://github.com/helius-labs/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](https://github.com/helius-labs/helius-sdk/blob/main/MIGRATION.md).

<CardGroup cols={1}>
  <Card title="Repositório GitHub" icon="js" href="https://github.com/helius-labs/helius-sdk">
    SDK oficial Helius TypeScript para desenvolvimento Solana
  </Card>
</CardGroup>

## Instalação

O Helius TypeScript SDK pode ser instalado com qualquer um dos seguintes gerenciadores de pacotes:

<Tabs>
  <Tab title="npm">
    ```bash theme={"system"}
    npm install helius-sdk
    ```
  </Tab>

  <Tab title="pnpm">
    ```bash theme={"system"}
    pnpm install helius-sdk
    ```
  </Tab>

  <Tab title="Yarn">
    ```bash theme={"system"}
    yarn add helius-sdk
    ```
  </Tab>
</Tabs>

## 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:

```typescript theme={"system"}
import { createHelius } from "helius-sdk";

(async () => {
  const apiKey = ""; // From Helius dashboard
  const helius = createHelius({ apiKey });

  try {
    const assets = await helius.getAssetsByOwner({
      ownerAddress: "owner_address_goes_here",
      page: 1,
      limit: 50,
      sortBy: { sortBy: "created", sortDirection: "asc" },
    });

    console.log("Fetched assets:", assets);
  } catch (error) {
    console.error("Error:", error);
  }
})();
```

## Documentação

O [diretório de exemplos](https://github.com/helius-labs/helius-sdk/tree/main/examples) 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](/docs/pt-BR/api-reference) e a [documentação oficial do Solana](https://solana.com/docs/rpc) para ajuda geral com a Solana JSON RPC API. Para ajuda geral com o Kit, consulte a [documentação do Kit](https://www.solanakit.com/).

## 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:

```typescript theme={"system"}
{
  "jsonrpc": "2.0",
  "error": {
    "code": -32001,
    "message": "Authentication failed. Missing or invalid API key."
  },
  "id": "1"
}
```

### 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:

<AccordionGroup>
  <Accordion title="400: Solicitação Incorreta">
    Isso ocorre quando uma solicitação tem parâmetros inválidos.
  </Accordion>

  <Accordion title="401: Não Autorizado">
    Isso ocorre quando uma chave de API inválida é fornecida ou o acesso é restrito devido a regras RPC.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

Se você encontrar algum desses erros:

<Steps>
  <Step title="Verifique a documentação de erros">
    Consulte [erros do Kit](https://www.solanakit.com/docs/concepts/errors) para uma lista dos erros que você pode encontrar
  </Step>

  <Step title="Revise a documentação">
    Consulte a [documentação Helius](/docs/) para mais orientações
  </Step>

  <Step title="Entre em contato com o suporte">
    Entre em contato com a equipe de suporte da Helius para obter assistência mais detalhada
  </Step>
</Steps>

## Contribuindo

Acolhemos todas as contribuições aos nossos SDKs! Leia o [guia de contribuições](https://github.com/helius-labs/helius-sdk/blob/main/CONTRIBUTING.md) antes de abrir um pull request.