getEpochScheduleの使用方法

​

一般的な使用例

• エポック境界の予測: エポック内のスロット数を決定し、現在のエポックがいつ終了し、次がいつ開始するかを推定します。
• リーダースケジュール計算: leaderScheduleSlotOffsetを理解して、来るエポックのリーダースケジュールがどれだけ前に生成されるかを知ります。
• ネットワーク初期化の分析: warmup、firstNormalEpoch、firstNormalSlotを観察して、クラスターのエポック長の初期ランプアップフェーズを理解します（該当する場合）。
• ネットワーク監視ツールの構築: この情報を使用して、エポックのタイミングと進行を正確に表示します。

​

リクエストパラメータ

​

応答構造

• slotsPerEpoch (u64): 各エポックの最大スロット数（ウォームアップ期間後）。
• leaderScheduleSlotOffset (u64): そのエポックのリーダースケジュールが生成されるエポック開始前のスロット数。
• warmup (boolean): クラスターがウォームアップ期間を持ち、エポックが短く始まり徐々に長くなるかどうかを示すブール値。
• firstNormalEpoch (u64): 完全なslotsPerEpoch長を持つ最初のエポック番号。warmupがtrueの場合に関連します。
• firstNormalSlot (u64): firstNormalEpochの最初のスロットのスロットインデックス。warmupがtrueの場合に関連します。

​

例

​

1. クラスターのエポックスケジュールを取得

curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getEpochSchedule"
  }'

const { Connection } = require('@solana/web3.js');

async function getClusterEpochSchedule() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const epochSchedule = await connection.getEpochSchedule();
    console.log(JSON.stringify(epochSchedule, null, 2));
  } catch (error) {
    console.error('Error fetching epoch schedule:', error);
  }
}

getClusterEpochSchedule();

​

開発者向けのヒント

• 静的情報: エポックスケジュールはクラスターのジェネシス設定によって決定され、重大なネットワークアップグレードまたは異なるパラメータを持つ新しいクラスターの起動がない限り、一般的に変更されません。
• メインネットとテストネット/Devnet: エポックスケジュール、特にslotsPerEpochとウォームアップパラメータは、メインネットベータ、テストネット、およびDevnetの間で大きく異なる場合があります。関心のある特定のクラスターを必ずクエリしてください。
• ウォームアップ期間: warmupがtrueの場合、firstNormalEpoch前のエポックにはslotsPerEpochより少ないスロットがあります。ウォームアップエポックの長さの正確な計算は2^N * MINIMUM_SLOTS_PER_EPOCHで、NはfirstNormalEpochに到達するまで（0から始まる）エポック番号です。通常、MINIMUM_SLOTS_PER_EPOCHは32です。