Solana Fungible Token API: Vollständiger Zugriff auf Token-Daten

Übersicht

Zunächst unterstützte die DAS API nur Besitzanfragen gegen Metaplex-NFTs und cNFTs. Helius hat die DAS API erweitert, um alle Token zu unterstützen, einschließlich einfacher SPL-Token (ohne Metadaten) und Token-2022 (plus deren Erweiterungen). Sie können die Token-Salden eines beliebigen Kontos über alle Token hinweg abfragen (SPL, Token-2022, NFTs und komprimierte NFTs), mit USD-Preisen inklusive. Ein Solana-Token wird durch sein Mint-Konto definiert. Beispielsweise ist das Mint-Konto für USDC EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v. Wenn Sie $40 USDC kaufen, wird ein Token-Konto erstellt, das 40 USDC-Token hält. Eine Wallet kann Hunderte von Token-Konten für verschiedene Token halten. Um mehr über Token-2022 zu erfahren, siehe den Helius Blogbeitrag.

Wann man dies verwenden sollte

Verwenden Sie die fungible Token-Erweiterung, wenn Sie eine einheitliche Ansicht der Vermögenswerte eines Kontos wünschen — fungible Token, NFTs und komprimierte NFTs — in einem DAS-Aufruf, mit Metadaten und USD-Preisen. Dies ist die richtige Wahl für Portfolio-Tracker, Wallets und Token-Dashboards. Nutzen Sie die Standard-RPC-Token-Methoden (getTokenAccountBalance, getTokenAccountsByOwner, getTokenSupply, getTokenLargestAccounts), wenn Sie nur rohe On-Chain-Werte benötigen — einen einzelnen Kontostand, das Gesamtangebot oder die größten Inhaber — ohne Metadaten oder Preise. Siehe den Get SPL Tokens Leitfaden dafür.

Wie es funktioniert

Die Helius-Erweiterung für fungible Token dreht sich um Besitz-Indexierung. Die folgenden Methoden bieten eine einheitliche Ansicht der Vermögenswerte eines Kontos: getAsset, getAssetsByOwner und searchAssets. Die Erweiterung fügt ein zusätzliches Feld namens tokenType hinzu, das es Ihnen ermöglicht, gegen alle Vermögenswerte abzufragen, die das Konto besitzt, einschließlich fungibler und Token-2022-Token. Die Optionen für tokenType sind:

fungible: Gibt alle fungiblen Token zurück.
nonFungible: Gibt alle NFTs (komprimiert und regulär) zurück.
regularNft: Gibt nur die regulären NFTs zurück.
compressedNft: Gibt nur die komprimierten NFTs zurück.
all: Gibt alle Token zurück.

Beispielanfrage:

{
    "jsonrpc": "2.0",
    "id": "helius-test",
    "method": "searchAssets",
    "params": {
        "ownerAddress": "5aZZ4duJUKiMsJN9vRsoAn4SDX7agvKu7Q3QdFWRfWze",
        "tokenType": "all"
    }
}

Die Antwort enthält jetzt fungible Token wie JitoSOL. Jedes Element enthält den gesamten Kontostand, die Programmadresse des Tokens, die zugeordnete Token-Adresse, die insgesamt im Umlauf befindliche Menge und die Preisinformationen. Das gekürzte Element unten zeigt die relevanten Felder:

{
    "id": "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
    "content": {
        "$schema": "",
        "json_uri": "",
        "metadata": {
            "description": "MEV-Powered Liquid Staking Derivative",
            "name": "Jito Staked SOL",
            "symbol": "JitoSOL",
            "token_standard": "Fungible"
        }
        // ...
    },
    "token_info": {
        "symbol": "JitoSOL",
        "balance": 35688813508,
        "supply": 5949594702758293,
        "decimals": 9,
        "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
        "associated_token_address": "H7iLu4DPFpzEx1AGN8BCN7Qg966YFndt781p6ukhgki9",
        "price_info": {
            "price_per_token": 56.47943,
            "total_price": 2015.6838854339217,
            "currency": "USDC"
        }
    }
    // ...
}

Token-2022-Unterstützung

Helius unterstützt Token-2022-Token und analysiert deren Erweiterungen. Die Antwort enthält das Feld mint_extensions, wenn das Token das Token-2022-Programm verwendet. Das gekürzte Element unten zeigt das Feld mint_extensions für BERN:

{
    "mint_extensions": {
        "transfer_fee_config": {
            "withheld_amount": 0,
            "newer_transfer_fee": {
                "epoch": 457,
                "maximum_fee": 3906250000000000000,
                "transfer_fee_basis_points": 690
            },
            "older_transfer_fee": {
                "epoch": 455,
                "maximum_fee": 3906250000000000000,
                "transfer_fee_basis_points": 0
            },
            "withdraw_withheld_authority": "7MyTjmRygJoCuDBUtAuSugiYZFULD2SWaoUTmtjtRDzD",
            "transfer_fee_config_authority": "7MyTjmRygJoCuDBUtAuSugiYZFULD2SWaoUTmtjtRDzD"
        }
    }
    // ...
}

Rückwärtskompatibilität

Für die Rückwärtskompatibilität ist das Verhalten identisch mit dem ursprünglichen DAS, wenn tokenType weggelassen wird: Es werden nur NFTs und komprimierte NFTs zurückgegeben.

{
    "jsonrpc": "2.0",
    "id": "helius-test",
    "method": "searchAssets",
    "params": {
        "ownerAddress": "5aZZ4duJUKiMsJN9vRsoAn4SDX7agvKu7Q3QdFWRfWze"
    }
}

Nächste Schritte

SPL-Token abrufen

Salden, Angebot, Inhaber und Token-Konten.

Vermögenswerte suchen

Filtern nach tokenType, Besitzer und Sammlung.

searchAssets Referenz

Vollständige Anfrage- und Antwortschemata.

Erste Schritte

Daten-Streaming & Ereignisüberwachung

Daten-APIs & RPCs

Handel

Transaktionen senden

Wallet-as-a-Service

Privatsphäre

Ressourcen

Solana Fungible Token API: Vollständiger Zugriff auf Token-Daten

Übersicht

Wann man dies verwenden sollte

Wie es funktioniert

Token-2022-Unterstützung

Rückwärtskompatibilität

Nächste Schritte

SPL-Token abrufen

Vermögenswerte suchen

searchAssets Referenz

​Übersicht

​Wann man dies verwenden sollte

​Wie es funktioniert

​Token-2022-Unterstützung

​Rückwärtskompatibilität

​Nächste Schritte

SPL-Token abrufen

Vermögenswerte suchen

searchAssets Referenz

Übersicht

Wann man dies verwenden sollte

Wie es funktioniert

Token-2022-Unterstützung

Rückwärtskompatibilität

Nächste Schritte