bump-sui 用于把项目中固定的 Sui 版本标签(mainnet-vX.Y.Z 或 testnet-vX.Y.Z)统一升级。用法:/bump-sui mainnet-v1.71.0,或传入 testnet-v 标签。
主要流程:先在工作分支上,从根 Cargo.toml 读出当前唯一版本标签;用一次 sed 替换根 Cargo.toml 中约 90 处该固定值,再执行 cargo update。对被排除的 workspace,例如 (cd sdk/ika-wasm && cargo update),以及其它有独立 lock 的排除包单独更新。
随后更新 .github/workflows/ts-integration-tests.yaml 和 .github/workflows/ts-ci.yaml 中 sui-binary 下载 URL 的标签(每个 URL 出现两次),以及 CLAUDE.md 中固定版本的注意事项。
msim 兼容性:比较新 Sui workspace 的 tokio 版本与 msim rev 的 tokio 版本;若不同,[patch.crates-io.tokio] 会静默失效,需要找到使用匹配 tokio 的 msim rev。
验证步骤:运行 ./scripts/check-sui-version-consistency.sh(CI 会强制检查),再执行 cargo build --release,然后通过 /dispatch-suites 触发集成测试套件;加密层与共识层通常是跨版本破坏点,同时留意 #[cfg(msim)] 相关代码腐化(--cfg msim 下未解析导入)。
PR 描述中需提醒开发者更新本地 sui 二进制:本地网络二进制版本不匹配时,DKG 可完成但重配置会静默停滞,详见 dev-docs/playbooks/localnet.md。完整清单见 dev-docs/conventions/sui-version-bump.md。