Cách lấy NFT Solana: Tài sản, bộ sưu tập và bằng chứng

Tổng quan

Hướng dẫn này trình bày cách đọc NFT và vật phẩm sưu tầm kỹ thuật số bằng Helius Digital Asset Standard (DAS) API: lấy một tài sản, liệt kê NFT của ví, truy vấn theo bộ sưu tập hoặc người tạo, làm việc với NFT nén và bằng chứng Merkle, liệt kê các phiên bản và đọc lịch sử giao dịch. Đối với token có thể thay thế — số dư, nguồn cung, người nắm giữ và giá — hãy xem hướng dẫn Lấy token SPL. Các phương thức getAsset và getAssetsByOwner đều hỗ trợ cả NFT lẫn token; trang này tập trung vào quy trình làm việc với NFT và vật phẩm sưu tầm.

Khi nào nên sử dụng

Sử dụng các phương thức trên trang này khi cần:

Hiển thị siêu dữ liệu, hình ảnh và thuộc tính của một NFT
Liệt kê mọi NFT mà một ví sở hữu cho danh mục đầu tư hoặc thư viện
Cung cấp dữ liệu cho chợ giao dịch hoặc trình khám phá bằng các truy vấn theo bộ sưu tập và người tạo
Xác minh hoặc chuyển NFT nén (cần có bằng chứng Merkle)
Hiển thị lịch sử giao dịch trên chuỗi của NFT
Liệt kê các phiên bản được tạo từ NFT gốc

Các phương thức NFT

Bắt đầu với getAsset cho một NFT hoặc getAssetsByOwner cho bộ sưu tập của một ví. Mỗi thẻ liên kết đến tài liệu tham khảo API đầy đủ tương ứng.

getAsset

Dữ liệu đầy đủ của một NFT theo ID.

getAssetsByOwner

Tất cả NFT do một ví nắm giữ.

searchAssets

Lọc theo bộ sưu tập, người tạo, thuộc tính và nhiều tiêu chí khác — xem hướng dẫn Tìm kiếm tài sản.

getAssetsByCreator

Tất cả tài sản do một người tạo phát hành.

getAssetsByGroup

Tất cả tài sản trong một bộ sưu tập.

getSignaturesForAsset

Lịch sử giao dịch của một tài sản.

getNftEditions

Các phiên bản được tạo từ NFT gốc.

getAssetProof

Bằng chứng Merkle cho một NFT nén.

Lấy một NFT

Truy xuất đầy đủ siêu dữ liệu, quyền sở hữu và dữ liệu bộ sưu tập của một NFT theo 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: 'getAsset',
    params: { id: 'F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk' },
  }),
});

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

Các truy vấn NFT khác

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 nén

NFT nén trạng thái (cNFT) được đọc bằng các phương thức giống như NFT thông thường — getAsset, getAssetsByOwner và searchAssets đều trả về các NFT này. Có hai điểm dành riêng cho tính năng nén:

Bằng chứng Merkle — các thao tác trên chuỗi như chuyển và đốt cần bằng chứng từ getAssetProof.
Lịch sử — sử dụng getSignaturesForAsset (được trình bày ở trên) để lấy lịch sử giao dịch của 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');

Các phương pháp hay nhất

Sử dụng phân trang cho các phương thức trả về tập kết quả lớn.
Xử lý lỗi bằng try/catch và thử lại các lỗi tạm thời với thời gian chờ tăng theo cấp số nhân.
Lưu phản hồi vào bộ nhớ đệm khi phù hợp để giảm số lệnh gọi API.
Sử dụng getAssetBatch thay vì thực hiện nhiều lệnh gọi getAsset riêng lẻ khi có nhiều ID.

Các bước tiếp theo

Get SPL Tokens

Số dư, nguồn cung, người nắm giữ và giá của token có thể thay thế.

Search Assets

Lọc NFT theo bộ sưu tập, người tạo và thuộc tính.

DAS API FAQ

Các câu hỏi thường gặp về tài sản, dữ liệu giá và cách sử dụng.

Bắt đầu

Truyền phát dữ liệu & lắng nghe sự kiện

API dữ liệu & RPC

Giao dịch

Gửi giao dịch

Ví dưới dạng dịch vụ

Quyền riêng tư

Tài nguyên

Cách lấy NFT Solana: Tài sản, bộ sưu tập và bằng chứng

Tổng quan

Khi nào nên sử dụng

Các phương thức NFT

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

Lấy một NFT

Các truy vấn NFT khác

NFT nén

Các phương pháp hay nhất

Các bước tiếp theo

Get SPL Tokens

Search Assets

DAS API FAQ

​Tổng quan

​Khi nào nên sử dụng

​Các phương thức NFT

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

​Lấy một NFT

​Các truy vấn NFT khác

​NFT nén

​Các phương pháp hay nhất

​Các bước tiếp theo

Get SPL Tokens

Search Assets

DAS API FAQ

Tổng quan

Khi nào nên sử dụng

Các phương thức NFT

Lấy một NFT

Các truy vấn NFT khác

NFT nén

Các phương pháp hay nhất

Các bước tiếp theo