Skip to main content
Helius TypeScript SDK (helius-sdk) упрощает разработку на Solana с использованием TypeScript — в Node.js, браузере или любой другой среде выполнения. На этой странице описаны установка и использование SDK, обработка распространенных ошибок и поиск актуальной документации. Обратите внимание, что SDK был переписан начиная с версии 2.0.0. Это было сделано для использования @solana/kit и устранения зависимости от версий @solana/web3.js выше 1.73.2. Если вы переходите на последнюю версию, ознакомьтесь с нашим руководством по миграции.

GitHub Repository

Официальный TypeScript SDK от Helius для разработки на Solana

Установка

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

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

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

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

В каталоге примеров представлены подробные примеры кода для каждого метода и базовых сценариев использования, сгруппированные по пространствам имен. Справочную документацию по API можно найти в нашей документации, а общую информацию об API Solana JSON RPC — в официальной документации Solana. Общую информацию о работе с Kit можно найти в документации Kit.

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

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

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

При работе с Helius SDK вы можете столкнуться с несколькими кодами ошибок. Ниже приведена таблица с описанием некоторых распространенных кодов ошибок и дополнительной информацией, которая поможет устранить неполадки:
Возникает, когда запрос содержит недопустимые параметры.
Возникает, когда указан недействительный ключ API или доступ ограничен правилами RPC.
Указывает, что пользователь превысил лимит запросов за определенный период или исчерпал кредиты.
Это общее сообщение об ошибке, связанной с проблемами на стороне сервера. Обратитесь за помощью в службу поддержки Helius.
Если вы столкнулись с любой из этих ошибок:
1

Check error documentation

Ознакомьтесь со списком ошибок Kit, с которыми вы можете столкнуться
2

Review the documentation

Дополнительные рекомендации приведены в документации Helius
3

Contact support

Обратитесь в службу поддержки Helius за более подробной помощью

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

Мы приветствуем любой вклад в наши SDK! Перед созданием запроса на включение изменений ознакомьтесь с руководством для участников.