getBlockHeight adalah cara sederhana untuk meminta ketinggian blok saat ini dari sebuah node Solana. Ketinggian blok menunjukkan jumlah blok yang telah diproses sejak blok genesis (slot 0).
Metode ini berguna untuk memahami dengan cepat sejauh mana rantai telah berkembang atau untuk merujuk ketinggian blok terbaru pada tingkat komitmen tertentu.
Kasus Penggunaan Umum
- Memantau Perkembangan Rantai: Panggil metode ini secara berkala untuk melihat perkembangan rantai.
- Mendapatkan Gambaran Panjang Rantai: Tentukan jumlah total blok yang telah diproses hingga titik tertentu (berdasarkan komitmen).
- Membandingkan dengan Data Lain: Gunakan ketinggian blok sebagai titik acuan saat menganalisis data atau peristiwa on-chain lainnya.
Parameter
getBlockHeight dapat menerima objek konfigurasi sebagai parameter pertamanya secara opsional (atau dipanggil tanpa parameter untuk menggunakan nilai default):
config(objek, opsional): Objek konfigurasi dengan bidang berikut:commitment(string, opsional): Menentukan tingkat komitmen yang akan digunakan untuk kueri. Nilai default-nya adalahfinalized.finalized: Node akan meminta blok terbaru yang telah dikonfirmasi oleh mayoritas super klaster sebagai blok yang telah mencapai penguncian maksimum.confirmed: Node akan meminta blok terbaru yang telah dipilih oleh mayoritas super klaster.processed: Node akan meminta blok terbarunya. Perhatikan bahwa blok tersebut mungkin belum lengkap.
minContextSlot(angka, opsional): Slot minimum tempat permintaan dapat dievaluasi. Hal ini memastikan bahwa ketinggian blok yang dikembalikan berasal dari slot yang sama dengan atau lebih besar dariminContextSlot.
finalized secara default.
Kiat untuk Developer
- Tingkat Komitmen Berpengaruh: Ketinggian blok yang dikembalikan dapat berbeda berdasarkan tingkat
commitmentyang ditentukan.finalizedmemberikan ketinggian paling stabil, sedangkanprocessedmungkin memberikan ketinggian yang lebih terkini, tetapi berpotensi bersifat sementara. minContextSlotuntuk Konsistensi: GunakanminContextSlotjika Anda perlu memastikan ketinggian blok diminta dari status yang setidaknya sama barunya dengan slot tertentu yang sedang Anda lacak.- Bukan Nomor Slot: Ingat bahwa ketinggian blok berbeda dari nomor slot. Slot adalah suatu periode waktu, dan tidak setiap slot menghasilkan blok (slot semacam ini disebut slot yang dilewati). Ketinggian blok adalah jumlah blok aktual yang dihasilkan.
- Pemeriksaan Dasar Kondisi Rantai: Meskipun sederhana,
getBlockHeightdapat menjadi bagian dari pemeriksaan dasar kondisi atau sinkronisasi rantai untuk aplikasi atau sistem pemantauan Anda.
Respons
Bidangresult pada respons JSON-RPC akan berupa satu angka:
blockHeight(angka): Ketinggian blok (u64) node saat ini berdasarkan tingkat komitmen yang ditentukan.
Contoh: Mengambil Ketinggian Blok Saat Ini
Mari ambil ketinggian blok saat ini dari RPC Helius Devnet. Catatan: GantiYOUR_API_KEY dengan kunci API Helius Anda yang sebenarnya dalam contoh berikut.