Apa itu DAS API?
Digital Asset Standard (DAS) API adalah spesifikasi sumber terbuka yang menyediakan satu antarmuka terpadu untuk setiap jenis aset digital di Solana:- NFT reguler (Token yang Tidak Dapat Dipertukarkan)
- NFT terkompresi (cNFT, menggunakan kompresi status)
- Token yang dapat dipertukarkan (SPL Token dan Token-2022, termasuk ekstensi)
- Mainnet:
https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY - Devnet:
https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
Mengapa menggunakan Helius untuk DAS API?
All asset types, one API
NFT, NFT terkompresi, dan token yang dapat dipertukarkan (SPL dan Token-2022) melalui satu antarmuka.
Complete metadata
Data on-chain dan off-chain (Arweave, IPFS) diindeks dan dikembalikan bersama dalam satu panggilan.
Price data included
Informasi harga dalam USD untuk token terverifikasi, dikembalikan bersama saldo.
Search and filtering
Buat kueri berdasarkan pemilik, koleksi, kreator, otoritas, atau filter atribut terperinci.
Metode mana yang sebaiknya digunakan?
Sebagian besar integrasi dimulai dengan salah satu dari tiga metode. Gunakan tabel ini untuk memilih titik masuk yang tepat, lalu gunakan metode khusus di bawah ini.
Sebagai pedoman umum:
- Mengetahui ID aset yang tepat? Gunakan
getAsset(ataugetAssetBatchuntuk banyak aset). - Ingin menampilkan aset milik sebuah dompet? Gunakan
getAssetsByOwner. - Ingin memfilter berdasarkan koleksi, jenis token, atau atribut? Gunakan
searchAssets.
Metode utama
Aset tunggal
getAsset
Data lengkap untuk satu aset berdasarkan ID-nya.
getAssetBatch
Hingga 1.000 aset dalam satu permintaan.
Aset berdasarkan pemilik, koleksi, atau kreator
getAssetsByOwner
Semua aset yang dimiliki sebuah dompet, beserta metadata dan saldo.
getAssetsByGroup
Semua aset dalam sebuah koleksi (kunci grup
collection).getAssetsByCreator
Semua aset yang dicetak oleh kreator tertentu.
getAssetsByAuthority
Semua aset yang dikendalikan oleh otoritas tertentu.
Pencarian
searchAssets
Pemfilteran fleksibel berdasarkan pemilik, koleksi,
tokenType, dan atribut.Aset terkompresi dan bukti
getAssetProof
Bukti Merkle untuk aset terkompresi, yang diperlukan untuk operasi on-chain.
getAssetProofBatch
Bukti Merkle untuk beberapa aset terkompresi sekaligus.
getSignaturesForAsset
Riwayat tanda tangan transaksi untuk suatu aset.
getNftEditions
Semua edisi yang dicetak dari NFT master.
Akun token
getTokenAccounts
Akun token berdasarkan mint atau pemilik, beserta saldo.
Mulai
Get Assets (NFTs)
Ambil NFT dan barang koleksi digital: aset tunggal, berdasarkan pemilik, koleksi, bukti, dan edisi.
Get SPL Tokens
Buat kueri untuk token yang dapat dipertukarkan: saldo, suplai, pemegang, dan akun token.
Search Assets
Filter aset berdasarkan pemilik, koleksi, jenis token, dan atribut.
Pagination
Paginasi berbasis halaman dan keyset untuk kumpulan hasil berukuran besar.
Menggunakan jenis aset khusus
Token yang dapat dipertukarkan
Helius memperluas DAS API agar mencakup semua token, termasuk token SPL biasa (tanpa metadata) dan Token-2022 (beserta ekstensinya). Dukungan token yang dapat dipertukarkan tersedia melaluigetAsset, getAssetsByOwner, dan searchAssets menggunakan parameter tokenType, sedangkan harga token terverifikasi dikembalikan dalam token_info.price_info.
Untuk kueri saldo, suplai, pemegang, dan akun token, lihat panduan Mendapatkan Token SPL dan ekstensi token yang dapat dipertukarkan.
NFT terkompresi
NFT dengan kompresi status (cNFT) menggunakan metode yang sama seperti NFT reguler untuk operasi baca (getAsset, getAssetsByOwner, searchAssets), ditambah dua metode khusus kompresi:
getAssetProofmengembalikan bukti Merkle yang diperlukan untuk memverifikasi dan menjalankan operasi on-chain seperti transfer dan pembakaran.getSignaturesForAssetmengembalikan riwayat transaksi untuk aset terkompresi.
Data off-chain
Sebagian besar koleksi NFT menyimpan metadata tambahan (atribut, gambar) secara off-chain di Arweave atau IPFS. DAS API mengindeks data off-chain ini dan mengembalikannya bersama data on-chain dalam satu panggilan.Helius tidak dapat mendeteksi perubahan data off-chain. Data off-chain hanya diperbarui setelah aset terlihat lagi secara on-chain (misalnya, ketika aset diubah). Untuk meminta pengindeksan ulang, hubungi dukungan Helius.
Praktik terbaik
Pagination
Mulai dari halaman 1 (bukan 0). Gunakan batas 100–1.000 dan terapkan paginasi untuk kumpulan data berukuran besar.
Error handling
Periksa kesalahan pada setiap respons dan coba lagi dengan backoff eksponensial.
Performance
Gunakan metode batch jika memungkinkan, simpan respons dalam cache, dan hindari merangkai beberapa panggilan jika satu panggilan sudah cukup.
Security
Jangan pernah mengekspos kunci API Anda dalam kode sisi klien. Proksikan permintaan melalui server dan tetapkan kebijakan CORS.
Langkah berikutnya
Get Assets (NFTs)
Ambil dan buat kueri untuk NFT serta barang koleksi digital.
DAS API reference
Skema permintaan dan respons lengkap untuk setiap metode DAS.
DAS API FAQ
Pertanyaan umum tentang aset, data harga, dan penggunaan.