API tài khoản lịch sử Solana (Beta)

Trạng thái tài khoản lịch sử là gì?

• Kiểm tra số dư token của ví tại một thời điểm cụ thể để kiểm toán, kế toán hoặc báo cáo thuế
• Gỡ lỗi giao dịch bằng cách đọc các tài khoản mà giao dịch đã tác động ngay trước và ngay sau khi thực thi
• Đọc các tài khoản của giao thức, chẳng hạn như pool, vault hoặc oracle, tại một slot trong quá khứ mà không cần tự phát lại sổ cái

Nên sử dụng phương thức nào?

Phạm vi cung cấp và giá

• Gói: Gói Business trở lên.
• Chi phí: 0 tín dụng cho mỗi lệnh gọi trong giai đoạn beta (giá có thể thay đổi).
• Giới hạn tốc độ: getHistoricalAccountInfo cho phép 100 yêu cầu mỗi giây, với mức tăng đột biến tối đa là 100. getHistoricalTokenAccountsByOwner cho phép 10 yêu cầu mỗi giây, với mức tăng đột biến tối đa là 10. Các giới hạn này tách biệt với giới hạn tốc độ RPC của gói và những yêu cầu vượt quá giới hạn sẽ trả về HTTP 429. Xem giới hạn tốc độ.
• Mạng: Chỉ Mainnet. Gọi các phương thức này trên endpoint mainnet tiêu chuẩn, https://mainnet.helius-rpc.com, hoặc endpoint Gatekeeper, https://beta.helius-rpc.com. Devnet trả về lỗi -32601.

Phạm vi dữ liệu

Chọn một vị trí trong lịch sử

Đọc trạng thái trước và sau một giao dịch

• Sau giao dịch: truy vấn slot và transactionIndex của chính giao dịch đó.
• Trước giao dịch: truy vấn cùng slot với transactionIndex trừ 1. Nếu đây là giao dịch đầu tiên trong slot (chỉ mục 0), hãy truy vấn slot trước đó mà không có transactionIndex.

# State of the account right after the transaction at index 10 in slot 445000000
curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "getHistoricalAccountInfo",
    "params": [
      "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      { "slot": 445000000, "transactionIndex": 10 },
      { "encoding": "jsonParsed" }
    ]
  }'

Tìm hiểu lastUpdatedAt

"lastUpdatedAt": { "slot": 444999837, "transactionIndex": 700 }

• slot và transactionIndex trỏ đến lần ghi cuối cùng tại hoặc trước vị trí được truy vấn. Trong ví dụ trên, truy vấn cho slot 445,000,000 trả về trạng thái được ghi lần cuối bởi giao dịch có chỉ mục 700 trong slot 444,999,837.
• transactionIndex: null có nghĩa là lần ghi xảy ra bên ngoài giao dịch, chẳng hạn như phần thưởng epoch.
• slot: 444959999 với transactionIndex: null có nghĩa là tài khoản chưa thay đổi kể từ khi phạm vi lịch sử bắt đầu. Điều này không có nghĩa là tài khoản đã được ghi trong slot đó.

Ý nghĩa của giá trị null

• Phản hồi null không có lastUpdatedAt, vì vậy phản hồi không cho biết tài khoản được tạo hoặc đóng khi nào. Để tìm các giao dịch đó, hãy sử dụng getTransactionsForAddress.
• Một địa chỉ chưa từng tồn tại cũng trả về null chứ không phải lỗi.
• Một slot trước phạm vi lịch sử trả về lỗi -32018 cho mọi địa chỉ, bất kể tài khoản có tồn tại hay không.

Duyệt ngược lịch sử tài khoản

const url = `https://mainnet.helius-rpc.com/?api-key=${process.env.HELIUS_API_KEY}`;
const COVERAGE_START_SLOT = 444959999;

type Position = { slot?: number; transactionIndex?: number };

async function getAccountHistory(address: string, start: Position = {}, maxStates = 100) {
  const states = [];
  let position = start;

  while (states.length < maxStates) {
    const response = await fetch(url, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        jsonrpc: "2.0",
        id: "1",
        method: "getHistoricalAccountInfo",
        params: [address, position, { encoding: "base64" }],
      }),
    });
    const { result, error } = await response.json();
    if (error) throw new Error(`${error.code}: ${error.message}`);

    const account = result.value;
    if (!account) break; // The account didn't exist before this write

    states.push(account);
    const { slot, transactionIndex } = account.lastUpdatedAt;
    if (slot <= COVERAGE_START_SLOT) break; // Reached the start of history coverage

    // Step to the position just before this write
    position = transactionIndex ? { slot, transactionIndex: transactionIndex - 1 } : { slot: slot - 1 };
  }

  return states; // Newest first
}

• Các tài khoản hiện đã đóng trả về null tại slot mới nhất. Hãy truyền một vị trí start từ thời điểm tài khoản vẫn còn tồn tại.
• Các lần ghi ngoài giao dịch lùi về slot trước đó. Nếu cùng tài khoản cũng được ghi bởi một giao dịch trước đó trong slot đó, quá trình duyệt sẽ bỏ qua trạng thái này.
• Để duyệt xuôi theo thời gian, hãy liệt kê các giao dịch của tài khoản từ cũ nhất đến mới nhất bằng getTransactionsForAddress và sortOrder: "asc". Sau đó, đọc trạng thái tại slot và transactionIndex của từng giao dịch.

Ngữ cảnh phản hồi

Phân trang nhất quán

• Truyền lại paginationKey trong đối tượng cấu hình để tải trang tiếp theo.
• Chỉ dừng khi paginationKey là null. Một trang có thể có ít kết quả hoặc trống nhưng vẫn còn kết quả ở phía sau.
• Cố định slot trên mọi trang. Nếu bỏ qua slot, mỗi trang sẽ đọc slot được lập chỉ mục mới nhất và các trang có thể đến từ những thời điểm khác nhau.
• Đặt limit trong khoảng từ 1 đến 5.000. Giá trị mặc định là 5.000.

Kiểu mã hóa và dữ liệu đã phân tích

• Các kiểu mã hóa được hỗ trợ là base64 (mặc định), base64+zstd và jsonParsed. base58 và binary không được hỗ trợ.
• Các tài khoản token jsonParsed sử dụng số chữ số thập phân của mint tại vị trí được truy vấn, vì vậy số lượng vẫn chính xác ngay cả khi mint đã thay đổi sau đó. Nếu không thể đọc mint tại vị trí đó, tài khoản sẽ dùng base64 thay thế.
• dataSlice hoạt động giống như trong getAccountInfo.

Mức cam kết

Lỗi

Câu hỏi thường gặp

Làm cách nào để lấy trạng thái của tài khoản Solana tại một slot cụ thể?

Có thể đọc tài khoản giữa hai giao dịch trong cùng một slot không?

Có thể truy vấn ngược về quá khứ bao xa?

Những gói nào bao gồm các phương thức tài khoản lịch sử?

Giới hạn tốc độ là bao nhiêu?

Làm cách nào để lấy mọi trạng thái trước đây của tài khoản?

Tôi có cần SDK mới không?

Bước tiếp theo