如何使用 getSlot

​

常见用例

• 获取当前网络进度： 确定节点处理或确认的最新槽。
• 节点同步检查： 比较不同节点的槽可以指示它们的同步状态。
• 操作时间戳： 使用当前槽作为操作的参考点或理解某些数据的年龄。
• 其他 RPC 调用的输入： 一些 RPC 方法可能使用槽号作为参考点。

​

请求参数

1. options (object, 可选)：一个可选的配置对象，具有以下字段：
   • commitment (string, 可选)：指定查询的承诺级别。支持的值为 finalized, confirmed, 或 processed。如果省略，将使用 RPC 节点的默认承诺（通常为 finalized）。
     • processed: 节点将查询其最新的槽。注意，此槽可能尚未被集群确认，并可能被跳过。
     • confirmed: 节点将查询集群中超级多数投票的最新槽。
     • finalized: 节点将查询集群超级多数确认已达到最大锁定（不能回滚）的最新槽。
   • minContextSlot (number, 可选)：请求可以评估的最小槽。这设置了节点上下文的最小槽。如果节点的状态比此槽旧，可能会返回错误或反映其当前（较旧）状态相对于此最小槽的槽号。

​

响应结构

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

​

示例

​

1. 获取当前槽（默认承诺）

# 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"
  }'

​

2. 获取具有特定承诺的当前槽

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

​

开发者提示

• 承诺很重要： 返回的槽号在很大程度上取决于指定的 commitment 级别。有关详细信息，请参阅 Solana 承诺级别。processed 将是节点已知的最高（最新）槽，而 finalized 将是整个网络确认的较旧槽。根据您的用例对数据最终性的需求选择合适的承诺级别。
• 节点可变性： 由于网络传播延迟或其自身的处理状态，不同的 RPC 节点可能会为相同的承诺级别返回略有不同的槽号。对于 processed 和 confirmed 级别尤其如此。
• minContextSlot： 此参数确保处理您请求的节点至少已达到 minContextSlot。如果节点落后于此槽，行为可能会有所不同（例如，错误或节点当前的最高槽小于 minContextSlot）。它通常用于需要确保查询针对足够最新状态的高级场景中。