跳转到主要内容
minimumLedgerSlot RPC 方法返回查询的 RPC 节点在其分类帐中拥有信息的最低(最旧)槽。这对于了解特定节点的历史数据保留非常有用。

常见用例

  • 确定历史数据可用性: 在尝试查询非常旧的历史数据(例如,旧的区块或交易)之前,您可以使用此方法检查节点是否可能拥有这些数据。如果您需要比 minimumLedgerSlot 还低的槽的数据,您可能需要找到一个存档节点。
  • 节点修剪意识: 理解 RPC 节点(特别是非存档节点)可能修剪旧的分类账数据。此值指示其存储历史记录的当前下限。
  • 同步历史数据获取者: 如果您正在构建一个摄取 Solana 历史数据的服务,这可以帮助您了解给定节点上可用数据的起点。

请求参数

此方法不接受任何参数。

响应结构

JSON-RPC 响应中的 result 字段是一个表示节点上可用的最小分类账槽的 u64 数字。 示例响应:
{
  "jsonrpc": "2.0",
  "result": 123456789,
  "id": 1
}

代码示例

curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "minimumLedgerSlot"
  }' \
  <YOUR_RPC_URL>

开发者提示

  • 节点特定: 返回的 minimumLedgerSlot 是您查询的 RPC 节点特定的。不同的节点可能有不同的分类账保留策略,因此有不同的最小槽。
  • 动态值: 该值可能会随着时间的推移而增加,因为节点修剪其分类账的旧部分以节省空间。它不会减少。
  • 不是所有历史数据: 这并不意味着节点拥有此槽与当前末端之间的所有区块。它仅表示可能拥有数据的最低槽。尤其是在非存档节点上,可能仍然存在缺口。
  • 存档节点: 如果要访问从创世开始的完整区块链历史记录,通常需要查询一个存档节点,该节点旨在存储所有分类账数据。
本指南帮助您理解和使用 minimumLedgerSlot RPC 方法,以确定 Solana RPC 节点存储的历史数据范围。