getBlockProduction

Returns recent block production information from the current or previous epoch.

This method will use 30 Compute Units.

---

Parameters

• object optional. Configuration object containing the following fields:

  • commitment string. The level of commitment required for the query. The options include:

    • finalized string.

      • The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.

    • confirmed string.

      • The node will query the most recent block that has been voted on by the supermajority of the cluster.

    • processed string.

      • The node will query its most recent block. Note that the block may not be complete.

  • range array. The slot range to return block production for. If parameter is not provided, the default value is current epoch.

    • firstSlot string. The first slot to return block production information for (inclusive).

    • lastSlot string. The last slot to return block production information for (inclusive). If the parameter is not provided, the default value is highest slot.

  • identity string. The results for this validator identity encoded in base-58.

Returns

• result The custom object with the following fields:

  • context. The additional context to retrieve the block production information.

    • apiVersion. The API version.

    • slot. The slot number to retrieve block production information.

  • value. Information about the block production in the specified slot range.

    • byIdentity. 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. The block production slot range.

      • firstSlot. The first slot of the block production information (inclusive).

      • lastSlot. The last slot of the block production information (inclusive).

// Result
{
	"jsonrpc": "2.0",
	"result": {
		"context": {
			"apiVersion": "2.1.11",
			"slot": 319939588
		},
		"value": {
			"byIdentity": {
				"138KHwTqKNWGLoo8fK5i8UxYtwoC5tC8o7M9rY1CDEjT": [
					16,
					16
				],
				...
			},
			"range": {
				"firstSlot": 319680000,
				"lastSlot": 319939588
			}
		}
	},
	"id": 1
}

mainnet

curl https://mainnet.solana.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","id":1, "method":"getBlockProduction"}'

devnet