Type Alias Broker

pub type Broker = Pallet<Runtime>;

Aliased Type

struct Broker(/* private fields */);

Implementations

impl<T> Pallet<T>

where T: Config,

pub fn current_price() -> Result<<<T as Config>::Currency as Inspect<<T as Config>::AccountId>>::Balance, DispatchError>

If there is an ongoing sale returns the current price of a core.

impl<T> Pallet<T>

where T: Config,

pub fn configure( origin: <T as Config>::RuntimeOrigin, config: ConfigRecord<<<<T as Config>::Coretime as CoretimeInterface>::RelayChainBlockNumberProvider as BlockNumberProvider>::BlockNumber>, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Configure the pallet.

• origin: Must be Root or pass AdminOrigin.
• config: The configuration for this pallet.

pub fn reserve( origin: <T as Config>::RuntimeOrigin, workload: BoundedVec<ScheduleItem, ConstU32<pallet_broker::::types::Schedule::{constant#0}>>, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Reserve a core for a workload.

The workload will be given a reservation, but two sale period boundaries must pass before the core is actually assigned.

• origin: Must be Root or pass AdminOrigin.
• workload: The workload which should be permanently placed on a core.

pub fn unreserve( origin: <T as Config>::RuntimeOrigin, item_index: u32, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Cancel a reservation for a workload.

• origin: Must be Root or pass AdminOrigin.
• item_index: The index of the reservation. Usually this will also be the index of the core on which the reservation has been scheduled. However, it is possible that if other cores are reserved or unreserved in the same sale rotation that they won’t correspond, so it’s better to look up the core properly in the Reservations storage.

pub fn set_lease( origin: <T as Config>::RuntimeOrigin, task: u32, until: u32, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Reserve a core for a single task workload for a limited period.

In the interlude and sale period where Bulk Coretime is sold for the period immediately after until, then the same workload may be renewed.

• origin: Must be Root or pass AdminOrigin.
• task: The workload which should be placed on a core.
• until: The timeslice now earlier than which task should be placed as a workload on a core.

pub fn start_sales( origin: <T as Config>::RuntimeOrigin, end_price: <<T as Config>::Currency as Inspect<<T as Config>::AccountId>>::Balance, extra_cores: u16, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Begin the Bulk Coretime sales rotation.

• origin: Must be Root or pass AdminOrigin.
• end_price: The price after the leadin period of Bulk Coretime in the first sale.
• extra_cores: Number of extra cores that should be requested on top of the cores required for Reservations and Leases.

This will call Self::request_core_count internally to set the correct core count on the relay chain.

pub fn purchase( origin: <T as Config>::RuntimeOrigin, price_limit: <<T as Config>::Currency as Inspect<<T as Config>::AccountId>>::Balance, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Purchase Bulk Coretime in the ongoing Sale.

• origin: Must be a Signed origin with at least enough funds to pay the current price of Bulk Coretime.
• price_limit: An amount no more than which should be paid.

pub fn renew( origin: <T as Config>::RuntimeOrigin, core: u16, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Renew Bulk Coretime in the ongoing Sale or its prior Interlude Period.

• origin: Must be a Signed origin with at least enough funds to pay the renewal price of the core.
• core: The core which should be renewed.

pub fn transfer( origin: <T as Config>::RuntimeOrigin, region_id: RegionId, new_owner: <T as Config>::AccountId, ) -> Result<(), DispatchError>

Transfer a Bulk Coretime Region to a new owner.

• origin: Must be a Signed origin of the account which owns the Region region_id.
• region_id: The Region whose ownership should change.
• new_owner: The new owner for the Region.

pub fn partition( origin: <T as Config>::RuntimeOrigin, region_id: RegionId, pivot: u32, ) -> Result<(), DispatchError>

Split a Bulk Coretime Region into two non-overlapping Regions at a particular time into the region.

• origin: Must be a Signed origin of the account which owns the Region region_id.
• region_id: The Region which should be partitioned into two non-overlapping Regions.
• pivot: The offset in time into the Region at which to make the split.

pub fn interlace( origin: <T as Config>::RuntimeOrigin, region_id: RegionId, pivot: CoreMask, ) -> Result<(), DispatchError>

Split a Bulk Coretime Region into two wholly-overlapping Regions with complementary interlace masks which together make up the original Region’s interlace mask.

• origin: Must be a Signed origin of the account which owns the Region region_id.
• region_id: The Region which should become two interlaced Regions of incomplete regularity.
• pivot: The interlace mask of one of the two new regions (the other is its partial complement).

pub fn assign( origin: <T as Config>::RuntimeOrigin, region_id: RegionId, task: u32, finality: Finality, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Assign a Bulk Coretime Region to a task.

• origin: Must be a Signed origin of the account which owns the Region region_id.
• region_id: The Region which should be assigned to the task.
• task: The task to assign.
• finality: Indication of whether this assignment is final (in which case it may be eligible for renewal) or provisional (in which case it may be manipulated and/or reassigned at a later stage).

pub fn pool( origin: <T as Config>::RuntimeOrigin, region_id: RegionId, payee: <T as Config>::AccountId, finality: Finality, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Place a Bulk Coretime Region into the Instantaneous Coretime Pool.

• origin: Must be a Signed origin of the account which owns the Region region_id.
• region_id: The Region which should be assigned to the Pool.
• payee: The account which is able to collect any revenue due for the usage of this Coretime.

pub fn claim_revenue( origin: <T as Config>::RuntimeOrigin, region_id: RegionId, max_timeslices: u32, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Claim the revenue owed from inclusion in the Instantaneous Coretime Pool.

• origin: Must be a Signed origin.
• region_id: The Region which was assigned to the Pool.
• max_timeslices: The maximum number of timeslices which should be processed. This must be greater than 0. This may affect the weight of the call but should be ideally made equivalent to the length of the Region region_id. If less, further dispatches will be required with the same region_id to claim revenue for the remainder.

pub fn purchase_credit( origin: <T as Config>::RuntimeOrigin, amount: <<T as Config>::Currency as Inspect<<T as Config>::AccountId>>::Balance, beneficiary: <<T as Config>::Coretime as CoretimeInterface>::AccountId, ) -> Result<(), DispatchError>

Purchase credit for use in the Instantaneous Coretime Pool.

• origin: Must be a Signed origin able to pay at least amount.
• amount: The amount of credit to purchase.
• beneficiary: The account on the Relay-chain which controls the credit (generally this will be the collator’s hot wallet).

pub fn drop_region( _origin: <T as Config>::RuntimeOrigin, region_id: RegionId, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Drop an expired Region from the chain.

• origin: Can be any kind of origin.
• region_id: The Region which has expired.

pub fn drop_contribution( _origin: <T as Config>::RuntimeOrigin, region_id: RegionId, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Drop an expired Instantaneous Pool Contribution record from the chain.

• origin: Can be any kind of origin.
• region_id: The Region identifying the Pool Contribution which has expired.

pub fn drop_history( _origin: <T as Config>::RuntimeOrigin, when: u32, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Drop an expired Instantaneous Pool History record from the chain.

• origin: Can be any kind of origin.
• region_id: The time of the Pool History record which has expired.

pub fn drop_renewal( _origin: <T as Config>::RuntimeOrigin, core: u16, when: u32, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Drop an expired Allowed Renewal record from the chain.

• origin: Can be any kind of origin.
• core: The core to which the expired renewal refers.
• when: The timeslice to which the expired renewal refers. This must have passed.

pub fn request_core_count( origin: <T as Config>::RuntimeOrigin, core_count: u16, ) -> Result<(), DispatchError>

Request a change to the number of cores available for scheduling work.

• origin: Must be Root or pass AdminOrigin.
• core_count: The desired number of cores to be made available.

pub fn notify_core_count( origin: <T as Config>::RuntimeOrigin, core_count: u16, ) -> Result<(), DispatchError>

pub fn notify_revenue( origin: <T as Config>::RuntimeOrigin, revenue: OnDemandRevenueRecord<<<<T as Config>::Coretime as CoretimeInterface>::RelayChainBlockNumberProvider as BlockNumberProvider>::BlockNumber, <<T as Config>::Coretime as CoretimeInterface>::Balance>, ) -> Result<(), DispatchError>

pub fn enable_auto_renew( origin: <T as Config>::RuntimeOrigin, core: u16, task: u32, workload_end_hint: Option<u32>, ) -> Result<(), DispatchError>

Extrinsic for enabling auto renewal.

Callable by the sovereign account of the task on the specified core. This account will be charged at the start of every bulk period for renewing core time.

• origin: Must be the sovereign account of the task
• core: The core to which the task to be renewed is currently assigned.
• task: The task for which we want to enable auto renewal.
• workload_end_hint: should be used when enabling auto-renewal for a core that is not expiring in the upcoming bulk period (e.g., due to holding a lease) since it would be inefficient to look up when the core expires to schedule the next renewal.

pub fn disable_auto_renew( origin: <T as Config>::RuntimeOrigin, core: u16, task: u32, ) -> Result<(), DispatchError>

Extrinsic for disabling auto renewal.

Callable by the sovereign account of the task on the specified core.

• origin: Must be the sovereign account of the task.
• core: The core for which we want to disable auto renewal.
• task: The task for which we want to disable auto renewal.

pub fn force_reserve( origin: <T as Config>::RuntimeOrigin, workload: BoundedVec<ScheduleItem, ConstU32<pallet_broker::::types::Schedule::{constant#0}>>, core: u16, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>

Reserve a core for a workload immediately.

• origin: Must be Root or pass AdminOrigin.
• workload: The workload which should be permanently placed on a core starting immediately.
• core: The core to which the assignment should be made until the reservation takes effect. It is left to the caller to either add this new core or reassign any other tasks to this existing core.

This reserves the workload and then injects the workload into the Workplan for the next two sale periods. This overwrites any existing assignments for this core at the start of the next sale period.

pub fn remove_lease( origin: <T as Config>::RuntimeOrigin, task: u32, ) -> Result<(), DispatchError>

Remove a lease.

• origin: Must be Root or pass AdminOrigin.
• task: The task id of the lease which should be removed.

pub fn remove_assignment( origin: <T as Config>::RuntimeOrigin, region_id: RegionId, ) -> Result<(), DispatchError>

Remove an assignment from the Workplan.

• origin: Must be Root or pass AdminOrigin.
• region_id: The Region to be removed from the workplan.

pub fn swap_leases( origin: <T as Config>::RuntimeOrigin, id: u32, other: u32, ) -> Result<(), DispatchError>

impl<T> Pallet<T>

where T: Config,

pub fn current_timeslice() -> u32

pub fn latest_timeslice_ready_to_commit( config: &ConfigRecord<<<<T as Config>::Coretime as CoretimeInterface>::RelayChainBlockNumberProvider as BlockNumberProvider>::BlockNumber>, ) -> u32

pub fn next_timeslice_to_commit( config: &ConfigRecord<<<<T as Config>::Coretime as CoretimeInterface>::RelayChainBlockNumberProvider as BlockNumberProvider>::BlockNumber>, status: &StatusRecord, ) -> Option<u32>

pub fn account_id() -> <T as Config>::AccountId

pub fn sale_price( sale: &SaleInfoRecord<<<T as Config>::Currency as Inspect<<T as Config>::AccountId>>::Balance, <<<T as Config>::Coretime as CoretimeInterface>::RelayChainBlockNumberProvider as BlockNumberProvider>::BlockNumber>, now: <<<T as Config>::Coretime as CoretimeInterface>::RelayChainBlockNumberProvider as BlockNumberProvider>::BlockNumber, ) -> <<T as Config>::Currency as Inspect<<T as Config>::AccountId>>::Balance

pub fn issue( core: u16, begin: u32, mask: CoreMask, end: u32, owner: Option<<T as Config>::AccountId>, paid: Option<<<T as Config>::Currency as Inspect<<T as Config>::AccountId>>::Balance>, ) -> RegionId

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

where T: Config + Config,

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

where T: Config,

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

where O: Output,

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( _now: <<<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: BlockNumber)

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> Inspect<<T as Config>::AccountId> for Pallet<T>

where T: Config,

type ItemId = u128

Type for identifying an item.

fn owner( item: &<Pallet<T> as Inspect<<T as Config>::AccountId>>::ItemId, ) -> Option<<T as Config>::AccountId>

Returns the owner of item, or None if the item doesn’t exist or has no owner.

fn attribute( item: &<Pallet<T> as Inspect<<T as Config>::AccountId>>::ItemId, key: &[u8], ) -> Option<Vec<u8>>

Returns the attribute value of item corresponding to key.

fn typed_attribute<K, V>(item: &Self::ItemId, key: &K) -> Option<V>

where K: Encode, V: Decode,

Returns the strongly-typed attribute value of item corresponding to key.

fn can_transfer(_item: &Self::ItemId) -> bool

Returns true if the item may be transferred.

impl<T> IntegrityTest for Pallet<T>

where T: Config,

fn integrity_test()

See Hooks::integrity_test.

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

where T: Config,

We don’t really support burning and minting.

We only need this to allow the region to be reserve transferable.

For reserve transfers that are not ‘local’, the asset must first be withdrawn to the holding register and then deposited into the designated account. This process necessitates that the asset is capable of being ‘burned’ and ‘minted’.

Since each region is associated with specific record data, we will not actually burn the asset. If we did, we wouldn’t know what record to assign to the newly minted region. Therefore, instead of burning, we set the asset’s owner to None. In essence, ‘burning’ a region involves setting its owner to None, whereas ‘minting’ the region assigns its owner to an actual account. This way we never lose track of the associated record data.

fn mint_into( item: &<Pallet<T> as Inspect<<T as Config>::AccountId>>::ItemId, who: &<T as Config>::AccountId, ) -> Result<(), DispatchError>

Deposit a region into an account.

fn burn( item: &<Pallet<T> as Inspect<<T as Config>::AccountId>>::ItemId, maybe_check_owner: Option<&<T as Config>::AccountId>, ) -> Result<(), DispatchError>

Withdraw a region from account.

fn set_attribute( _item: &Self::ItemId, _key: &[u8], _value: &[u8], ) -> Result<(), DispatchError>

Set attribute value of item’s key.

fn set_typed_attribute<K, V>( item: &Self::ItemId, key: &K, value: &V, ) -> Result<(), DispatchError>

where K: Encode, V: Encode,

Attempt to set the strongly-typed attribute value of item’s key.

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.

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> 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> Transfer<<T as Config>::AccountId> for Pallet<T>

where T: Config,

fn transfer( item: &<Pallet<T> as Inspect<<T as Config>::AccountId>>::ItemId, dest: &<T as Config>::AccountId, ) -> Result<(), DispatchError>

Transfer item into destination account.

impl<T> TryDecodeEntireStorage for Pallet<T>

where T: Config,

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

where T: Config,

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

Execute the state checks.

impl<T> ViewFunctionIdPrefix for Pallet<T>

where T: Config,

fn prefix() -> [u8; 16]

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>