メインコンテンツへスキップ
getTokenSupply RPCメソッドは、特定のSPLトークンミントの総供給量を返します。これは、作成されたトークンの全体量を理解するために不可欠です。

一般的な使用例

  • トークン情報の表示: エクスプローラやウォレットインターフェースでトークンの総供給量を表示します。
  • トークノミクス分析: トークンの最大または現在の総発行量を理解します。
  • 検証: ミントアカウント自体が報告するトークン供給を確認します。
  • 供給変動の監視: トークンがミント可能な場合、その総供給の変化を追跡するのに使用できます(ただし、代替可能なトークンの場合、供給は通常固定されているか、発行権限によって管理されています)。

リクエストパラメーター

  1. mintAddress (string, required): クエリしたいトークンミントのbase-58でエンコードされた公開鍵。
  2. options (object, optional): オプションの設定オブジェクトには以下を含めることができます:

レスポンス構造

JSON-RPCレスポンスのresult.valueフィールドには、トークンの供給に関する詳細が含まれています。
  • amount (string): トークンの最小単位(生データ量)での総供給。文字列として提供されます。この値は小数点には調整されていません。
  • decimals (u8): このトークンミントで定義された小数点以下の桁数。これは、生データ量を人間が読みやすい形式に変換するのに重要です。
  • uiAmount (number | null): トークンのdecimalsに合わせて調整された、浮動小数点数としてのトークンの総供給。このフィールドはnullまたは精度が低い場合があります。表示には通常、uiAmountStringが推奨されます。
  • uiAmountString (string): トークンのdecimalsに合わせて調整された文字列としてのトークンの総供給。これは総供給の最もユーザーフレンドリーな表現です。
レスポンスの例:

コード例

開発者向けヒント

  • 供給が不変(通常): ほとんどのSPLトークンでは、ミントアカウント自体の観点から見た総供給量は固定されており、特定の発行権限がある場合を除き、トークンを追加発行したり、(通常はトークンアカウントから)焼却することはできません。
  • decimalsが重要: amountまたはuiAmountStringを正しく解釈するために、必ずdecimalsフィールドを使用してください。
  • データソース: このメソッドはミントアカウントに直接クエリを実行し、供給情報を取得します。
このガイドは、Solana上でのSPLトークン供給のクエリにおいて、getTokenSupply RPCメソッドを効果的に使用するための必要な情報を提供します。