Перейти к основному содержанию

Обзор

Digital Asset Standard (DAS) API представляет собой единый интерфейс для чтения активов Solana. Один набор методов JSON-RPC охватывает все типы активов, поэтому вам не нужно самостоятельно декодировать аккаунты Token Metadata, воспроизводить транзакции Bubblegum или объединять токен-аккаунты. DAS API индексирует:
  • NFT и программируемые NFT (Metaplex Token Metadata)
  • Сжатые NFT (Bubblegum v1 и v2), включая доказательства Меркла
  • Активы и коллекции MPL Core
  • Взаимозаменяемые токены (SPL Token и Token-2022) с ценами в USD, если они доступны
  • Печатные издания NFT с мастер-изданием
  • Расширения Token-2022 и инскрипции токенов

Эндпоинт

Методы DAS обслуживаются на том же эндпоинте, что и стандартный Solana RPC. Отправляйте их на ваш URL OrbitFlare RPC вместе с API-ключом:
Методы DAS принимают параметры в виде именованного объекта ("params": { ... }), а не позиционного массива.
О том, как создать API-ключ и передавать его в запросах, см. раздел Аутентификация.

Методы

Активы

getAsset

Получить один актив по его ID.

getAssetBatch

Получить до 1 000 активов по их ID за один вызов.

getAssetsByOwner

Список активов, которыми владеет кошелёк.

getAssetsByGroup

Список активов в коллекции.

getAssetsByCreator

Список активов, созданных адресом.

getAssetsByAuthority

Список активов, контролируемых полномочием на обновление (update authority).

searchAssets

Поиск активов по владельцу, создателю, коллекции, интерфейсу и другим признакам.

Сжатые NFT

getAssetProof

Получить доказательство Меркла для сжатого актива.

getAssetProofBatch

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

getAssetWithProof

Получить сжатый актив и его доказательство за один вызов.

getSignaturesForAsset

Список транзакций, затронувших сжатый актив.

Токены и издания

getTokenAccounts

Список токен-аккаунтов по владельцу или по минту.

getNftEditions

Список напечатанных изданий NFT с мастер-изданием.

Совместимость

DAS API использует стандартные названия методов, параметры и формат ответов DAS. Если вы уже используете DAS API другого провайдера, направьте ваш клиент на эндпоинт OrbitFlare и оставьте остальной код без изменений.
  • Пакетные методы отвечают на оба названия: getAssetBatch и getAssets, getAssetProofBatch и getAssetProofs.
  • getSignaturesForAsset также доступен как getAssetSignatures.
  • Большинство методов также принимают название в snake_case, например get_asset или get_assets_by_owner. Исключения: getAssetsByAuthority и getSignaturesForAsset.
  • getTokenAccounts и getNftEditions принимают owner и mint, а также ownerAddress и mintAddress.
  • Параметры отображения можно передавать как options или displayOptions.
requireFullIndex: true пока не поддерживается. Запросы с этим параметром отклоняются с кодом -32602, а не обрабатываются без гарантии. См. Параметры отображения.

Ответы

  • Методы для одного актива возвращают объект актива.
  • Методы-списки возвращают страницу объектов активов с total, limit, маркером страницы или курсора и last_indexed_slot. См. Пагинация.
  • last_indexed_slot означает последний слот, обработанный индексом. Используйте его, чтобы оценить актуальность ответа.

Ошибки

Следующие шаги

Объект актива

Все поля, которые может содержать ответ с активом.

Пагинация

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