getTokenSupply RPCメソッドは、特定のSPLトークンミントの総供給量を返します。これは、作成されたトークンの全体量を理解するために不可欠です。
一般的な使用例
- トークン情報の表示: エクスプローラやウォレットインターフェースでトークンの総供給量を表示します。
- トークノミクス分析: トークンの最大または現在の総発行量を理解します。
- 検証: ミントアカウント自体が報告するトークン供給を確認します。
- 供給変動の監視: トークンがミント可能な場合、その総供給の変化を追跡するのに使用できます(ただし、代替可能なトークンの場合、供給は通常固定されているか、発行権限によって管理されています)。
リクエストパラメーター
-
mintAddress(string, required): クエリしたいトークンミントのbase-58でエンコードされた公開鍵。 -
options(object, optional): オプションの設定オブジェクトには以下を含めることができます:commitment(string, optional): クエリのコミットメントレベルを指定します (例:"finalized","confirmed","processed")。
レスポンス構造
JSON-RPCレスポンスのresult.valueフィールドには、トークンの供給に関する詳細が含まれています。
amount(string): トークンの最小単位(生データ量)での総供給。文字列として提供されます。この値は小数点には調整されていません。decimals(u8): このトークンミントで定義された小数点以下の桁数。これは、生データ量を人間が読みやすい形式に変換するのに重要です。uiAmount(number | null): トークンのdecimalsに合わせて調整された、浮動小数点数としてのトークンの総供給。このフィールドはnullまたは精度が低い場合があります。表示には通常、uiAmountStringが推奨されます。uiAmountString(string): トークンのdecimalsに合わせて調整された文字列としてのトークンの総供給。これは総供給の最もユーザーフレンドリーな表現です。
コード例
開発者向けヒント
- 供給が不変(通常): ほとんどのSPLトークンでは、ミントアカウント自体の観点から見た総供給量は固定されており、特定の発行権限がある場合を除き、トークンを追加発行したり、(通常はトークンアカウントから)焼却することはできません。
decimalsが重要:amountまたはuiAmountStringを正しく解釈するために、必ずdecimalsフィールドを使用してください。- データソース: このメソッドはミントアカウントに直接クエリを実行し、供給情報を取得します。
getTokenSupply RPCメソッドを効果的に使用するための必要な情報を提供します。