Safe Haskell	None
Language	Haskell2010

Cardano.Rpc.Server.NodeKernelAccess.Type

Synopsis

data NodeKernelAccess = NodeKernelAccess {
- chainDb :: ChainDB IO (CardanoBlock StandardCrypto)
- systemStart :: SystemStart
- readEraHistory :: forall (m :: Type -> Type). MonadIO m => m EraHistory
- securityParam :: SecurityParam
- genesisConfig :: GenesisBundle
}
data GenesisBundle = GenesisBundle {
- byronConfig :: !Config
- shelleyGenesisHash :: !GenesisHashShelley
- transitionConfig :: !(TransitionConfig LatestKnownEra)
}

Documentation

data NodeKernelAccess Source #

In-process access to the node kernel. Constructed by cardano-node once consensus initialisation completes.

Constructors

NodeKernelAccess

Fields

chainDb :: ChainDB IO (CardanoBlock StandardCrypto)
Handle to the consensus chain database
systemStart :: SystemStart
Network system start time, extracted from genesis config. Used together with readEraHistory to convert slots to wall-clock time.
readEraHistory :: forall (m :: Type -> Type). MonadIO m => m EraHistory
Read current era history from the ledger state. This is a separate read from chainDb, but the inconsistency is always safe: the ledger state is at or ahead of any block in ChainDB, and era summaries only grow, so the returned history always covers the slot of any block fetched from ChainDB.
securityParam :: SecurityParam
The protocol security parameter k: consensus never rolls back more than k blocks.
genesisConfig :: GenesisBundle
The network's genesis configuration. Genesis data never changes after startup, so it is read once and stored as a pure value.

Instances

Instances details

Has (IORef (Maybe NodeKernelAccess)) RpcEnv Source #
Instance details Defined in Cardano.Rpc.Server.Internal.Monad Methods obtain :: RpcEnv -> IORef (Maybe NodeKernelAccess) Source #

data GenesisBundle Source #

The per-era genesis configuration of the network the node is running on.

Gathered once, when the node kernel hook fires. The Byron genesis and the Shelley-onwards transition config are both read straight off CardanoProtocolParams, part of cardano-node's boot-time ProtocolInfoArgs. No hard-fork navigation is needed.

The Shelley genesis hash is the exception: ProtocolInfoArgs does not carry it, so it is threaded in separately from cardano-node's own boot-time genesis parsing (see mkNodeKernelAccess).

Constructors

GenesisBundle

Fields

byronConfig :: !Config
The Byron genesis configuration, which bundles the genesis data with the hash the Byron ledger computed when it parsed the file.
shelleyGenesisHash :: !GenesisHashShelley
Blake2b-256 hash of the raw Shelley genesis file bytes.
transitionConfig :: !(TransitionConfig LatestKnownEra)
The Shelley-onwards genesis configuration, in the same representation GenesisConfig uses. It retains the full parsed Shelley genesis, including sgInitialFunds and sgStaking; consensus keeps only a compacted copy with those fields erased.