#substrate #interop #ismp #polkadot-sdk

no-std pallet-hyperbridge

Pallet hyperbridge mediates the connection between hyperbridge and substrate-based chains

7 stable releases

16.0.0 Feb 3, 2025
15.0.0 Jan 10, 2025
1.15.3 Dec 10, 2024
1.15.1 Oct 15, 2024
1.6.2 May 10, 2024

#635 in Magic Beans

Download history 13/week @ 2024-11-04 31/week @ 2024-11-18 297/week @ 2024-12-09 4/week @ 2024-12-16 124/week @ 2025-01-06 37/week @ 2025-01-13 7/week @ 2025-01-20 18/week @ 2025-01-27 332/week @ 2025-02-03 201/week @ 2025-02-10

558 downloads per month
Used in pallet-token-gateway

Apache-2.0 and maybe GPL-3.0-or-later…

280KB
3.5K SLoC

Pallet Hyperbridge

Pallet hyperbridge mediates the connection between hyperbridge and substrate-based chains. This pallet provides:

  • An IsmpDispatcher implementation which collects protocol fees and commits the reciepts for these fees to child storage. Hyperbridge only accepts messages that have been paid for using this module.
  • An IsmpModule which recieves and processes requests from hyperbridge. These requests are dispatched by hyperbridge governance and may adjust fees or request payouts for both relayers and protocol revenue.

This pallet contains no calls and dispatches no requests. Substrate based chains should use this to dispatch requests that should be processed by hyperbridge.

Usage

This module must be configured as an IsmpModule in your IsmpRouter implementation so that it may receive important messages from hyperbridge such as paramter updates or relayer fee withdrawals.

use ismp::Error;
use ismp::module::IsmpModule;
use ismp::router::IsmpRouter;
use pallet_hyperbridge::PALLET_HYPERBRIDGE_ID;

#[derive(Default)]
struct ModuleRouter;

impl IsmpRouter for ModuleRouter {
    fn module_for_id(&self, id: Vec<u8>) -> Result<Box<dyn IsmpModule>, Error> {
        return match id.as_slice() {
            PALLET_HYPERBRIDGE_ID => Ok(Box::new(pallet_hyperbridge::Pallet::<Runtime>::default())),
            _ => Err(Error::ModuleNotFound(id)),
        };
    }
}

License

This library is licensed under the Apache 2.0 License, Copyright (c) 2025 Polytope Labs.

Dependencies

~21–78MB
~1.5M SLoC