Modulesolana-haskell-sdk-1.3.0.0GHC2021

Network.Solana.RPC.HTTP.Ledger

This module provides bindings to Solana JSON-RPC methods related to the ledger, including epoch and slot information, block leader schedules, genesis data, and transaction counts. It is useful for building explorers, monitoring tools, or protocols that depend on precise ledger state and validator schedule tracking.

4 types
12 values

Packagesolana-haskell-sdk-1.3.0.0
Exports16
LanguageGHC2021
LicenceApache-2.0
SourceLedger.hs

getEpochInfo

3 declarations

valuegetEpochInfo :: JsonRpc m => m EpochInfo

Returns information about the current epoch.

This includes the current slot, block height, epoch index, and transaction count since genesis.

typetype Epoch = Word64

Solana epoch index.

datadata EpochInfo

Contains information about the current epoch.

Constructors

EpochInfo
- absoluteSlot :: Slot
  The current absolute slot.
- blockHeight :: Word64
  The current block height.
- epoch :: Epoch
  The current epoch index.
- slotIndex :: Word64
  Slot index relative to the start of the epoch.
- slotsInEpoch :: Word64
  Total number of slots in the epoch.
- transactionCount :: Maybe Word64
  Total number of successful transactions since genesis.

Instances4Show, Generic, FromJSON, Rep

Show EpochInfoDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Ledger
Generic EpochInfoDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Ledger
FromJSON EpochInfoDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Ledger
type Rep EpochInfo = D1 ('MetaData "EpochInfo" "Network.Solana.RPC.HTTP.Ledger" "solana-haskell-sdk-1.3.0.0-JMJNnl7jmEh90dthY33ZzW" 'False) (C1 ('MetaCons "EpochInfo" 'PrefixI 'True) ((S1 ('MetaSel ('Just "absoluteSlot") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Slot) :*: (S1 ('MetaSel ('Just "blockHeight") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Word64) :*: S1 ('MetaSel ('Just "epoch") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Epoch))) :*: (S1 ('MetaSel ('Just "slotIndex") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Word64) :*: (S1 ('MetaSel ('Just "slotsInEpoch") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Word64) :*: S1 ('MetaSel ('Just "transactionCount") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Maybe Word64))))))Defined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Ledger

getEpochSchedule

2 declarations

valuegetEpochSchedule :: JsonRpc m => m EpochSchedule

Returns the epoch scheduling parameters configured in the cluster's genesis configuration.

datadata EpochSchedule

Contains epoch schedule information as defined in the cluster's genesis config.

Constructors

EpochSchedule
- slotsPerEpoch :: Word64
  Maximum number of slots per epoch.
- leaderScheduleSlotOffset :: Word64
  Number of slots before epoch start to compute leader schedule.
- warmup :: Bool
  Whether epochs start small and grow (warmup).
- firstNormalEpoch :: Word64
  First normal-length epoch.(log2(slotsPerEpoch) - log2(MINIMUM_SLOTS_PER_EPOCH))
- firstNormalSlot :: Word64
  First slot of the first normal-length epoch. ( MINIMUM_SLOTS_PER_EPOCH * (2.pow(firstNormalEpoch) - 1))

Instances4Show, Generic, FromJSON, Rep

Show EpochScheduleDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Ledger
Generic EpochScheduleDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Ledger
FromJSON EpochScheduleDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Ledger
type Rep EpochSchedule = D1 ('MetaData "EpochSchedule" "Network.Solana.RPC.HTTP.Ledger" "solana-haskell-sdk-1.3.0.0-JMJNnl7jmEh90dthY33ZzW" 'False) (C1 ('MetaCons "EpochSchedule" 'PrefixI 'True) ((S1 ('MetaSel ('Just "slotsPerEpoch") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Word64) :*: S1 ('MetaSel ('Just "leaderScheduleSlotOffset") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Word64)) :*: (S1 ('MetaSel ('Just "warmup") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Bool) :*: (S1 ('MetaSel ('Just "firstNormalEpoch") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Word64) :*: S1 ('MetaSel ('Just "firstNormalSlot") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Word64)))))Defined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Ledger

getFirstAvailableBlock

1 declaration

valuegetFirstAvailableBlock :: JsonRpc m => m Slot

Returns the slot of the lowest confirmed block that has not been purged from the ledger.

getGenesisHash

1 declaration

valuegetGenesisHash :: JsonRpc m => m BlockHash

Returns the block hash of the genesis block.

getLeaderSchedule

2 declarations

valuegetLeaderSchedule :: JsonRpc m => Maybe Slot -> m (Maybe LeaderSchedule)

Returns the leader schedule mapping validator identities to their leader slots.

Fetches the leader schedule for the epoch that contains the specified slot. If no slot is specified, the schedule for the current epoch is returned.

typetype LeaderSchedule = Map SolanaPublicKey [Word64]

Map from validator identity pubkeys to arrays of slot indices indicating when each validator is expected to produce a block.

getMaxRetransmitSlot

1 declaration

valuegetMaxRetransmitSlot :: JsonRpc m => m Slot

Returns the highest slot observed by the node from the retransmit stage.

getMaxShredInsertSlot

1 declaration

valuegetMaxShredInsertSlot :: JsonRpc m => m Slot

Returns the highest slot observed by the node after shred insertion.

getSlot

1 declaration

valuegetSlot :: JsonRpc m => m Slot

Returns the current slot, based on the default or specified commitment level.

getSlotLeader

1 declaration

valuegetSlotLeader :: JsonRpc m => m SolanaPublicKey

Returns the identity public key of the current slot leader.

getSlotLeaders

1 declaration

valuegetSlotLeaders :: JsonRpc m => Slot -> Int -> m [SolanaPublicKey]

Returns the list of slot leaders for a given slot range.

Takes a starting Slot and a limit (between 1 and 5,000), and returns the validator identities that will produce blocks for the given slots.

getTransactionCount

1 declaration

valuegetTransactionCount :: JsonRpc m => m Word64

Returns the total number of transactions recorded in the ledger.

minimumLedgerSlot

1 declaration

valueminimumLedgerSlot :: JsonRpc m => m Slot

Returns the lowest slot that the node has information about in its ledger.