Cách sử dụng getBlocksWithLimit

​

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

• Truy xuất một số lượng khối tiếp theo cố định: Lấy một số lượng slot khối xác định đã được xác nhận sau một slot bắt đầu cụ thể.
• Khám phá khối theo phân trang: Truy xuất các khối theo từng phần khi phân tích một phân đoạn của blockchain.
• Giám sát khối gần đây: Lấy N khối gần nhất từ một slot gần đây đã biết.

​

Tham số yêu cầu

1. start_slot (u64, bắt buộc): Slot đầu tiên cần xem xét (bao gồm cả slot này).
2. limit (u64, bắt buộc): Số lượng slot khối tối đa cần trả về. Tổng số slot được truy vấn (từ start_slot đến limit khối sau đó) không được vượt quá 500.000 slot.
3. commitment (chuỗi, tùy chọn): 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. Tham số này được truyền dưới dạng trường duy nhất trong một đối tượng cấu hình ở vị trí tham số cuối cùng.

​

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

• Ví dụ: Nếu start_slot là 5 và limit là 3, một kết quả có thể là [5, 6, 7].

​

Ví dụ

​

1. Lấy số lượng khối giới hạn từ một slot bắt đầu

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

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

async function getBlocksWithLimitExample(startSlot, limit) {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const blocks = await connection.getBlocksWithLimit(startSlot, limit);
    console.log(`Up to ${limit} confirmed blocks starting from slot ${startSlot}:`, blocks);
  } catch (error) {
    console.error('Error fetching blocks with limit:', error);
  }
}

// Example usage:
const startSlot = 280000000;
const limit = 5;
getBlocksWithLimitExample(startSlot, limit);

​

2. Lấy các khối có giới hạn và mức cam kết cụ thể

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

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

async function getBlocksWithLimitAndCommitment(startSlot, limit) {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const blocks = await connection.getBlocksWithLimit(startSlot, limit, { commitment: 'finalized' });
    console.log(`Up to ${limit} finalized blocks starting from slot ${startSlot}:`, blocks);
  } catch (error) {
    console.error('Error fetching blocks with limit and commitment:', error);
  }
}

// Example usage:
const commitStartSlot = 290000000;
const commitLimit = 3;
getBlocksWithLimitAndCommitment(commitStartSlot, commitLimit);

​

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

• Làm rõ phạm vi: Tham số limit xác định số lượng slot khối tối đa cần trả về. Giới hạn 500.000 slot áp dụng cho phạm vi khái niệm được quét (tức là từ start_slot đến start_slot + limit - 1). Hãy đảm bảo phạm vi khái niệm này không vượt quá 500.000 slot, ngay cả khi tìm thấy và trả về ít khối thực tế hơn trong phạm vi đó.
• Khả năng cung cấp dữ liệu của nút: Các nút có thể không lưu giữ thông tin cho tất cả slot trong quá khứ. Một start_slot quá cũ có thể trả về ít khối hơn limit đã chỉ định hoặc trả về một mảng trống, tùy thuộc vào chính sách lưu giữ sổ cái của nút.
• Cam kết khối: Trong Alpenglow, confirmed và finalized trả về cùng các khối đã được cam kết vĩnh viễn; nên ưu tiên finalized cho mã mới. Các nút khác nhau vẫn có thể tạm thời cho kết quả khác nhau do độ trễ lan truyền.
• Tính đặc thù của trường hợp sử dụng: getBlocksWithLimit là lựa chọn lý tưởng khi bạn biết điểm bắt đầu và cần một số lượng cố định các khối tiếp theo. Nếu cần tất cả các khối trong một phạm vi slot đã biết, getBlocks có thể phù hợp hơn.

​

Phương thức liên quan