Cách sử dụng getBlockProduction

Phương thức RPC getBlockProduction cung cấp thông tin về hoạt động sản xuất khối trong epoch hiện tại hoặc một phạm vi slot được chỉ định. Phương thức này có thể truy xuất dữ liệu cho tất cả trình xác thực hoặc một danh tính trình xác thực cụ thể. Thông tin này hữu ích để giám sát hiệu suất của trình xác thực và tìm hiểu các mô hình sản xuất khối trên mạng.

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

Giám sát hiệu suất của trình xác thực: Theo dõi số khối được tạo và các slot lãnh đạo của một trình xác thực cụ thể.
Phân tích hiệu suất epoch: Xem tổng quan về hoạt động sản xuất khối của tất cả trình xác thực trong epoch hiện tại hoặc một epoch trước đó.
Xác định các slot bị bỏ lỡ: Kiểm tra xem trình xác thực có bỏ lỡ các slot lãnh đạo được chỉ định hay không.
Kiểm tra tình trạng mạng: Thu thập dữ liệu về hiệu quả sản xuất khối tổng thể.

Tham số yêu cầu

Phương thức getBlockProduction chấp nhận một đối tượng cấu hình không bắt buộc với các tham số sau:

commitment (chuỗi, không bắt buộc): Chỉ định mức cam kết dùng 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.
range (đối tượng, không bắt buộc): Xác định phạm vi slot cần truy vấn.
- firstSlot (u64): Slot đầu tiên cần lấy thông tin sản xuất khối (bao gồm slot này).
- lastSlot (u64, không bắt buộc): Slot cuối cùng cần lấy thông tin sản xuất khối (bao gồm slot này). Nếu bỏ qua, phương thức sẽ trả về dữ liệu sản xuất khối của epoch hiện tại cho đến slot hiện tại.
identity (chuỗi, không bắt buộc): Khóa công khai được mã hóa base58 của danh tính trình xác thực. Nếu được cung cấp, phản hồi sẽ chỉ bao gồm thông tin sản xuất khối của trình xác thực cụ thể này. Nếu bỏ qua, phương thức sẽ trả về thông tin của tất cả trình xác thực trong phạm vi được chỉ định (hoặc epoch hiện tại).

Lưu ý: Phải cung cấp ít nhất một trong hai giá trị identity hoặc range.firstSlot. Nếu không cung cấp identity thì bắt buộc phải có tham số range.

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

Trường result của phản hồi JSON-RPC sẽ là một đối tượng chứa:

context (đối tượng):
- slot (u64): Slot tại thời điểm truy xuất thông tin.
value (đối tượng):
- byIdentity (đối tượng): Một đối tượng trong đó các khóa là chuỗi danh tính trình xác thực (khóa công khai được mã hóa base58), còn các giá trị là những đối tượng chứa:
  - leaderSlots (u64): Số slot lãnh đạo được chỉ định cho trình xác thực này trong phạm vi/epoch được truy vấn.
  - blocksProduced (u64): Số khối do trình xác thực này tạo ra trong phạm vi/epoch được truy vấn.
- range (đối tượng):
  - firstSlot (u64): Slot đầu tiên của phạm vi được truy vấn.
  - lastSlot (u64): Slot cuối cùng của phạm vi được truy vấn.

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

Hiểu ranh giới epoch: Khi truy vấn bằng identity mà không có range, dữ liệu được trả về thuộc epoch hiện tại cho đến slot mới nhất mà nút đã xử lý. Nếu cần dữ liệu của một epoch trước đó đầy đủ cho một trình xác thực cụ thể, bạn cần xác định firstSlot và lastSlot của epoch đó.
Khả năng cung cấp dữ liệu của nút: Phạm vi dữ liệu sản xuất khối trong quá khứ có thể khác nhau giữa các nút RPC. Một số phạm vi slot quá cũ có thể không có trên tất cả các nút.
Giám sát hiệu suất: getBlockProduction đóng vai trò quan trọng khi xây dựng bảng điều khiển hoặc cảnh báo liên quan đến thời gian hoạt động của trình xác thực và tỷ lệ sản xuất khối thành công.
Kết hợp với getLeaderSchedule: Để phân tích chuyên sâu hơn, bạn có thể đối chiếu dữ liệu getBlockProduction với kết quả của getLeaderSchedule để xem những slot lãnh đạo cụ thể nào đã được tạo hoặc bị bỏ lỡ.
Danh tính so với tất cả trình xác thực: Truy vấn không có identity có thể trả về lượng dữ liệu lớn, đặc biệt nếu không chỉ định range hoặc chỉ định một range rộng. Hãy lưu ý đến kích thước phản hồi và yêu cầu xử lý.

Ví dụ

1. Lấy dữ liệu sản xuất khối của epoch hiện tại (tất cả trình xác thực)

Ví dụ này truy xuất dữ liệu sản xuất khối của tất cả trình xác thực trong epoch hiện tại.

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

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

async function getEpochBlockProduction() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const blockProduction = await connection.getBlockProduction();
    console.log('Block Production for Current Epoch:', JSON.stringify(blockProduction, null, 2));
    // Example: Accessing data for a specific validator (if present)
    // const specificValidatorIdentity = " deaktivCQ2sV2KF1y7n4qX1xUFk6VXL79CdfjrmLdshs"; // Replace with actual identity
    // if (blockProduction.value.byIdentity[specificValidatorIdentity]) {
    //   console.log(\`Data for \${specificValidatorIdentity}:\`, blockProduction.value.byIdentity[specificValidatorIdentity]);
    // }
  } catch (error) {
    console.error('Error fetching block production:', error);
  }
}

getEpochBlockProduction();

2. Lấy dữ liệu sản xuất khối của một trình xác thực cụ thể trong epoch hiện tại

Ví dụ này truy xuất dữ liệu sản xuất khối của một danh tính trình xác thực cụ thể trong epoch hiện tại.

# Replace YOUR_VALIDATOR_IDENTITY_PUBKEY with the actual validator's base58 public 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": "getBlockProduction",
    "params": [
      {
        "identity": "YOUR_VALIDATOR_IDENTITY_PUBKEY"
      }
    ]
  }'

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

async function getValidatorBlockProduction(validatorIdentity) {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const blockProduction = await connection.getBlockProduction({ identity: validatorIdentity });
    console.log(\`Block Production for \${validatorIdentity}:\`, JSON.stringify(blockProduction, null, 2));
  } catch (error) {
    console.error(\`Error fetching block production for \${validatorIdentity}:\`, error);
  }
}

// Replace with the validator identity you want to query
const validatorIdentity = "So11111111111111111111111111111111111111112"; // Example: Solana Foundation
getValidatorBlockProduction(validatorIdentity);

3. Lấy dữ liệu sản xuất khối cho một phạm vi slot và trình xác thực cụ thể

Ví dụ này truy xuất dữ liệu sản xuất khối của một trình xác thực cụ thể trong phạm vi slot đã xác định.

# Replace YOUR_VALIDATOR_IDENTITY_PUBKEY, START_SLOT, and END_SLOT.
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \\
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBlockProduction",
    "params": [
      {
        "identity": "YOUR_VALIDATOR_IDENTITY_PUBKEY",
        "range": {
          "firstSlot": START_SLOT, # e.g., 200000000
          "lastSlot": END_SLOT    # e.g., 200010000
        }
      }
    ]
  }'

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

async function getValidatorBlockProductionForRange(validatorIdentity, firstSlot, lastSlot) {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const blockProduction = await connection.getBlockProduction({
      identity: validatorIdentity,
      range: {
        firstSlot: firstSlot,
        lastSlot: lastSlot,
      },
    });
    console.log(\`Block Production for \${validatorIdentity} in range \${firstSlot}-\${lastSlot}:\`, JSON.stringify(blockProduction, null, 2));
  } catch (error) {
    console.error(\`Error fetching block production for \${validatorIdentity} in range:\`, error);
  }
}

// Replace with your desired parameters
const validatorIdentity = "Beefy1So11111111111111111111111111111111111"; // Example validator
const firstSlot = 200000000; // Example start slot
const lastSlot = 200010000;   // Example end slot
getValidatorBlockProductionForRange(validatorIdentity, firstSlot, lastSlot);

Hướng dẫn này giúp bạn hiểu rõ cách sử dụng phương thức RPC getBlockProduction để phân tích hoạt động sản xuất khối trên Solana.

Phương thức liên quan

getLeaderSchedule

Lấy toàn bộ lịch lãnh đạo để đối chiếu với dữ liệu sản xuất

getVoteAccounts

Lấy thông tin về tất cả trình xác thực tham gia bỏ phiếu

Bắt đầu tại đây

Dữ liệu thời gian thực

Giao dịch độ trễ thấp

Dữ liệu lịch sử & ví

Hướng dẫn phương thức RPC

Mức độ sẵn sàng cho môi trường production

Sử dụng Orb

Hướng dẫn khác

Cách sử dụng getBlockProduction

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

Tham số yêu cầu

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

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

Ví dụ

1. Lấy dữ liệu sản xuất khối của epoch hiện tại (tất cả trình xác thực)

2. Lấy dữ liệu sản xuất khối của một trình xác thực cụ thể trong epoch hiện tại

3. Lấy dữ liệu sản xuất khối cho một phạm vi slot và trình xác thực cụ thể

Phương thức liên quan

getLeaderSchedule

getVoteAccounts

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

​Tham số yêu cầu

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

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

​Ví dụ

​1. Lấy dữ liệu sản xuất khối của epoch hiện tại (tất cả trình xác thực)

​2. Lấy dữ liệu sản xuất khối của một trình xác thực cụ thể trong epoch hiện tại

​3. Lấy dữ liệu sản xuất khối cho một phạm vi slot và trình xác thực cụ thể

​Phương thức liên quan

getLeaderSchedule

getVoteAccounts

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

Tham số yêu cầu

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

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

Ví dụ

1. Lấy dữ liệu sản xuất khối của epoch hiện tại (tất cả trình xác thực)

2. Lấy dữ liệu sản xuất khối của một trình xác thực cụ thể trong epoch hiện tại

3. Lấy dữ liệu sản xuất khối cho một phạm vi slot và trình xác thực cụ thể

Phương thức liên quan