Cara Menggunakan isBlockhashValid

​

Kasus Penggunaan Umum

• Pengiriman Ulang Transaksi: Sebelum mencoba kembali transaksi yang gagal, periksa apakah blockhash aslinya masih valid. Jika tidak, blockhash baru harus diambil.
• Penandatanganan Transaksi yang Ditunda: Jika transaksi telah disiapkan tetapi baru ditandatangani dan dikirimkan nanti, verifikasi validitas blockhash tepat sebelum pengiriman.
• Pemrosesan Transaksi Optimistis: Tentukan apakah blockhash kemungkinan akan diterima oleh jaringan jika transaksi segera dikirim.

​

Parameter Permintaan

1. blockhash (string, wajib): Blockhash yang akan diperiksa, sebagai string yang dikodekan dalam base-58.
2. options (object, opsional): Object konfigurasi opsional yang dapat mencakup:
   • commitment (string, opsional): Menentukan tingkat komitmen untuk kueri (misalnya, "finalized", "confirmed", "processed"). Jika dihilangkan, komitmen default node akan digunakan.
   • minContextSlot (u64, opsional): Slot minimum tempat permintaan dapat dievaluasi. Ini memastikan node RPC tidak merespons dengan status dari slot yang lebih lama daripada minContextSlot.

​

Struktur Respons

• context (object): Object yang berisi:
  • slot (u64): Slot tempat node RPC mengevaluasi validitas blockhash.
• value (boolean): true jika blockhash masih valid, dan false jika tidak.

{
  "jsonrpc": "2.0",
  "result": {
    "context": { "slot": 180000500 },
    "value": true
  },
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "context": { "slot": 180000800 },
    "value": false
  },
  "id": 1
}

​

Contoh Kode

# Check validity of a blockhash (replace <YOUR_BLOCKHASH>):
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "isBlockhashValid",
    "params": [
      "<YOUR_BLOCKHASH>"
    ]
  }' \
  <YOUR_RPC_URL>

# Check with commitment and minContextSlot (replace <YOUR_BLOCKHASH>):
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "isBlockhashValid",
    "params": [
      "<YOUR_BLOCKHASH>",
      {
        "commitment": "confirmed",
        "minContextSlot": 170000000
      }
    ]
  }' \
  <YOUR_RPC_URL>

const { Connection } = require('@solana/web3.js');

async function checkBlockhash(blockhashToCheck) {
  // Replace with your RPC endpoint
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');

  try {
    console.log(`Checking validity of blockhash: ${blockhashToCheck}`);
    const result = await connection.isBlockhashValid(blockhashToCheck);
    
    console.log(`  Blockhash is valid: ${result.value}`);
    console.log(`  Checked at slot: ${result.context.slot}`);

    // Example with options
    // const resultWithOptions = await connection.isBlockhashValid(
    //   blockhashToCheck,
    //   { commitment: 'confirmed', minContextSlot: result.context.slot - 100 }
    // );
    // console.log(`\nWith options - Valid: ${resultWithOptions.value}, Slot: ${resultWithOptions.context.slot}`);

  } catch (error) {
    console.error(`Error checking blockhash ${blockhashToCheck}:`, error);
  }
}

// Example usage: First, get a recent blockhash
async function getRecentBlockhashAndCheck() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const { blockhash } = await connection.getLatestBlockhash();
    await checkBlockhash(blockhash); 
    
    // Example with a known old/invalid blockhash (will likely be false)
    // This blockhash is just an example and will be invalid.
    const oldBlockhash = 'J7rBdM6AecPDEZp8aPq5iPSNKVkU5Q76F3oAV4eW5wsW'; 
    // await checkBlockhash(oldBlockhash);

  } catch (error) {
    console.error('Error in example execution:', error);
  }
}

getRecentBlockhashAndCheck();

​

Tips untuk Developer

• Blockhash Memiliki Masa Berlaku: Blockhash hanya valid untuk waktu terbatas (sekitar 150 slot atau kurang lebih 30 detik). Selalu ambil blockhash baru jika Anda tidak yakin atau jika sudah cukup lama berlalu.
• Penggunaan minContextSlot: Gunakan minContextSlot untuk mencegah kueri ke node RPC usang yang mungkin memberikan respons “valid” yang sudah tidak berlaku untuk blockhash yang sebenarnya terlalu lama dari perspektif seluruh cluster.
• Alternatif untuk Node Lama: Untuk node yang menjalankan Solana versi sebelum 1.9, gunakan getFeeCalculatorForBlockhash("<YOUR_BLOCKHASH>"). Jika metode ini berhasil mengembalikan respons, blockhash tersebut valid. Jika menghasilkan kesalahan (biasanya karena blockhash tidak ditemukan atau terlalu lama), blockhash tersebut tidak valid.
• Konfirmasi Jaringan: Meskipun isBlockhashValid mengembalikan true, transaksi baru dianggap final setelah mencapai tingkat komitmen yang diinginkan pada jaringan setelah dikirimkan.

​

Metode Terkait