Cách sử dụng getLatestBlockhash

​

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

• Xây dựng 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 giao dịch.
• Quản lý thời hạn giao dịch: Sử dụng lastValidBlockHeight để xác định khoảng thời gian mà một giao dịch tham chiếu đến blockhash đã lấy dự kiến vẫn còn hiệu lực.
• Kiểm tra trước khi thực thi: Mặc dù simulateTransaction có thể ngầm thực hiện việc này, ứng dụng có thể lấy một blockhash để chuẩn bị giao dịch theo cách thủ công nhằm phục vụ mô phỏng.

​

Tham số yêu cầu

• commitment (chuỗi, không bắt buộc): Chỉ định mức cam kết cho truy vấn. Nếu bỏ qua, mức cam kết mặc định của nút sẽ được sử dụng. Nên dùng finalized cho mã mới; trong Alpenglow, confirmed trả về cùng một trạng thái vĩnh viễn và vẫn khả dụng để đảm bảo khả năng tương thích.
• 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á. Điều 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. Một giao dịch tham chiếu đến blockhash này có hiệu lực 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 mức cam kết 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();

​

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

• Hiệu lực của blockhash: Một blockhash có hiệu lực trong thời gian giới hạn, khoảng 30 giây (mặc 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 quá lastValidBlockHeight của giao dịch. Luôn lấy một blockhash mới nếu đã qua một khoảng thời gian đáng kể kể từ lần lấy gần nhất.
• Chọn mức cam kết: Trong Alpenglow, confirmed và finalized trả về cùng một trạng thái được cam kết vĩnh viễn tại cùng một thời điểm. Nên dùng finalized cho mã mới vì confirmed sẽ bị loại bỏ trong một bản phát hành sau này.
• 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 quá lastValidBlockHeight, bạn phải ký lại giao dịch bằng một blockhash mới hơn, gần đây hơn rồi gửi lại.

​

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