Was ist die DAS API?
Die Digital Asset Standard (DAS) API ist eine Open-Source-Spezifikation, die Ihnen ein einheitliches Interface für jeden Typ von digitalem Asset auf Solana bietet:- Reguläre NFTs (Non-Fungible Tokens)
- Komprimierte NFTs (cNFTs, unter Verwendung von State-Kompression)
- Fungible Tokens (SPL Token und Token-2022, einschließlich Erweiterungen)
- Mainnet:
https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY - Devnet:
https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
Warum Helius für die DAS API?
Alle Asset-Typen, eine API
NFTs, komprimierte NFTs und fungible Tokens (SPL und Token-2022) über ein einziges Interface.
Vollständige Metadaten
On-Chain- und Off-Chain-Daten (Arweave, IPFS), die zusammen in einem Aufruf indiziert und zurückgegeben werden.
Preisdaten enthalten
USD-Preisinformationen für verifizierte Tokens, zusammen mit Salden zurückgegeben.
Suche und Filterung
Abfrage nach Besitzer, Sammlung, Ersteller, Autorität oder umfangreichen Attributfiltern.
Welche Methode sollte ich verwenden?
Die meisten Integrationen beginnen mit einer von drei Methoden. Verwenden Sie diese Tabelle, um den richtigen Einstiegspunkt zu wählen, und greifen Sie dann auf die unten aufgeführten spezialisierten Methoden zurück.
Als Faustregel gilt:
- Kennen Sie die genaue Asset-ID? Verwenden Sie
getAsset(odergetAssetBatchfür viele). - Listen Sie die Bestände einer Wallet auf? Verwenden Sie
getAssetsByOwner. - Filtern nach Sammlung, Token-Typ oder Attributen? Verwenden Sie
searchAssets.
Wichtige Methoden
Einzelnes Asset
getAsset
Vollständige Daten für ein Asset anhand seiner ID.
getAssetBatch
Bis zu 1.000 Assets in einer einzigen Anfrage.
Assets nach Besitzer, Sammlung oder Ersteller
getAssetsByOwner
Alle von einer Wallet gehaltenen Assets mit Metadaten und Salden.
getAssetsByGroup
Alle Assets in einer Sammlung (Gruppenschlüssel
collection).getAssetsByCreator
Alle von einem bestimmten Ersteller geprägten Assets.
getAssetsByAuthority
Alle von einer bestimmten Autorität kontrollierten Assets.
Suche
searchAssets
Flexible Filterung nach Besitzer, Sammlung,
tokenType und Attributen.Komprimierte Assets und Beweise
getAssetProof
Merkle-Beweis für ein komprimiertes Asset, erforderlich für On-Chain-Operationen.
getAssetProofBatch
Merkle-Beweise für mehrere komprimierte Assets auf einmal.
getSignaturesForAsset
Transaktionssignaturverlauf für ein Asset.
getNftEditions
Alle Editionen, die von einem Master-NFT gedruckt wurden.
Token-Konten
getTokenAccounts
Token-Konten nach Mint oder Besitzer mit Salden.
Erste Schritte
Get Assets (NFTs)
NFTs und digitale Sammelobjekte abrufen: einzelnes Asset, nach Besitzer, Sammlungen, Beweise und Editionen.
Get SPL Tokens
Fungible Tokens abfragen: Salden, Angebot, Inhaber und Token-Konten.
Search Assets
Assets nach Besitzer, Sammlung, Token-Typ und Attributen filtern.
Pagination
Seitenbasierte und Keyset-Paginierung für große Ergebnismengen.
Arbeiten mit speziellen Asset-Typen
Fungible Tokens
Helius erweitert die DAS API, um alle Tokens abzudecken, einschließlich einfacher SPL Tokens (ohne Metadaten) und Token-2022 (plus deren Erweiterungen). Unterstützung für Fungible Tokens ist übergetAsset, getAssetsByOwner und searchAssets mit dem tokenType Parameter verfügbar, und Preise für verifizierte Tokens werden unter token_info.price_info zurückgegeben.
Für Salden-, Angebots-, Inhaber- und Token-Kontoabfragen siehe den Get SPL Tokens Leitfaden und die fungible Token Erweiterung.
Komprimierte NFTs
State-komprimierte NFTs (cNFTs) verwenden die gleichen Methoden wie reguläre NFTs für Lesezugriffe (getAsset, getAssetsByOwner, searchAssets), plus zwei kompressionsspezifische Methoden:
getAssetProofgibt den Merkle-Beweis zurück, der zur Verifizierung und Durchführung von On-Chain-Operationen wie Übertragungen und Brennen erforderlich ist.getSignaturesForAssetgibt den Transaktionsverlauf für ein komprimiertes Asset zurück.
Off-Chain-Daten
Die meisten NFT-Sammlungen speichern zusätzliche Metadaten (Attribute, Bilder) außerhalb der Chain auf Arweave oder IPFS. Die DAS API indiziert diese Off-Chain-Daten und gibt sie zusammen mit On-Chain-Daten in einem einzigen Aufruf zurück.Helius kann keine Off-Chain-Datenmutationen erkennen. Off-Chain-Daten werden nur dann aktualisiert, wenn das Asset erneut On-Chain gesehen wird (zum Beispiel, wenn es modifiziert wird). Um eine erneute Indizierung anzufordern, wenden Sie sich an den Helius-Support.
Beste Praktiken
Pagination
Beginnen Sie auf Seite 1 (nicht 0). Verwenden Sie Limits von 100–1.000 und paginieren Sie für große Datensätze.
Fehlerbehandlung
Überprüfen Sie bei jeder Antwort auf Fehler und versuchen Sie es mit exponentieller Rückoff-Methode erneut.
Leistung
Verwenden Sie nach Möglichkeit Batch-Methoden, cachen Sie Antworten und vermeiden Sie das Verkettung von Aufrufen, wenn einer ausreicht.
Sicherheit
Legen Sie Ihren API-Schlüssel niemals in klientseitigem Code offen. Leiten Sie Anfragen über einen Server weiter und setzen Sie CORS-Richtlinien fest.
Nächste Schritte
Get Assets (NFTs)
Abrufen und Abfragen von NFTs und digitalen Sammlerstücken.
DAS API Referenz
Vollständige Anfragen- und Antwortschemata für jede DAS-Methode.
DAS API FAQ
Häufige Fragen zu Assets, Preisdaten und Verwendung.