add 'pc-node smart-contracts upsert-script' command (#1016)

Author: jankun4

Cargo.lock

@@ -258,8 +258,7 @@ substrate-prometheus-endpoint = { package = "substrate-prometheus-endpoint", git
 substrate-test-runtime-client = { default-features = false, git = "https://github.com/paritytech/polkadot-sdk.git", tag = "polkadot-stable2506-2" }
 substrate-wasm-builder = { default-features = false, git = "https://github.com/paritytech/polkadot-sdk.git", tag = "polkadot-stable2506-2" }
 
-raw-scripts = { git = "https://github.com/input-output-hk/partner-chains-smart-contracts.git", tag = "v8.1.0" }
-
+raw-scripts = { git = "https://github.com/input-output-hk/partner-chains-smart-contracts.git", tag = "v8.2.0" }
 # local dependencies
 
 # utils

Cargo.toml

@@ -6,12 +6,19 @@ This changelog is based on [Keep A Changelog](https://keepachangelog.com/en/1.1.
 
 ## Changed
 
+* **BREAKING**: Updated partner-chains-smart-contracts (raw-scripts) dependency to v8.2.0.
+  Possibility to interact with smart-contracts used by earlier versions is lost.
+  Governance authority will have to establish new partner chain on Cardano.
+  All initialization and candidates registrations have to be repeated.
+
 ## Removed
 
 ## Fixed
 
 ## Added
 
+* Added `partner-chains-node smart-contracts upsert-script` command for inserting and updating versioned scripts.
+
 # v1.8.0
 
 ## Changed

changelog.md

@@ -661,6 +661,11 @@ impl From<ecdsa::Public> for SidechainPublicKey {
 	}
 }
 
+/// CBOR bytes of Plutus smart contract.
+#[derive(Clone, Encode, Decode, DecodeWithMemTracking, TypeInfo, PartialEq, Eq, Hash)]
+#[byte_string(debug, hex_serialize, hex_deserialize, decode_hex)]
+pub struct PlutusScriptCbor(pub Vec<u8>);
+
 /// CBOR bytes of Cardano Transaction.
 #[derive(Clone, Encode, Decode, DecodeWithMemTracking, TypeInfo, PartialEq, Eq, Hash)]
 #[byte_string(debug, hex_serialize, hex_deserialize, decode_hex)]

toolkit/sidechain/domain/src/lib.rs

@@ -42,6 +42,7 @@ pub mod permissioned_candidates;
 pub mod register;
 pub mod reserve;
 pub mod sign_tx;
+pub mod versioning;
 
 #[derive(Clone, Debug, clap::Subcommand)]
 #[allow(clippy::large_enum_variant)]
@@ -73,6 +74,8 @@ pub enum SmartContractsCmd {
 	#[command(subcommand)]
 	/// Send token to bridge contract
 	Bridge(bridge::BridgeCmd),
+	/// Upsert versioned smart contract
+	UpsertScript(versioning::UpsertScriptCmd),
 }
 
 #[derive(Clone, Debug, clap::Parser)]
@@ -132,6 +135,7 @@ impl SmartContractsCmd {
 			Self::SignTx(cmd) => cmd.execute().await,
 			Self::GovernedMap(cmd) => cmd.execute().await,
 			Self::Bridge(cmd) => cmd.execute().await,
+			Self::UpsertScript(cmd) => cmd.execute().await,
 		}?;
 		println!("{}", result);
 		Ok(())

toolkit/smart-contracts/commands/src/lib.rs

@@ -0,0 +1,45 @@
+use crate::{GenesisUtxo, PaymentFilePath, option_to_json};
+use partner_chains_cardano_offchain::{
+	plutus_script::PlutusScript, versioning_system::upsert_script,
+};
+use sidechain_domain::PlutusScriptCbor;
+
+#[derive(Clone, Debug, clap::Parser)]
+/// Command for upserting the versioned script on the mainchain
+pub struct UpsertScriptCmd {
+	#[clap(flatten)]
+	common_arguments: crate::CommonArguments,
+	#[arg(long)]
+	/// Script ID
+	script_id: u32,
+	#[arg(long)]
+	/// CBOR encoded Plutus V2 script
+	plutus_script: PlutusScriptCbor,
+	#[clap(flatten)]
+	/// Path to the payment key file
+	payment_key_file: PaymentFilePath,
+	#[clap(flatten)]
+	/// Genesis UTXO
+	genesis_utxo: GenesisUtxo,
+}
+
+impl UpsertScriptCmd {
+	/// Creates or updates a versioning utxo with reference script
+	pub async fn execute(self) -> crate::SubCmdResult {
+		let payment_key = self.payment_key_file.read_key()?;
+
+		let client = self.common_arguments.get_ogmios_client().await?;
+
+		let result = upsert_script(
+			PlutusScript::v2_from_cbor(&self.plutus_script.0)?,
+			self.script_id,
+			self.genesis_utxo.into(),
+			&payment_key,
+			&client,
+			&self.common_arguments.retries(),
+		)
+		.await?;
+
+		Ok(option_to_json(result))
+	}
+}

toolkit/smart-contracts/commands/src/versioning.rs

@@ -1,8 +1,9 @@
 use crate::{
 	await_tx::AwaitTx,
 	cardano_keys::CardanoPaymentSigningKey,
+	csl::TransactionContext,
 	multisig::MultiSigSmartContractResult,
-	plutus_script,
+	plutus_script, scripts_data,
 	versioning_system::{ScriptData, initialize_script},
 };
 use ogmios_client::{
@@ -29,16 +30,25 @@ pub async fn init_ics_scripts<
 	client: &T,
 	await_tx: &A,
 ) -> anyhow::Result<Vec<MultiSigSmartContractResult>> {
+	let payment_ctx = TransactionContext::for_payment_key(payment_key, client).await?;
+	let version_oracle = scripts_data::version_oracle(genesis_utxo, payment_ctx.network)?;
+
 	let ics_validator = ScriptData::new(
 		"Illiquid Circulation Supply Validator",
-		ILLIQUID_CIRCULATION_SUPPLY_VALIDATOR.0.to_vec(),
+		plutus_script![
+			ILLIQUID_CIRCULATION_SUPPLY_VALIDATOR,
+			version_oracle.policy_id_as_plutus_data()
+		]?
+		.bytes
+		.to_vec(),
 		ScriptId::IlliquidCirculationSupplyValidator,
 	);
 	let ics_auth_token_policy = ScriptData::new(
 		"Illiquid Circulation Supply Auth Token Policy",
 		plutus_script![
 			ILLIQUID_CIRCULATION_SUPPLY_AUTHORITY_TOKEN_POLICY,
-			ScriptId::IlliquidCirculationSupplyAuthorityTokenPolicy
+			ScriptId::IlliquidCirculationSupplyAuthorityTokenPolicy,
+			version_oracle.policy_id_as_plutus_data()
 		]?
 		.bytes
 		.to_vec(),

toolkit/smart-contracts/offchain/src/bridge/init.rs

@@ -38,8 +38,8 @@ pub mod sign_tx;
 mod test_values;
 /// Supports governance updates
 pub mod update_governance;
-
-mod versioning_system;
+/// Supports versioning system
+pub mod versioning_system;
 
 /// Simply wraps asset id with amount.
 #[derive(Clone)]

toolkit/smart-contracts/offchain/src/lib.rs

@@ -16,7 +16,9 @@
 use crate::{
 	await_tx::AwaitTx,
 	cardano_keys::CardanoPaymentSigningKey,
+	csl::TransactionContext,
 	multisig::MultiSigSmartContractResult,
+	plutus_script, scripts_data,
 	versioning_system::{ScriptData, initialize_script},
 };
 use ogmios_client::{
@@ -42,14 +44,21 @@ pub async fn init_reserve_management<
 	client: &T,
 	await_tx: &A,
 ) -> anyhow::Result<Vec<MultiSigSmartContractResult>> {
+	let payment_ctx = TransactionContext::for_payment_key(payment_key, client).await?;
+	let version_oracle = scripts_data::version_oracle(genesis_utxo, payment_ctx.network)?;
+
 	let reserve_validator = ScriptData::new(
 		"Reserve Management Validator",
-		RESERVE_VALIDATOR.0.to_vec(),
+		plutus_script![RESERVE_VALIDATOR, version_oracle.policy_id_as_plutus_data()]?
+			.bytes
+			.to_vec(),
 		ScriptId::ReserveValidator,
 	);
 	let reserve_policy = ScriptData::new(
 		"Reserve Management Policy",
-		RESERVE_AUTH_POLICY.0.to_vec(),
+		plutus_script![RESERVE_AUTH_POLICY, version_oracle.policy_id_as_plutus_data()]?
+			.bytes
+			.to_vec(),
 		ScriptId::ReserveAuthPolicy,
 	);