Cách sử dụng getEpochInfo

​

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

• Theo dõi tiến trình epoch: Theo dõi chỉ số slot hiện tại trong epoch và tổng số slot của epoch để ước tính thời gian còn lại.
• Phân tích trạng thái mạng: Lấy số epoch hiện tại, độ cao block và số lượng giao dịch đã xử lý trong epoch hiện tại.
• Kiểm tra đồng bộ hóa: Xác minh một node có được đồng bộ hợp lý với mạng hay không bằng cách so sánh thông tin epoch của node đó.

​

Tham số yêu cầu

• commitment (chuỗi, không bắt buộc): Chỉ định mức cam kết sẽ dùng khi truy vấn sổ cái.
  • finalized: Nút sẽ truy vấn block gần nhất đã được cam kết vĩnh viễn. Nên ưu tiên 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 block gần nhất của nó. Lưu ý rằng block có thể chưa hoàn chỉnh.
  • Nếu không được cung cấp, mức cam kết mặc định là finalized.
• 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á. Bạn có thể dùng tham số này để đảm bảo phản hồi đến từ một trạng thái đủ gần đây.

​

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

• absoluteSlot (u64): Số slot tuyệt đối hiện tại.
• blockHeight (u64): Chiều cao block hiện tại.
• epoch (u64): Số epoch hiện tại.
• slotIndex (u64): Slot hiện tại tính tương đối từ thời điểm bắt đầu epoch hiện tại.
• slotsInEpoch (u64): Tổng số slot trong epoch hiện tại.
• transactionCount (u64 | null): Tổng số giao dịch đã được xử lý trong epoch hiện tại. Có thể là null nếu dữ liệu không khả dụng.

​

Ví dụ

​

1. Lấy thông tin epoch hiện tại (Không có tham số)

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

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

async function getCurrentEpochInfo() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const epochInfo = await connection.getEpochInfo();
    console.log(JSON.stringify(epochInfo, null, 2));
  } catch (error) {
    console.error('Error fetching epoch information:', error);
  }
}

getCurrentEpochInfo();

​

2. Lấy thông tin epoch hiện tại với mức cam kết finalized

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

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

async function getFinalizedEpochInfo() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const epochInfo = await connection.getEpochInfo('finalized'); // Or connection.getEpochInfo({ commitment: 'finalized' });
    console.log(JSON.stringify(epochInfo, null, 2));
  } catch (error) {
    console.error('Error fetching finalized epoch information:', error);
  }
}

getFinalizedEpochInfo();

​

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

• Các mức cam kết: processed là mức mới nhất nhưng có thể bị hoàn tác. Trong Alpenglow, confirmed và finalized có cùng độ trễ và bảo đảm hoàn tất vĩnh viễn; nên ưu tiên finalized cho mã mới.
• Khả năng cung cấp transactionCount: Trường transactionCount có thể là null nếu nút không có sẵn thông tin này hoặc nếu thông tin không được theo dõi cho mức cam kết cụ thể.
• Độ dài epoch: Số lượng slotsInEpoch có thể thay đổi. Bạn có thể dùng getEpochSchedule để xem thêm thông tin chi tiết về lịch trình epoch.

​

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