Cách sử dụng getSlot

​

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

• Lấy tiến trình hiện tại của mạng: Xác định slot gần đây nhất đã được nút xử lý hoặc xác nhận.
• Kiểm tra khả năng đồng bộ hóa của nút: So sánh slot từ các nút khác nhau có thể cho biết trạng thái đồng bộ hóa của chúng.
• Gắn dấu thời gian cho hoạt động: Sử dụng slot hiện tại làm điểm tham chiếu cho các hoạt động hoặc để xác định độ cũ của một số dữ liệu.
• Đầu vào cho các lệnh gọi RPC khác: Một số phương thức RPC có thể sử dụng số slot làm điểm tham chiếu.

​

Tham số yêu cầu

1. options (object, không bắt buộc): Một đối tượng cấu hình không bắt buộc có các trường sau:
   • commitment (string, không bắt buộc): Chỉ định mức cam kết cho truy vấn. Các giá trị được hỗ trợ là finalized, confirmed hoặc processed. Nếu bỏ qua, mức cam kết mặc định của nút RPC sẽ được sử dụng (thường là finalized).
     • processed: Nút sẽ truy vấn slot mới nhất của nó. Lưu ý rằng slot này có thể chưa được cụm xác nhận và có khả năng bị bỏ qua.
     • confirmed: Trong Alpenglow, giá trị này tương đương với finalized; được giữ lại để đảm bảo khả năng tương thích.
     • finalized: Nút sẽ truy vấn slot mới nhất đã được cam kết vĩnh viễn. Nên dùng giá trị này cho mã mới.
   • minContextSlot (number, không bắt buộc): Slot tối thiểu mà tại đó yêu cầu có thể được đánh giá. Tham số này đặt slot tối thiểu cho ngữ cảnh của nút. Nếu trạng thái của nút cũ hơn slot này, nút có thể trả về lỗi hoặc số slot phản ánh trạng thái hiện tại (cũ hơn) của nó so với mức tối thiểu này.

​

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

{
  "jsonrpc": "2.0",
  "result": 123456789,
  "id": 1
}

​

Ví dụ

​

1. Lấy slot hiện tại (mức cam kết mặc định)

# Replace <api-key> with your Helius API 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": "getSlot"
  }'

// Replace <api-key> with your Helius API key
const { Connection } = require('@solana/web3.js');

async function getCurrentSlot() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const slot = await connection.getSlot();
    console.log('Current slot (default commitment):', slot);
  } catch (error) {
    console.error('Error fetching current slot:', error);
  }
}

getCurrentSlot();

​

2. Lấy slot đã hoàn tất hiện tại

# Replace <api-key> with your Helius API 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": "getSlot",
    "params": [
      {
        "commitment": "finalized"
      }
    ]
  }'

// Replace <api-key> with your Helius API key
const { Connection } = require('@solana/web3.js');

async function getFinalizedSlot() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const slot = await connection.getSlot('finalized');
    console.log('Current slot (finalized commitment):', slot);
    // Note: For @solana/web3.js v1.30.0 and later, you can pass commitment directly.
    // For older versions or more complex options, use an object:
    // const slot = await connection.getSlot({ commitment: 'finalized' });
  } catch (error) {
    console.error('Error fetching finalized slot:', error);
  }
}

getFinalizedSlot();

​

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

• Mức cam kết rất quan trọng: processed trả về slot mới nhất mà nút đã thực thi và có thể bao gồm công việc sau đó bị hoàn tác. Trong Alpenglow, confirmed và finalized trả về cùng một trạng thái đã được cam kết vĩnh viễn; nên dùng finalized cho mã mới.
• Sự khác biệt giữa các nút: Các nút RPC khác nhau có thể trả về số slot hơi khác nhau do độ trễ truyền tải trên mạng hoặc trạng thái xử lý riêng của chúng. Điều này đặc biệt đúng ở mức cam kết processed.
• minContextSlot: Tham số này đảm bảo nút xử lý yêu cầu của bạn đã đạt ít nhất đến minContextSlot. Nếu nút chưa đạt đến slot này, hành vi có thể khác nhau (ví dụ: trả về lỗi hoặc slot cao nhất hiện tại của nút, thấp hơn minContextSlot). Tham số này thường được dùng trong các tình huống nâng cao khi cần đảm bảo truy vấn được thực hiện trên một trạng thái đủ mới.