getBlockHeight adalah cara sederhana untuk mengkueri simpul Solana guna mendapatkan ketinggian bloknya saat ini. 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: Simpul akan mengkueri blok terbaru yang telah dikomit secara permanen. Utamakan nilai ini untuk kode baru.confirmed: Dalam Alpenglow, setara denganfinalized; dipertahankan untuk kompatibilitas.processed: Simpul akan mengkueri blok terbarunya. Perhatikan bahwa blok tersebut mungkin belum lengkap.
minContextSlot(angka, opsional): Slot minimum tempat permintaan dapat dievaluasi. 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 Itu Penting:
processeddapat mengembalikan ketinggian yang lebih baru tetapi bersifat sementara. Dalam Alpenglow,confirmeddanfinalizedmengembalikan ketinggian yang sama dan telah dikomit secara permanen; utamakanfinalizeduntuk kode baru. minContextSlotuntuk Konsistensi: GunakanminContextSlotjika Anda perlu memastikan bahwa ketinggian blok dikueri dari status yang setidaknya sama barunya dengan slot tertentu yang Anda pantau.- Bukan Nomor Slot: Ingat bahwa ketinggian blok berbeda dari nomor slot. Slot adalah suatu periode waktu, dan tidak setiap slot menghasilkan blok (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 dari respons JSON-RPC akan berupa satu angka:
blockHeight(angka): Ketinggian blok saat ini (u64) dari simpul 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 di bawah ini.