Cara Menggunakan getBlocks

Metode RPC getBlocks memungkinkan Anda mengambil daftar nomor slot blok yang telah dikonfirmasi antara slot awal tertentu dan slot akhir opsional. Metode ini berguna ketika Anda perlu mengetahui blok mana yang telah dikonfirmasi dalam rentang tertentu tanpa mengambil seluruh isi setiap blok.

Hindari Pengelompokan untuk Performa yang Lebih BaikMengelompokkan metode arsip akan meningkatkan latensi secara signifikan. Batch yang berisi lebih dari 10 permintaan tidak diizinkan.

Kasus Penggunaan Umum

Mengidentifikasi Blok yang Dikonfirmasi dalam Suatu Rentang: Dapatkan dengan cepat daftar semua slot blok yang berhasil dikonfirmasi antara dua titik dalam buku besar.
Mengiterasi Blok: Gunakan daftar slot yang dikembalikan untuk kemudian mengambil informasi terperinci bagi setiap blok menggunakan getBlock jika diperlukan.
Audit Blok Dasar: Verifikasi keberadaan blok dalam rentang tertentu.

Parameter Permintaan

Metode getBlocks menerima parameter berikut:

start_slot (u64, wajib): Slot pertama yang dipertimbangkan dalam rentang (inklusif).
end_slot (u64, opsional): Slot terakhir yang dipertimbangkan dalam rentang (inklusif).
- Jika tidak diberikan, kueri akan mengembalikan blok dari start_slot hingga slot terbaru yang telah dikonfirmasi.
- Rentang antara start_slot dan end_slot (atau slot terbaru jika end_slot dihilangkan) tidak boleh melebihi 500.000 slot.
commitment (string, opsional): Menentukan tingkat komitmen untuk kueri. Jika dihilangkan, komitmen default node akan digunakan. Nilai ini diteruskan sebagai satu-satunya bidang dalam objek konfigurasi sebagai parameter terakhir.

Struktur Respons

Bidang result dalam respons JSON-RPC akan berupa array bilangan bulat u64. Setiap bilangan bulat dalam array mewakili nomor slot blok yang dikonfirmasi dalam rentang yang ditentukan.

Contoh: [5, 6, 7, 8, 9, 10]

Contoh

1. Mendapatkan Blok dalam Rentang Slot Tertentu

Contoh ini mengambil daftar slot blok yang dikonfirmasi antara slot 250000000 dan 250000010.

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

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

async function getBlocksInRange(startSlot, endSlot) {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const blocks = await connection.getBlocks(startSlot, endSlot);
    console.log(`Confirmed blocks between slot ${startSlot} and ${endSlot}:`, blocks);
  } catch (error) {
    console.error('Error fetching blocks:', error);
  }
}

// Example usage:
const startSlot = 250000000;
const endSlot = 250000010;
getBlocksInRange(startSlot, endSlot);

2. Mendapatkan Blok dari Slot Awal hingga Slot Terbaru yang Dikonfirmasi

Contoh ini mengambil slot blok yang dikonfirmasi mulai dari 260000000 hingga blok terbaru yang dikonfirmasi oleh node (dengan mematuhi batas rentang 500.000 slot 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": "getBlocks",
    "params": [
      260000000 
    ]
  }'

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

async function getBlocksFromStart(startSlot) {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    // The endSlot parameter is omitted to fetch up to the latest confirmed block
    const blocks = await connection.getBlocks(startSlot);
    console.log(`Confirmed blocks from slot ${startSlot} to latest:`, blocks);
    if (blocks.length > 0) {
      console.log(`Latest block in range: ${blocks[blocks.length - 1]}`);
    }
  } catch (error) {
    console.error('Error fetching blocks:', error);
  }
}

// Example usage (ensure this doesn't exceed the 500,000 slot limit from latest block):
const recentStartSlot = 260000000; 
getBlocksFromStart(recentStartSlot);

3. Mendapatkan Blok dengan Tingkat Komitmen Tertentu

Contoh ini mengambil blok menggunakan tingkat 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": "getBlocks",
    "params": [
      270000000,
      270000005,
      { "commitment": "finalized" }
    ]
  }'

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

async function getBlocksWithCommitment(startSlot, endSlot) {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const blocks = await connection.getBlocks(startSlot, endSlot, { commitment: 'finalized' });
    console.log(`Finalized blocks between slot ${startSlot} and ${endSlot}:`, blocks);
  } catch (error) {
    console.error('Error fetching blocks with commitment:', error);
  }
}

// Example usage:
const commitStartSlot = 270000000;
const commitEndSlot = 270000005;
getBlocksWithCommitment(commitStartSlot, commitEndSlot);

Tips untuk Pengembang

Batas Rentang: Ingat batas rentang 500.000 slot. Meminta rentang yang lebih besar akan menghasilkan kesalahan.
Ketersediaan Data Node: Node mungkin tidak menyimpan informasi untuk semua slot historis. Nilai start_slot yang sangat lama dapat mengembalikan array kosong atau kesalahan, tergantung pada konfigurasi node dan retensi buku besarnya.
Komitmen Blok: Dalam Alpenglow, confirmed dan finalized mengembalikan blok yang sama dan telah dikomit secara permanen; pilih finalized untuk kode baru. Node yang berbeda masih dapat memberikan hasil berbeda untuk sementara karena keterlambatan propagasi.
Pelengkap getBlock: getBlocks sering digunakan sebagai langkah pertama untuk mengidentifikasi slot blok yang relevan sebelum menggunakan getBlock guna mengambil detail lengkap setiap blok dalam daftar tersebut.
Alternatif Paginasi: Karena getBlocks memiliki batas rentang, jika Anda perlu memindai bagian rantai yang sangat besar, Anda perlu melakukan beberapa panggilan ke getBlocks dengan membagi rentang total yang diinginkan menjadi segmen berukuran 500.000 slot atau kurang.

Panduan ini memberikan gambaran umum yang jelas tentang cara menggunakan metode RPC getBlocks untuk mencantumkan slot blok yang telah dikomit secara permanen di jaringan Solana.

Mulai di Sini

Data Real-Time

Perdagangan Berlatensi Rendah

Data Historis & Dompet

Panduan Metode RPC

Kesiapan Produksi

Menggunakan Orb

Panduan Praktis Lainnya

Cara Menggunakan getBlocks

Kasus Penggunaan Umum

Parameter Permintaan

Struktur Respons

Contoh

1. Mendapatkan Blok dalam Rentang Slot Tertentu

2. Mendapatkan Blok dari Slot Awal hingga Slot Terbaru yang Dikonfirmasi

3. Mendapatkan Blok dengan Tingkat Komitmen Tertentu

Tips untuk Pengembang

Metode Terkait

getBlock

getBlocksWithLimit

​Kasus Penggunaan Umum

​Parameter Permintaan

​Struktur Respons

​Contoh

​1. Mendapatkan Blok dalam Rentang Slot Tertentu

​2. Mendapatkan Blok dari Slot Awal hingga Slot Terbaru yang Dikonfirmasi

​3. Mendapatkan Blok dengan Tingkat Komitmen Tertentu

​Tips untuk Pengembang

​Metode Terkait

getBlock

getBlocksWithLimit

Kasus Penggunaan Umum

Parameter Permintaan

Struktur Respons

Contoh

1. Mendapatkan Blok dalam Rentang Slot Tertentu

2. Mendapatkan Blok dari Slot Awal hingga Slot Terbaru yang Dikonfirmasi

3. Mendapatkan Blok dengan Tingkat Komitmen Tertentu

Tips untuk Pengembang

Metode Terkait