Modulesolana-haskell-sdk-1.3.0.0GHC2021

Network.Solana.RPC.HTTP.Block

This module provides access to block-related JSON-RPC methods in the Solana network. These include fetching full block data, commitment levels, recent block production statistics, block ranges, timestamps, and validity of blockhashes. Useful for exploring historical blocks, validator performance, and transaction confirmation metadata.

8 types
14 values

Packagesolana-haskell-sdk-1.3.0.0
Exports22
LanguageGHC2021
LicenceApache-2.0
SourceBlock.hs

getBlock

valuegetBlock' :: JsonRpc m => Slot -> ConfigurationObject -> m (Maybe BlockInfo)

Returns identity and transaction information about a confirmed block in the ledger, using the given configuration.

A slot that holds no block is answered by the node with a JSON-RPC error, not with null: -32007 (slot skipped), -32001 (pruned from the ledger) or -32004 (not yet produced or rooted). The transport raises such errors as a JsonRpcException (CallException) that runWeb3' does not catch, so wrap the call in try to handle them. Nothing is returned only when the node itself answers null, which Agave does solely for a rooted slot missing from its blockstore without being flagged skipped.

valuegetBlock :: JsonRpc m => Slot -> m (Maybe BlockInfo)

Returns identity and transaction information about a confirmed block in the ledger. Sets maxSupportedTransactionVersion so that blocks containing versioned (v0) transactions can be decoded (without it, such blocks make the node respond with error -32015); as a result, v0 transactions are returned without their address-lookup-table data, so instruction account indices may reference addresses not present in the parsed account keys. A slot holding no block is a JSON-RPC error rather than Nothing; see getBlock'.

datadata BlockInfo

Contains identity and transaction information for a block.

Constructors

BlockInfo
- blockhashBI :: BlockHash
  The blockhash of this block.
- previousBlockhashBI :: BlockHash
  The blockhash of this block's parent. If the parent is not available due to ledger cleanup, this will return "11111111111111111111111111111111".
- parentSlotBI :: Slot
  The slot index of this block's parent.
- transactionsBI :: [TransactionWithMeta]
  List of transactions included in the block, each with optional metadata.
- blockTimeBI :: Maybe Int64
  Estimated production time, as a Unix timestamp (in seconds). Nothing if not available.
- blockHeightBI :: Maybe BlockHeight
  The number of blocks beneath this block.

Instances2Show, FromJSON

Show BlockInfoDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block
FromJSON BlockInfoDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block

datadata TransactionWithMeta

A transaction and its optional metadata as included in a block.

Constructors

TransactionWithMeta
- meta :: Maybe Object
  Optional metadata for the transaction.
- transaction :: Transaction
  The transaction details.

Instances4Show, Generic, FromJSON, Rep

Show TransactionWithMetaDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block
Generic TransactionWithMetaDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block
FromJSON TransactionWithMetaDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block
type Rep TransactionWithMeta = D1 ('MetaData "TransactionWithMeta" "Network.Solana.RPC.HTTP.Block" "solana-haskell-sdk-1.3.0.0-JMJNnl7jmEh90dthY33ZzW" 'False) (C1 ('MetaCons "TransactionWithMeta" 'PrefixI 'True) (S1 ('MetaSel ('Just "meta") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Maybe Object)) :*: S1 ('MetaSel ('Just "transaction") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Transaction)))Defined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block

getBlockCommitment

valuegetBlockCommitment :: JsonRpc m => Slot -> m BlockCommitment

Get the block commitment based on the given block number Slot. Returns a BlockCommitment for the specified block.

datadata BlockCommitment

Commitment information for a block.

Constructors

BlockCommitment
- commitmentList :: Maybe [Word64]
  Array logging the amount of cluster stake in lamports that has voted on the block at each depth from 0 to MAX_LOCKOUT_HISTORY
- totalStake :: Integer
  Total active stake, in lamports, for the current epoch.

Instances2Show, FromJSON

Show BlockCommitmentDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block
FromJSON BlockCommitmentDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block

getBlockHeight

valuegetBlockHeight :: JsonRpc m => m BlockHeight

Returns the current block height of the node.

getBlockProduction

valuegetBlockProduction' :: JsonRpc m => m (RPCResponse BlockProduction)

Returns recent block production information from the current or previous epoch. Returns RPCResponse BlockProduction with the production statistics.

valuegetBlockProduction :: JsonRpc m => m BlockProduction

Returns recent block production information from the current or previous epoch.

typetype ValidatorData = [Word64]

Per-validator production counts: a two-element array of the number of leader slots and the number of blocks produced.

typetype ByIdentity = Map SolanaPublicKey ValidatorData

Mapping from validator identity to its production counts (ValidatorData).

datadata BlockProductionRange

Range of slots considered for block production.

Constructors

BlockProductionRange
- firstSlot :: Slot
  First slot in the range.
- lastSlot :: Slot
  Last slot in the range.

Instances4Show, Generic, FromJSON, Rep

Show BlockProductionRangeDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block
Generic BlockProductionRangeDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block
FromJSON BlockProductionRangeDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block
type Rep BlockProductionRange = D1 ('MetaData "BlockProductionRange" "Network.Solana.RPC.HTTP.Block" "solana-haskell-sdk-1.3.0.0-JMJNnl7jmEh90dthY33ZzW" 'False) (C1 ('MetaCons "BlockProductionRange" 'PrefixI 'True) (S1 ('MetaSel ('Just "firstSlot") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Slot) :*: S1 ('MetaSel ('Just "lastSlot") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Slot)))Defined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block

datadata BlockProduction

Block production statistics mapped by validator identity.

Constructors

BlockProduction ByIdentity BlockProductionRange

Instances4Show, Generic, FromJSON, Rep

Show BlockProductionDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block
Generic BlockProductionDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block
FromJSON BlockProductionDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block
type Rep BlockProduction = D1 ('MetaData "BlockProduction" "Network.Solana.RPC.HTTP.Block" "solana-haskell-sdk-1.3.0.0-JMJNnl7jmEh90dthY33ZzW" 'False) (C1 ('MetaCons "BlockProduction" 'PrefixI 'False) (S1 ('MetaSel 'Nothing 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 ByIdentity) :*: S1 ('MetaSel 'Nothing 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 BlockProductionRange)))Defined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block

getBlocks

1 declaration

valuegetBlocks :: JsonRpc m => Slot -> Maybe Slot -> m [Slot]

Returns a list of confirmed blocks between two slots (inclusive). The maximum range allowed is 500,000 slots.

getBlocksWithLimit

1 declaration

valuegetBlocksWithLimit :: JsonRpc m => Slot -> Int -> m [Slot]

Returns a list of confirmed blocks starting from the given slot, up to the specified limit.

getBlockTime

1 declaration

valuegetBlockTime :: JsonRpc m => Slot -> m (Maybe Int)

Returns the estimated production time of a block (as Unix timestamp). This is based on stake-weighted votes and validator-reported timestamps. Returns Nothing if the block exists but carries no timestamp; a slot holding no block is a JSON-RPC error, as for getBlock'.

getLatestBlockhash

4 declarations

valuegetLatestBlockhash' :: JsonRpc m => m (RPCResponse LatestBlockHash)

Get the hash and height of the latest block. Returns RPCResponse LatestBlockHash containing the block information.

valuegetLatestBlockhash :: JsonRpc m => m LatestBlockHash

Get the hash and height of the latest block.

valuegetTheLatestBlockhash :: JsonRpc m => m BlockHash

Get only the blockhash of the latest block.

datadata LatestBlockHash

Contains the hash and the height of the latest block.

Constructors

LatestBlockHash
- blockhash :: BlockHash
  Block hash as a base-58 encoded string.
- lastValidBlockHeight :: BlockHeight
  Last block height at which the blockhash is still considered valid.

Instances4Show, Generic, FromJSON, Rep

Show LatestBlockHashDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block
Generic LatestBlockHashDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block
FromJSON LatestBlockHashDefined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block
type Rep LatestBlockHash = D1 ('MetaData "LatestBlockHash" "Network.Solana.RPC.HTTP.Block" "solana-haskell-sdk-1.3.0.0-JMJNnl7jmEh90dthY33ZzW" 'False) (C1 ('MetaCons "LatestBlockHash" 'PrefixI 'True) (S1 ('MetaSel ('Just "blockhash") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 BlockHash) :*: S1 ('MetaSel ('Just "lastValidBlockHeight") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 BlockHeight)))Defined in solana-haskell-sdk-1.3.0.0 · Network.Solana.RPC.HTTP.Block

isBlockhashValid

2 declarations

valueisBlockhashValid' :: JsonRpc m => BlockHash -> m (RPCResponse Bool)

Returns whether a blockhash is still valid.

valueisBlockhashValid :: JsonRpc m => BlockHash -> m Bool

Returns whether a blockhash is still valid.