Expand description
§ISMP Parachain Client
This allows parachains communicate over ISMP leveraging the relay chain as a consensus oracle.
The consensus client relies on a pallet which stores a list of parachains whom we intend to track their finalized states. This can be paired with an inherent provider which includes the proofs for the relevant parachains configured in the pallet at every block.
§Overview
The Pallet allows the AdminOrigin configured in pallet-ismp to dispatch calls for adding and removing parachains from the pallet whitelist.
§License
This library is licensed under the Apache 2.0 License, Copyright (c) 2025 Polytope Labs.
Re-exports§
pub use weights::WeightInfo;pub use consensus::*;pub use pallet::*;
Modules§
- consensus
- The parachain consensus client module
- migration
- Storage migrations for ismp-parachain.
- pallet
- The
palletmodule in each FRAME pallet hosts the most important items needed to construct this pallet. - weights
- weights trait crate
Structs§
- MaxRelay
State Commitments - Type-level
Get<u32>mirror ofMAX_RELAY_STATE_COMMITMENTS, used as the bound forpallet::KnownRelayHeights. - Parachain
Data - Data provided when registering a parachain to be tracked by hyperbridge consensus client
Enums§
- Legacy
Drain State - State of the multi-block drain of the legacy
RelayChainStateCommitmentsmap.Active(None)is the initial state and means the nexton_idlecall should passNoneas theclear()cursor (start from the beginning).Active(Some(cursor))carries the cursor returned by the previous call so the next call resumes where it left off.Doneis set whenclear()returnsNone, indicating the prefix has been fully cleared; subsequenton_idlecalls become a single cheap read and do no further work.
Constants§
- MAX_
RELAY_ STATE_ COMMITMENTS - Maximum number of relay-chain state commitments retained in
pallet::CurrentRelayChainStateRoots. At ~6s per relay block, 256 entries covers ~25 minutes of history.
Traits§
- Relay
Chain Oracle - Interface that exposes the relay chain state roots.
Functions§
- parachain_
consensus_ state_ id - Returns the consensus state id for The relay chain