Cách sử dụng isBlockhashValid

​

Các trường hợp sử dụng phổ biến

• Gửi lại giao dịch: Trước khi thử lại một giao dịch thất bại, hãy kiểm tra xem blockhash ban đầu của giao dịch có còn hợp lệ hay không. Nếu không, bạn phải lấy một blockhash mới.
• Ký giao dịch có độ trễ: Nếu một giao dịch đã được chuẩn bị nhưng được ký và gửi sau đó, hãy xác minh tính hợp lệ của blockhash ngay trước khi gửi.
• Xử lý giao dịch lạc quan: Xác định xem một blockhash có khả năng được mạng chấp nhận hay không nếu giao dịch được gửi ngay lập tức.

​

Tham số yêu cầu

1. blockhash (chuỗi, bắt buộc): Blockhash cần kiểm tra, ở dạng chuỗi được mã hóa base-58.
2. options (đối tượng, không bắt buộc): Một đối tượng cấu hình không bắt buộc có thể bao gồm:
   • commitment (chuỗi, không bắt buộc): Chỉ định mức cam kết cho truy vấn (ví dụ: "finalized", "confirmed", "processed"). Nếu bỏ qua, mức cam kết mặc định của nút sẽ được sử dụng.
   • minContextSlot (u64, không bắt buộc): Slot tối thiểu mà tại đó yêu cầu có thể được đánh giá. Điều này đảm bảo nút RPC không phản hồi bằng trạng thái từ một slot cũ hơn minContextSlot.

​

Cấu trúc phản hồi

• context (đối tượng): Một đối tượng chứa:
  • slot (u64): Slot mà tại đó nút RPC đã đánh giá tính hợp lệ của blockhash.
• value (boolean): true nếu blockhash vẫn hợp lệ, nếu không thì là false.

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

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

​

Ví dụ mã

# 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();

​

Mẹo dành cho nhà phát triển

• Blockhash sẽ hết hạn: Blockhash chỉ hợp lệ trong một khoảng thời gian giới hạn (khoảng 150 slot, tương đương khoảng 1–2 phút). Luôn lấy một blockhash mới nếu bạn không chắc chắn hoặc nếu đã trôi qua một khoảng thời gian đáng kể.
• Cách sử dụng minContextSlot: Sử dụng minContextSlot để tránh truy vấn một nút RPC chưa cập nhật. Nút này có thể trả về phản hồi “hợp lệ” đã lỗi thời cho một blockhash mà trên thực tế đã quá cũ theo góc nhìn của phần còn lại trong cụm.
• Giải pháp thay thế cho các nút cũ hơn: Đối với các nút chạy phiên bản Solana trước 1.9, hãy sử dụng getFeeCalculatorForBlockhash("<YOUR_BLOCKHASH>"). Nếu phương thức này trả về thành công thì blockhash hợp lệ. Nếu phương thức trả về lỗi (thường là do không tìm thấy blockhash hoặc blockhash đã quá cũ) thì blockhash không hợp lệ.
• Xác nhận trên mạng: Ngay cả khi isBlockhashValid trả về true, một giao dịch chỉ được hoàn tất sau khi đạt mức cam kết mong muốn trên mạng sau khi gửi.

​

Các phương thức liên quan