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

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: 'confirmed' });
    console.log(`Up to ${limit} confirmed blocks (with 'confirmed' commitment) 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 quy đị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 có ít khối thực tế hơn được tìm thấy và trả về 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ả cá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 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.
• Xác nhận khối: Phương thức này trả về các khối đã được xác nhận. Tập hợp khối chính xác có thể khác đôi chút tùy thuộc vào mức commitment đã chọn và nút mà bạn truy vấn, đặc biệt đối với các slot mới nhất.
• 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