Skip to main content

​
Что такое DAS API?

Digital Asset Standard (DAS) API — это спецификация с открытым исходным кодом, которая предоставляет единый интерфейс для всех типов цифровых активов в Solana:
  • Обычные NFT (невзаимозаменяемые токены)
  • Сжатые NFT (cNFT, использующие сжатие состояния)
  • Взаимозаменяемые токены (SPL Token и Token-2022, включая расширения)
Единый набор методов охватывает метаданные, сведения о владельцах, балансы, коллекции, создателей, поиск и доказательства Меркла. Это позволяет создавать торговые площадки NFT, кошельки, средства отслеживания портфелей, приложения с доступом по токенам и инструменты аналитики на основе одного API. В обеих сетях используются одинаковые методы:
  • Основная сеть: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Тестовая сеть: https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY

​
Почему стоит использовать Helius для DAS API?

All asset types, one API

NFT, сжатые NFT и взаимозаменяемые токены (SPL и Token-2022) через единый интерфейс.

Complete metadata

Данные в блокчейне и вне блокчейна (Arweave, IPFS) индексируются и возвращаются вместе за один вызов.

Price data included

Цены проверенных токенов в долларах США возвращаются вместе с балансами.

Search and filtering

Выполняйте запросы по владельцу, коллекции, создателю, уполномоченному субъекту или расширенным фильтрам атрибутов.

​
Какой метод следует использовать?

Большинство интеграций начинается с одного из трех методов. Выберите подходящую точку входа с помощью этой таблицы, а затем при необходимости используйте специализированные методы ниже. Общее правило:
  • Знаете точный идентификатор актива? Используйте getAsset (или getAssetBatch для нескольких активов).
  • Получаете список активов кошелька? Используйте getAssetsByOwner.
  • Фильтруете по коллекции, типу токена или атрибутам? Используйте searchAssets.

​
Основные методы

​
Отдельный актив

getAsset

Полные данные одного актива по его идентификатору.

getAssetBatch

До 1 000 активов в одном запросе.

​
Активы по владельцу, коллекции или создателю

getAssetsByOwner

Все активы в кошельке с метаданными и балансами.

getAssetsByGroup

Все активы в коллекции (ключ группы collection).

getAssetsByCreator

Все активы, выпущенные определенным создателем.

getAssetsByAuthority

Все активы под управлением указанного уполномоченного субъекта.

​
Поиск

searchAssets

Гибкая фильтрация по владельцу, коллекции, tokenType и атрибутам.

​
Сжатые активы и доказательства

getAssetProof

Доказательство Меркла для сжатого актива, необходимое для операций в блокчейне.

getAssetProofBatch

Доказательства Меркла сразу для нескольких сжатых активов.

getSignaturesForAsset

История подписей транзакций для актива.

getNftEditions

Все экземпляры, выпущенные на основе главного NFT.

​
Счета токенов

getTokenAccounts

Счета токенов по адресу выпуска или владельцу с балансами.

​
Начало работы

Get Assets (NFTs)

Получайте NFT и цифровые коллекционные объекты: отдельный актив, активы по владельцу, коллекции, доказательства и экземпляры.

Get SPL Tokens

Запрашивайте взаимозаменяемые токены: балансы, объем предложения, держателей и счета токенов.

Search Assets

Фильтруйте активы по владельцу, коллекции, типу токена и атрибутам.

Pagination

Постраничная пагинация и пагинация по ключам для больших наборов результатов.

​
Работа с особыми типами активов

​
Взаимозаменяемые токены

Helius расширяет DAS API, добавляя поддержку всех токенов, включая обычные токены SPL (без метаданных) и Token-2022 (вместе с их расширениями). Поддержка взаимозаменяемых токенов доступна через getAsset, getAssetsByOwner и searchAssets с использованием параметра tokenType, а цены проверенных токенов возвращаются в поле token_info.price_info. Сведения о запросах балансов, объема предложения, держателей и счетов токенов см. в руководстве по получению токенов SPL и расширении для взаимозаменяемых токенов.

​
Сжатые NFT

Для чтения NFT со сжатием состояния (cNFT) используются те же методы, что и для обычных NFT (getAsset, getAssetsByOwner, searchAssets), а также два метода, предназначенных для сжатых активов:
  • getAssetProof возвращает доказательство Меркла, необходимое для проверки и выполнения в блокчейне таких операций, как передача и сжигание.
  • getSignaturesForAsset возвращает историю транзакций сжатого актива.
Полные примеры для сжатых NFT см. в руководстве по получению активов.

​
Данные вне блокчейна

Большинство коллекций NFT хранит дополнительные метаданные (атрибуты и изображения) вне блокчейна в Arweave или IPFS. DAS API индексирует эти данные и возвращает их вместе с данными из блокчейна за один вызов.
Helius не может обнаруживать изменения данных вне блокчейна. Эти данные обновляются только после того, как актив снова появляется в блокчейне (например, при его изменении). Чтобы запросить повторную индексацию, обратитесь в службу поддержки Helius.

​
Рекомендации

Pagination

Начинайте со страницы 1, а не 0. Устанавливайте лимит от 100 до 1 000 и используйте пагинацию для больших наборов данных.

Error handling

Проверяйте каждый ответ на наличие ошибок и повторяйте запросы с экспоненциальной задержкой.

Performance

По возможности используйте пакетные методы, кэшируйте ответы и не объединяйте вызовы в цепочки, если достаточно одного вызова.

Security

Никогда не раскрывайте ключ API в клиентском коде. Проксируйте запросы через сервер и настройте политики CORS.

​
Дальнейшие действия

Get Assets (NFTs)

Получайте NFT и цифровые коллекционные объекты и выполняйте запросы по ним.

DAS API reference

Полные схемы запросов и ответов для каждого метода DAS.

DAS API FAQ

Часто задаваемые вопросы об активах, ценах и использовании.