coretime_rococo_runtime/
coretime.rs

1// Copyright (C) Parity Technologies (UK) Ltd.
2// This file is part of Cumulus.
3// SPDX-License-Identifier: Apache-2.0
4
5// Licensed under the Apache License, Version 2.0 (the "License");
6// you may not use this file except in compliance with the License.
7// You may obtain a copy of the License at
8//
9// 	http://www.apache.org/licenses/LICENSE-2.0
10//
11// Unless required by applicable law or agreed to in writing, software
12// distributed under the License is distributed on an "AS IS" BASIS,
13// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14// See the License for the specific language governing permissions and
15// limitations under the License.
16
17use crate::{xcm_config::LocationToAccountId, *};
18use codec::{Decode, Encode};
19use cumulus_pallet_parachain_system::RelaychainDataProvider;
20use cumulus_primitives_core::relay_chain;
21use frame_support::{
22	parameter_types,
23	traits::{
24		fungible::{Balanced, Credit, Inspect},
25		tokens::{Fortitude, Preservation},
26		DefensiveResult, OnUnbalanced,
27	},
28};
29use frame_system::Pallet as System;
30use pallet_broker::{
31	CoreAssignment, CoreIndex, CoretimeInterface, PartsOf57600, RCBlockNumberOf, TaskId,
32};
33use parachains_common::{AccountId, Balance};
34use rococo_runtime_constants::system_parachain::coretime;
35use sp_runtime::traits::{AccountIdConversion, MaybeConvert};
36use xcm::latest::prelude::*;
37use xcm_executor::traits::{ConvertLocation, TransactAsset};
38
39pub struct BurnCoretimeRevenue;
40impl OnUnbalanced<Credit<AccountId, Balances>> for BurnCoretimeRevenue {
41	fn on_nonzero_unbalanced(amount: Credit<AccountId, Balances>) {
42		let acc = RevenueAccumulationAccount::get();
43		if !System::<Runtime>::account_exists(&acc) {
44			System::<Runtime>::inc_providers(&acc);
45		}
46		Balances::resolve(&acc, amount).defensive_ok();
47	}
48}
49
50type AssetTransactor = <xcm_config::XcmConfig as xcm_executor::Config>::AssetTransactor;
51
52fn burn_at_relay(stash: &AccountId, value: Balance) -> Result<(), XcmError> {
53	let dest = Location::parent();
54	let stash_location =
55		Junction::AccountId32 { network: None, id: stash.clone().into() }.into_location();
56	let asset = Asset { id: AssetId(Location::parent()), fun: Fungible(value) };
57	let dummy_xcm_context = XcmContext { origin: None, message_id: [0; 32], topic: None };
58
59	let withdrawn = AssetTransactor::withdraw_asset(&asset, &stash_location, None)?;
60
61	AssetTransactor::can_check_out(&dest, &asset, &dummy_xcm_context)?;
62
63	let parent_assets = Into::<Assets>::into(withdrawn)
64		.reanchored(&dest, &Here.into())
65		.defensive_map_err(|_| XcmError::ReanchorFailed)?;
66
67	PolkadotXcm::send_xcm(
68		Here,
69		Location::parent(),
70		Xcm(vec![
71			Instruction::UnpaidExecution {
72				weight_limit: WeightLimit::Unlimited,
73				check_origin: None,
74			},
75			ReceiveTeleportedAsset(parent_assets.clone()),
76			BurnAsset(parent_assets),
77		]),
78	)?;
79
80	AssetTransactor::check_out(&dest, &asset, &dummy_xcm_context);
81
82	Ok(())
83}
84
85/// A type containing the encoding of the coretime pallet in the Relay chain runtime. Used to
86/// construct any remote calls. The codec index must correspond to the index of `Coretime` in the
87/// `construct_runtime` of the Relay chain.
88#[derive(Encode, Decode)]
89enum RelayRuntimePallets {
90	#[codec(index = 74)]
91	Coretime(CoretimeProviderCalls),
92}
93
94/// Call encoding for the calls needed from the relay coretime pallet.
95#[derive(Encode, Decode)]
96enum CoretimeProviderCalls {
97	#[codec(index = 1)]
98	RequestCoreCount(CoreIndex),
99	#[codec(index = 2)]
100	RequestRevenueInfoAt(relay_chain::BlockNumber),
101	#[codec(index = 3)]
102	CreditAccount(AccountId, Balance),
103	#[codec(index = 4)]
104	AssignCore(
105		CoreIndex,
106		relay_chain::BlockNumber,
107		Vec<(CoreAssignment, PartsOf57600)>,
108		Option<relay_chain::BlockNumber>,
109	),
110}
111
112parameter_types! {
113	pub const BrokerPalletId: PalletId = PalletId(*b"py/broke");
114	pub const MinimumCreditPurchase: Balance =  UNITS / 10;
115	pub RevenueAccumulationAccount: AccountId = BrokerPalletId::get().into_sub_account_truncating(b"burnstash");
116	pub const MinimumEndPrice: Balance = UNITS;
117}
118
119/// Type that implements the `CoretimeInterface` for the allocation of Coretime. Meant to operate
120/// from the parachain context. That is, the parachain provides a market (broker) for the sale of
121/// coretime, but assumes a `CoretimeProvider` (i.e. a Relay Chain) to actually provide cores.
122pub struct CoretimeAllocator;
123impl CoretimeInterface for CoretimeAllocator {
124	type AccountId = AccountId;
125	type Balance = Balance;
126	type RelayChainBlockNumberProvider = RelaychainDataProvider<Runtime>;
127
128	fn request_core_count(count: CoreIndex) {
129		use crate::coretime::CoretimeProviderCalls::RequestCoreCount;
130		let request_core_count_call = RelayRuntimePallets::Coretime(RequestCoreCount(count));
131
132		let message = Xcm(vec![
133			Instruction::UnpaidExecution {
134				weight_limit: WeightLimit::Unlimited,
135				check_origin: None,
136			},
137			Instruction::Transact {
138				origin_kind: OriginKind::Native,
139				call: request_core_count_call.encode().into(),
140				fallback_max_weight: Some(Weight::from_parts(1_000_000_000, 200_000)),
141			},
142		]);
143
144		match PolkadotXcm::send_xcm(Here, Location::parent(), message.clone()) {
145			Ok(_) => log::info!(
146				target: "runtime::coretime",
147				"Request to update schedulable cores sent successfully."
148			),
149			Err(e) => log::error!(
150				target: "runtime::coretime",
151				"Failed to send request to update schedulable cores: {:?}",
152				e
153			),
154		}
155	}
156
157	fn request_revenue_info_at(when: RCBlockNumberOf<Self>) {
158		use crate::coretime::CoretimeProviderCalls::RequestRevenueInfoAt;
159		let request_revenue_info_at_call =
160			RelayRuntimePallets::Coretime(RequestRevenueInfoAt(when));
161
162		let message = Xcm(vec![
163			Instruction::UnpaidExecution {
164				weight_limit: WeightLimit::Unlimited,
165				check_origin: None,
166			},
167			Instruction::Transact {
168				origin_kind: OriginKind::Native,
169				call: request_revenue_info_at_call.encode().into(),
170				fallback_max_weight: Some(Weight::from_parts(1_000_000_000, 200_000)),
171			},
172		]);
173
174		match PolkadotXcm::send_xcm(Here, Location::parent(), message.clone()) {
175			Ok(_) => log::info!(
176				target: "runtime::coretime",
177				"Request for revenue information sent successfully."
178			),
179			Err(e) => log::error!(
180				target: "runtime::coretime",
181				"Request for revenue information failed to send: {:?}",
182				e
183			),
184		}
185	}
186
187	fn credit_account(who: Self::AccountId, amount: Self::Balance) {
188		use crate::coretime::CoretimeProviderCalls::CreditAccount;
189		let credit_account_call = RelayRuntimePallets::Coretime(CreditAccount(who, amount));
190
191		let message = Xcm(vec![
192			Instruction::UnpaidExecution {
193				weight_limit: WeightLimit::Unlimited,
194				check_origin: None,
195			},
196			Instruction::Transact {
197				origin_kind: OriginKind::Native,
198				call: credit_account_call.encode().into(),
199				fallback_max_weight: Some(Weight::from_parts(1_000_000_000, 200_000)),
200			},
201		]);
202
203		match PolkadotXcm::send_xcm(Here, Location::parent(), message.clone()) {
204			Ok(_) => log::info!(
205				target: "runtime::coretime",
206				"Instruction to credit account sent successfully."
207			),
208			Err(e) => log::error!(
209				target: "runtime::coretime",
210				"Instruction to credit account failed to send: {:?}",
211				e
212			),
213		}
214	}
215
216	fn assign_core(
217		core: CoreIndex,
218		begin: RCBlockNumberOf<Self>,
219		assignment: Vec<(CoreAssignment, PartsOf57600)>,
220		end_hint: Option<RCBlockNumberOf<Self>>,
221	) {
222		use crate::coretime::CoretimeProviderCalls::AssignCore;
223
224		// The relay chain currently only allows `assign_core` to be called with a complete mask
225		// and only ever with increasing `begin`. The assignments must be truncated to avoid
226		// dropping that core's assignment completely.
227
228		// This shadowing of `assignment` is temporary and can be removed when the relay can accept
229		// multiple messages to assign a single core.
230		let assignment = if assignment.len() > 28 {
231			let mut total_parts = 0u16;
232			// Account for missing parts with a new `Idle` assignment at the start as
233			// `assign_core` on the relay assumes this is sorted. We'll add the rest of the
234			// assignments and sum the parts in one pass, so this is just initialized to 0.
235			let mut assignment_truncated = vec![(CoreAssignment::Idle, 0)];
236			// Truncate to first 27 non-idle assignments.
237			assignment_truncated.extend(
238				assignment
239					.into_iter()
240					.filter(|(a, _)| *a != CoreAssignment::Idle)
241					.take(27)
242					.inspect(|(_, parts)| total_parts += *parts)
243					.collect::<Vec<_>>(),
244			);
245
246			// Set the parts of the `Idle` assignment we injected at the start of the vec above.
247			assignment_truncated[0].1 = 57_600u16.saturating_sub(total_parts);
248			assignment_truncated
249		} else {
250			assignment
251		};
252
253		let assign_core_call =
254			RelayRuntimePallets::Coretime(AssignCore(core, begin, assignment, end_hint));
255
256		let message = Xcm(vec![
257			Instruction::UnpaidExecution {
258				weight_limit: WeightLimit::Unlimited,
259				check_origin: None,
260			},
261			Instruction::Transact {
262				origin_kind: OriginKind::Native,
263				call: assign_core_call.encode().into(),
264				fallback_max_weight: Some(Weight::from_parts(1_000_000_000, 200_000)),
265			},
266		]);
267
268		match PolkadotXcm::send_xcm(Here, Location::parent(), message.clone()) {
269			Ok(_) => log::info!(
270				target: "runtime::coretime",
271				"Core assignment sent successfully."
272			),
273			Err(e) => log::error!(
274				target: "runtime::coretime",
275				"Core assignment failed to send: {:?}",
276				e
277			),
278		}
279	}
280
281	fn on_new_timeslice(_t: pallet_broker::Timeslice) {
282		let stash = RevenueAccumulationAccount::get();
283		let value =
284			Balances::reducible_balance(&stash, Preservation::Expendable, Fortitude::Polite);
285
286		if value > 0 {
287			log::debug!(target: "runtime::coretime", "Going to burn {value} stashed tokens at RC");
288			match burn_at_relay(&stash, value) {
289				Ok(()) => {
290					log::debug!(target: "runtime::coretime", "Succesfully burnt {value} tokens");
291				},
292				Err(err) => {
293					log::error!(target: "runtime::coretime", "burn_at_relay failed: {err:?}");
294				},
295			}
296		}
297	}
298}
299
300pub struct SovereignAccountOf;
301impl MaybeConvert<TaskId, AccountId> for SovereignAccountOf {
302	fn maybe_convert(id: TaskId) -> Option<AccountId> {
303		// Currently all tasks are parachains.
304		let location = Location::new(1, [Parachain(id)]);
305		LocationToAccountId::convert_location(&location)
306	}
307}
308
309impl pallet_broker::Config for Runtime {
310	type RuntimeEvent = RuntimeEvent;
311	type Currency = Balances;
312	type OnRevenue = BurnCoretimeRevenue;
313	type TimeslicePeriod = ConstU32<{ coretime::TIMESLICE_PERIOD }>;
314	type MaxLeasedCores = ConstU32<50>;
315	type MaxReservedCores = ConstU32<10>;
316	type Coretime = CoretimeAllocator;
317	type ConvertBalance = sp_runtime::traits::Identity;
318	type WeightInfo = weights::pallet_broker::WeightInfo<Runtime>;
319	type PalletId = BrokerPalletId;
320	type AdminOrigin = EnsureRoot<AccountId>;
321	type SovereignAccountOf = SovereignAccountOf;
322	type MaxAutoRenewals = ConstU32<100>;
323	type PriceAdapter = pallet_broker::MinimumPrice<Balance, MinimumEndPrice>;
324	type MinimumCreditPurchase = MinimumCreditPurchase;
325}