Skip to content

Partner Chains Node v1.3.1

Latest
Compare
Choose a tag to compare
@github-actions github-actions released this 08 Jan 13:06
12a4a4b

Critical: Runtime Migration Guide for v1.3.1

Features

This patch version extends the Sidechain pallet with a new extrinsic sidechain/upgrade_and_set_addresses
which allows the on-chain governance to atomically upgrade the runtime and set the genesis utxo and new main chain scripts to observe.

  1. Update Partner Chains SDK dependencies in your Cargo.toml to v1.3.1

  2. Add the following configuration to your runtime configuration:

    impl pallet_sidechain::Config for Runtime {
        // ... other parameters
      type MainChainScripts = sp_session_validator_management::MainChainScripts;
    
      fn set_main_chain_scripts(scripts: Self::MainChainScripts) {
        pallet_session_validator_management::MainChainScriptsConfiguration::<Runtime>::set(scripts);
      }
    }

    This will allow the upgrade_and_set_addresses extrinsic to update configuration of the SessionValidatorManagement
    pallet together with the Runtime code.

  3. Increment the spec_version in your runtime configuration.

  4. Build the new Runtime WASM (you can do it by running cargo build --release)

  5. Upgrade the runtime of the chain using the newly built WASM (it can be found in $CARGO_TARGET_DIR/release/wbuild/<runtime name>/<runtime name>.compressed.wasm) and the
    extrinsic system/setCode.

After these steps the chain should be running the runtime using Partner Chains SDK v1.3.1. This version is fully backwards-compatible and is a preparatory step towards v1.4.0

Bug fixes

Native-token queries cache was failing - giving wrong results - when native token scripts addresses were being updated. This has been fixed.

Compatibility matrix

partner-chains-node partner-chains-smart-contracts cardano-node cardano-db-sync kupo ogmios
1.3.1 6.2.2 10.1.2 13.5.0.2 2.9.0 6.8.0

Full Changelog: v1.3.0...v1.3.1