Cara Menggunakan getBlocksWithLimit

​

Kasus Penggunaan Umum

• Mengambil Sejumlah Tetap Blok Berikutnya: Dapatkan sejumlah slot blok yang telah dikonfirmasi setelah slot awal tertentu.
• Eksplorasi Blok dengan Paginasi: Ambil blok secara bertahap saat menganalisis segmen blockchain.
• Pemantauan Blok Terbaru: Dapatkan N blok terakhir dari slot terbaru yang diketahui.

​

Parameter Permintaan

1. start_slot (u64, wajib): Slot pertama yang akan dipertimbangkan (inklusif).
2. limit (u64, wajib): Jumlah maksimum slot blok yang akan dikembalikan. Jumlah total slot yang dikueri (dari start_slot hingga limit blok setelahnya) tidak boleh melebihi 500.000 slot.
3. commitment (string, opsional): Menentukan tingkat komitmen untuk kueri. Jika dihilangkan, komitmen default node akan digunakan. Parameter ini diteruskan sebagai satu-satunya bidang dalam objek konfigurasi sebagai parameter terakhir.

​

Struktur Respons

• Contoh: Jika start_slot adalah 5 dan limit adalah 3, salah satu kemungkinan hasilnya adalah [5, 6, 7].

​

Contoh

​

1. Mendapatkan Blok dalam Jumlah Terbatas dari Slot Awal

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

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

async function getBlocksWithLimitExample(startSlot, limit) {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const blocks = await connection.getBlocksWithLimit(startSlot, limit);
    console.log(`Up to ${limit} confirmed blocks starting from slot ${startSlot}:`, blocks);
  } catch (error) {
    console.error('Error fetching blocks with limit:', error);
  }
}

// Example usage:
const startSlot = 280000000;
const limit = 5;
getBlocksWithLimitExample(startSlot, limit);

​

2. Mendapatkan Blok dengan Batas dan Tingkat Komitmen Tertentu

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

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

async function getBlocksWithLimitAndCommitment(startSlot, limit) {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const blocks = await connection.getBlocksWithLimit(startSlot, limit, { commitment: 'finalized' });
    console.log(`Up to ${limit} finalized blocks starting from slot ${startSlot}:`, blocks);
  } catch (error) {
    console.error('Error fetching blocks with limit and commitment:', error);
  }
}

// Example usage:
const commitStartSlot = 290000000;
const commitLimit = 3;
getBlocksWithLimitAndCommitment(commitStartSlot, commitLimit);

​

Tips untuk Developer

• Penjelasan Rentang: Parameter limit menentukan jumlah maksimum slot blok yang akan dikembalikan. Batasan 500.000 slot berlaku untuk rentang konseptual yang dipindai (yaitu, dari start_slot hingga start_slot + limit - 1). Pastikan rentang konseptual ini tidak melebihi 500.000 slot, meskipun jumlah blok aktual yang ditemukan dan dikembalikan dalam rentang tersebut lebih sedikit.
• Ketersediaan Data Node: Node mungkin tidak menyimpan informasi untuk semua slot historis. start_slot yang sangat lama mungkin mengembalikan lebih sedikit blok daripada limit yang ditentukan, atau array kosong, tergantung pada retensi buku besar node.
• Komitmen Blok: Dalam Alpenglow, confirmed dan finalized mengembalikan blok yang sama dan telah dikomitmenkan secara permanen; gunakan finalized untuk kode baru. Node yang berbeda mungkin masih memberikan hasil berbeda untuk sementara waktu karena keterlambatan propagasi.
• Kekhususan Kasus Penggunaan: getBlocksWithLimit ideal ketika Anda mengetahui titik awal dan memerlukan jumlah tetap blok berikutnya. Jika Anda memerlukan semua blok dalam rentang slot yang diketahui, getBlocks mungkin lebih sesuai.

​

Metode Terkait