Skip to main content

​
DAS API là gì?

Digital Asset Standard (DAS) API là một đặc tả nguồn mở cung cấp cho bạn một giao diện hợp nhất cho mọi loại tài sản kỹ thuật số trên Solana:
  • NFT thông thường (Token không thể thay thế)
  • NFT nén (cNFT, sử dụng cơ chế nén trạng thái)
  • Token có thể thay thế (SPL Token và Token-2022, bao gồm cả các phần mở rộng)
Một bộ phương thức duy nhất bao quát siêu dữ liệu, quyền sở hữu, số dư, bộ sưu tập, nhà sáng tạo, tìm kiếm và bằng chứng Merkle — nhờ đó, bạn có thể xây dựng sàn giao dịch NFT, ví, công cụ theo dõi danh mục đầu tư, ứng dụng kiểm soát quyền truy cập bằng token và công cụ phân tích trên cùng một API. Cả hai mạng đều sử dụng cùng các phương thức:
  • Mainnet: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Devnet: https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY

​
Tại sao nên dùng Helius cho DAS API?

All asset types, one API

NFT, NFT nén và token có thể thay thế (SPL và Token-2022) thông qua một giao diện duy nhất.

Complete metadata

Dữ liệu on-chain và off-chain (Arweave, IPFS) được lập chỉ mục và trả về cùng nhau trong một lệnh gọi.

Price data included

Thông tin giá bằng USD của các token đã xác minh được trả về cùng với số dư.

Search and filtering

Truy vấn theo chủ sở hữu, bộ sưu tập, nhà sáng tạo, thẩm quyền hoặc các bộ lọc thuộc tính nâng cao.

​
Tôi nên sử dụng phương thức nào?

Hầu hết quy trình tích hợp bắt đầu bằng một trong ba phương thức. Hãy sử dụng bảng này để chọn điểm bắt đầu phù hợp, sau đó dùng các phương thức chuyên biệt bên dưới. Theo nguyên tắc chung:
  • Biết chính xác ID tài sản? Dùng getAsset (hoặc getAssetBatch cho nhiều tài sản).
  • Liệt kê tài sản mà một ví nắm giữ? Dùng getAssetsByOwner.
  • Lọc theo bộ sưu tập, loại token hoặc thuộc tính? Dùng searchAssets.

​
Các phương thức chính

​
Một tài sản

getAsset

Toàn bộ dữ liệu của một tài sản theo ID.

getAssetBatch

Tối đa 1.000 tài sản trong một yêu cầu duy nhất.

​
Tài sản theo chủ sở hữu, bộ sưu tập hoặc nhà sáng tạo

getAssetsByOwner

Tất cả tài sản do một ví nắm giữ, kèm siêu dữ liệu và số dư.

getAssetsByGroup

Tất cả tài sản trong một bộ sưu tập (khóa nhóm collection).

getAssetsByCreator

Tất cả tài sản được đúc bởi một nhà sáng tạo cụ thể.

getAssetsByAuthority

Tất cả tài sản do một thẩm quyền nhất định kiểm soát.

​
Tìm kiếm

searchAssets

Lọc linh hoạt theo chủ sở hữu, bộ sưu tập, tokenType và thuộc tính.

​
Tài sản nén và bằng chứng

getAssetProof

Bằng chứng Merkle cho một tài sản nén, cần thiết cho các thao tác on-chain.

getAssetProofBatch

Bằng chứng Merkle cho nhiều tài sản nén cùng lúc.

getSignaturesForAsset

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

getNftEditions

Tất cả các phiên bản được tạo từ một NFT gốc.

​
Tài khoản token

getTokenAccounts

Tài khoản token theo địa chỉ đúc hoặc chủ sở hữu, kèm số dư.

​
Bắt đầu

Get Assets (NFTs)

Truy xuất NFT và vật phẩm sưu tầm kỹ thuật số: từng tài sản, theo chủ sở hữu, bộ sưu tập, bằng chứng và phiên bản.

Get SPL Tokens

Truy vấn token có thể thay thế: số dư, nguồn cung, người nắm giữ và tài khoản token.

Search Assets

Lọc tài sản theo chủ sở hữu, bộ sưu tập, loại token và thuộc tính.

Pagination

Phân trang theo trang và theo khóa cho các tập kết quả lớn.

​
Làm việc với các loại tài sản đặc biệt

​
Token có thể thay thế

Helius mở rộng DAS API để hỗ trợ tất cả token, bao gồm token SPL thông thường (không có siêu dữ liệu) và Token-2022 (cùng các phần mở rộng của chúng). Tính năng hỗ trợ token có thể thay thế được cung cấp thông qua getAsset, getAssetsByOwner và searchAssets bằng tham số tokenType; giá của các token đã xác minh được trả về trong token_info.price_info. Để truy vấn số dư, nguồn cung, người nắm giữ và tài khoản token, hãy xem hướng dẫn Lấy SPL Token và phần mở rộng token có thể thay thế.

​
NFT nén

NFT nén trạng thái (cNFT) sử dụng cùng các phương thức đọc như NFT thông thường (getAsset, getAssetsByOwner, searchAssets), cùng với hai phương thức dành riêng cho cơ chế nén:
  • getAssetProof trả về bằng chứng Merkle cần thiết để xác minh và thực hiện các thao tác on-chain như chuyển và đốt.
  • getSignaturesForAsset trả về lịch sử giao dịch của một tài sản nén.
Xem hướng dẫn Lấy tài sản để tham khảo đầy đủ các ví dụ về NFT nén.

​
Dữ liệu off-chain

Hầu hết các bộ sưu tập NFT lưu trữ siêu dữ liệu bổ sung (thuộc tính, hình ảnh) trên Arweave hoặc IPFS ở ngoài chuỗi. DAS API lập chỉ mục dữ liệu off-chain này và trả về cùng với dữ liệu on-chain trong một lệnh gọi duy nhất.
Helius không thể phát hiện các thay đổi đối với dữ liệu off-chain. Dữ liệu off-chain chỉ được làm mới khi tài sản xuất hiện trở lại on-chain (ví dụ: khi tài sản được sửa đổi). Để yêu cầu lập chỉ mục lại, hãy liên hệ với bộ phận hỗ trợ của Helius.

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

Pagination

Bắt đầu từ trang 1 (không phải 0). Đặt giới hạn từ 100–1.000 và phân trang đối với các tập dữ liệu lớn.

Error handling

Kiểm tra lỗi trong mọi phản hồi và thử lại với thời gian chờ tăng theo cấp số nhân.

Performance

Sử dụng các phương thức xử lý hàng loạt khi có thể, lưu phản hồi vào bộ nhớ đệm và tránh nối chuỗi nhiều lệnh gọi khi chỉ cần một lệnh gọi.

Security

Tuyệt đối không để lộ khóa API trong mã phía máy khách. Chuyển tiếp yêu cầu qua máy chủ và thiết lập các chính sách CORS.

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

Get Assets (NFTs)

Truy xuất và truy vấn NFT cùng các vật phẩm sưu tầm kỹ thuật số.

DAS API reference

Lược đồ đầy đủ của yêu cầu và phản hồi cho mọi phương thức DAS.

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.