getSlot mengembalikan slot saat ini yang dianggap oleh node RPC telah mencapai tingkat commitment tertentu. Metode ini sangat penting untuk memahami status blockchain saat ini sebagaimana dipersepsikan oleh node.
Kasus Penggunaan Umum
- Mendapatkan Perkembangan Jaringan Saat Ini: Tentukan slot terbaru yang diproses atau dikonfirmasi oleh node.
- Pemeriksaan Sinkronisasi Node: Membandingkan slot dari berbagai node dapat memberikan indikasi status sinkronisasinya.
- Pemberian Stempel Waktu pada Operasi: Gunakan slot saat ini sebagai titik referensi untuk operasi atau untuk memahami usia data tertentu.
- Input untuk Panggilan RPC Lainnya: Beberapa metode RPC mungkin menggunakan nomor slot sebagai titik referensi.
Parameter Permintaan
Metode ini menerima objek konfigurasi opsional sebagai parameter pertamanya:options(object, opsional): Objek konfigurasi opsional dengan bidang berikut:commitment(string, opsional): Menentukan tingkat commitment untuk kueri. Nilai yang didukung adalahfinalized,confirmed, atauprocessed. Jika dihilangkan, commitment default node RPC akan digunakan (biasanyafinalized).processed: Node akan melakukan kueri pada slot terbarunya. Perhatikan bahwa slot ini mungkin belum dikonfirmasi oleh cluster dan berpotensi dilewati.confirmed: Node akan melakukan kueri pada slot terbaru yang telah diberi suara oleh mayoritas besar cluster.finalized: Node akan melakukan kueri pada slot terbaru yang dikonfirmasi oleh mayoritas besar cluster sebagai slot yang telah mencapai penguncian maksimum (tidak dapat dibatalkan).
minContextSlot(number, opsional): Slot minimum tempat permintaan dapat dievaluasi. Ini menetapkan slot minimum untuk konteks node. Jika status node lebih lama daripada slot ini, node dapat mengembalikan kesalahan atau nomor slot yang mencerminkan statusnya saat ini (yang lebih lama) relatif terhadap nilai minimum ini.
Struktur Respons
Bidangresult dari respons JSON-RPC adalah satu u64 (bilangan bulat 64-bit tanpa tanda) yang merepresentasikan nomor slot saat ini berdasarkan tingkat commitment yang ditentukan.
Contoh Respons:
Contoh
1. Mendapatkan Slot Saat Ini (Commitment Default)
Contoh ini mengambil slot saat ini menggunakan tingkat commitment default node (biasanyafinalized).
2. Mendapatkan Slot Saat Ini dengan Commitment Tertentu
Contoh ini mengambil slot saat ini yang telah mencapai commitmentconfirmed.
Tips untuk Developer
- Commitment Itu Penting: Nomor slot yang dikembalikan sangat bergantung pada tingkat
commitmentyang ditentukan. Lihat Tingkat Commitment Solana untuk informasi mendetail.processedakan menjadi slot tertinggi (terbaru) yang diketahui oleh node, sedangkanfinalizedakan menjadi slot lebih lama yang dikonfirmasi oleh seluruh jaringan. Pilih tingkat commitment yang sesuai dengan kebutuhan finalitas data untuk kasus penggunaan Anda. - Variasi Node: Node RPC yang berbeda mungkin mengembalikan nomor slot yang sedikit berbeda untuk tingkat commitment yang sama karena penundaan propagasi jaringan atau status pemrosesannya sendiri. Hal ini terutama berlaku untuk tingkat
processeddanconfirmed. minContextSlot: Parameter ini memastikan bahwa node yang memproses permintaan Anda setidaknya telah mencapaiminContextSlot. Jika node tertinggal dari slot ini, perilakunya dapat bervariasi (misalnya, mengembalikan kesalahan atau slot tertinggi node saat ini yang lebih rendah daripadaminContextSlot). Parameter ini umumnya digunakan dalam skenario lanjutan ketika Anda perlu memastikan bahwa kueri dijalankan terhadap status yang cukup baru.
getSlot adalah metode sederhana tetapi penting untuk berinteraksi dengan blockchain Solana dan memahami perkembangannya saat ini.