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.
-
Update Partner Chains SDK dependencies in your
Cargo.toml
tov1.3.1
-
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. -
Increment the
spec_version
in your runtime configuration. -
Build the new Runtime WASM (you can do it by running
cargo build --release
) -
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
extrinsicsystem/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