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

# Solana DAS API: унифицированный доступ к данным NFT и токенов

> Самый полный API Solana для NFT, сжатых NFT и токенов. Единый интерфейс для всех цифровых активов с полными метаданными, сведениями о владельцах и поиском.

## Что такое 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?

<CardGroup cols={2}>
  <Card title="All asset types, one API" icon="gem">
    NFT, сжатые NFT и взаимозаменяемые токены (SPL и Token-2022) через единый интерфейс.
  </Card>

  <Card title="Complete metadata" icon="database">
    Данные в блокчейне и вне блокчейна (Arweave, IPFS) индексируются и возвращаются вместе за один вызов.
  </Card>

  <Card title="Price data included" icon="coins">
    Цены проверенных токенов в долларах США возвращаются вместе с балансами.
  </Card>

  <Card title="Search and filtering" icon="magnifying-glass">
    Выполняйте запросы по владельцу, коллекции, создателю, уполномоченному субъекту или расширенным фильтрам атрибутов.
  </Card>
</CardGroup>

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

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

| Метод | Для чего использовать | Что возвращает |
| - | - | - |
| **`getAsset`** | Отдельный актив, идентификатор которого вам уже известен | Полные метаданные, сведения о владельце и цена одного актива (для токенов) |
| **`getAssetsByOwner`** | Все активы в кошельке | Все активы по адресу с метаданными и балансами |
| **`searchAssets`** | Фильтрация запросов по активам | Активы, соответствующие фильтрам по владельцу, коллекции, `tokenType` и атрибутам |

Общее правило:

* Знаете точный идентификатор актива? Используйте `getAsset` (или `getAssetBatch` для нескольких активов).
* Получаете список активов кошелька? Используйте `getAssetsByOwner`.
* Фильтруете по коллекции, типу токена или атрибутам? Используйте `searchAssets`.

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

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

<CardGroup cols={2}>
  <Card title="getAsset" icon="gem" href="/docs/ru/api-reference/das/getasset">
    Полные данные одного актива по его идентификатору.
  </Card>

  <Card title="getAssetBatch" icon="layer-group" href="/docs/ru/api-reference/das/getassetbatch">
    До 1 000 активов в одном запросе.
  </Card>
</CardGroup>

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

<CardGroup cols={2}>
  <Card title="getAssetsByOwner" icon="wallet" href="/docs/ru/api-reference/das/getassetsbyowner">
    Все активы в кошельке с метаданными и балансами.
  </Card>

  <Card title="getAssetsByGroup" icon="layer-group" href="/docs/ru/api-reference/das/getassetsbygroup">
    Все активы в коллекции (ключ группы `collection`).
  </Card>

  <Card title="getAssetsByCreator" icon="user" href="/docs/ru/api-reference/das/getassetsbycreator">
    Все активы, выпущенные определенным создателем.
  </Card>

  <Card title="getAssetsByAuthority" icon="address-card" href="/docs/ru/api-reference/das/getassetsbyauthority">
    Все активы под управлением указанного уполномоченного субъекта.
  </Card>
</CardGroup>

### Поиск

<CardGroup cols={2}>
  <Card title="searchAssets" icon="magnifying-glass" href="/docs/ru/api-reference/das/searchassets">
    Гибкая фильтрация по владельцу, коллекции, `tokenType` и атрибутам.
  </Card>
</CardGroup>

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

<CardGroup cols={2}>
  <Card title="getAssetProof" icon="shield-check" href="/docs/ru/api-reference/das/getassetproof">
    Доказательство Меркла для сжатого актива, необходимое для операций в блокчейне.
  </Card>

  <Card title="getAssetProofBatch" icon="shield-check" href="/docs/ru/api-reference/das/getassetproofbatch">
    Доказательства Меркла сразу для нескольких сжатых активов.
  </Card>

  <Card title="getSignaturesForAsset" icon="clock-rotate-left" href="/docs/ru/api-reference/das/getsignaturesforasset">
    История подписей транзакций для актива.
  </Card>

  <Card title="getNftEditions" icon="image" href="/docs/ru/api-reference/das/getnfteditions">
    Все экземпляры, выпущенные на основе главного NFT.
  </Card>
</CardGroup>

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

<CardGroup cols={2}>
  <Card title="getTokenAccounts" icon="coins" href="/docs/ru/api-reference/das/gettokenaccounts">
    Счета токенов по адресу выпуска или владельцу с балансами.
  </Card>
</CardGroup>

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

<CardGroup cols={2}>
  <Card title="Get Assets (NFTs)" icon="image" href="/docs/ru/das/get-nfts">
    Получайте NFT и цифровые коллекционные объекты: отдельный актив, активы по владельцу, коллекции, доказательства и экземпляры.
  </Card>

  <Card title="Get SPL Tokens" icon="coins" href="/docs/ru/das/get-tokens">
    Запрашивайте взаимозаменяемые токены: балансы, объем предложения, держателей и счета токенов.
  </Card>

  <Card title="Search Assets" icon="magnifying-glass" href="/docs/ru/das/search">
    Фильтруйте активы по владельцу, коллекции, типу токена и атрибутам.
  </Card>

  <Card title="Pagination" icon="list" href="/docs/ru/das/pagination">
    Постраничная пагинация и пагинация по ключам для больших наборов результатов.
  </Card>
</CardGroup>

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

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

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

Сведения о запросах балансов, объема предложения, держателей и счетов токенов см. в [руководстве по получению токенов SPL](/docs/ru/das/get-tokens) и [расширении для взаимозаменяемых токенов](/docs/ru/das/fungible-token-extension).

### Сжатые NFT

Для чтения NFT со сжатием состояния (cNFT) используются те же методы, что и для обычных NFT (`getAsset`, `getAssetsByOwner`, `searchAssets`), а также два метода, предназначенных для сжатых активов:

* `getAssetProof` возвращает доказательство Меркла, необходимое для проверки и выполнения в блокчейне таких операций, как передача и сжигание.
* `getSignaturesForAsset` возвращает историю транзакций сжатого актива.

Полные примеры для сжатых NFT см. в [руководстве по получению активов](/docs/ru/das/get-nfts).

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

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

<Note>
  Helius не может обнаруживать изменения данных вне блокчейна. Эти данные обновляются только после того, как актив снова появляется в блокчейне (например, при его изменении). Чтобы запросить повторную индексацию, обратитесь в службу поддержки Helius.
</Note>

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

<CardGroup cols={2}>
  <Card title="Pagination" icon="list">
    Начинайте со страницы 1, а не 0. Устанавливайте лимит от 100 до 1 000 и используйте пагинацию для больших наборов данных.
  </Card>

  <Card title="Error handling" icon="shield-check">
    Проверяйте каждый ответ на наличие ошибок и повторяйте запросы с экспоненциальной задержкой.
  </Card>

  <Card title="Performance" icon="bolt">
    По возможности используйте пакетные методы, кэшируйте ответы и не объединяйте вызовы в цепочки, если достаточно одного вызова.
  </Card>

  <Card title="Security" icon="lock">
    Никогда не раскрывайте ключ API в клиентском коде. Проксируйте запросы через сервер и настройте политики CORS.
  </Card>
</CardGroup>

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

<CardGroup cols={3}>
  <Card title="Get Assets (NFTs)" icon="image" href="/docs/ru/das/get-nfts">
    Получайте NFT и цифровые коллекционные объекты и выполняйте запросы по ним.
  </Card>

  <Card title="DAS API reference" icon="code" href="/docs/ru/api-reference/das">
    Полные схемы запросов и ответов для каждого метода DAS.
  </Card>

  <Card title="DAS API FAQ" icon="book" href="/docs/ru/faqs/das-api">
    Часто задаваемые вопросы об активах, ценах и использовании.
  </Card>
</CardGroup>


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