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 cần sử dụng khi truy vấn sổ cái.
  • finalized: Node sẽ truy vấn block gần nhất được đại đa số trong cụm xác nhận là đã đạt mức khóa tối đa.
  • confirmed: Node sẽ truy vấn block gần nhất đã được đại đa số trong cụm bỏ phiếu xác nhận.
  • processed: Node sẽ truy vấn block gần nhất của nó. Lưu ý rằng block có thể chưa hoàn tất.
  • 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á. Có thể dùng tham số này để đảm bảo phản hồi đến từ một trạng thái đủ mới.

​

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

• absoluteSlot (u64): Số slot tuyệt đối hiện tại.
• blockHeight (u64): Độ 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ừ đầ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 đã xử lý trong epoch hiện tại. Có thể là null nếu dữ liệu không có sẵn.

​

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 ‘confirmed’

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": "confirmed"
      }
    ]
  }'

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

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

getConfirmedEpochInfo();

​

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

• Mức cam kết: Việc chọn commitment có thể ảnh hưởng đến tính kịp thời và tính chung cuộc của dữ liệu. processed nhanh nhất nhưng kém an toàn nhất, còn finalized an toàn nhất nhưng có thể chậm hơn đôi chút. Tìm hiểu thêm về các mức cam kết để biết thông tin chi tiết.
• Khả dụng của transactionCount: Trường transactionCount có thể là null nếu node 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ể sử dụng getEpochSchedule để biết thêm chi tiết về lịch trình epoch.

​

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