Cara Menggunakan getLatestBlockhash

​

Kasus Penggunaan Umum

• Pembuatan Transaksi: Dapatkan blockhash terbaru untuk disertakan dalam transaksi baru sebelum menandatangani dan mengirimnya.
• Pengelolaan Masa Berlaku Transaksi: Gunakan lastValidBlockHeight untuk mengetahui berapa lama transaksi yang merujuk pada blockhash yang diambil diperkirakan akan tetap valid.
• Pemeriksaan Praeksekusi: Meskipun simulateTransaction dapat melakukannya secara implisit, aplikasi dapat mengambil blockhash untuk menyiapkan transaksi secara manual guna simulasi.

​

Parameter Permintaan

• commitment (string, opsional): Menentukan tingkat komitmen untuk kueri. Jika dihilangkan, komitmen default node akan digunakan. Untuk transaksi, confirmed atau finalized umumnya digunakan untuk memastikan blockhash berasal dari bagian chain yang cukup stabil.
• minContextSlot (integer, opsional): Slot minimum tempat permintaan dapat dievaluasi. Ini memastikan kueri dilakukan terhadap status ledger yang telah memproses setidaknya hingga slot ini.

​

Struktur Respons

• blockhash (string): String berenkode base-58 yang merepresentasikan blockhash terbaru.
• lastValidBlockHeight (u64): Ketinggian blok tempat blockhash akan kedaluwarsa. Transaksi yang merujuk pada blockhash ini valid hingga jaringan mencapai lastValidBlockHeight ini.

​

Contoh

​

1. Mendapatkan Blockhash Terbaru dengan Komitmen Default

# Replace <api-key> with your Helius API key
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getLatestBlockhash"
  }'

// Replace <api-key> with your Helius API key
const { Connection } = require('@solana/web3.js');

async function fetchLatestBlockhash() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
    console.log('Latest Blockhash Info:');
    console.log(`  Blockhash: ${blockhash}`);
    console.log(`  Last Valid Block Height: ${lastValidBlockHeight}`);
    // This blockhash can now be used in a transaction
  } catch (error) {
    console.error('Error fetching latest blockhash:', error);
  }
}

fetchLatestBlockhash();

​

2. Mendapatkan Blockhash Terbaru dengan Komitmen ‘confirmed’

# Replace <api-key> with your Helius API key
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getLatestBlockhash",
    "params": [{ "commitment": "confirmed" }]
  }'

// Replace <api-key> with your Helius API key
const { Connection } = require('@solana/web3.js');

async function fetchConfirmedBlockhash() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash('confirmed');
    console.log('Confirmed Blockhash Info:');
    console.log(`  Blockhash: ${blockhash}`);
    console.log(`  Last Valid Block Height: ${lastValidBlockHeight}`);
  } catch (error) {
    console.error('Error fetching confirmed blockhash:', error);
  }
}

fetchConfirmedBlockhash();

​

Kiat untuk Developer

• Validitas Blockhash: Blockhash berlaku untuk waktu terbatas, sekitar 2 menit (meskipun durasi ini dapat bervariasi). Transaksi harus dikonfirmasi oleh jaringan sebelum lastValidBlockHeight terlewati. Selalu ambil blockhash baru jika waktu yang cukup lama telah berlalu sejak blockhash terakhir diperoleh.
• Memilih Komitmen: Untuk transaksi penting, penggunaan komitmen finalized memberikan jaminan terkuat bahwa blockhash berasal dari fork chain utama, tetapi blockhash tersebut mungkin sedikit lebih lama. confirmed menawarkan keseimbangan yang baik. Pelajari lebih lanjut tentang tingkat komitmen untuk informasi mendetail.
• Biaya Transaksi: Jangan lupa untuk menghitung dan menyertakan biaya transaksi yang sesuai. Blockhash itu sendiri tidak menentukan biaya.
• Logika Percobaan Ulang: Jika transaksi kedaluwarsa karena lastValidBlockHeight telah terlewati, Anda harus menandatanganinya kembali dengan blockhash baru yang lebih mutakhir, lalu mengirimkannya ulang.

​

Metode Terkait