Best Practices for Updating Polkadot or Paseo Versions (with Xcavate Nuances)

Stage
Tools / Actions
Key Precaution

Version Selection

psvm

Upgrade stepwise, review changelogs

Version Bump

psvm, metadata change in runtime and Cargo.toml

Ensure correct version numbers

Code Review

Templates, base repos

Catch breaking changes early

Migrations

try-runtime, custom scripts

Especially for XCM or Xcavate logic

Build & Test

cargo build, tests

WASM artifacts and functionality intact

Deployment

Polkadot.js or governance pathways

Use appropriate channel (Sudo vs governance)

Verification

On-chain runtime version + feature tests

Confirm successful upgrade

Last updated