> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitflare.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Справочник по полям объекта актива, возвращаемого методами OrbitFlare DAS API: content, ownership, compression, royalty, creators, token info и плагины MPL Core.

## Обзор

Все методы DAS, возвращающие активы, используют один и тот же объект актива. Поля, неприменимые к активу, опускаются. Например, `token_info` присутствует только у активов на основе токенов, а `plugins` только у активов MPL Core.

## Пример

Программируемый NFT из коллекции Mad Lads:

```json theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
{
  "interface": "ProgrammableNFT",
  "id": "JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC",
  "content": {
    "$schema": "https://schema.metaplex.com/nft1.0.json",
    "json_uri": "https://madlads.s3.us-west-2.amazonaws.com/json/6867.json",
    "files": [
      {
        "uri": "https://madlads.s3.us-west-2.amazonaws.com/images/6867.png",
        "mime": "image/png"
      }
    ],
    "metadata": {
      "attributes": [
        { "value": "Male", "trait_type": "Gender" },
        { "value": "Galaxy", "trait_type": "Type" }
      ],
      "description": "Fock it.",
      "name": "Mad Lads #6867",
      "symbol": "MAD",
      "token_standard": "ProgrammableNonFungible"
    },
    "links": {
      "image": "https://madlads.s3.us-west-2.amazonaws.com/images/6867.png",
      "external_url": "https://madlads.com"
    },
    "category": "image"
  },
  "authorities": [
    { "address": "2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW", "scopes": ["full"] }
  ],
  "compression": {
    "eligible": false,
    "compressed": false,
    "data_hash": "",
    "creator_hash": "",
    "asset_hash": "",
    "tree": "",
    "seq": 0,
    "leaf_id": 0
  },
  "grouping": [
    { "group_key": "collection", "group_value": "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w" }
  ],
  "royalty": {
    "royalty_model": "creators",
    "target": null,
    "percent": 0.042,
    "basis_points": 420,
    "primary_sale_happened": true,
    "locked": false
  },
  "creators": [
    { "address": "5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv", "share": 0, "verified": true },
    { "address": "2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW", "share": 100, "verified": true }
  ],
  "ownership": {
    "frozen": true,
    "delegated": true,
    "delegate": "FARqKAafAbgT25QcgiX5d1g6xpadgG7xymu5N6gSmp4x",
    "ownership_model": "single",
    "owner": "CxBhuJwhVgNMc7yjnRx3XFAsTnnbYDc2bhAGSaLBjNqZ"
  },
  "supply": {
    "print_max_supply": 0,
    "print_current_supply": 0,
    "edition_nonce": 254
  },
  "mutable": true,
  "burnt": false,
  "token_info": {
    "supply": 1,
    "decimals": 0,
    "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
    "associated_token_address": "J4z9rkXuQFVFYEcE4FnbZrT677Eh6WU3f125wyaDyQXg"
  }
}
```

## Поля

<ResponseField name="interface" type="string">
  Стандарт актива. Одно из значений: `V1_NFT`, `V1_PRINT`, `LEGACY_NFT`, `V2_NFT`, `ProgrammableNFT`, `FungibleAsset`, `FungibleToken`, `MplCoreAsset`, `MplCoreCollection`, `MplCoreGroup`, `MplBubblegumV2`, `Identity`, `Executable` или `Custom`.
</ResponseField>

<ResponseField name="id" type="string">
  ID актива. Для активов на основе токенов это адрес минта. Для сжатых NFT это ID актива, выведенный из дерева и индекса листа. Для MPL Core это адрес аккаунта актива.
</ResponseField>

<ResponseField name="last_indexed_slot" type="number">
  Последний слот, обработанный индексом на момент формирования ответа. Присутствует в ответах для одного актива и на верхнем уровне ответов-списков.
</ResponseField>

<ResponseField name="content" type="object">
  Офчейн-метаданные и ссылки.

  <Expandable title="поля content">
    <ResponseField name="$schema" type="string">
      URL схемы метаданных.
    </ResponseField>

    <ResponseField name="json_uri" type="string">
      URI офчейн-метаданных в формате JSON.
    </ResponseField>

    <ResponseField name="files" type="array">
      Файлы, перечисленные в метаданных. Каждый имеет `uri` и `mime` и может иметь `quality` и `contexts`.
    </ResponseField>

    <ResponseField name="metadata" type="object">
      `name`, `symbol`, `description`, `attributes` и `token_standard`. `json_name` содержит имя из офчейн-JSON.
    </ResponseField>

    <ResponseField name="links" type="object">
      Удобные ссылки, такие как `image`, `animation_url` и `external_url`.
    </ResponseField>

    <ResponseField name="category" type="string">
      Категория медиа из метаданных, например `image` или `video`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="authorities" type="array">
  Адреса, имеющие полномочия над активом. Каждая запись содержит `address` и `scopes` (`full`, `royalty`, `metadata` или `extension`).
</ResponseField>

<ResponseField name="compression" type="object">
  Состояние сжатия. Для несжатых активов `compressed` равно `false`, а остальные поля пусты.

  <Expandable title="поля compression">
    <ResponseField name="compressed" type="boolean">
      Является ли актив сжатым NFT.
    </ResponseField>

    <ResponseField name="eligible" type="boolean">
      Может ли актив быть сжат.
    </ResponseField>

    <ResponseField name="tree" type="string">
      Адрес дерева Меркла.
    </ResponseField>

    <ResponseField name="leaf_id" type="number">
      Индекс листа в дереве.
    </ResponseField>

    <ResponseField name="seq" type="number">
      Порядковый номер последнего изменения листа.
    </ResponseField>

    <ResponseField name="data_hash" type="string">
      Хеш метаданных актива.
    </ResponseField>

    <ResponseField name="creator_hash" type="string">
      Хеш массива создателей.
    </ResponseField>

    <ResponseField name="asset_hash" type="string">
      Хеш листа.
    </ResponseField>

    <ResponseField name="collection_hash" type="string">
      Только Bubblegum v2. Хеш коллекции.
    </ResponseField>

    <ResponseField name="asset_data_hash" type="string">
      Только Bubblegum v2. Хеш данных актива.
    </ResponseField>

    <ResponseField name="flags" type="number">
      Только Bubblegum v2. Флаги листа.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="grouping" type="array">
  Группы, к которым принадлежит актив. Каждая запись содержит `group_key` (обычно `collection`) и `group_value` (адрес коллекции). Неверифицированные коллекции появляются только с `showUnverifiedCollections` и в этом случае имеют `verified: false`. `collection_metadata` появляется с `showCollectionMetadata`.
</ResponseField>

<ResponseField name="royalty" type="object">
  `royalty_model` (`creators`, `fanout` или `single`), `target`, `percent`, `basis_points`, `primary_sale_happened` и `locked`.
</ResponseField>

<ResponseField name="creators" type="array">
  Создатели с `address`, `share` (доля роялти в процентах) и `verified`.
</ResponseField>

<ResponseField name="ownership" type="object">
  <Expandable title="поля ownership">
    <ResponseField name="owner" type="string">
      Текущий владелец. Пусто для взаимозаменяемых токенов, у которых много держателей.
    </ResponseField>

    <ResponseField name="ownership_model" type="string">
      `single` для NFT, `token` для взаимозаменяемых токенов.
    </ResponseField>

    <ResponseField name="frozen" type="boolean">
      Заморожен ли актив.
    </ResponseField>

    <ResponseField name="delegated" type="boolean">
      Назначен ли делегат.
    </ResponseField>

    <ResponseField name="delegate" type="string | null">
      Адрес делегата, если он есть.
    </ResponseField>

    <ResponseField name="non_transferable" type="boolean">
      Присутствует, если актив нельзя передать.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="supply" type="object | null">
  Предложение изданий: `print_max_supply`, `print_current_supply` и `edition_nonce`. У отпечатков также есть `edition_number` и `master_edition_mint`.
</ResponseField>

<ResponseField name="mutable" type="boolean">
  Можно ли ещё изменить метаданные.
</ResponseField>

<ResponseField name="burnt" type="boolean">
  Был ли актив сожжён.
</ResponseField>

<ResponseField name="token_info" type="object">
  Сведения о токене для активов на основе токенов.

  <Expandable title="поля token_info">
    <ResponseField name="supply" type="number">
      Общее предложение в базовых единицах.
    </ResponseField>

    <ResponseField name="decimals" type="number">
      Количество десятичных знаков минта.
    </ResponseField>

    <ResponseField name="token_program" type="string">
      ID программы SPL Token или Token-2022.
    </ResponseField>

    <ResponseField name="mint_authority" type="string">
      Полномочие на минт (mint authority), если задано.
    </ResponseField>

    <ResponseField name="freeze_authority" type="string">
      Полномочие на заморозку (freeze authority), если задано.
    </ResponseField>

    <ResponseField name="balance" type="number">
      Баланс запрошенного владельца в базовых единицах.
    </ResponseField>

    <ResponseField name="associated_token_address" type="string">
      Ассоциированный токен-аккаунт владельца для этого минта.
    </ResponseField>

    <ResponseField name="symbol" type="string">
      Символ токена. Присутствует, если доступна цена.
    </ResponseField>

    <ResponseField name="price_info" type="object">
      Цена в USD: `price_per_token`, `total_price` (для баланса владельца) и `currency`. Присутствует для взаимозаменяемых токенов с известной ценой.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="mint_extensions" type="object">
  Расширения минта Token-2022, такие как указатель метаданных, комиссия за перевод и постоянный делегат.
</ResponseField>

<ResponseField name="inscription" type="object">
  Данные инскрипции токена. Возвращаются с `showInscription`.
</ResponseField>

<ResponseField name="plugins" type="object">
  Плагины MPL Core. `external_plugins`, `unknown_plugins` и `unknown_external_plugins` содержат прочие типы плагинов.
</ResponseField>

<ResponseField name="mpl_core_info" type="object">
  Сведения MPL Core: `num_minted`, `current_size` и `plugins_json_version`.
</ResponseField>

<ResponseField name="uses" type="object">
  Использования (uses) устаревшего Token Metadata: `use_method`, `remaining` и `total`.
</ResponseField>


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