如何使用 getEpochInfo

​

常见用例

• 监控 Epoch 进度： 跟踪 epoch 中的当前 slot 索引和 epoch 中的总 slots 以估算剩余时间。
• 网络状态分析： 获取当前 epoch 编号、区块高度以及当前 epoch 中处理的交易数量。
• 同步检查： 通过比较节点的 epoch 信息来验证其是否与网络合理同步。

​

请求参数

• （string，可选）：指定查询分类帐时使用的承诺级别。
  • ：节点将查询集群超多数确认为已达到最大锁定的最新区块。
  • ：节点将查询由集群超多数投票的最新区块。
  • ：节点将查询其最新区块。注意区块可能不完整。
  • 如果未提供，默认承诺为。
• （number，可选）：请求可评估的最小 slot。可用于确保响应来自足够新的状态。

​

响应结构

• （u64）：当前绝对 slot 编号。
• （u64）：当前区块高度。
• （u64）：当前 epoch 编号。
• （u64）：相对于当前 epoch 开始的当前 slot。
• （u64）：当前 epoch 中的总 slot 数。
• （u64 | null）：当前 epoch 中处理的总交易数。如果数据不可用，可以为。

​

示例

​

1. 获取当前纪元信息（无参数）

curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getEpochInfo"
  }'

​

2. 使用“confirmed”承诺获取当前纪元信息

curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getEpochInfo",
    "params": [
      {
        "commitment": "confirmed"
      }
    ]
  }'

​

开发者提示

• 承诺级别： 选择commitment可能会影响数据的及时性和最终性。processed最快但最不安全，而finalized最安全但可能会稍有延迟。了解更多关于承诺级别的详细信息。
• transactionCount 可用性： 如果节点没有这些信息或未跟踪特定承诺级别，transactionCount字段可能为null。
• 纪元长度： slotsInEpoch的数量可能会有所不同。你可以使用getEpochSchedule获取有关纪元计划的更多详细信息。

​

相关方法