主な使用例
- アカウントのSOL保有量を迅速に確認する: 主な用途は、アカウント(ウォレット、プログラムなど)がどれだけのSOLを保有しているかを確認することです。
パラメータ
- パブリックキー(string, 必須):クエリを行うアカウントのbase-58エンコードされた公開鍵です。
-
設定オブジェクト(object, オプション):次のフィールドを含む設定オブジェクトです。
- コミットメントレベル(string, オプション):クエリに使用するコミットメントレベルを指定します。デフォルトは「max」です。
- max: ノードはクラスターの過半数によって最大ロックアウトに達したと確認された最新のブロックをクエリします。
- recent: ノードはクラスターの過半数によって投票された最新のブロックをクエリします。
- single: ノードは自身の最新のブロックをクエリします。注意: ブロックが完了していない可能性があります。
- スロット(number, オプション):リクエストが評価される最小スロットです。
- コミットメントレベル(string, オプション):クエリに使用するコミットメントレベルを指定します。デフォルトは「max」です。
レスポンス
JSON-RPCレスポンスの”result”フィールドには次のオブジェクトが含まれます。- コンテナ(object):
- スロット(number):残高が取得されたスロット。
- RPC APIバージョン(string, オプション):すべてのノードからは提供されない場合もあります。
- 残高(number):アカウントの残高(unsigned 64-bit integer)をlamport単位で表示。
例:アカウントの残高を取得する
メインネットでSerum Program V3 IDのSOL残高をチェックしてみましょう。このプログラムアカウント自体は家賃免除のためにSOLを保持しています。 注意: 以下の例であなたの実際のHelius APIキーを置き換えてください。開発者向けヒント
- SOL残高の簡易確認: アカウントのSOL残高のみが必要で、オンチェーンデータ(オーナー、データ、または実行可能な状態など)が不要の場合、getBalanceは効果的です。
- 存在しないアカウント: アカウントがオンチェーンに存在しない場合(初期化されていない、またはSOLを保持していない)、getBalanceは0を返します。これにより、SOL残高を気にする場合にアカウントの存在をすばやく確認できます。
- Lamports と SOL: 残高はlamports単位で返されるため、SOLに変換するには1,000,000,000で割る必要があります。
- コミットメントレベル: コミットメントレベルの選択は、残高の速さと確認の程度に影響を与える可能性があります。UI表示目的では「recent」が良いバランスを提供します。重要な金融取引には「max」が最も高い保証を提供します。Solana Commitment Levelsで詳細情報をご覧ください。
- 複数アカウントのバッチ処理: getBalanceは単一アカウント用ですが、多くのアカウントの残高が必要な場合、getMultipleAccountsを使用して各アカウントの情報からlamport残高を抽出することにより、個別のgetBalance呼び出しを行うより高性能です。
関連メソッド
getAccountInfo
データ、オーナー、および実行可能ステータスを含む完全なアカウント情報を取得します
getMultipleAccounts
単一のリクエストで複数アカウントのバッチ取得