メインコンテンツへスキップ

概要

最初は、DAS APIはMetaplex NFTおよびcNFTに対する所有権クエリのみをサポートしていました。Heliusは、DAS APIを拡張して、メタデータなしのSPLトークンやToken-2022(およびその拡張機能)を含むすべてのトークンをサポートしました。 すべてのトークン(SPL、Token-2022、NFT、および圧縮NFT)にわたる任意のアカウントのトークン残高をクエリできます。USDでのトークン価格も含まれています。Solanaトークンはそのミントアカウントによって定義されます。例えば、USDCのミントアカウントはEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1vです。$40のUSDCを購入すると、40 USDCトークンを保持するトークンアカウントが作成されます。ウォレットは異なるトークンのトークンアカウントを何百も保持できます。 Token-2022について詳しくは、Heliusのブログ投稿を参照してください。

使用タイミング

ファンジブルトークンの拡張機能を使用して、アカウントの資産—ファンジブルトークン、NFT、および圧縮NFT—をメタデータとUSD価格とともに、1つのDAS呼び出しで統一ビューとして取得したい場合に使用してください。ポートフォリオトラッカー、ウォレット、トークンダッシュボードに最適です。 メタデータや価格が不要で、生のオンチェーン値(単一アカウントの残高、総供給量、最大の所持者)だけが必要な場合は、標準のRPCトークンメソッド(getTokenAccountBalancegetTokenAccountsByOwnergetTokenSupplygetTokenLargestAccounts)を利用してください。そのためのGet SPL Tokensガイドを参照してください。

動作方法

Heliusのファンジブルトークン拡張機能は、所有権インデックスを中心に動作します。以下のメソッドがアカウントの資産の統一ビューを提供します:getAssetgetAssetsByOwner、およびsearchAssets この拡張機能には、アカウントが所有するすべての資産、ファンジブルトークンおよびToken-2022トークンを含むクエリを行うための追加フィールドtokenTypeがあります。tokenTypeのオプションは以下の通りです。
  • fungible: すべてのファンジブルトークンを返します。
  • nonFungible: すべてのNFT(圧縮および通常のNFT)を返します。
  • regularNft: 通常のNFTのみを返します。
  • compressedNft: 圧縮NFTのみを返します。
  • all: すべてのトークンを返します。
例のリクエスト:
レスポンスには、JitoSOLのようなファンジブルトークンが含まれるようになりました。各項目には、総アカウント残高、トークンのプログラムアドレス、関連トークンアドレス、流通している総供給量、価格情報が含まれています。以下のトリムされた項目には関連フィールドが示されています。

Token-2022 のサポート

HeliusはToken-2022トークンをサポートし、その拡張機能を解析します。レスポンスには、トークンがToken-2022プログラムを使用している場合、mint_extensionsフィールドが含まれています。以下のトリムされた項目には、BERNのmint_extensionsフィールドが示されています。

後方互換性

後方互換性の場合、tokenTypeが省略されると、元のDASと同じ動作になり、NFTと圧縮NFTのみが返されます。

次のステップ

SPLトークンの取得

残高、供給量、所持者、およびトークンアカウント。

資産の検索

tokenType、owner、およびcollectionでフィルタリング。

searchAssetsリファレンス

完全なリクエストおよびレスポンススキーマ。