Type Alias BridgeRococoGrandpa

pub type BridgeRococoGrandpa = Pallet<Runtime, Instance1>;

Aliased Type

struct BridgeRococoGrandpa(/* private fields */);

Implementations

impl<T, I> Pallet<T, I>

where T: Config<I>, I: 'static,

pub fn submit_finality_proof( origin: <T as Config>::RuntimeOrigin, finality_target: Box<<<T as Config<I>>::BridgedChain as Chain>::Header>, justification: GrandpaJustification<<<T as Config<I>>::BridgedChain as Chain>::Header>, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

👎Deprecated: submit_finality_proof will be removed in May 2024. Use submit_finality_proof_ex instead.

This call is deprecated and will be removed around May 2024. Use the submit_finality_proof_ex instead. Semantically, this call is an equivalent of the submit_finality_proof_ex call without current authority set id check.

pub fn initialize( origin: <T as Config>::RuntimeOrigin, init_data: InitializationData<<<T as Config<I>>::BridgedChain as Chain>::Header>, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Bootstrap the bridge pallet with an initial header and authority set from which to sync.

The initial configuration provided does not need to be the genesis header of the bridged chain, it can be any arbitrary header. You can also provide the next scheduled set change if it is already know.

This function is only allowed to be called from a trusted origin and writes to storage with practically no checks in terms of the validity of the data. It is important that you ensure that valid data is being passed in.

pub fn set_owner( origin: <T as Config>::RuntimeOrigin, new_owner: Option<<T as Config>::AccountId>, ) -> Result<(), DispatchError>

Change PalletOwner.

May only be called either by root, or by PalletOwner.

pub fn set_operating_mode( origin: <T as Config>::RuntimeOrigin, operating_mode: BasicOperatingMode, ) -> Result<(), DispatchError>

Halt or resume all pallet operations.

May only be called either by root, or by PalletOwner.

pub fn submit_finality_proof_ex( origin: <T as Config>::RuntimeOrigin, finality_target: Box<<<T as Config<I>>::BridgedChain as Chain>::Header>, justification: GrandpaJustification<<<T as Config<I>>::BridgedChain as Chain>::Header>, current_set_id: u64, _is_free_execution_expected: bool, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Verify a target header is finalized according to the given finality proof. The proof is assumed to be signed by GRANDPA authorities set with current_set_id id.

It will use the underlying storage pallet to fetch information about the current authorities and best finalized header in order to verify that the header is finalized.

If successful in verification, it will write the target header to the underlying storage pallet.

The call fails if:

• the pallet is halted;

• the pallet knows better header than the finality_target;

• the id of best GRANDPA authority set, known to the pallet is not equal to the current_set_id;

• verification is not optimized or invalid;

• header contains forced authorities set change or change with non-zero delay.

The is_free_execution_expected parameter is not really used inside the call. It is used by the transaction extension, which should be registered at the runtime level. If this parameter is true, the transaction will be treated as invalid, if the call won’t be executed for free. If transaction extension is not used by the runtime, this parameter is not used at all.

pub fn force_set_pallet_state( origin: <T as Config>::RuntimeOrigin, new_current_set_id: u64, new_authorities: Vec<(Public, u64)>, new_best_header: Box<<<T as Config<I>>::BridgedChain as Chain>::Header>, ) -> Result<(), DispatchError>

Set current authorities set and best finalized bridged header to given values (almost) without any checks. This call can fail only if:

• the call origin is not a root or a pallet owner;

• there are too many authorities in the new set.

No other checks are made. Previously imported headers stay in the storage and are still accessible after the call.

impl<T, I> Pallet<T, I>

where T: Config<I>, I: 'static, <T as Config>::RuntimeEvent: TryInto<Event<T, I>>,

pub fn synced_headers_grandpa_info() -> Vec<HeaderFinalityInfo<GrandpaJustification<<<T as Config<I>>::BridgedChain as Chain>::Header>, AuthoritySet>>

Get the GRANDPA justifications accepted in the current block.

impl<T, I> Pallet<T, I>

where T: Config<I>, I: 'static,

pub fn best_finalized() -> Option<HeaderId<<<T as Config<I>>::BridgedChain as Chain>::Hash, <<T as Config<I>>::BridgedChain as Chain>::BlockNumber>>

Returns the hash of the best finalized header.

Trait Implementations

impl<T, I> BeforeAllRuntimeMigrations for Pallet<T, I>

where T: Config<I>, I: 'static,

fn before_all_runtime_migrations() -> Weight

Something that should happen before runtime migrations are executed.

impl<T, I> Benchmarking for Pallet<T, I>

where T: Config<I> + Config, I: 'static,

fn benchmarks(extra: bool) -> Vec<BenchmarkMetadata>

Get the benchmarks available for this pallet. Generally there is one benchmark per extrinsic, so these are sometimes just called “extrinsics”.

fn run_benchmark( extrinsic: &[u8], c: &[(BenchmarkParameter, u32)], whitelist: &[TrackedStorageKey], verify: bool, internal_repeats: u32, ) -> Result<Vec<BenchmarkResult>, BenchmarkError>

Run the benchmarks for this pallet.

impl<T, I> BridgeRuntimeFilterCall<<T as Config>::AccountId, <T as Config>::RuntimeCall> for Pallet<T, I>

where I: 'static, T: Config<I>, <T as Config>::RuntimeCall: CallSubType<T, I>,

type ToPostDispatch = ()

Data that may be passed from the validate to post_dispatch.

fn validate( _who: &<T as Config>::AccountId, call: &<T as Config>::RuntimeCall, ) -> ((), Result<ValidTransaction, TransactionValidityError>)

Called during validation. Needs to checks whether a runtime call, submitted by the who is valid. Transactions not signed are not validated.

fn post_dispatch( _who: &AccountId, _has_failed: bool, _to_post_dispatch: Self::ToPostDispatch, )

Called after transaction is dispatched.

impl<T, I> Callable<T> for Pallet<T, I>

where T: Config<I>, I: 'static,

type RuntimeCall = Call<T, I>

impl<T, I> Clone for Pallet<T, I>

fn clone(&self) -> Pallet<T, I>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T, I> Debug for Pallet<T, I>

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<T, I> DispatchViewFunction for Pallet<T, I>

where T: Config<I>, I: 'static,

fn dispatch_view_function<O>( id: &ViewFunctionId, input: &mut &[u8], output: &mut O, ) -> Result<(), ViewFunctionDispatchError>

where O: Output,

impl<T, I> GetStorageVersion for Pallet<T, I>

where T: Config<I>, I: 'static,

type InCodeStorageVersion = NoStorageVersionSet

This type is generated by the pallet macro.

fn in_code_storage_version() -> <Pallet<T, I> as GetStorageVersion>::InCodeStorageVersion

Returns the in-code storage version as specified in the storage_version attribute, or NoStorageVersionSet if the attribute is missing.

fn on_chain_storage_version() -> StorageVersion

Returns the storage version of the pallet as last set in the actual on-chain storage.

fn current_storage_version() -> Self::InCodeStorageVersion

👎Deprecated: This method has been renamed to in_code_storage_version and will be removed after March 2024.

DEPRECATED: Use Self::current_storage_version instead.

impl<T, I> HeaderChain<<T as Config<I>>::BridgedChain> for Pallet<T, I>

where T: Config<I>, I: 'static,

fn finalized_header_state_root( header_hash: <<T as Config<I>>::BridgedChain as Chain>::Hash, ) -> Option<<<T as Config<I>>::BridgedChain as Chain>::Hash>

Returns state (storage) root of given finalized header.

fn verify_storage_proof( header_hash: <C as Chain>::Hash, storage_proof: Vec<Vec<u8>>, ) -> Result<StorageProofChecker<<C as Chain>::Hasher>, HeaderChainError>

Get storage proof checker using finalized header.

impl<T, I> Hooks<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T, I>

where T: Config<I>, I: 'static,

fn on_initialize( _n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, ) -> Weight

Block initialization hook. This is called at the very beginning of block execution.

fn on_finalize( _n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, )

Block finalization hook. This is called at the very end of block execution.

fn on_idle(_n: BlockNumber, _remaining_weight: Weight) -> Weight

Hook to consume a block’s idle time. This will run when the block is being finalized (before Hooks::on_finalize).

fn on_poll(_n: BlockNumber, _weight: &mut WeightMeter)

A hook to run logic after inherent application.

fn on_runtime_upgrade() -> Weight

Hook executed when a code change (aka. a “runtime upgrade”) is detected by the FRAME Executive pallet.

fn try_state(_n: BlockNumber) -> Result<(), DispatchError>

Execute the sanity checks of this pallet, per block.

fn pre_upgrade() -> Result<Vec<u8>, DispatchError>

Execute some pre-checks prior to a runtime upgrade.

fn post_upgrade(_state: Vec<u8>) -> Result<(), DispatchError>

Execute some post-checks after a runtime upgrade.

fn offchain_worker(_n: BlockNumber)

Implementing this function on a pallet allows you to perform long-running tasks that are dispatched as separate threads, and entirely independent of the main blockchain execution.

fn integrity_test()

Check the integrity of this pallet’s configuration.

impl<T, I> IntegrityTest for Pallet<T, I>

where T: Config<I>, I: 'static,

fn integrity_test()

See Hooks::integrity_test.

impl<T, I> OffchainWorker<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T, I>

where T: Config<I>, I: 'static,

fn offchain_worker( n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, )

This function is being called after every block import (when fully synced).

impl<T, I> OnFinalize<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T, I>

where T: Config<I>, I: 'static,

fn on_finalize( n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, )

See Hooks::on_finalize.

impl<T, I> OnGenesis for Pallet<T, I>

where T: Config<I>, I: 'static,

fn on_genesis()

Something that should happen at genesis.

impl<T, I> OnIdle<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T, I>

where T: Config<I>, I: 'static,

fn on_idle( n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, remaining_weight: Weight, ) -> Weight

See Hooks::on_idle.

impl<T, I> OnInitialize<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T, I>

where T: Config<I>, I: 'static,

fn on_initialize( n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, ) -> Weight

See Hooks::on_initialize.

impl<T, I> OnPoll<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T, I>

where T: Config<I>, I: 'static,

fn on_poll( n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, weight: &mut WeightMeter, )

Code to execute every now and then at the beginning of the block after inherent application.

impl<T, I> OnRuntimeUpgrade for Pallet<T, I>

where T: Config<I>, I: 'static,

fn on_runtime_upgrade() -> Weight

See Hooks::on_runtime_upgrade.

fn pre_upgrade() -> Result<Vec<u8>, DispatchError>

See Hooks::pre_upgrade.

fn post_upgrade(state: Vec<u8>) -> Result<(), DispatchError>

See Hooks::post_upgrade.

fn try_on_runtime_upgrade(checks: bool) -> Result<Weight, DispatchError>

The expected and default behavior of this method is to handle executing pre_upgrade -> on_runtime_upgrade -> post_upgrade hooks for a migration.

impl<T, I> OwnedBridgeModule<T> for Pallet<T, I>

where T: Config<I>, I: 'static,

const LOG_TARGET: &'static str = LOG_TARGET

The target that will be used when publishing logs related to this module.

type OwnerStorage = StorageValue<_GeneratedPrefixForStoragePalletOwner<T, I>, <T as Config>::AccountId>

A storage entry that holds the module Owner account.

type OperatingMode = BasicOperatingMode

Operating mode type of the pallet.

type OperatingModeStorage = StorageValue<_GeneratedPrefixForStoragePalletOperatingMode<T, I>, BasicOperatingMode, ValueQuery>

A storage value that holds the pallet operating mode.

fn is_halted() -> bool

Check if the module is halted.

fn ensure_owner_or_root( origin: <T as Config>::RuntimeOrigin, ) -> Result<(), BadOrigin>

Ensure that the origin is either root, or PalletOwner.

fn ensure_not_halted() -> Result<(), OwnedBridgeModuleError>

Ensure that the module is not halted.

fn set_owner( origin: <T as Config>::RuntimeOrigin, maybe_owner: Option<<T as Config>::AccountId>, ) -> Result<(), DispatchError>

Change the owner of the module.

fn set_operating_mode( origin: <T as Config>::RuntimeOrigin, operating_mode: Self::OperatingMode, ) -> Result<(), DispatchError>

Halt or resume all/some module operations.

fn module_owner() -> Option<<T as Config>::AccountId>

Pallet owner has a right to halt all module operations and then resume it. If it is None, then there are no direct ways to halt/resume module operations, but other runtime methods may still be used to do that (i.e. democracy::referendum to update halt flag directly or call the set_operating_mode).

fn operating_mode() -> Self::OperatingMode

The current operating mode of the module. Depending on the mode either all, some, or no transactions will be allowed.

impl<T, I> PalletInfoAccess for Pallet<T, I>

where T: Config<I>, I: 'static,

fn index() -> usize

Index of the pallet as configured in the runtime.

fn name() -> &'static str

Name of the pallet as configured in the runtime.

fn name_hash() -> [u8; 16]

Two128 hash of name.

fn module_name() -> &'static str

Name of the Rust module containing the pallet.

fn crate_version() -> CrateVersion

Version of the crate containing the pallet.

impl<T, I> PalletsInfoAccess for Pallet<T, I>

where T: Config<I>, I: 'static,

fn count() -> usize

The number of pallets’ information that this type represents.

fn infos() -> Vec<PalletInfoData>

All of the pallets’ information that this type represents.

impl<T, I> PartialEq for Pallet<T, I>

fn eq(&self, other: &Pallet<T, I>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T, I> StorageInfoTrait for Pallet<T, I>

where T: Config<I>, I: 'static,

fn storage_info() -> Vec<StorageInfo>

impl<T, I> TryDecodeEntireStorage for Pallet<T, I>

where T: Config<I>, I: 'static,

fn try_decode_entire_state() -> Result<usize, Vec<TryDecodeEntireStorageError>>

Decode the entire data under the given storage, returning Ok(bytes_decoded) if success.

impl<T, I> TryState<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T, I>

where T: Config<I>, I: 'static,

fn try_state( n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, _s: Select, ) -> Result<(), DispatchError>

Execute the state checks.

impl<T, I> ViewFunctionIdPrefix for Pallet<T, I>

where T: Config<I>, I: 'static,

fn prefix() -> [u8; 16]

impl<T, I> WhitelistedStorageKeys for Pallet<T, I>

where T: Config<I>, I: 'static,

fn whitelisted_storage_keys() -> Vec<TrackedStorageKey>

Returns a Vec<TrackedStorageKey> indicating the storage keys that should be whitelisted during benchmarking. This means that those keys will be excluded from the benchmarking performance calculation.

impl<T, I> Eq for Pallet<T, I>