1234567891011121314151617181920212223242526272829303132333435use cumulus_primitives_core::ParaId;36use log::info;37use sc_cli::{38 ChainSpec, CliConfiguration, DefaultConfigurationValues, ImportParams, KeystoreParams,39 NetworkParams, Result, SharedParams, SubstrateCli,40};41use sc_service::config::{BasePath, PrometheusConfig};42use sp_runtime::traits::AccountIdConversion;43use up_common::types::opaque::RuntimeId;4445#[cfg(feature = "quartz-runtime")]46use crate::service::QuartzRuntimeExecutor;47#[cfg(feature = "unique-runtime")]48use crate::service::UniqueRuntimeExecutor;49use crate::{50 chain_spec::{self, RuntimeIdentification, ServiceId, ServiceIdentification},51 cli::{Cli, RelayChainCli, Subcommand},52 service::{53 new_partial, start_dev_node, start_node, OpalRuntimeExecutor, ParachainHostFunctions,54 },55};5657macro_rules! no_runtime_err {58 ($runtime_id:expr) => {59 format!(60 "No runtime valid runtime was found for chain {:#?}",61 $runtime_id62 )63 };64}6566fn load_spec(id: &str) -> std::result::Result<Box<dyn sc_service::ChainSpec>, String> {67 Ok(match id {68 "dev" => Box::new(chain_spec::development_config()),69 "" | "local" => Box::new(chain_spec::local_testnet_config()),70 path => {71 let path = std::path::PathBuf::from(path);72 #[allow(clippy::redundant_clone)]73 let chain_spec = Box::new(chain_spec::OpalChainSpec::from_json_file(path.clone())?)74 as Box<dyn sc_service::ChainSpec>;7576 match chain_spec.runtime_id() {77 #[cfg(feature = "unique-runtime")]78 RuntimeId::Unique => Box::new(chain_spec::UniqueChainSpec::from_json_file(path)?),7980 #[cfg(feature = "quartz-runtime")]81 RuntimeId::Quartz => Box::new(chain_spec::QuartzChainSpec::from_json_file(path)?),8283 RuntimeId::Opal => chain_spec,84 runtime_id => return Err(no_runtime_err!(runtime_id)),85 }86 }87 })88}8990impl SubstrateCli for Cli {91 92 fn impl_name() -> String {93 format!("{} Node", Self::node_name())94 }9596 fn impl_version() -> String {97 env!("SUBSTRATE_CLI_IMPL_VERSION").into()98 }99 100 fn description() -> String {101 format!(102 "{} Node\n\nThe command-line arguments provided first will be \103 passed to the parachain node, while the arguments provided after -- will be passed \104 to the relaychain node.\n\n\105 {} [parachain-args] -- [relaychain-args]",106 Self::node_name(),107 Self::executable_name()108 )109 }110111 fn author() -> String {112 env!("CARGO_PKG_AUTHORS").into()113 }114115 116 fn support_url() -> String {117 "support@unique.network".into()118 }119120 fn copyright_start_year() -> i32 {121 2019122 }123124 fn load_spec(&self, id: &str) -> std::result::Result<Box<dyn sc_service::ChainSpec>, String> {125 load_spec(id)126 }127}128129impl SubstrateCli for RelayChainCli {130 131 fn impl_name() -> String {132 format!("{} Node", Cli::node_name())133 }134135 fn impl_version() -> String {136 env!("SUBSTRATE_CLI_IMPL_VERSION").into()137 }138 139 fn description() -> String {140 format!(141 "{} Node\n\nThe command-line arguments provided first will be \142 passed to the parachain node, while the arguments provided after -- will be passed \143 to the relaychain node.\n\n\144 parachain-collator [parachain-args] -- [relaychain-args]",145 Cli::node_name()146 )147 }148149 fn author() -> String {150 env!("CARGO_PKG_AUTHORS").into()151 }152 153 fn support_url() -> String {154 "support@unique.network".into()155 }156157 fn copyright_start_year() -> i32 {158 2019159 }160161 fn load_spec(&self, id: &str) -> std::result::Result<Box<dyn sc_service::ChainSpec>, String> {162 polkadot_cli::Cli::from_iter([RelayChainCli::executable_name()].iter()).load_spec(id)163 }164}165166macro_rules! async_run_with_runtime {167 (168 $runtime:path, $runtime_api:path, $executor:path,169 $runner:ident, $components:ident, $cli:ident, $cmd:ident, $config:ident,170 $( $code:tt )*171 ) => {172 $runner.async_run(|$config| {173 let $components = new_partial::<174 $runtime, $runtime_api, $executor, _175 >(176 &$config,177 crate::service::parachain_build_import_queue::<$runtime, _, _>,178 )?;179 let task_manager = $components.task_manager;180181 { $( $code )* }.map(|v| (v, task_manager))182 })183 };184}185186macro_rules! construct_async_run {187 (|$components:ident, $cli:ident, $cmd:ident, $config:ident| $( $code:tt )* ) => {{188 let runner = $cli.create_runner($cmd)?;189190 match runner.config().chain_spec.runtime_id() {191 #[cfg(feature = "unique-runtime")]192 RuntimeId::Unique => async_run_with_runtime!(193 unique_runtime::Runtime, unique_runtime::RuntimeApi, UniqueRuntimeExecutor,194 runner, $components, $cli, $cmd, $config, $( $code )*195 ),196197 #[cfg(feature = "quartz-runtime")]198 RuntimeId::Quartz => async_run_with_runtime!(199 quartz_runtime::Runtime, quartz_runtime::RuntimeApi, QuartzRuntimeExecutor,200 runner, $components, $cli, $cmd, $config, $( $code )*201 ),202203 RuntimeId::Opal => async_run_with_runtime!(204 opal_runtime::Runtime, opal_runtime::RuntimeApi, OpalRuntimeExecutor,205 runner, $components, $cli, $cmd, $config, $( $code )*206 ),207208 runtime_id => Err(no_runtime_err!(runtime_id).into())209 }210 }}211}212213macro_rules! sync_run_with_runtime {214 (215 $runtime:path, $runtime_api:path, $executor:path,216 $runner:ident, $components:ident, $cli:ident, $cmd:ident, $config:ident,217 $( $code:tt )*218 ) => {219 $runner.sync_run(|$config| {220 let $components = new_partial::<221 $runtime, $runtime_api, $executor, _222 >(223 &$config,224 crate::service::parachain_build_import_queue::<$runtime, _, _>,225 )?;226227 $( $code )*228 })229 };230}231232macro_rules! construct_sync_run {233 (|$components:ident, $cli:ident, $cmd:ident, $config:ident| $( $code:tt )* ) => {{234 let runner = $cli.create_runner($cmd)?;235236 match runner.config().chain_spec.runtime_id() {237 #[cfg(feature = "unique-runtime")]238 RuntimeId::Unique => sync_run_with_runtime!(239 unique_runtime::Runtime, unique_runtime::RuntimeApi, UniqueRuntimeExecutor,240 runner, $components, $cli, $cmd, $config, $( $code )*241 ),242243 #[cfg(feature = "quartz-runtime")]244 RuntimeId::Quartz => sync_run_with_runtime!(245 quartz_runtime::Runtime, quartz_runtime::RuntimeApi, QuartzRuntimeExecutor,246 runner, $components, $cli, $cmd, $config, $( $code )*247 ),248249 RuntimeId::Opal => sync_run_with_runtime!(250 opal_runtime::Runtime, opal_runtime::RuntimeApi, OpalRuntimeExecutor,251 runner, $components, $cli, $cmd, $config, $( $code )*252 ),253254 runtime_id => Err(no_runtime_err!(runtime_id).into())255 }256 }}257}258259macro_rules! start_node_using_chain_runtime {260 ($start_node_fn:ident($config:expr $(, $($args:expr),+)?) $($code:tt)*) => {261 match $config.chain_spec.runtime_id() {262 #[cfg(feature = "unique-runtime")]263 RuntimeId::Unique => $start_node_fn::<264 unique_runtime::Runtime,265 unique_runtime::RuntimeApi,266 UniqueRuntimeExecutor,267 >($config $(, $($args),+)?) $($code)*,268269 #[cfg(feature = "quartz-runtime")]270 RuntimeId::Quartz => $start_node_fn::<271 quartz_runtime::Runtime,272 quartz_runtime::RuntimeApi,273 QuartzRuntimeExecutor,274 >($config $(, $($args),+)?) $($code)*,275276 RuntimeId::Opal => $start_node_fn::<277 opal_runtime::Runtime,278 opal_runtime::RuntimeApi,279 OpalRuntimeExecutor,280 >($config $(, $($args),+)?) $($code)*,281282 runtime_id => Err(no_runtime_err!(runtime_id).into()),283 }284 };285}286287288pub fn run() -> Result<()> {289 let cli = Cli::from_args();290291 match &cli.subcommand {292 Some(Subcommand::Key(cmd)) => cmd.run(&cli),293 Some(Subcommand::BuildSpec(cmd)) => {294 let runner = cli.create_runner(cmd)?;295 runner.sync_run(|config| cmd.run(config.chain_spec, config.network))296 }297 Some(Subcommand::CheckBlock(cmd)) => {298 construct_async_run!(|components, cli, cmd, config| {299 Ok(cmd.run(components.client, components.import_queue))300 })301 }302 Some(Subcommand::ExportBlocks(cmd)) => {303 construct_async_run!(|components, cli, cmd, config| {304 Ok(cmd.run(components.client, config.database))305 })306 }307 Some(Subcommand::ExportState(cmd)) => {308 construct_async_run!(|components, cli, cmd, config| {309 Ok(cmd.run(components.client, config.chain_spec))310 })311 }312 Some(Subcommand::ImportBlocks(cmd)) => {313 construct_async_run!(|components, cli, cmd, config| {314 Ok(cmd.run(components.client, components.import_queue))315 })316 }317 Some(Subcommand::PurgeChain(cmd)) => {318 let runner = cli.create_runner(cmd)?;319320 runner.sync_run(|config| {321 let polkadot_cli = RelayChainCli::new(322 &config,323 [RelayChainCli::executable_name()]324 .iter()325 .chain(cli.relaychain_args.iter()),326 );327328 let polkadot_config = SubstrateCli::create_configuration(329 &polkadot_cli,330 &polkadot_cli,331 config.tokio_handle.clone(),332 )333 .map_err(|err| format!("Relay chain argument error: {err}"))?;334335 cmd.run(config, polkadot_config)336 })337 }338 Some(Subcommand::Revert(cmd)) => construct_async_run!(|components, cli, cmd, config| {339 Ok(cmd.run(components.client, components.backend, None))340 }),341 Some(Subcommand::ExportGenesisState(cmd)) => {342 construct_sync_run!(|components, cli, cmd, _config| cmd.run(components.client))343 }344 Some(Subcommand::ExportGenesisWasm(cmd)) => {345 construct_sync_run!(|_components, cli, cmd, _config| {346 let spec = cli.load_spec(&cmd.shared_params.chain.clone().unwrap_or_default())?;347 cmd.run(&*spec)348 })349 }350 #[cfg(feature = "runtime-benchmarks")]351 Some(Subcommand::Benchmark(cmd)) => {352 use frame_benchmarking_cli::{BenchmarkCmd, SUBSTRATE_REFERENCE_HARDWARE};353 use polkadot_cli::Block;354355 type Header = <Block as sp_runtime::traits::Block>::Header;356 type Hasher = <Header as sp_runtime::traits::Header>::Hashing;357358 let runner = cli.create_runner(cmd)?;359 360 match cmd {361 BenchmarkCmd::Pallet(cmd) => {362 runner.sync_run(|config| cmd.run::<Hasher, ParachainHostFunctions>(config))363 }364 BenchmarkCmd::Block(cmd) => runner.sync_run(|config| {365 let partials = new_partial::<366 opal_runtime::Runtime,367 opal_runtime::RuntimeApi,368 OpalRuntimeExecutor,369 _,370 >(371 &config,372 crate::service::parachain_build_import_queue::<opal_runtime::Runtime, _, _>,373 )?;374 cmd.run(partials.client)375 }),376 BenchmarkCmd::Storage(cmd) => runner.sync_run(|config| {377 let partials = new_partial::<378 opal_runtime::Runtime,379 opal_runtime::RuntimeApi,380 OpalRuntimeExecutor,381 _,382 >(383 &config,384 crate::service::parachain_build_import_queue::<opal_runtime::Runtime, _, _>,385 )?;386 let db = partials.backend.expose_db();387 let storage = partials.backend.expose_storage();388389 cmd.run(config, partials.client.clone(), db, storage)390 }),391 BenchmarkCmd::Machine(cmd) => {392 runner.sync_run(|config| cmd.run(&config, SUBSTRATE_REFERENCE_HARDWARE.clone()))393 }394 BenchmarkCmd::Overhead(_) | BenchmarkCmd::Extrinsic(_) => {395 Err("Unsupported benchmarking command".into())396 }397 }398 }399 #[cfg(feature = "try-runtime")]400 401 #[allow(deprecated)]402 Some(Subcommand::TryRuntime(cmd)) => {403 use std::{future::Future, pin::Pin};404405 use polkadot_cli::Block;406 use sc_executor::{sp_wasm_interface::ExtendedHostFunctions, NativeExecutionDispatch};407 use try_runtime_cli::block_building_info::timestamp_with_aura_info;408409 let runner = cli.create_runner(cmd)?;410411 412 let registry = &runner413 .config()414 .prometheus_config415 .as_ref()416 .map(|cfg| &cfg.registry);417 let task_manager =418 sc_service::TaskManager::new(runner.config().tokio_handle.clone(), *registry)419 .map_err(|e| format!("Error: {e:?}"))?;420 let info_provider = Some(timestamp_with_aura_info(12000));421422 runner.async_run(|config| -> Result<(Pin<Box<dyn Future<Output = _>>>, _)> {423 Ok((424 match config.chain_spec.runtime_id() {425 #[cfg(feature = "unique-runtime")]426 RuntimeId::Unique => Box::pin(427 cmd428 .run::<Block, <UniqueRuntimeExecutor as NativeExecutionDispatch>::ExtendHostFunctions, _>(429 info_provider,430 ),431 ),432433 #[cfg(feature = "quartz-runtime")]434 RuntimeId::Quartz => Box::pin(435 cmd436 .run::<Block, <QuartzRuntimeExecutor as NativeExecutionDispatch>::ExtendHostFunctions, _>(437 info_provider,438 ),439 ),440441 RuntimeId::Opal => Box::pin(442 cmd443 .run::<Block, <OpalRuntimeExecutor as NativeExecutionDispatch>::ExtendHostFunctions, _>(444 info_provider,445 ),446 ),447 runtime_id => return Err(no_runtime_err!(runtime_id).into()),448 },449 task_manager,450 ))451 })452 }453 #[cfg(not(feature = "try-runtime"))]454 Some(Subcommand::TryRuntime) => {455 Err("Try-runtime must be enabled by `--features try-runtime`.".into())456 }457 None => {458 let runner = cli.create_runner(&cli.run.normalize())?;459 let collator_options = cli.run.collator_options();460461 runner.run_node_until_exit(|config| async move {462 let hwbench = if !cli.no_hardware_benchmarks {463 config.database.path().map(|database_path| {464 let _ = std::fs::create_dir_all(database_path);465 sc_sysinfo::gather_hwbench(Some(database_path))466 })467 } else {468 None469 };470471 let extensions = chain_spec::Extensions::try_get(&*config.chain_spec);472473 let service_id = config.chain_spec.service_id();474 let relay_chain_id = extensions.map(|e| e.relay_chain.clone());475 let is_dev_service = matches![service_id, ServiceId::Dev]476 || relay_chain_id == Some("dev-service".into());477478 if is_dev_service {479 info!("Running Dev service");480481 let mut config = config;482483 config.state_pruning = Some(sc_service::PruningMode::ArchiveAll);484485 return start_node_using_chain_runtime! {486 start_dev_node(config, cli.idle_autoseal_interval, cli.autoseal_finalization_delay, cli.disable_autoseal_on_tx).map_err(Into::into)487 };488 };489490 let para_id = extensions491 .map(|e| e.para_id)492 .ok_or("Could not find parachain ID in chain-spec.")?;493494 let polkadot_cli = RelayChainCli::new(495 &config,496 [RelayChainCli::executable_name()]497 .iter()498 .chain(cli.relaychain_args.iter()),499 );500501 let para_id = ParaId::from(para_id);502503 let parachain_account =504 AccountIdConversion::<polkadot_primitives::AccountId>::into_account_truncating(505 ¶_id,506 );507508 let polkadot_config = SubstrateCli::create_configuration(509 &polkadot_cli,510 &polkadot_cli,511 config.tokio_handle.clone(),512 )513 .map_err(|err| format!("Relay chain argument error: {err}"))?;514515 info!("Parachain id: {:?}", para_id);516 info!("Parachain Account: {}", parachain_account);517 info!(518 "Is collating: {}",519 if config.role.is_authority() {520 "yes"521 } else {522 "no"523 }524 );525526 start_node_using_chain_runtime! {527 start_node(config, polkadot_config, collator_options, para_id, hwbench)528 .await529 .map(|r| r.0)530 .map_err(Into::into)531 }532 })533 }534 }535}536537impl DefaultConfigurationValues for RelayChainCli {538 fn p2p_listen_port() -> u16 {539 30334540 }541542 fn rpc_listen_port() -> u16 {543 9945544 }545546 fn prometheus_listen_port() -> u16 {547 9616548 }549}550551impl CliConfiguration<Self> for RelayChainCli {552 fn shared_params(&self) -> &SharedParams {553 self.base.base.shared_params()554 }555556 fn import_params(&self) -> Option<&ImportParams> {557 self.base.base.import_params()558 }559560 fn network_params(&self) -> Option<&NetworkParams> {561 self.base.base.network_params()562 }563564 fn keystore_params(&self) -> Option<&KeystoreParams> {565 self.base.base.keystore_params()566 }567568 fn base_path(&self) -> Result<Option<BasePath>> {569 Ok(self570 .shared_params()571 .base_path()?572 .or_else(|| Some(self.base_path.clone().into())))573 }574575 fn prometheus_config(576 &self,577 default_listen_port: u16,578 chain_spec: &Box<dyn ChainSpec>,579 ) -> Result<Option<PrometheusConfig>> {580 self.base581 .base582 .prometheus_config(default_listen_port, chain_spec)583 }584585 fn init<F>(586 &self,587 _support_url: &String,588 _impl_version: &String,589 _logger_hook: F,590 _config: &sc_service::Configuration,591 ) -> Result<()> {592 unreachable!("PolkadotCli is never initialized; qed");593 }594595 fn chain_id(&self, is_dev: bool) -> Result<String> {596 let chain_id = self.base.base.chain_id(is_dev)?;597598 Ok(if chain_id.is_empty() {599 self.chain_id.clone().unwrap_or_default()600 } else {601 chain_id602 })603 }604605 fn role(&self, is_dev: bool) -> Result<sc_service::Role> {606 self.base.base.role(is_dev)607 }608609 fn transaction_pool(&self, is_dev: bool) -> Result<sc_service::config::TransactionPoolOptions> {610 self.base.base.transaction_pool(is_dev)611 }612613 fn rpc_methods(&self) -> Result<sc_service::config::RpcMethods> {614 self.base.base.rpc_methods()615 }616617 fn rpc_max_connections(&self) -> Result<u32> {618 self.base.base.rpc_max_connections()619 }620621 fn rpc_cors(&self, is_dev: bool) -> Result<Option<Vec<String>>> {622 self.base.base.rpc_cors(is_dev)623 }624625 fn default_heap_pages(&self) -> Result<Option<u64>> {626 self.base.base.default_heap_pages()627 }628629 fn force_authoring(&self) -> Result<bool> {630 self.base.base.force_authoring()631 }632633 fn disable_grandpa(&self) -> Result<bool> {634 self.base.base.disable_grandpa()635 }636637 fn max_runtime_instances(&self) -> Result<Option<usize>> {638 self.base.base.max_runtime_instances()639 }640641 fn announce_block(&self) -> Result<bool> {642 self.base.base.announce_block()643 }644645 fn telemetry_endpoints(646 &self,647 chain_spec: &Box<dyn ChainSpec>,648 ) -> Result<Option<sc_telemetry::TelemetryEndpoints>> {649 self.base.base.telemetry_endpoints(chain_spec)650 }651}