如何使用 getInflationReward

​

常见用例

• 验证质押奖励： 检查质押账户是否在过去的纪元中获得了预期的奖励。
• 跟踪奖励历史： 查询多个纪元的奖励，以建立一个地址的历史记录。
• 审计验证者支付： 验证者可以使用此方法验证奖励分配（尽管奖励是支付给质押账户的，而不是直接支付给验证者身份）。

​

请求参数

1. addresses （字符串数组）：要查询的账户的base-58编码公钥列表。允许的最大地址数量可能因RPC提供商而异（例如，Helius允许付款计划最多1005个）。
2. config （对象，可选）：包含以下可选字段的配置对象：

• commitment （字符串，可选）：指定承诺级别。如果未提供，默认值为finalized。
• epoch （整数，可选）：要获取奖励的纪元编号。如果省略，RPC节点通常会使用已分发奖励的最近完成的纪元。
• minContextSlot （整数，可选）：请求的最低槽位。确保查询基于处理到至少此槽位的分类帐状态。

​

响应结构

• 如果地址在指定纪元收到奖励，则为包含通胀奖励详细信息的对象。
• 如果地址未在该纪元收到通胀奖励或账户不存在，则为**null**。

• epoch （u64）：奖励被记入的纪元。
• effectiveSlot （u64）：奖励应用并生效的槽位。
• amount （u64）：奖励金额（以lamports为单位）。
• postBalance （u64）：奖励记入后账户的余额（以lamports为单位）。
• commission （u8 | 未定义）：对于投票账户，这是奖励记入时验证器收取的佣金百分比（0-100）。非投票账户将为undefined。

​

示例

​

1. 获取单个地址的通胀奖励（上一个纪元）

# Replace YOUR_VOTE_ACCOUNT_PUBKEY with an actual vote account public key
# 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": "getInflationReward",
    "params": [
      ["YOUR_VOTE_ACCOUNT_PUBKEY"]
    ]
  }'

​

2. 获取多个地址在特定纪元的通胀奖励

# Replace <api-key> with your Helius API key
# Replace PUBKEY_1 and PUBKEY_2 with actual public keys
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getInflationReward",
    "params": [
      ["PUBKEY_1", "PUBKEY_2"],
      { "epoch": 450, "commitment": "confirmed" }
    ]
  }'

​

开发者提示

• 特定纪元： 奖励在每个纪元结束时发放。确保查询正确的纪元号。
• 奖励时间： 通胀奖励在纪元结束时计算，并在下一个纪元开始时应用。effectiveSlot 指示何时发生。
• 空结果： 对地址的 null 结果表示在指定纪元中未找到该地址的奖励。这可能是因为账户无资格（例如，不是足够抵押的股份账户）、奖励为零或账户在当时不存在。
• 速率限制： 请注意 RPC 提供商的速率限制，尤其是在查询大量地址时。