12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970#![cfg_attr(not(feature = "std"), no_std)]7172#[cfg(feature = "runtime-benchmarks")]73mod benchmarking;7475pub mod weights;7677use sp_core::H160;78use codec::{Codec, Decode, Encode};79use frame_system::{self as system, ensure_signed};80pub use pallet::*;81use scale_info::TypeInfo;82use sp_runtime::{83 traits::{BadOrigin, One, Saturating, Zero},84 RuntimeDebug, DispatchErrorWithPostInfo,85};86use sp_std::{borrow::Borrow, cmp::Ordering, marker::PhantomData, prelude::*};8788use frame_support::{89 dispatch::{DispatchError, DispatchResult, Dispatchable, UnfilteredDispatchable, Parameter},90 traits::{91 schedule::{self, DispatchTime, MaybeHashed},92 NamedReservableCurrency, EnsureOrigin, Get, IsType, OriginTrait, PrivilegeCmp,93 StorageVersion,94 },95 weights::{Weight},96};9798pub use weights::WeightInfo;99100101pub type TaskAddress<BlockNumber> = (BlockNumber, u32);102pub const MAX_TASK_ID_LENGTH_IN_BYTES: u8 = 16;103104type ScheduledId = [u8; MAX_TASK_ID_LENGTH_IN_BYTES as usize];105pub type CallOrHashOf<T> =106 MaybeHashed<<T as Config>::RuntimeCall, <T as frame_system::Config>::Hash>;107108109#[cfg_attr(any(feature = "std", test), derive(PartialEq, Eq))]110#[derive(Clone, RuntimeDebug, Encode, Decode, TypeInfo)]111pub struct ScheduledV3<Call, BlockNumber, PalletsOrigin, AccountId> {112 113 maybe_id: Option<ScheduledId>,114 115 priority: schedule::Priority,116 117 call: Call,118 119 maybe_periodic: Option<schedule::Period<BlockNumber>>,120 121 origin: PalletsOrigin,122 _phantom: PhantomData<AccountId>,123}124125pub type ScheduledV3Of<T> = ScheduledV3<126 CallOrHashOf<T>,127 <T as frame_system::Config>::BlockNumber,128 <T as Config>::PalletsOrigin,129 <T as frame_system::Config>::AccountId,130>;131132pub type ScheduledOf<T> = ScheduledV3Of<T>;133134135pub type Scheduled<Call, BlockNumber, PalletsOrigin, AccountId> =136 ScheduledV3<Call, BlockNumber, PalletsOrigin, AccountId>;137138pub enum ScheduledEnsureOriginSuccess<AccountId> {139 Root,140 Signed(AccountId),141 Unsigned,142}143144#[cfg(feature = "runtime-benchmarks")]145mod preimage_provider {146 use frame_support::traits::PreimageRecipient;147 pub trait PreimageProviderAndMaybeRecipient<H>: PreimageRecipient<H> {}148 impl<H, T: PreimageRecipient<H>> PreimageProviderAndMaybeRecipient<H> for T {}149}150151#[cfg(not(feature = "runtime-benchmarks"))]152mod preimage_provider {153 use frame_support::traits::PreimageProvider;154 pub trait PreimageProviderAndMaybeRecipient<H>: PreimageProvider<H> {}155 impl<H, T: PreimageProvider<H>> PreimageProviderAndMaybeRecipient<H> for T {}156}157158pub use preimage_provider::PreimageProviderAndMaybeRecipient;159160pub(crate) trait MarginalWeightInfo: WeightInfo {161 fn item(periodic: bool, named: bool, resolved: Option<bool>) -> Weight {162 match (periodic, named, resolved) {163 (_, false, None) => Self::on_initialize_aborted(2) - Self::on_initialize_aborted(1),164 (_, true, None) => {165 Self::on_initialize_named_aborted(2) - Self::on_initialize_named_aborted(1)166 }167 (false, false, Some(false)) => Self::on_initialize(2) - Self::on_initialize(1),168 (false, true, Some(false)) => {169 Self::on_initialize_named(2) - Self::on_initialize_named(1)170 }171 (true, false, Some(false)) => {172 Self::on_initialize_periodic(2) - Self::on_initialize_periodic(1)173 }174 (true, true, Some(false)) => {175 Self::on_initialize_periodic_named_resolved(2)176 - Self::on_initialize_periodic_named_resolved(1)177 }178 (false, false, Some(true)) => Self::on_initialize(2) - Self::on_initialize(1),179 (false, true, Some(true)) => {180 Self::on_initialize_named_resolved(2) - Self::on_initialize_named_resolved(1)181 }182 (true, false, Some(true)) => {183 Self::on_initialize_periodic_resolved(2) - Self::on_initialize_periodic_resolved(1)184 }185 (true, true, Some(true)) => {186 Self::on_initialize_periodic_named_resolved(2)187 - Self::on_initialize_periodic_named_resolved(1)188 }189 }190 }191}192impl<T: WeightInfo> MarginalWeightInfo for T {}193194#[frame_support::pallet]195pub mod pallet {196 use super::*;197 use frame_support::{198 dispatch::PostDispatchInfo,199 pallet_prelude::*,200 traits::{201 schedule::{LookupError, LOWEST_PRIORITY},202 PreimageProvider,203 },204 };205 use frame_system::pallet_prelude::*;206207 208 const STORAGE_VERSION: StorageVersion = StorageVersion::new(3);209210 #[pallet::pallet]211 #[pallet::generate_store(pub(super) trait Store)]212 #[pallet::storage_version(STORAGE_VERSION)]213 #[pallet::without_storage_info]214 pub struct Pallet<T>(_);215216 217 #[pallet::config]218 pub trait Config: frame_system::Config {219 220 type RuntimeEvent: From<Event<Self>> + IsType<<Self as frame_system::Config>::RuntimeEvent>;221222 223 type RuntimeOrigin: OriginTrait<PalletsOrigin = Self::PalletsOrigin>224 + From<Self::PalletsOrigin>225 + IsType<<Self as system::Config>::RuntimeOrigin>;226227 228 type PalletsOrigin: From<system::RawOrigin<Self::AccountId>> + Codec + Clone + Eq + TypeInfo;229230 type Currency: NamedReservableCurrency<Self::AccountId, ReserveIdentifier = ScheduledId>;231232 233 type RuntimeCall: Parameter234 + Dispatchable<Origin = <Self as Config>::RuntimeOrigin, PostInfo = PostDispatchInfo>235 + UnfilteredDispatchable<Origin = <Self as system::Config>::RuntimeOrigin>236 + GetDispatchInfo237 + From<system::RuntimeCall<Self>>;238239 240 241 #[pallet::constant]242 type MaximumWeight: Get<Weight>;243244 245 type ScheduleOrigin: EnsureOrigin<246 <Self as system::Config>::RuntimeOrigin,247 Success = ScheduledEnsureOriginSuccess<Self::AccountId>,248 >;249250 251 type PrioritySetOrigin: EnsureOrigin<<Self as system::Config>::RuntimeOrigin>;252253 254 255 256 257 258 259 260 type OriginPrivilegeCmp: PrivilegeCmp<Self::PalletsOrigin>;261262 263 264 #[pallet::constant]265 type MaxScheduledPerBlock: Get<u32>;266267 268 type WeightInfo: WeightInfo;269270 271 type PreimageProvider: PreimageProviderAndMaybeRecipient<Self::Hash>;272273 274 type NoPreimagePostponement: Get<Option<Self::BlockNumber>>;275276 277 278279 280 type CallExecutor: DispatchCall<Self, H160>;281 }282283 284 pub trait DispatchCall<T: frame_system::Config + Config, SelfContainedSignedInfo> {285 286 fn reserve_balance(287 id: ScheduledId,288 sponsor: <T as frame_system::Config>::AccountId,289 call: <T as Config>::RuntimeCall,290 count: u32,291 ) -> Result<(), DispatchError>;292293 294 fn pay_for_call(295 id: ScheduledId,296 sponsor: <T as frame_system::Config>::AccountId,297 call: <T as Config>::RuntimeCall,298 ) -> Result<u128, DispatchError>;299300 301 fn dispatch_call(302 signer: Option<T::AccountId>,303 function: <T as Config>::RuntimeCall,304 ) -> Result<305 Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>,306 TransactionValidityError,307 >;308309 310 fn cancel_reserve(311 id: ScheduledId,312 sponsor: <T as frame_system::Config>::AccountId,313 ) -> Result<u128, DispatchError>;314 }315316 317 #[pallet::storage]318 pub type Agenda<T: Config> =319 StorageMap<_, Twox64Concat, T::BlockNumber, Vec<Option<ScheduledV3Of<T>>>, ValueQuery>;320321 322 #[pallet::storage]323 pub(crate) type Lookup<T: Config> =324 StorageMap<_, Twox64Concat, ScheduledId, TaskAddress<T::BlockNumber>>;325326 327 #[pallet::event]328 #[pallet::generate_deposit(pub(super) fn deposit_event)]329 pub enum Event<T: Config> {330 331 Scheduled { when: T::BlockNumber, index: u32 },332 333 Canceled { when: T::BlockNumber, index: u32 },334 335 PriorityChanged {336 when: T::BlockNumber,337 index: u32,338 priority: schedule::Priority,339 },340 341 Dispatched {342 task: TaskAddress<T::BlockNumber>,343 id: Option<ScheduledId>,344 result: DispatchResult,345 },346 347 CallLookupFailed {348 task: TaskAddress<T::BlockNumber>,349 id: Option<ScheduledId>,350 error: LookupError,351 },352 }353354 #[pallet::error]355 pub enum Error<T> {356 357 FailedToSchedule,358 359 NotFound,360 361 TargetBlockNumberInPast,362 363 RescheduleNoChange,364 }365366 #[pallet::hooks]367 impl<T: Config> Hooks<BlockNumberFor<T>> for Pallet<T> {368 369 fn on_initialize(now: T::BlockNumber) -> Weight {370 let limit = T::MaximumWeight::get();371372 let mut queued = Agenda::<T>::take(now)373 .into_iter()374 .enumerate()375 .filter_map(|(index, s)| Some((index as u32, s?)))376 .collect::<Vec<_>>();377378 if queued.len() as u32 > T::MaxScheduledPerBlock::get() {379 log::warn!(380 target: "runtime::scheduler",381 "Warning: This block has more items queued in Scheduler than \382 expected from the runtime configuration. An update might be needed."383 );384 }385386 queued.sort_by_key(|(_, s)| s.priority);387388 let next = now + One::one();389390 let mut total_weight: Weight = T::WeightInfo::on_initialize(0);391 for (order, (index, mut s)) in queued.into_iter().enumerate() {392 let named = s.maybe_id.is_some();393394 let (call, maybe_completed) = s.call.resolved::<T::PreimageProvider>();395 s.call = call;396397 let resolved = if let Some(completed) = maybe_completed {398 T::PreimageProvider::unrequest_preimage(&completed);399 true400 } else {401 false402 };403 let call = match s.call.as_value().cloned() {404 Some(c) => c,405 None => {406 407 total_weight.saturating_accrue(T::WeightInfo::item(false, named, None));408 if let Some(delay) = T::NoPreimagePostponement::get() {409 let until = now.saturating_add(delay);410 if let Some(ref id) = s.maybe_id {411 let index = Agenda::<T>::decode_len(until).unwrap_or(0);412 Lookup::<T>::insert(id, (until, index as u32));413 }414 Agenda::<T>::append(until, Some(s));415 }416 continue;417 }418 };419420 let periodic = s.maybe_periodic.is_some();421 let call_weight = call.get_dispatch_info().weight;422 let mut item_weight = T::WeightInfo::item(periodic, named, Some(resolved));423 let origin = <<T as Config>::RuntimeOrigin as From<T::PalletsOrigin>>::from(424 s.origin.clone(),425 )426 .into();427 if ensure_signed(origin).is_ok() {428 429 item_weight.saturating_accrue(T::DbWeight::get().reads_writes(1, 1));430 }431432 433 434 435 436 let hard_deadline = s.priority <= schedule::HARD_DEADLINE;437 let test_weight = total_weight438 .saturating_add(call_weight)439 .saturating_add(item_weight);440 if !hard_deadline && order > 0 && test_weight.all_gt(limit) {441 442 total_weight.saturating_accrue(T::WeightInfo::item(false, named, None));443 if let Some(ref id) = s.maybe_id {444 445 446 447 448 let index = Agenda::<T>::decode_len(next).unwrap_or(0);449 Lookup::<T>::insert(id, (next, index as u32));450 }451 Agenda::<T>::append(next, Some(s));452 continue;453 }454455 let scheduled_origin =456 <<T as Config>::RuntimeOrigin as From<T::PalletsOrigin>>::from(s.origin.clone());457 let ensured_origin =458 T::ScheduleOrigin::ensure_origin(scheduled_origin.into()).unwrap();459460 let r;461 match ensured_origin {462 ScheduledEnsureOriginSuccess::Root => {463 r = Ok(call.dispatch_bypass_filter(frame_system::RawOrigin::Root.into()));464 }465 ScheduledEnsureOriginSuccess::Signed(sender) => {466 467 468 r = T::CallExecutor::dispatch_call(Some(sender), call.clone());469 }470 ScheduledEnsureOriginSuccess::Unsigned => {471 472 r = T::CallExecutor::dispatch_call(None, call.clone());473 }474 }475476 let mut actual_call_weight: Weight = item_weight;477 let result: Result<_, DispatchError> = match r {478 Ok(o) => match o {479 Ok(di) => {480 actual_call_weight = di.actual_weight.unwrap_or(item_weight);481 Ok(())482 }483 Err(err) => Err(err.error),484 },485 Err(_) => {486 log::error!(487 target: "runtime::scheduler",488 "Warning: Scheduler has failed to execute a post-dispatch transaction. \489 This block might have become invalid.");490 Err(DispatchError::CannotLookup)491 } 492 };493494 total_weight.saturating_accrue(item_weight);495 total_weight.saturating_accrue(actual_call_weight);496497 Self::deposit_event(Event::Dispatched {498 task: (now, index),499 id: s.maybe_id.clone(),500 result,501 });502503 if let &Some((period, count)) = &s.maybe_periodic {504 if count > 1 {505 s.maybe_periodic = Some((period, count - 1));506 } else {507 s.maybe_periodic = None;508 }509 let wake = now + period;510 let is_canceled;511512 513 if let Some(ref id) = s.maybe_id {514 is_canceled = Lookup::<T>::get(id).is_none();515 let wake_index = Agenda::<T>::decode_len(wake).unwrap_or(0);516517 if !is_canceled {518 Lookup::<T>::insert(id, (wake, wake_index as u32));519 }520 } else {521 is_canceled = false;522 }523524 if !is_canceled {525 Agenda::<T>::append(wake, Some(s));526 }527 } else if let Some(ref id) = s.maybe_id {528 Lookup::<T>::remove(id);529 }530 }531 total_weight532 }533 }534535 #[pallet::call]536 impl<T: Config> Pallet<T> {537 538 #[pallet::weight(<T as Config>::WeightInfo::schedule_named(T::MaxScheduledPerBlock::get()))]539 pub fn schedule_named(540 origin: OriginFor<T>,541 id: ScheduledId,542 when: T::BlockNumber,543 maybe_periodic: Option<schedule::Period<T::BlockNumber>>,544 priority: Option<schedule::Priority>,545 call: Box<CallOrHashOf<T>>,546 ) -> DispatchResult {547 T::ScheduleOrigin::ensure_origin(origin.clone())?;548549 if priority.is_some() {550 T::PrioritySetOrigin::ensure_origin(origin.clone())?;551 }552553 let origin = <T as Config>::RuntimeOrigin::from(origin);554 Self::do_schedule_named(555 id,556 DispatchTime::At(when),557 maybe_periodic,558 priority.unwrap_or(LOWEST_PRIORITY),559 origin.caller().clone(),560 *call,561 )?;562 Ok(())563 }564565 566 #[pallet::weight(<T as Config>::WeightInfo::cancel_named(T::MaxScheduledPerBlock::get()))]567 pub fn cancel_named(origin: OriginFor<T>, id: ScheduledId) -> DispatchResult {568 T::ScheduleOrigin::ensure_origin(origin.clone())?;569 let origin = <T as Config>::RuntimeOrigin::from(origin);570 Self::do_cancel_named(Some(origin.caller().clone()), id)?;571 Ok(())572 }573574 575 576 577 578 579 #[pallet::weight(<T as Config>::WeightInfo::schedule_named(T::MaxScheduledPerBlock::get()))]580 pub fn schedule_named_after(581 origin: OriginFor<T>,582 id: ScheduledId,583 after: T::BlockNumber,584 maybe_periodic: Option<schedule::Period<T::BlockNumber>>,585 priority: Option<schedule::Priority>,586 call: Box<CallOrHashOf<T>>,587 ) -> DispatchResult {588 T::ScheduleOrigin::ensure_origin(origin.clone())?;589590 if priority.is_some() {591 T::PrioritySetOrigin::ensure_origin(origin.clone())?;592 }593594 let origin = <T as Config>::RuntimeOrigin::from(origin);595 Self::do_schedule_named(596 id,597 DispatchTime::After(after),598 maybe_periodic,599 priority.unwrap_or(LOWEST_PRIORITY),600 origin.caller().clone(),601 *call,602 )?;603 Ok(())604 }605606 #[pallet::weight(<T as Config>::WeightInfo::change_named_priority(T::MaxScheduledPerBlock::get()))]607 pub fn change_named_priority(608 origin: OriginFor<T>,609 id: ScheduledId,610 priority: schedule::Priority,611 ) -> DispatchResult {612 T::PrioritySetOrigin::ensure_origin(origin.clone())?;613 let origin = <T as Config>::Origin::from(origin);614 Self::do_change_named_priority(origin.caller().clone(), id, priority)615 }616 }617}618619impl<T: Config> Pallet<T> {620 #[cfg(feature = "try-runtime")]621 pub fn pre_migrate_to_v3() -> Result<(), &'static str> {622 Ok(())623 }624625 #[cfg(feature = "try-runtime")]626 pub fn post_migrate_to_v3() -> Result<(), &'static str> {627 use frame_support::dispatch::GetStorageVersion;628629 assert!(Self::current_storage_version() == 3);630 for k in Agenda::<T>::iter_keys() {631 let _ = Agenda::<T>::try_get(k).map_err(|()| "Invalid item in Agenda")?;632 }633 Ok(())634 }635636 637 pub fn migrate_origin<OldOrigin: Into<T::PalletsOrigin> + codec::Decode>() {638 Agenda::<T>::translate::<639 Vec<Option<Scheduled<CallOrHashOf<T>, T::BlockNumber, OldOrigin, T::AccountId>>>,640 _,641 >(|_, agenda| {642 Some(643 agenda644 .into_iter()645 .map(|schedule| {646 schedule.map(|schedule| Scheduled {647 maybe_id: schedule.maybe_id,648 priority: schedule.priority,649 call: schedule.call,650 maybe_periodic: schedule.maybe_periodic,651 origin: schedule.origin.into(),652 _phantom: Default::default(),653 })654 })655 .collect::<Vec<_>>(),656 )657 });658 }659660 fn resolve_time(when: DispatchTime<T::BlockNumber>) -> Result<T::BlockNumber, DispatchError> {661 let now = frame_system::Pallet::<T>::block_number();662663 let when = match when {664 DispatchTime::At(x) => x,665 666 667 DispatchTime::After(x) => now.saturating_add(x).saturating_add(One::one()),668 };669670 if when <= now {671 return Err(Error::<T>::TargetBlockNumberInPast.into());672 }673674 Ok(when)675 }676677 fn do_schedule_named(678 id: ScheduledId,679 when: DispatchTime<T::BlockNumber>,680 maybe_periodic: Option<schedule::Period<T::BlockNumber>>,681 priority: schedule::Priority,682 origin: T::PalletsOrigin,683 call: CallOrHashOf<T>,684 ) -> Result<TaskAddress<T::BlockNumber>, DispatchError> {685 686 if Lookup::<T>::contains_key(&id) {687 return Err(Error::<T>::FailedToSchedule)?;688 }689690 let when = Self::resolve_time(when)?;691692 call.ensure_requested::<T::PreimageProvider>();693694 695 let maybe_periodic = maybe_periodic696 .filter(|p| p.1 > 1 && !p.0.is_zero())697 698 .map(|(p, c)| (p, c - 1));699700 let s = Scheduled {701 maybe_id: Some(id.clone()),702 priority,703 call: call.clone(),704 maybe_periodic,705 origin: origin.clone(),706 _phantom: Default::default(),707 };708709 710 711 712 713 714 715 716 717 718 719 720 721 722723 Agenda::<T>::append(when, Some(s));724 let index = Agenda::<T>::decode_len(when).unwrap_or(1) as u32 - 1;725 let address = (when, index);726 Lookup::<T>::insert(&id, &address);727 Self::deposit_event(Event::Scheduled { when, index });728729 Ok(address)730 }731732 fn do_cancel_named(origin: Option<T::PalletsOrigin>, id: ScheduledId) -> DispatchResult {733 Lookup::<T>::try_mutate_exists(id, |lookup| -> DispatchResult {734 if let Some((when, index)) = lookup.take() {735 let i = index as usize;736 Agenda::<T>::try_mutate(when, |agenda| -> DispatchResult {737 if let Some(s) = agenda.get_mut(i) {738 if let (Some(ref o), Some(ref s)) = (origin.clone(), s.borrow()) {739 if matches!(740 T::OriginPrivilegeCmp::cmp_privilege(o, &s.origin),741 Some(Ordering::Less) | None742 ) {743 return Err(BadOrigin.into());744 }745 746 747 748 749 750 751 752 753754 s.call.ensure_unrequested::<T::PreimageProvider>();755 }756 *s = None;757 }758 Ok(())759 })?;760761 Self::deposit_event(Event::Canceled { when, index });762 Ok(())763 } else {764 Err(Error::<T>::NotFound)?765 }766 })767 }768769 fn do_change_named_priority(770 origin: T::PalletsOrigin,771 id: ScheduledId,772 priority: schedule::Priority,773 ) -> DispatchResult {774 match Lookup::<T>::get(id) {775 Some((when, index)) => {776 let i = index as usize;777 Agenda::<T>::try_mutate(when, |agenda| {778 if let Some(Some(s)) = agenda.get_mut(i) {779 if matches!(780 T::OriginPrivilegeCmp::cmp_privilege(&origin, &s.origin),781 Some(Ordering::Less) | None782 ) {783 return Err(BadOrigin.into());784 }785786 s.priority = priority;787 Self::deposit_event(Event::PriorityChanged {788 when,789 index,790 priority,791 });792 }793 Ok(())794 })795 }796 None => Err(Error::<T>::NotFound.into()),797 }798 }799}