Как получить NFT в Solana: активы, коллекции и доказательства

Обзор

В этом руководстве описано чтение NFT и цифровых коллекционных объектов с помощью Helius Digital Asset Standard (DAS) API: получение отдельного актива, списка NFT кошелька, поиск по коллекции или создателю, работа со сжатыми NFT и доказательствами Меркла, получение списка изданий и чтение истории транзакций. Информацию о взаимозаменяемых токенах — балансах, предложении, держателях и ценах — см. в руководстве по получению SPL-токенов. Методы getAsset и getAssetsByOwner работают как с NFT, так и с токенами. Эта страница посвящена процессам работы с NFT и коллекционными объектами.

Когда это использовать

Используйте методы на этой странице, когда вам нужно:

Отобразить метаданные, изображение и атрибуты отдельного NFT
Получить список всех NFT, принадлежащих кошельку, для портфеля или галереи
Реализовать поиск по коллекции и создателю для маркетплейса или обозревателя
Проверить или передать сжатые NFT, для которых требуются доказательства Меркла
Показать историю транзакций NFT в блокчейне
Получить список изданий, выпущенных из мастер-NFT

Методы для работы с NFT

Начните с getAsset для отдельного NFT или с getAssetsByOwner для коллекции кошелька. Каждая карточка содержит ссылку на полную справку по API.

getAsset

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

getAssetsByOwner

Все NFT, хранящиеся в кошельке.

searchAssets

Фильтрация по коллекции, создателю, атрибутам и другим параметрам — см. руководство по поиску активов.

getAssetsByCreator

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

getAssetsByGroup

Все активы в коллекции.

getSignaturesForAsset

История транзакций актива.

getNftEditions

Издания, выпущенные из мастер-NFT.

getAssetProof

Доказательство Меркла для сжатого NFT.

Получение отдельного NFT

Получите полные метаданные, сведения о владельце и данные коллекции для одного NFT по его идентификатору:

const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getAsset',
    params: { id: 'F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk' },
  }),
});

const { result } = await response.json();
console.log(result.content.metadata.name, result.ownership.owner);

Другие запросы NFT

List a wallet's NFTs — getAssetsByOwner

const getNFTsByOwner = async (ownerAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetsByOwner',
      params: { ownerAddress, page: 1, limit: 10 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getNFTsByOwner('86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY');

By creator — getAssetsByCreator

const getAssetsByCreator = async (creatorAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetsByCreator',
      params: { creatorAddress, page: 1, limit: 100 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getAssetsByCreator('9uBX3ASjxWvNBAD1xjbVaKA74mWGZys3RGSF7DdeDD3F');

By collection — getAssetsByGroup

const getAssetsByCollection = async (collectionAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetsByGroup',
      params: { groupKey: 'collection', groupValue: collectionAddress, page: 1, limit: 100 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getAssetsByCollection('J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w');

Transaction history — getSignaturesForAsset

const getNFTTransactionHistory = async (mintAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getSignaturesForAsset',
      params: { id: mintAddress, page: 1, limit: 100 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getNFTTransactionHistory('FNt6A9Mfnqbwc1tY7uwAguKQ1JcpBrxmhczDgbdJy5AC');

Сжатые NFT

NFT со сжатым состоянием (cNFT) читаются теми же методами, что и обычные NFT: getAsset, getAssetsByOwner и searchAssets также возвращают их. Со сжатием связаны две особенности:

Доказательства Меркла — для операций в блокчейне, таких как передача и сжигание, требуется доказательство из getAssetProof.
История — используйте getSignaturesForAsset, показанный выше, чтобы получить историю транзакций cNFT.

Get a Merkle proof — getAssetProof

const getProof = async (id) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetProof',
      params: { id },
    }),
  });

  const { result } = await response.json();
  return result; // { root, proof, node_index, leaf, tree_id }
};

getProof('Bu1DEKeawy7txbnCEJE4BU3BKLXaNAKCYcHR4XhndGss');

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

Get SPL Tokens

Балансы взаимозаменяемых токенов, предложение, держатели и цены.

Search Assets

Фильтрация NFT по коллекции, создателю и атрибутам.

DAS API FAQ

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

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

Потоковая передача данных и отслеживание событий

API данных и RPC

Торговля

Отправка транзакций

Кошелек как услуга

Конфиденциальность

Ресурсы

Как получить NFT в Solana: активы, коллекции и доказательства

Обзор

Когда это использовать

Методы для работы с NFT

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

Получение отдельного NFT

Другие запросы NFT

Сжатые NFT

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

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

Get SPL Tokens

Search Assets

DAS API FAQ

​Обзор

​Когда это использовать

​Методы для работы с NFT

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

​Получение отдельного NFT

​Другие запросы NFT

​Сжатые NFT

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

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

Get SPL Tokens

Search Assets

DAS API FAQ

Обзор

Когда это использовать

Методы для работы с NFT

Получение отдельного NFT

Другие запросы NFT

Сжатые NFT

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

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