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

DAS APIとは?

デジタル資産標準(DAS)APIは、Solana上のすべての種類のデジタル資産に対して統一されたインターフェースを提供するオープンソースの仕様です:
  • 通常のNFT(Non-Fungible Tokens)
  • 圧縮NFT(cNFT、状態圧縮を使用)
  • ファンジブルトークン(SPLトークンとトークン-2022、拡張を含む)
単一のメソッドセットがメタデータ、所有権、残高、コレクション、制作者、検索、Merkle証明をカバーするため、NFTマーケットプレイス、ウォレット、ポートフォリオトラッカー、トークンゲートアプリ、分析ツールを同じAPIで構築できます。 両方のネットワークが同じメソッドを共有します:
  • Mainnet: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Devnet: https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY

なぜDAS APIにHeliusを使うのか?

すべてのアセットタイプ、一つのAPI

単一インターフェースを通じてNFT、圧縮NFT、およびファンジブルトークン(SPLおよびトークン-2022)を提供。

完全なメタデータ

オンチェーンおよびオフチェーンデータ(Arweave、IPFS)を一つの呼び出しでインデックス化して返します。

価格データを含む

検証済みのトークン用のUSD価格情報を残高と一緒に返します。

検索とフィルタリング

所有者、コレクション、制作者、権限、または豊富な属性フィルターでクエリを行います。

どのメソッドを使用すべきか?

ほとんどの統合は3つのメソッドのいずれかから始まります。このテーブルを使用して正しいエントリポイントを選び、以下の特殊メソッドにアクセスしてください。 一般的なルールとして:
  • 正確なアセットIDがわかっている? getAsset(または多くの場合はgetAssetBatch)を使います。
  • ウォレットの保有をリストアップしますか? getAssetsByOwnerを使います。
  • コレクション、トークンタイプ、または属性でフィルタリングしますか? searchAssetsを使います。

主要メソッド

単一アセット

getAsset

IDによる一つのアセットの完全データ。

getAssetBatch

一度に最大1,000アセットのリクエスト。

所有者、コレクション、または制作者別のアセット

getAssetsByOwner

ウォレットが所有するすべてのアセット、メタデータと残高を含む。

getAssetsByGroup

コレクション内のすべてのアセット(グループキーcollection)。

getAssetsByCreator

特定の制作者によって作成されたすべてのアセット。

getAssetsByAuthority

指定された権限によって管理されるすべてのアセット。

検索

searchAssets

所有者、コレクション、tokenType、および属性による柔軟なフィルタリング。

圧縮資産と証明

getAssetProof

オンチェーン操作に必要な圧縮資産のMerkle証明。

getAssetProofBatch

複数の圧縮資産のMerkle証明を一度に。

getSignaturesForAsset

アセットのトランザクション署名履歴。

getNftEditions

マスターNFTから作成されたすべてのエディション。

トークンアカウント

getTokenAccounts

鋳造または所有者によるトークンアカウント、残高を含む。

始めるには

アセット(NFT)の取得

単一のアセット、所有者、コレクション、証明、エディションでNFTとデジタルコレクションを取得します。

SPLトークンの取得

ファンジブルトークンをクエリ:残高、供給、保有者、トークンアカウント。

アセットの検索

所有者、コレクション、トークンタイプ、および属性によってアセットをフィルタリングします。

ページネーション

大きな結果セットのためのページベースおよびキーセットページネーション。

特別な資産タイプの操作

ファンジブルトークン

Heliusは、通常のSPLトークン(メタデータなし)およびトークン-2022(およびその拡張)を含むすべてのトークンをカバーするようにDAS APIを拡張します。ファンジブルトークンサポートは、getAssetgetAssetsByOwner、およびsearchAssetsを使用し、検証済みトークンの価格はtoken_info.price_infoで返されます。 残高、供給、保有者、トークンアカウントクエリについては、SPLトークン取得ガイドおよびファンジブルトークン拡張をご覧ください。

圧縮NFT

状態が圧縮されたNFT(cNFT)は、読み取りに対して通常のNFTと同じメソッド(getAssetgetAssetsByOwnersearchAssets)を使用し、圧縮特有の2つのメソッドを追加します:
  • getAssetProofは、転送やバーンなどのオンチェーン操作を検証および実行するために必要なMerkle証明を返します。
  • getSignaturesForAssetは、圧縮されたアセットのトランザクション履歴を返します。
完全な圧縮NFT例については、アセット取得ガイドをご覧ください。

オフチェーンデータ

ほとんどのNFTコレクションは、追加のメタデータ(属性、画像)をArweaveまたはIPFSにオフチェーンで保存します。DAS APIは、このオフチェーンデータをインデックス化し、オンチェーンデータと一緒に単一の呼び出しで返します。
Heliusはオフチェーンデータの変更を検出できません。オフチェーンデータは、アセットがオンチェーンで再度見られたときにのみ(たとえば変更されたとき)更新されます。再インデックスをリクエストするには、Heliusサポートに連絡してください。

ベストプラクティス

ページネーション

ページ1(0ではなく)から開始します。100〜1,000の制限を使用し、大規模なデータセットに対してページネーションします。

エラーハンドリング

すべての応答でエラーをチェックし、指数バックオフでリトライします。

パフォーマンス

可能な場合はバッチメソッドを使用し、応答をキャッシュし、1回で済む場合は連鎖呼び出しを避けます。

セキュリティ

APIキーをクライアントサイドのコードに公開しないでください。リクエストをサーバー経由でプロキシし、CORSポリシーを設定します。

次のステップ

アセット(NFT)の取得

NFTとデジタルコレクションを取得およびクエリ。

DAS APIリファレンス

すべてのDASメソッドの完全なリクエストおよび応答スキーマ。

DAS API FAQ

アセット、価格データ、使用法に関するよくある質問。