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 mengkueri buku besar.
  • finalized: Node akan mengkueri blok terbaru yang telah dikonfirmasi oleh supermayoritas klaster sebagai blok yang telah mencapai penguncian maksimum.
  • confirmed: Node akan mengkueri blok terbaru yang telah dipilih oleh supermayoritas klaster.
  • processed: Node akan mengkueri 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 kondisi yang cukup baru.

​

Struktur Respons

• absoluteSlot (u64): Nomor slot absolut saat ini.
• blockHeight (u64): Tinggi 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. Nilainya 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 ‘confirmed’

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": "confirmed"
      }
    ]
  }'

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

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

getConfirmedEpochInfo();

​

Kiat untuk Pengembang

• Tingkat Komitmen: Pilihan commitment dapat memengaruhi kebaruan dan finalitas data. processed adalah yang tercepat tetapi paling tidak aman, sedangkan finalized adalah yang paling aman tetapi mungkin sedikit tertinggal. Pelajari lebih lanjut tentang tingkat komitmen untuk informasi terperinci.
• Ketersediaan transactionCount: Bidang transactionCount mungkin bernilai null jika node tidak memiliki informasi ini 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