solana-validator-optimizer 2.2.0

Optimized Solana validator tool with snapshot prefetching, RPC caching, and Prometheus metrics.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

use crate::config::AppConfig;
use anyhow::Result;
use serde::Serialize;
use solana_client::nonblocking::rpc_client::RpcClient;
use solana_commitment_config::CommitmentConfig;
use std::time::Instant;

#[derive(Debug, Clone, Serialize)]
pub struct RpcHealthReport {
    pub endpoint: String,
    pub healthy: bool,
    pub health_status: String,
    pub solana_version: Option<String>,
    pub slot: Option<u64>,
    pub latest_blockhash: Option<String>,
    pub get_health_latency_ms: u128,
    pub get_version_latency_ms: Option<u128>,
    pub get_slot_latency_ms: Option<u128>,
    pub get_latest_blockhash_latency_ms: Option<u128>,
    pub warnings: Vec<String>,
}

pub async fn check_rpc_health(config: &AppConfig) -> Result<RpcHealthReport> {
    check_rpc_health_url(&config.rpc_url).await
}

pub async fn check_rpc_health_url(endpoint: &str) -> Result<RpcHealthReport> {
    let client =
        RpcClient::new_with_commitment(endpoint.to_string(), CommitmentConfig::confirmed());

    let mut warnings = Vec::new();

    let health_start = Instant::now();
    let health_result = client.get_health().await;
    let get_health_latency_ms = health_start.elapsed().as_millis();

    let (healthy, health_status) = match health_result {
        Ok(()) => {
            // In Solana client v3.x, get_health() returns Ok(()) when the RPC node is healthy.
            // The previous implementation formatted Ok(()) as "()" and then looked for "ok",
            // which incorrectly marked a healthy endpoint as unhealthy.
            (true, "ok".to_string())
        }
        Err(err) => {
            warnings.push(format!("getHealth failed: {err}"));
            (false, "unhealthy".to_string())
        }
    };

    let version_start = Instant::now();
    let version_result = client.get_version().await;
    let get_version_latency_ms = Some(version_start.elapsed().as_millis());

    let solana_version = match version_result {
        Ok(version) => Some(version.solana_core),
        Err(err) => {
            warnings.push(format!("getVersion failed: {err}"));
            None
        }
    };

    let slot_start = Instant::now();
    let slot_result = client.get_slot().await;
    let get_slot_latency_ms = Some(slot_start.elapsed().as_millis());

    let slot = match slot_result {
        Ok(slot) => Some(slot),
        Err(err) => {
            warnings.push(format!("getSlot failed: {err}"));
            None
        }
    };

    let blockhash_start = Instant::now();
    let blockhash_result = client.get_latest_blockhash().await;
    let get_latest_blockhash_latency_ms = Some(blockhash_start.elapsed().as_millis());

    let latest_blockhash = match blockhash_result {
        Ok(blockhash) => Some(blockhash.to_string()),
        Err(err) => {
            warnings.push(format!("getLatestBlockhash failed: {err}"));
            None
        }
    };

    if get_health_latency_ms > 1_000 {
        warnings.push(format!(
            "getHealth latency is high: {get_health_latency_ms} ms"
        ));
    }

    if let Some(latency) = get_version_latency_ms {
        if latency > 1_000 {
            warnings.push(format!("getVersion latency is high: {latency} ms"));
        }
    }

    if let Some(latency) = get_slot_latency_ms {
        if latency > 1_000 {
            warnings.push(format!("getSlot latency is high: {latency} ms"));
        }
    }

    if let Some(latency) = get_latest_blockhash_latency_ms {
        if latency > 1_000 {
            warnings.push(format!("getLatestBlockhash latency is high: {latency} ms"));
        }
    }

    Ok(RpcHealthReport {
        endpoint: endpoint.to_string(),
        healthy,
        health_status,
        solana_version,
        slot,
        latest_blockhash,
        get_health_latency_ms,
        get_version_latency_ms,
        get_slot_latency_ms,
        get_latest_blockhash_latency_ms,
        warnings,
    })
}