Cara Menggunakan getLatestBlockhash

​

Kasus Penggunaan Umum

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

​

Parameter Permintaan

• commitment (string, opsional): Menentukan tingkat komitmen untuk kueri. Jika dihilangkan, komitmen default node akan digunakan. Gunakan finalized untuk kode baru; pada Alpenglow, confirmed mengembalikan status permanen yang sama dan tetap tersedia untuk kompatibilitas.
• minContextSlot (integer, opsional): Slot minimum tempat permintaan dapat dievaluasi. Hal ini memastikan kueri dilakukan terhadap status ledger yang telah diproses setidaknya hingga slot ini.

​

Struktur Respons

• blockhash (string): String yang dikodekan dengan base-58 dan merepresentasikan hash blok terbaru.
• lastValidBlockHeight (u64): Tinggi blok tempat blockhash akan kedaluwarsa. Transaksi yang merujuk pada blockhash ini tetap valid hingga jaringan mencapai lastValidBlockHeight tersebut.

​

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. Dapatkan Hash Blok Terbaru dengan Komitmen finalized

# 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": "finalized" }]
  }'

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

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

fetchFinalizedBlockhash();

​

Kiat untuk Developer

• Validitas Hash Blok: Hash blok berlaku untuk waktu terbatas, sekitar 30 detik (meskipun durasi ini dapat bervariasi). Transaksi harus dikonfirmasi oleh jaringan sebelum lastValidBlockHeight transaksi tersebut terlewati. Selalu ambil hash blok baru jika sudah cukup lama sejak hash blok terakhir diperoleh.
• Memilih Komitmen: Pada Alpenglow, confirmed dan finalized mengembalikan status yang dikomit secara permanen pada titik yang sama. Gunakan finalized untuk kode baru karena confirmed akan dihapus pada rilis mendatang.
• Biaya Transaksi: Ingatlah untuk menghitung dan menyertakan biaya transaksi yang sesuai. Hash blok itu sendiri tidak menentukan biaya.
• Logika Percobaan Ulang: Jika transaksi kedaluwarsa karena lastValidBlockHeight transaksi tersebut telah terlewati, Anda harus menandatanganinya kembali dengan hash blok baru yang lebih terkini, lalu mengirimkannya ulang.

​

Metode Terkait