98 lines
2.1 KiB
Plaintext
98 lines
2.1 KiB
Plaintext
import {
|
|
DocBlock,
|
|
DocSideBySide,
|
|
CodeParams,
|
|
Parameter,
|
|
Field,
|
|
Values,
|
|
CodeSnippets,
|
|
} from "../../../components/CodeDocBlock";
|
|
|
|
<DocBlock>
|
|
|
|
## getBlockProduction
|
|
|
|
Returns recent block production information from the current or previous epoch.
|
|
|
|
<DocSideBySide>
|
|
|
|
<CodeParams>
|
|
|
|
### Parameters:
|
|
|
|
<Parameter type={"object"} optional={true}>
|
|
|
|
Configuration object containing the following fields:
|
|
|
|
<Field
|
|
name="commitment"
|
|
type="string"
|
|
optional={true}
|
|
href="/api/http#configuring-state-commitment"
|
|
></Field>
|
|
|
|
<Field name="identity" type="string" optional={true}>
|
|
Only return results for this validator identity (base-58 encoded)
|
|
</Field>
|
|
|
|
<Field name="range" type="object" optional={true}>
|
|
Slot range to return block production for. If parameter not provided, defaults to current epoch.
|
|
|
|
- `firstSlot: <u64>` - first slot to return block production information for (inclusive)
|
|
- (optional) `lastSlot: <u64>` - last slot to return block production information for (inclusive). If parameter not provided, defaults to the highest slot
|
|
|
|
</Field>
|
|
|
|
</Parameter>
|
|
|
|
### Result:
|
|
|
|
The result will be an RpcResponse JSON object with `value` equal to:
|
|
|
|
- `<object>`
|
|
- `byIdentity: <object>` - a dictionary of validator identities,
|
|
as base-58 encoded strings. Value is a two element array containing the
|
|
number of leader slots and the number of blocks produced.
|
|
- `range: <object>` - Block production slot range
|
|
- `firstSlot: <u64>` - first slot of the block production information (inclusive)
|
|
- `lastSlot: <u64>` - last slot of block production information (inclusive)
|
|
|
|
</CodeParams>
|
|
|
|
<CodeSnippets>
|
|
|
|
### Code sample:
|
|
|
|
```bash
|
|
curl http://localhost:8899 -X POST -H "Content-Type: application/json" -d '
|
|
{"jsonrpc":"2.0","id":1, "method":"getBlockProduction"}
|
|
'
|
|
```
|
|
|
|
### Response:
|
|
|
|
```json
|
|
{
|
|
"jsonrpc": "2.0",
|
|
"result": {
|
|
"context": {
|
|
"slot": 9887
|
|
},
|
|
"value": {
|
|
"byIdentity": {
|
|
"85iYT5RuzRTDgjyRa3cP8SYhM2j21fj7NhfJ3peu1DPr": [9888, 9886]
|
|
},
|
|
"range": {
|
|
"firstSlot": 0,
|
|
"lastSlot": 9887
|
|
}
|
|
}
|
|
},
|
|
"id": 1
|
|
}
|
|
```
|
|
|
|
</CodeSnippets>
|
|
</DocSideBySide>
|
|
</DocBlock>
|