Cara Menggunakan getEpochInfo

​

Kasus Penggunaan Umum

• Memantau Progres Epoch: Lacak indeks slot saat ini dalam epoch dan jumlah total slot dalam epoch untuk memperkirakan waktu yang tersisa.
• Analisis Kondisi Jaringan: Dapatkan nomor epoch saat ini, tinggi blok, dan jumlah transaksi yang diproses dalam epoch saat ini.
• Pemeriksaan Sinkronisasi: Pastikan node cukup tersinkronisasi dengan jaringan dengan membandingkan informasi epochnya.

​

Parameter Permintaan

• commitment (string, opsional): Menentukan tingkat komitmen yang akan digunakan saat mengueri ledger.
  • finalized: Node akan mengueri blok terbaru yang telah dikomit secara permanen. Gunakan nilai ini untuk kode baru.
  • confirmed: Di bawah Alpenglow, setara dengan finalized; dipertahankan untuk kompatibilitas.
  • processed: Node akan mengueri blok terbarunya. Perhatikan bahwa blok tersebut mungkin belum lengkap.
  • Jika tidak diberikan, komitmen default adalah finalized.
• minContextSlot (number, opsional): Slot minimum tempat permintaan dapat dievaluasi. Parameter ini dapat digunakan untuk memastikan respons berasal dari status yang cukup baru.

​

Struktur Respons

• absoluteSlot (u64): Nomor slot absolut saat ini.
• blockHeight (u64): Ketinggian blok saat ini.
• epoch (u64): Nomor epoch saat ini.
• slotIndex (u64): Slot saat ini relatif terhadap awal epoch saat ini.
• slotsInEpoch (u64): Jumlah total slot dalam epoch saat ini.
• transactionCount (u64 | null): Jumlah total transaksi yang diproses dalam epoch saat ini. Dapat berupa null jika data tidak tersedia.

​

Contoh

​

1. Dapatkan Informasi Epoch Saat Ini (Tanpa Parameter)

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

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

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

getCurrentEpochInfo();

​

2. Dapatkan Informasi Epoch Saat Ini dengan Komitmen finalized

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

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

async function getFinalizedEpochInfo() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const epochInfo = await connection.getEpochInfo('finalized'); // Or connection.getEpochInfo({ commitment: 'finalized' });
    console.log(JSON.stringify(epochInfo, null, 2));
  } catch (error) {
    console.error('Error fetching finalized epoch information:', error);
  }
}

getFinalizedEpochInfo();

​

Kiat untuk Pengembang

• Tingkat Komitmen: processed adalah yang terbaru, tetapi dapat dibatalkan. Di bawah Alpenglow, confirmed dan finalized memiliki latensi dan jaminan finalitas permanen yang sama; gunakan finalized untuk kode baru.
• Ketersediaan transactionCount: Kolom transactionCount mungkin berupa null jika node tidak memiliki informasi ini secara langsung atau jika informasi tersebut tidak dilacak untuk tingkat komitmen tertentu.
• Panjang Epoch: Jumlah slotsInEpoch dapat bervariasi. Anda dapat menggunakan getEpochSchedule untuk mendapatkan detail selengkapnya tentang jadwal epoch.

​

Metode Terkait