getFirstAvailableBlock RPCメソッドは、クエリされたノードからまだ元帳から削除されていない最も古い確認済みブロックのスロット番号を返します。これは、特定のノードが現在保存している履歴データの範囲を理解するのに役立ちます。
一般的な使用例
- 履歴データクエリ: 特定のノードで履歴のブロックやトランザクションデータのクエリを開始できる開始点を決定します。
- ノードの同期チェック: 同期の直接的な測定ではありませんが、他のノードに比べてどれだけの履歴データを保持しているかのアイデアを得ることができます。
- 元帳分析: 特定のRPCエンドポイントで利用可能な元帳の深さを理解します。
リクエストパラメータ
このメソッドはパラメータを取らない。レスポンス構造
JSON-RPCレスポンスのresultフィールドは、最初の利用可能なブロックのスロット番号を表すu64(符号なし64ビット整数)になります。
例
1. 最初の利用可能なブロックスロットを取得
この例では、クエリされたノードで利用可能な最も古いブロックのスロットを取得します。開発者へのヒント
- ノード固有: 最初の利用可能なブロックは、異なるRPCノード間で大きく異なる場合があります。ノードは元帳データを異なる速度で削除するように設定できるため、あるノードはより深い履歴を持つことがあります。
- 固定ではない:
getFirstAvailableBlockで返される値は、スペースを節約するために古いスロットが最終的に削除されると時間とともに増加します。 - 確認済みブロック: このメソッドは確認済みブロックを指します。処理されたがまだ確認または確定されていないブロックは考慮されません。
getFirstAvailableBlock RPCメソッドを使用する方法を説明します。