Cách sử dụng getLatestBlockhash

​

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

• Tạo giao dịch: Lấy một blockhash gần đây để đưa vào giao dịch mới trước khi ký và gửi.
• Quản lý thời hạn giao dịch: Sử dụng lastValidBlockHeight để xác định khoảng thời gian mà giao dịch tham chiếu đến blockhash đã truy xuất dự kiến còn hợp lệ.
• Kiểm tra trước khi thực thi: Mặc dù simulateTransaction có thể thực hiện việc này ngầm định, ứng dụng vẫn có thể truy xuất blockhash để chuẩn bị giao dịch theo cách thủ công cho quá trình mô phỏng.

​

Tham số yêu cầu

• commitment (chuỗi, không bắt buộc): Chỉ định mức commitment cho truy vấn. Nếu bỏ qua, commitment mặc định của nút sẽ được sử dụng. Đối với giao dịch, confirmed hoặc finalized thường được sử dụng để đảm bảo blockhash đến từ một phần tương đối ổn định của chuỗi.
• minContextSlot (số nguyên, không bắt buộc): Slot tối thiểu mà tại đó yêu cầu có thể được đánh giá. Tham số này đảm bảo truy vấn được thực hiện dựa trên trạng thái sổ cái đã xử lý ít nhất đến slot này.

​

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

• blockhash (chuỗi): Chuỗi được mã hóa base-58 đại diện cho blockhash mới nhất.
• lastValidBlockHeight (u64): Độ cao khối mà tại đó blockhash sẽ hết hạn. Giao dịch tham chiếu đến blockhash này vẫn hợp lệ cho đến khi mạng đạt đến lastValidBlockHeight.

​

Ví dụ

​

1. Lấy blockhash mới nhất với commitment mặc định

# 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. Lấy blockhash mới nhất với commitment ‘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();

​

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

• Thời hạn hiệu lực của blockhash: Blockhash chỉ hợp lệ trong một khoảng thời gian giới hạn, khoảng 2 phút (dù thời gian này có thể thay đổi). Giao dịch phải được mạng xác nhận trước khi vượt qua lastValidBlockHeight tương ứng. Luôn truy xuất blockhash mới nếu đã qua một khoảng thời gian đáng kể kể từ lần truy xuất gần nhất.
• Chọn commitment: Đối với các giao dịch quan trọng, việc sử dụng commitment finalized mang lại sự đảm bảo cao nhất rằng blockhash đến từ nhánh chính của chuỗi, nhưng blockhash đó có thể cũ hơn đôi chút. confirmed mang lại sự cân bằng phù hợp. Tìm hiểu thêm về các mức commitment để biết thông tin chi tiết.
• Phí giao dịch: Hãy nhớ tính toán và bao gồm cả phí giao dịch phù hợp. Bản thân blockhash không quyết định mức phí.
• Logic thử lại: Nếu giao dịch hết hạn do đã vượt qua lastValidBlockHeight tương ứng, bạn phải ký lại giao dịch bằng một blockhash mới và gần đây hơn, sau đó gửi lại.

​

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