Returns information about all the nodes currently participating in the cluster.
Modulesolana-haskell-sdk-1.3.0.0GHC2021
Network.Solana.RPC.HTTP.Chain
This module provides access to Solana JSON-RPC endpoints related to cluster-wide and node-specific information.
These endpoints are especially useful for monitoring, diagnostics, and understanding the state of the cluster from a validator or RPC node's perspective.
Contents
Synopsis
- value getClusterNodes
- data ClusterNodes
- value getHealth
- value getHighestSnapshotSlot
- data HighestSnapshotSlot
- value getIdentity'
- value getIdentity
- newtype NodeIdentity
- value getRecentPerformanceSamples
- data PerformanceSample
- value getRecentPrioritizationFees
- data PrioritizationFee
- value percentilePriorityFee
- value getVersion
- data SolanaVersion
- Packagesolana-haskell-sdk-1.3.0.0
- Exports15
- LanguageGHC2021
- LicenceApache-2.0
- SourceChain.hs
getClusterNodes
Contains information about all the nodes participating in the cluster.
Constructors
ClusterNodespubkey :: SolanaPublicKeyThe node's public key.
gossip :: Maybe StringGossip network address for the node.
tpu :: Maybe StringTPU (Transaction Processing Unit) network address.
rpc :: Maybe StringJSON-RPC address, if the RPC service is enabled.
version :: Maybe StringSoftware version of the node, if available.
featureSet :: Maybe Word32Unique identifier of the node's feature set.
shredVersion :: Maybe Word16Shred version used by the node.
Instances4Show, Generic, FromJSON, Rep
Show ClusterNodesDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.ChainGeneric ClusterNodesDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.ChainFromJSON ClusterNodesDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Chaintype Rep ClusterNodes = D1 ('MetaDataDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Chain"ClusterNodes"
"Network.Solana.RPC.HTTP.Chain"
"solana-haskell-sdk-1.3.0.0-JMJNnl7jmEh90dthY33ZzW"
'False) (C1 ('MetaCons"ClusterNodes"
'PrefixI 'True) ((S1 ('MetaSel ('Just"pubkey"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 SolanaPublicKey) :*: (S1 ('MetaSel ('Just"gossip"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Maybe String)) :*: S1 ('MetaSel ('Just"tpu"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Maybe String)))) :*: ((S1 ('MetaSel ('Just"rpc"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Maybe String)) :*: S1 ('MetaSel ('Just"version"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Maybe String))) :*: (S1 ('MetaSel ('Just"featureSet"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Maybe Word32)) :*: S1 ('MetaSel ('Just"shredVersion"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Maybe Word16))))))
getHealth
Checks if the node is healthy.
A healthy node is within a certain number of slots (defined by HEALTH_CHECK_SLOT_DISTANCE, a validator-side constant)
of the latest confirmed cluster slot. Returns "ok" if healthy; otherwise, an error is returned.
getHighestSnapshotSlot
Returns the highest full and incremental snapshot slots that the node has generated.
This includes the highest full snapshot slot and, if available, the corresponding highest incremental snapshot slot.
Contains the highest slot information that the node has snapshots for.
Constructors
HighestSnapshotSlotfull :: Word64The highest full snapshot slot.
incremental :: Maybe Word64The highest incremental snapshot slot, if available.
Instances4Show, Generic, FromJSON, Rep
Show HighestSnapshotSlotDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.ChainGeneric HighestSnapshotSlotDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.ChainFromJSON HighestSnapshotSlotDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Chaintype Rep HighestSnapshotSlot = D1 ('MetaDataDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Chain"HighestSnapshotSlot"
"Network.Solana.RPC.HTTP.Chain"
"solana-haskell-sdk-1.3.0.0-JMJNnl7jmEh90dthY33ZzW"
'False) (C1 ('MetaCons"HighestSnapshotSlot"
'PrefixI 'True) (S1 ('MetaSel ('Just"full"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Word64) :*: S1 ('MetaSel ('Just"incremental"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Maybe Word64))))
getIdentity
Returns the full NodeIdentity object for the current node.
Returns the identity public key of the current node.
Identity information for the current node.
Constructors
NodeIdentityidentity :: SolanaPublicKeyThe node's identity public key.
Instances4Show, Generic, FromJSON, Rep
Show NodeIdentityDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.ChainGeneric NodeIdentityDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.ChainFromJSON NodeIdentityDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Chaintype Rep NodeIdentity = D1 ('MetaDataDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Chain"NodeIdentity"
"Network.Solana.RPC.HTTP.Chain"
"solana-haskell-sdk-1.3.0.0-JMJNnl7jmEh90dthY33ZzW"
'True) (C1 ('MetaCons"NodeIdentity"
'PrefixI 'True) (S1 ('MetaSel ('Just"identity"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 SolanaPublicKey)))
getRecentPerformanceSamples
Returns a list of recent PerformanceSample entries, in reverse slot order.
Performance samples are collected every 60 seconds and include metrics such as the number of transactions, slots, and non-vote transactions within each sample window. Optionally takes the number of samples to return (must be ≤ 720).
Performance metrics sampled periodically from the node.
Constructors
PerformanceSampleslot :: SlotSlot in which the sample was taken.
numTransactions :: Word64Number of transactions during the sample period.
numSlots :: Word64Number of slots completed during the sample.
samplePeriodSecs :: Word16Duration of the sampling window, in seconds.
numNonVoteTransactions :: Maybe Word64Number of non-vote transactions during the sample; Nothing (
nullon the wire) for older samples that do not record it.
Instances4Show, Generic, FromJSON, Rep
Show PerformanceSampleDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.ChainGeneric PerformanceSampleDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.ChainFromJSON PerformanceSampleDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Chaintype Rep PerformanceSample = D1 ('MetaDataDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Chain"PerformanceSample"
"Network.Solana.RPC.HTTP.Chain"
"solana-haskell-sdk-1.3.0.0-JMJNnl7jmEh90dthY33ZzW"
'False) (C1 ('MetaCons"PerformanceSample"
'PrefixI 'True) ((S1 ('MetaSel ('Just"slot"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Slot) :*: S1 ('MetaSel ('Just"numTransactions"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Word64)) :*: (S1 ('MetaSel ('Just"numSlots"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Word64) :*: (S1 ('MetaSel ('Just"samplePeriodSecs"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Word16) :*: S1 ('MetaSel ('Just"numNonVoteTransactions"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Maybe Word64))))))
getRecentPrioritizationFees
Returns recent prioritization fees observed in recent blocks.
Optionally takes a list of up to 128 account addresses. If provided, the response estimates the prioritization fee for landing a transaction that locks all listed accounts as writable.
A prioritization fee sample from a recent block.
Constructors
PrioritizationFeepfSlot :: SlotSlot in which the fee was observed.
prioritizationFee :: Word64Per-compute-unit fee (in micro-lamports).
Instances4Show, Generic, FromJSON, Rep
Show PrioritizationFeeDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.ChainGeneric PrioritizationFeeDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.ChainFromJSON PrioritizationFeeDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Chaintype Rep PrioritizationFee = D1 ('MetaDataDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Chain"PrioritizationFee"
"Network.Solana.RPC.HTTP.Chain"
"solana-haskell-sdk-1.3.0.0-JMJNnl7jmEh90dthY33ZzW"
'False) (C1 ('MetaCons"PrioritizationFee"
'PrefixI 'True) (S1 ('MetaSel ('Just"pfSlot"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Slot) :*: S1 ('MetaSel ('Just"prioritizationFee"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Word64)))
Nearest-rank percentile over the sorted, nonzero fee samples (e.g. from
getRecentPrioritizationFees). Zero samples (slots with no priority fee)
are dropped before ranking, so the result reflects only slots that
actually paid a priority fee. p is clamped into [0, 1]. An empty
sample list, or one containing only zeros, returns 0.
getVersion
Returns the Solana software version and feature set currently running on the node.
Contains information about the software version and feature set identifier of the node.
Constructors
SolanaVersionsolana_core :: StringSoftware version of 'solana-core'.
feature_set :: Maybe Word32Unique identifier of the software's feature set; Nothing if the node does not report one.
Instances5Eq, Show, Generic, FromJSON, Rep
Eq SolanaVersionDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.ChainShow SolanaVersionDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.ChainGeneric SolanaVersionDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.ChainFromJSON SolanaVersionDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Chaintype Rep SolanaVersion = D1 ('MetaDataDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Chain"SolanaVersion"
"Network.Solana.RPC.HTTP.Chain"
"solana-haskell-sdk-1.3.0.0-JMJNnl7jmEh90dthY33ZzW"
'False) (C1 ('MetaCons"SolanaVersion"
'PrefixI 'True) (S1 ('MetaSel ('Just"solana_core"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 String) :*: S1 ('MetaSel ('Just"feature_set"
) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Maybe Word32))))