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

> Официальный TypeScript SDK от Helius для разработки на Solana. Установите helius-sdk, получайте активы с помощью DAS API и обрабатывайте распространенные ошибки и коды состояния RPC.

Helius TypeScript SDK ([`helius-sdk`](https://github.com/helius-labs/helius-sdk)) упрощает разработку на Solana с использованием TypeScript — в Node.js, браузере или любой другой среде выполнения. На этой странице описаны установка и использование SDK, обработка распространенных ошибок и поиск актуальной документации.

Обратите внимание, что SDK был переписан начиная с версии 2.0.0. Это было сделано для использования `@solana/kit` и устранения зависимости от версий `@solana/web3.js` выше 1.73.2. Если вы переходите на последнюю версию, ознакомьтесь с нашим [руководством по миграции](https://github.com/helius-labs/helius-sdk/blob/main/MIGRATION.md).

<CardGroup cols={1}>
  <Card title="GitHub Repository" icon="js" href="https://github.com/helius-labs/helius-sdk">
    Официальный TypeScript SDK от Helius для разработки на Solana
  </Card>
</CardGroup>

## Установка

Helius TypeScript SDK можно установить с помощью любого из следующих менеджеров пакетов:

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

## Быстрый старт

Ниже приведен простой пример использования TypeScript SDK для получения списка активов, принадлежащих указанному адресу:

```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);
  }
})();
```

## Документация

В [каталоге примеров](https://github.com/helius-labs/helius-sdk/tree/main/examples) представлены подробные примеры кода для каждого метода и базовых сценариев использования, сгруппированные по пространствам имен. Справочную документацию по API можно найти в нашей [документации](/docs/ru/api-reference), а общую информацию об API Solana JSON RPC — в [официальной документации Solana](https://solana.com/docs/rpc). Общую информацию о работе с Kit можно найти в [документации Kit](https://www.solanakit.com/).

## Обработка ошибок

Если API возвращает ответ, не указывающий на успешное выполнение (то есть код состояния 4xx или 5xx), будет создано сообщение об ошибке.

Например, ниже приведена ошибка 401, возникающая при неправильном вызове getAsset:

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

### Распространенные коды ошибок

При работе с Helius SDK вы можете столкнуться с несколькими кодами ошибок. Ниже приведена таблица с описанием некоторых распространенных кодов ошибок и дополнительной информацией, которая поможет устранить неполадки:

<AccordionGroup>
  <Accordion title="400: Bad Request">
    Возникает, когда запрос содержит недопустимые параметры.
  </Accordion>

  <Accordion title="401: Unauthorized">
    Возникает, когда указан недействительный ключ API или доступ ограничен правилами RPC.
  </Accordion>

  <Accordion title="429: Too Many Requests">
    Указывает, что пользователь превысил лимит запросов за определенный период или исчерпал кредиты.
  </Accordion>

  <Accordion title="5XX: Internal Server Error">
    Это общее сообщение об ошибке, связанной с проблемами на стороне сервера. Обратитесь за помощью в службу поддержки Helius.
  </Accordion>
</AccordionGroup>

Если вы столкнулись с любой из этих ошибок:

<Steps>
  <Step title="Check error documentation">
    Ознакомьтесь со [списком ошибок Kit](https://www.solanakit.com/docs/concepts/errors), с которыми вы можете столкнуться
  </Step>

  <Step title="Review the documentation">
    Дополнительные рекомендации приведены в [документации Helius](/docs/)
  </Step>

  <Step title="Contact support">
    Обратитесь в службу поддержки Helius за более подробной помощью
  </Step>
</Steps>

## Участие в разработке

Мы приветствуем любой вклад в наши SDK! Перед созданием запроса на включение изменений ознакомьтесь с [руководством для участников](https://github.com/helius-labs/helius-sdk/blob/main/CONTRIBUTING.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.