Type Alias Domains

pub type Domains = Pallet<Runtime>;

Aliased Type

struct Domains(/* private fields */);

Implementations

impl<T> Pallet<T>

where T: Config,

pub fn submit_bundle( origin: <T as Config>::RuntimeOrigin, opaque_bundle: Bundle<OpaqueExtrinsic, <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, <T as Config>::Hash, <T as Config>::DomainHeader, <T as Config>::Balance>, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

pub fn submit_fraud_proof( origin: <T as Config>::RuntimeOrigin, fraud_proof: Box<FraudProof<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, <T as Config>::Hash, <T as Config>::DomainHeader, <T as Config>::MmrHash>>, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

pub fn register_domain_runtime( origin: <T as Config>::RuntimeOrigin, runtime_name: String, runtime_type: RuntimeType, raw_genesis_storage: Vec<u8>, ) -> Result<(), DispatchError>

pub fn upgrade_domain_runtime( origin: <T as Config>::RuntimeOrigin, runtime_id: u32, raw_genesis_storage: Vec<u8>, ) -> Result<(), DispatchError>

pub fn register_operator( origin: <T as Config>::RuntimeOrigin, domain_id: DomainId, amount: <T as Config>::Balance, config: OperatorConfig<<T as Config>::Balance>, ) -> Result<(), DispatchError>

pub fn nominate_operator( origin: <T as Config>::RuntimeOrigin, operator_id: u64, amount: <T as Config>::Balance, ) -> Result<(), DispatchError>

pub fn instantiate_domain( origin: <T as Config>::RuntimeOrigin, domain_config_params: DomainConfigParams<<T as Config>::AccountId, <T as Config>::Balance>, ) -> Result<(), DispatchError>

pub fn deregister_operator( origin: <T as Config>::RuntimeOrigin, operator_id: u64, ) -> Result<(), DispatchError>

pub fn withdraw_stake( origin: <T as Config>::RuntimeOrigin, operator_id: u64, to_withdraw: WithdrawStake<<T as Config>::Balance, <T as Config>::Share>, ) -> Result<(), DispatchError>

pub fn unlock_funds( origin: <T as Config>::RuntimeOrigin, operator_id: u64, ) -> Result<(), DispatchError>

Unlocks the first withdrawal given the unlocking period is complete. Even if the rest of the withdrawals are out of the unlocking period, the nominator should call this extrinsic to unlock each withdrawal

pub fn unlock_nominator( origin: <T as Config>::RuntimeOrigin, operator_id: u64, ) -> Result<(), DispatchError>

Unlocks the nominator under given operator given the unlocking period is complete. A nominator can initiate their unlock given operator is already deregistered.

pub fn update_domain_operator_allow_list( origin: <T as Config>::RuntimeOrigin, domain_id: DomainId, operator_allow_list: OperatorAllowList<<T as Config>::AccountId>, ) -> Result<(), DispatchError>

Extrinsic to update domain’s operator allow list. Note:

• If the previous allowed list is set to specific operators and new allow list is set to Anyone, then domain will become permissioned to open for all operators.
• If the previous allowed list is set to Anyone or specific operators and the new allow list is set to specific operators, then all the registered not allowed operators will continue to operate until they de-register themselves.

pub fn force_staking_epoch_transition( origin: <T as Config>::RuntimeOrigin, domain_id: DomainId, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Force staking epoch transition for a given domain

pub fn set_permissioned_action_allowed_by( origin: <T as Config>::RuntimeOrigin, permissioned_action_allowed_by: PermissionedActionAllowedBy<<T as Config>::AccountId>, ) -> Result<(), DispatchError>

Update permissioned action allowed by storage by Sudo.

pub fn send_domain_sudo_call( origin: <T as Config>::RuntimeOrigin, domain_id: DomainId, call: Vec<u8>, ) -> Result<(), DispatchError>

Submit a domain sudo call.

pub fn freeze_domain( origin: <T as Config>::RuntimeOrigin, domain_id: DomainId, ) -> Result<(), DispatchError>

Freezes a given domain. A frozen domain does not accept new bundles but accepts fraud proofs.

pub fn unfreeze_domain( origin: <T as Config>::RuntimeOrigin, domain_id: DomainId, ) -> Result<(), DispatchError>

Unfreezes a frozen domain.

pub fn prune_domain_execution_receipt( origin: <T as Config>::RuntimeOrigin, domain_id: DomainId, bad_receipt_hash: <<T as Config>::DomainHeader as Header>::Hash, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Prunes a given execution receipt for given frozen domain. This call assumes the execution receipt to be bad and implicitly trusts Sudo to do the necessary validation of the ER before dispatching this call.

pub fn transfer_treasury_funds( origin: <T as Config>::RuntimeOrigin, account_id: <T as Config>::AccountId, balance: <T as Config>::Balance, ) -> Result<(), DispatchError>

Transfer funds from treasury to given account

pub fn submit_receipt( origin: <T as Config>::RuntimeOrigin, singleton_receipt: SealedSingletonReceipt<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, <T as Config>::Hash, <T as Config>::DomainHeader, <T as Config>::Balance>, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

pub fn send_evm_domain_set_contract_creation_allowed_by_call( origin: <T as Config>::RuntimeOrigin, domain_id: DomainId, contract_creation_allowed_by: PermissionedActionAllowedBy<<<EthereumSignature as Verify>::Signer as IdentifyAccount>::AccountId>, ) -> Result<(), DispatchError>

Submit an EVM domain “set contract creation allowed by” call as domain owner or root.

impl<T> Pallet<T>

where T: Config,

pub fn successful_bundles(domain_id: DomainId) -> Vec<H256>

pub fn domain_runtime_code(domain_id: DomainId) -> Option<Vec<u8>>

pub fn domain_best_number( domain_id: DomainId, ) -> Result<<<T as Config>::DomainHeader as Header>::Number, BundleError>

pub fn domain_registry_fallback( domain_id: DomainId, ) -> Option<DomainObject<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, <<T as Config>::DomainHeader as Header>::Hash, <T as Config>::AccountId, <T as Config>::Balance>>

Fallback decoding for the domain registry v2 to v3 migration. Returns the domain registry entry for the supplied domain_id, if that domain exists. Tries the v3 storage format first, then falls back to the v2 format.

All reads that could possibly happen between the runtime upgrade and the storage migration must go through this function. (Writes are ok, because any v3 writes will look “corrupt” and get skipped by the migration.)

pub fn runtime_id(domain_id: DomainId) -> Option<u32>

Returns the runtime ID for the supplied domain_id, if that domain exists.

pub fn runtime_upgrades() -> Vec<u32>

Returns the list of runtime upgrades in the current block.

pub fn domain_instance_data( domain_id: DomainId, ) -> Option<(DomainInstanceData, <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number)>

pub fn genesis_state_root(domain_id: DomainId) -> Option<H256>

pub fn domain_tx_range(domain_id: DomainId) -> U256

Returns the tx range for the domain.

pub fn bundle_producer_election_params( domain_id: DomainId, ) -> Option<BundleProducerElectionParams<<T as Config>::Balance>>

pub fn operator(operator_id: u64) -> Option<(Public, <T as Config>::Balance)>

pub fn head_receipt_number( domain_id: DomainId, ) -> <<T as Config>::DomainHeader as Header>::Number

Returns the best execution chain number.

pub fn oldest_unconfirmed_receipt_number( domain_id: DomainId, ) -> Option<<<T as Config>::DomainHeader as Header>::Number>

Returns the block number of the oldest existing unconfirmed execution receipt, return None means there is no unconfirmed ER exist or submitted yet.

pub fn latest_confirmed_domain_block_number( domain_id: DomainId, ) -> <<T as Config>::DomainHeader as Header>::Number

Returns the latest confirmed domain block number for a given domain Zero block is always a default confirmed block.

pub fn latest_confirmed_domain_block( domain_id: DomainId, ) -> Option<(<<T as Config>::DomainHeader as Header>::Number, <T as Config>::DomainHash)>

pub fn domain_bundle_limit( domain_id: DomainId, ) -> Result<Option<DomainBundleLimit>, Error>

Returns the domain bundle limit of the given domain

pub fn non_empty_er_exists(domain_id: DomainId) -> bool

Returns if there are any ERs in the challenge period that have non empty extrinsics. Note that Genesis ER is also considered special and hence non empty

pub fn extrinsics_shuffling_seed() -> <T as Config>::Hash

The external function used to access the extrinsics shuffling seed stored in BlockInherentExtrinsicData.

pub fn timestamp() -> u64

The external function used to access the timestamp stored in BlockInherentExtrinsicData.

pub fn consensus_transaction_byte_fee() -> u128

The external function used to access the consensus transaction byte fee stored in BlockInherentExtrinsicData. This value is returned by the consensus_chain_byte_fee() runtime API

pub fn execution_receipt( receipt_hash: <<T as Config>::DomainHeader as Header>::Hash, ) -> Option<ExecutionReceipt<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, <T as Config>::Hash, <<T as Config>::DomainHeader as Header>::Number, <T as Config>::DomainHash, <T as Config>::Balance>>

pub fn receipt_hash( domain_id: DomainId, domain_number: <<T as Config>::DomainHeader as Header>::Number, ) -> Option<<<T as Config>::DomainHeader as Header>::Hash>

pub fn confirmed_domain_block_storage_key(domain_id: DomainId) -> Vec<u8>

pub fn is_bad_er_pending_to_prune( domain_id: DomainId, receipt_number: <<T as Config>::DomainHeader as Header>::Number, ) -> bool

pub fn is_operator_pending_to_slash( domain_id: DomainId, operator_id: u64, ) -> bool

pub fn max_submit_bundle_weight() -> Weight

pub fn max_submit_receipt_weight() -> Weight

pub fn max_staking_epoch_transition() -> Weight

pub fn max_prune_domain_execution_receipt() -> Weight

pub fn reward_domain_operators( domain_id: DomainId, source: OperatorRewardSource<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number>, rewards: <T as Config>::Balance, )

Reward the active operators of this domain epoch.

pub fn storage_fund_account_balance(operator_id: u64) -> <T as Config>::Balance

pub fn operator_highest_slot_from_previous_block( operator_id: u64, pre_dispatch: bool, ) -> u64

pub fn get_domain_runtime_code_for_receipt( domain_id: DomainId, receipt: &ExecutionReceipt<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, <T as Config>::Hash, <<T as Config>::DomainHeader as Header>::Number, <T as Config>::DomainHash, <T as Config>::Balance>, maybe_domain_runtime_code_at: Option<DomainRuntimeCodeAt<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, <T as Config>::Hash, <T as Config>::MmrHash>>, ) -> Result<Vec<u8>, FraudProofError>

pub fn is_domain_runtime_upgraded_since( domain_id: DomainId, at: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, ) -> Option<bool>

pub fn verify_mmr_proof_and_extract_state_root( mmr_leaf_proof: ConsensusChainMmrLeafProof<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, <T as Config>::Hash, <T as Config>::MmrHash>, expected_block_number: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, ) -> Result<<T as Config>::Hash, FraudProofError>

pub fn is_domain_registered(domain_id: DomainId) -> bool

Returns true if the Domain is registered.

pub fn domain_sudo_call(domain_id: DomainId) -> Option<Vec<u8>>

Returns domain’s sudo call, if any.

pub fn receipt_gap( domain_id: DomainId, ) -> Result<<<T as Config>::DomainHeader as Header>::Number, BundleError>

pub fn is_evm_domain(domain_id: DomainId) -> bool

Returns true if this is an EVM domain.

pub fn is_private_evm_domain(domain_id: DomainId) -> bool

Returns true if this is a private EVM domain.

pub fn evm_domain_contract_creation_allowed_by_call( domain_id: DomainId, ) -> Option<PermissionedActionAllowedBy<<<EthereumSignature as Verify>::Signer as IdentifyAccount>::AccountId>>

Returns EVM domain’s “set contract creation allowed by” call, if any.

impl<T> Pallet<T>

where T: Config + CreateUnsigned<Call<T>>,

pub fn submit_bundle_unsigned( opaque_bundle: Bundle<OpaqueExtrinsic, <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, <T as Config>::Hash, <T as Config>::DomainHeader, <T as Config>::Balance>, )

Submits an unsigned extrinsic Call::submit_bundle.

pub fn submit_receipt_unsigned( singleton_receipt: SealedSingletonReceipt<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, <T as Config>::Hash, <T as Config>::DomainHeader, <T as Config>::Balance>, )

Submits an unsigned extrinsic Call::submit_receipt.

pub fn submit_fraud_proof_unsigned( fraud_proof: FraudProof<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, <T as Config>::Hash, <T as Config>::DomainHeader, <T as Config>::MmrHash>, )

Submits an unsigned extrinsic Call::submit_fraud_proof.

impl<T> Pallet<T>

where T: Config,

pub fn domain_staking_summary<KArg>( k: KArg, ) -> Option<StakingSummary<u64, <T as Config>::Balance>>

where KArg: EncodeLike<DomainId>,

An auto-generated getter for DomainStakingSummary.

impl<T> Pallet<T>

where T: Config,

pub fn next_domain_id() -> DomainId

An auto-generated getter for NextDomainId.

impl<T> Pallet<T>

where T: Config,

pub fn consensus_block_info<KArg1, KArg2>( k1: KArg1, k2: KArg2, ) -> Option<<T as Config>::Hash>

where KArg1: EncodeLike<DomainId>, KArg2: EncodeLike<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number>,

An auto-generated getter for ConsensusBlockHash.

impl<T> Pallet<T>

where T: Config,

pub fn latest_confirmed_domain_execution_receipt<KArg>( k: KArg, ) -> Option<ExecutionReceipt<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, <T as Config>::Hash, <<T as Config>::DomainHeader as Header>::Number, <T as Config>::DomainHash, <T as Config>::Balance>>

where KArg: EncodeLike<DomainId>,

An auto-generated getter for LatestConfirmedDomainExecutionReceipt.

impl<T> Pallet<T>

where T: Config,

pub fn latest_submitted_er<KArg>( k: KArg, ) -> <<T as Config>::DomainHeader as Header>::Number

where KArg: EncodeLike<(DomainId, u64)>,

An auto-generated getter for LatestSubmittedER.

Trait Implementations

impl<T> BeforeAllRuntimeMigrations for Pallet<T>

where T: Config,

fn before_all_runtime_migrations() -> Weight

Something that should happen before runtime migrations are executed.

impl<T> Callable<T> for Pallet<T>

where T: Config,

type RuntimeCall = Call<T>

impl<T> Clone for Pallet<T>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for Pallet<T>

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

Formats the value using the given formatter.

impl<T> DomainOwner<<T as Config>::AccountId> for Pallet<T>

where T: Config,

fn is_domain_owner(domain_id: DomainId, acc: <T as Config>::AccountId) -> bool

Returns true if the account is the domain owner.

impl<T> GetStorageVersion for Pallet<T>

where T: Config,

type InCodeStorageVersion = StorageVersion

This type is generated by the pallet macro.

fn in_code_storage_version() -> <Pallet<T> 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> Hooks<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>

where T: Config,

fn on_initialize( block_number: <<<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( _: <<<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 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> IntegrityTest for Pallet<T>

where T: Config,

fn integrity_test()

See [Hooks::integrity_test].

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

where T: Config,

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> OnFinalize<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>

where T: Config,

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

See [Hooks::on_finalize].

impl<T> OnGenesis for Pallet<T>

where T: Config,

fn on_genesis()

Something that should happen at genesis.

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

where T: Config,

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

See [Hooks::on_idle].

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

where T: Config,

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

See [Hooks::on_initialize].

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

where T: Config,

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> OnRuntimeUpgrade for Pallet<T>

where T: Config,

fn on_runtime_upgrade() -> Weight

See [Hooks::on_runtime_upgrade].

impl<T> PalletInfoAccess for Pallet<T>

where T: Config,

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> PalletsInfoAccess for Pallet<T>

where T: Config,

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> PartialEq for Pallet<T>

fn eq(&self, other: &Pallet<T>) -> 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> StorageInfoTrait for Pallet<T>

where T: Config,

fn storage_info() -> Vec<StorageInfo>

impl<T> WhitelistedStorageKeys for Pallet<T>

where T: Config,

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> Eq for Pallet<T>