capabilities.work

Run a Cluster Health and Readiness Check

A 5-step recipe with Solana. We can help you get access.

Recipe · 5 steps

Run a Cluster Health and Readiness Check

with Solana

Confirm an RPC node is healthy, current, and on a known version.

  1. Ask the node whether it is caught up with the cluster. A healthy node returns the string "ok"; a lagging node returns an error carrying how many slots behind it is.
  2. Record the solana-core version and feature set the node runs, so clients can detect a node lagging behind a cluster-wide upgrade.
  3. Read the slot the node has reached, the primary freshness signal for an RPC endpoint.
  4. Place the current slot inside its epoch, giving the epoch number, the position within it, and the running transaction count.
  5. Read the current block height, which advances only with confirmed blocks and is the value transaction expiry is measured against.
What you'll need to have ready
  • commitment: Commitment level for the slot and block height reads.
For your developer

Arazzo workflow solana:cluster-health-check, 5 operations: getHealth → getVersion → getSlot → getEpochInfo → getBlockHeight. Specs on APIs.io.