Cách sử dụng getBlockHeight

​

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

• Theo dõi tiến trình của chuỗi: Gọi phương thức này định kỳ để theo dõi sự tiến triển của chuỗi.
• Lấy thông tin nhanh về độ dài chuỗi: Xác định tổng số khối đã được xử lý đến một thời điểm nhất định (dựa trên mức cam kết).
• Đối chiếu với dữ liệu khác: Sử dụng chiều cao khối làm điểm tham chiếu khi phân tích dữ liệu hoặc sự kiện khác trên chuỗi.

​

Tham số

1. config (đối tượng, không bắt buộc): Một đối tượng cấu hình có các trường sau:
   • commitment (chuỗi, không bắt buộc): Chỉ định mức cam kết dùng cho truy vấn. Mặc định là finalized.
     • finalized: Nút sẽ truy vấn khối được cam kết vĩnh viễn gần đây nhất. Nên dùng giá trị này cho mã mới.
     • confirmed: Trong Alpenglow, tương đương với finalized; được giữ lại để đảm bảo khả năng tương thích.
     • processed: Nút sẽ truy vấn khối gần đây nhất của nó. Lưu ý rằng khối có thể chưa hoàn chỉnh.
   • minContextSlot (số, 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 chiều cao khối trả về thuộc một slot lớn hơn hoặc bằng minContextSlot.

​

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

• Mức cam kết rất quan trọng: processed có thể trả về một chiều cao mới hơn nhưng chỉ mang tính tạm thời. Trong Alpenglow, confirmed và finalized trả về cùng một chiều cao được cam kết vĩnh viễn; nên dùng finalized cho mã mới.
• minContextSlot để đảm bảo tính nhất quán: Sử dụng minContextSlot nếu cần đảm bảo chiều cao khối được truy vấn từ một trạng thái ít nhất cũng mới bằng một slot cụ thể mà bạn đang theo dõi.
• Không phải số slot: Hãy nhớ rằng chiều cao khối khác với số slot. Slot là một khoảng thời gian và không phải slot nào cũng tạo ra một khối (những slot này được gọi là slot bị bỏ qua). Chiều cao khối là số lượng khối thực tế đã được tạo ra.
• Kiểm tra cơ bản về tình trạng chuỗi: Tuy đơn giản, getBlockHeight có thể là một phần của quy trình kiểm tra cơ bản về tình trạng hoặc khả năng đồng bộ hóa của chuỗi cho ứng dụng hoặc hệ thống giám sát của bạn.

​

Phản hồi

• blockHeight (số): Chiều cao khối hiện tại (u64) của nút theo mức cam kết đã chỉ định.

{
  "jsonrpc": "2.0",
  "result": 275123456, // Example block height
  "id": 1
}

​

Ví dụ: Lấy chiều cao khối hiện tại

curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY -X POST -H "Content-Type: application/json" -d \
'{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBlockHeight",
  "params": [] 
}'

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

async function getCurrentBlockHeight() {
  const rpcUrl = 'https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY'; // Replace YOUR_API_KEY
  const connection = new Connection(rpcUrl, 'confirmed');

  try {
    const blockHeight = await connection.getBlockHeight();
    console.log(`Current Block Height: ${blockHeight}`);

  } catch (error) {
    console.error('Error fetching block height:', error);
  }
}

getCurrentBlockHeight();

import { createSolanaRpc } from "@solana/kit";

const rpc_url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY";
const rpc = createSolanaRpc(rpc_url);

let blockHeight = await rpc.getBlockHeight().send();

console.log("block height:", blockHeight);

use anyhow::Result;
use solana_client::nonblocking::rpc_client::RpcClient;
use solana_sdk::commitment_config::CommitmentConfig;

#[tokio::main]
async fn main() -> Result<()> {
    let client = RpcClient::new_with_commitment(
        String::from("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"),
        CommitmentConfig::finalized(),
    );

    let block_height = client.get_block_height().await?;

    println!("Block height: {:#?}", block_height);

    Ok(())
}