Skip to main content

Crate ismp_parachain

Crate ismp_parachain 

Source
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 pallet module in each FRAME pallet hosts the most important items needed to construct this pallet.
weights
weights trait crate

Structs§

MaxRelayStateCommitments
Type-level Get<u32> mirror of MAX_RELAY_STATE_COMMITMENTS, used as the bound for pallet::KnownRelayHeights.
ParachainData
Data provided when registering a parachain to be tracked by hyperbridge consensus client

Enums§

LegacyDrainState
State of the multi-block drain of the legacy RelayChainStateCommitments map. Active(None) is the initial state and means the next on_idle call should pass None as the clear() 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. Done is set when clear() returns None, indicating the prefix has been fully cleared; subsequent on_idle calls 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§

RelayChainOracle
Interface that exposes the relay chain state roots.

Functions§

parachain_consensus_state_id
Returns the consensus state id for The relay chain