API Documentation

Our API provides endpoints to query validator and network information. All responses are JSON.

Required Versions

Returns the software versions that must be run for upcoming epochs in order to receive stake from the Solana Foundation Delegation Program. The endpoint returns at least 4 future epochs. If no versions are explicitly set for future epochs, they inherit from the most recent defined version. When versions are set for specific future epochs, all gaps are filled with inherited versions from the previous epoch. The legacy firedancer_min_version field contains the Frankendancer minimum. A client minimum is "client not allowed" when that client is ineligible for the epoch. A null maximum means no upper bound.

GET https://api.solana.org/api/community/v1/sfdp_required_versions

Query Parameters

ParameterTypeDescription
clusterstringRequired. Either 'mainnet-beta' or 'testnet'

Example Request

curl --request GET "https://api.solana.org/api/community/v1/sfdp_required_versions?cluster=mainnet-beta"

Example Response

{
  "data": [
    {
      "cluster": "mainnet-beta",
      "epoch": 857,
      "agave_min_version": "2.0.0",
      "agave_max_version": null,
      "firedancer_min_version": "0.1.0",
      "firedancer_max_version": null,
      "firedancer_full_min_version": "client not allowed",
      "firedancer_full_max_version": null,
      "inherited_from_prev_epoch": true
    },
    {
      "cluster": "mainnet-beta",
      "epoch": 858,
      "agave_min_version": "2.0.0",
      "agave_max_version": null,
      "firedancer_min_version": "0.1.0",
      "firedancer_max_version": null,
      "firedancer_full_min_version": "client not allowed",
      "firedancer_full_max_version": null,
      "inherited_from_prev_epoch": true
    },
    {
      "cluster": "mainnet-beta",
      "epoch": 859,
      "agave_min_version": "2.0.0",
      "agave_max_version": null,
      "firedancer_min_version": "0.1.0",
      "firedancer_max_version": null,
      "firedancer_full_min_version": "client not allowed",
      "firedancer_full_max_version": null,
      "inherited_from_prev_epoch": true
    },
    {
      "cluster": "mainnet-beta",
      "epoch": 860,
      "agave_min_version": "2.1.0",
      "agave_max_version": "2.2.0",
      "firedancer_min_version": "client not allowed",
      "firedancer_max_version": null,
      "firedancer_full_min_version": "26.0.0",
      "firedancer_full_max_version": null,
      "inherited_from_prev_epoch": false
    }
  ]
}

SFDP Participants

Returns a list of Solana Foundation Delegation Program participants and their current program statuses.

GET https://api.solana.org/api/community/v1/sfdp_participants

Example Request

curl --request GET https://api.solana.org/api/community/v1/sfdp_participants

Example Response

[
  {
    "mainnetBetaPubkey": "JEz865PrGtMHsKope27BETXtBDSNeFo4hVtbfsiF64f",
    "testnetPubkey": "BYWeoPrtLAhZdP2FoScmGHWmZVqBKhgwGy4kHyKyR9DF",
    "state": "TestnetOnboarded",
    "sfdp2OnboardingEpoch": null
  },
  {
    "mainnetBetaPubkey": "Gb2M4Ee5ciut3Cc3toG6UrXJohPPiLcT3RkUaDU7dHp2",
    "testnetPubkey": "8az9GBsu44bnEr3aFmqE7AYhP59xG4PoyfkXBhKFmSEv",
    "state": "Approved",
    "sfdp2OnboardingEpoch": 577
  },
  {
    "mainnetBetaPubkey": "AWfsAgeXiX6qi2ZS6ctYQ8pRc3q7bh4HaYmisoqLB45F",
    "testnetPubkey": "13mLjjALbXAHCYPTx1zAXJap1nKXigJQNGQn5cQbrRGc",
    "state": "Rejected",
    "sfdp2OnboardingEpoch": 577
  }
]