getLeaderSchedule RPC Method

Parameters

u64

string

Fetchs the leader schedule for the epoch that corresponds to the provided slot. If unspecified, the leader schedule for the current epoch is fetched

object

array

The configuration object with 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

identity

string

Only returns the results for this validator identity encoded as base-58

Returns

result

Null if the requested epoch is not found otherwise the result field will be a dictionary of validator identities, as base-58 encoded strings, and their corresponding leader slot indices as values (indices are relative to the first slot in the requested epoch)

Request

curl https://docs-demo.solana-mainnet.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","id":1, "method":"getLeaderSchedule"}'

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.solana-mainnet.quiknode.pro/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getLeaderSchedule"
})

response = https.request(request)
puts response.read_body

const web3 = require("@solana/web3.js");
(async () => {
  const solana = new web3.Connection("https://docs-demo.solana-mainnet.quiknode.pro/");
  console.log(await solana.getLeaderSchedule());
})();

import { createSolanaRpc } from "@solana/web3.js";

(async () => {
  const solanaRpc = createSolanaRpc("https://docs-demo.solana-mainnet.quiknode.pro/");
  
  try {
    const slot = await solanaRpc.getSlot().send();
    const leaderSchedule = await solanaRpc.getLeaderSchedule(slot).send();
    console.log(leaderSchedule);
  } catch (error) {
    console.error("Error fetching leader schedule:", error);
  }
})();

from solana.rpc.api import Client
solana_client = Client("https://docs-demo.solana-mainnet.quiknode.pro/")
print(solana_client.get_leader_schedule())

use reqwest::header;
use reqwest::Client;
use std::error::Error;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let mut headers = header::HeaderMap::new();
    headers.insert("Content-Type", "application/json".parse().unwrap());

    let client = Client::new();
    let json_data = r#"
    {
        "jsonrpc": "2.0",
        "id": 1,
        "method": "getLeaderSchedule"
    }
    "#;
    let response = client
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
        .headers(headers)
        .body(json_data)
        .send()
        .await?; 

    let body = response.text().await?;
    println!("{}", body);

    Ok(())
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free